Use this function to define type codes in BAI2 bank import files as credit or debit so that files can be imported and automatically matched to open items. This function is one of several that are required to complete the advanced bank statement import setup process.

When importing bank transactions using the BAI2 file format, the import process cannot identify whether a transaction code is a credit or a debit. The type codes are included in the Account identifier record (Record type 03) and Transaction detail (Record type 16) of the BAI2 file. If a code is not defined with the appropriate sign, the bank statement file is not imported and is listed as an error in the import log file. Note that only type codes related to a transaction detail record are blocked while importing the file, if not defined.

You can create multiple sets of Bank type codes, either one for all banks or one per bank. The list below shows which type codes can be defined for the advanced bank statement import process. However, always check with the bank to ensure you are using the correct type codes.

101-399: Credit summary and detail type codes

401-699: Debit summary and detail type codes

700-799: Loan summary and detail type codes

See Understanding the BAI2 file format for more information.

For detailed information on setting up statement imports, see “Advanced bank statement imports - Setup and workflow” on the How-to tab.

This involves technical settings that should be done very carefully. If you are not certain, contact your Sage X3 administrator or business partner.

Bank statement import setup overview

This provides an overview of the setup procedures necessary to perform advanced bank statement imports, which includes matching statements to open items and generating payments. You can also match to existing payments without generating a new payment. Note that you cannot match a single transaction to an open item and a payment combination. See Bank statement import overview.

This involves technical settings that should be done very carefully. If you are not certain, contact your Sage X3 administrator or business partner.

View the online help for each function for specifics on data entry and complete function help.

BSI - Bank statement import activity code
You need to activate this activity code to take advantage of the bank statement import process.

Understanding electronic bank formats
To set up the bank statement import successfully, at least a basic understanding about the structure and content of electronic bank statement files is required. This includes MT940, CAMT.053, BAI2, CFONB, and AR Lockbox CSV file types.

Note: Most banks provide CAMT messages in ZIP files. You need to unzip the files before importing into Sage X3.

Payment entry types for bank statement imports
It is strongly recommended to use dedicated payment entry types for the bank statement import (BSI) so that settings can be made independent from other entry types. A dedicated BSI entry type is available as part of the default setup that you can copy or adapt. Dedicated BAI2 and CFONB entry types are also available.

Bank import segment definition
The segment definition describes the detailed structure of the information contained in a segment. This includes segments from the logical parts, like the header, data line, footer, etc., of a bank import format. Based on this, the import extracts and interprets the information contained in the file. The sequence of the segments is controlled by the import format definition.

Note: If you are importing BAI2 files, you need to define Bank import type codes (BSIIMPTC). This is an additional step dedicated to this format.

Bank import format
The format definition describes the overall structure of the format and the sequence or occurrence of the segments. It also controls when new entries for statements and transactions are created during the import.

At least one Bank import format must be defined; it can be used for several bank accounts. You can also have several formats, (i.e., for bank accounts from different banks using different MT940 or CAMT.053 variants).

BP number and Invoice number definitions
The BP number and the invoice number are the main criteria for automatic matching, but are typically given in the bank statement file in a non-structured way as part of the payment reason or information text.

For an efficient search, you need to provide information about the structure of these numbers so the search process can recognize parts of the payment reason text as a BP or invoice number.

Bank import settings
These settings control various aspects of the import and the matching processes. Settings are done at the company level at a minimum, but you can have different settings per company for different bank accounts and/or file formats. For CFONB file formats, a specific bank is not entered.

These settings are applied in the context of an import, so if you import a bank statement file, you need to select a group of settings for this import. These settings are used for the import and the matching process later. For example, you can import and match transactions through the advanced bank statement import workflow or import files and then reconcile using the Bank statement reconciliation (RAPBAN) function.

If you want to included existing payments in the import and matching process, you need to select at least one option in the Payments block of the Search criteria section.

Note: For CFONB file formats, you cannot reconcile using the Bank statement reconciliation function for matching.

Excluded search terms
You can define common terms that are excluded from the business partner name search. Common search terms can include the abbreviations of legal forms that are used in BP names like Ltd, S.A., Inc., and GmbH AG. Salutations like Mister, Miss, Mrs., Herr, and Frau that are used in BP names can also be excluded.

Excluding these common terms that are found in many business partner records increases search performance because it reduces the number of possible BP accounts that need to be searched for open items.

Search term list
Search terms can be used if fixed identifications (like a BP name or a certain text given in the transaction) should be used to match the transaction to a certain G/L or BP account.

Understanding the BAI2 file format

The BAI2 file is a standard bank statement format developed by the Bank Administration Institute (BAI) and used for electronic cash management balance reporting. It is mostly used in the United Kingdom and the United States.

A BAI2 file contains multiple record types in a specific structure. Each file contains one File header (type 01) and one File trailer (type 99), but can contain multiple groups. Each group has a Group header (type 02) and a Group trailer (type 98). Within each group pair, there can be multiple Accounts (types 03 and 49) that contain the Transaction detail (type 16) followed by single or multiple Continuation lines (type 88).

The annotated sample below highlights the nesting structure of a BAI2 file that contains one group and two accounts.

The first two digits of each line followed by a comma identify the Record type.

On the lines for Transaction detail (highlighted in purple), the type code follows the Record type 16, separated by a comma. In this example, one Transaction detail line has a 195 type code and the second Transaction detail line has a 495 type code.

Prerequisites

SEEREFERTTO  Refer to documentation Implementation

Actions

 Click this button to define a new type code.

Presentation

Click Create to define bank type codes when importing BAI2 bank transaction files or click the Edit icon to modify an existing bank type code.

Close

Fields presentation

Header

  • Bank type code (field BSICODSCT)

Enter a unique identifier for the list of type codes.

  • Bank (field BAN)

Enter a bank to apply these type code definitions to imports from this bank.

Leave this field blank to apply these settings to BAI2 imports from banks with no specific list of type codes defined. A list defined specifically for a bank will always take precedence.

  • Description (field DESAXX)

Enter a description for the type code.

  • Short description (field SHO)

Enter a short description.

Grid

  • Code (field COD)

Enter a specific type code for a transaction.

The following codes can be defined for advanced bank statement import:

  • 101-399: Credit summary and detail type codes
  • 401-699: Debit summary and detail type codes
  • 700-799: Loan summary and detail type codes
    • Description (field DES)

    Enter the description for the type code according to information provided by your bank.

    • Level (field LEV)

    Select the transaction type:

  • Status
  • Summary
  • Detail
  • Note: Only Detail transaction types are taken into account for the advanced bank statement import process.

    • Sign (field SIG)

    Select Credit or Debit to define the appropriate sign for the transaction.

    • Summary code (field SUMCOD)

    This field is optional and is used for codes that summarize account credit or debit activity. Example: 100 for credit or 400 for debit.

    This field is not used for Detail transaction types.

    • Record (field REC)

    Enter 16 to indicate that this type code is in the Transaction detail (Record 16) in the BAI2 file.

    Note: Only Record type 16 is used by the advanced bank statement import process.

    • Destination (field DESFLD)

    Enter the database field to store the defined type codes. For example, [BSIIMPD]SNS.

    Close

    Error messages

    In addition to the generic error messages, the following messages can appear during the entry :

    Format and segment definition have to be of the same file type

    The file types defined in the bank import segment definition and the linked bank import format must be the same.

    Mandatory field '$1$' in segment '$2$' does not exist. Please check the according format and segment definition.

    Review and update the segment definition.

    Tables used

    The following tables are implemented by the function :

    Table

    Table description

    BSIIMPTC [BSITC]

    Bank import type codes

    SEEREFERTTO  Refer to documentation Implementation