3 Working with CGI Payments and Credits

This chapter contains the following topics:

3.1 Understanding CGI Payments

The Common Global Implementation (CGI) Initiative aims to extend the scope of multi-bank payment format implementation guideline based on the ISO 20022 XML payment. The initiative provides a forum for global, multi-country, multi-bank, and multi-instrument implementations.

The conditions that are specific to the ISO 20022 CGI payment file format are:

  • The payment currency can be any currency.

  • There is no restriction on the disbursement bank branch location and payee bank branch location.

  • The payee bank account is required for all electronic funds transfers (EFTs).

To create the CGI payment XML file in the JD Edwards EnterpriseOne system, you set up your company and supplier bank accounts with the BIC number and IBAN. When you use the Write process in the automatic payment process, the system writes records to an XML file for accounts. You then send the XML file to the bank.

The JD Edwards EnterpriseOne system supports the creation of the credit transfer XML payment format. The XML file is created for CGI credit transfer payments when you run the automatic payment process. However, the system does not support the transmission of the XML file to the bank.


Note:

To specify default processing for CGI payments, you set processing options for version ZJDE0001 of the Payment Information Extractor Report (R744003), and the CGI Credit Transfer POs - COMM -04 program (P744003). The only function of the P744003 program is to provide additional processing options for CGI to complement the general processing options available in the R744003 program.

To access the processing options for P744003, select the CGI Credit Transfer Processing Options (P744003) from the General CGI XML menu (G74CGICT). You can also access the processing options through the Interactive Versions program.

To access the processing options for R744003, select the CGI XML Credit Transfer (R744003) from the General CGI XML menu (G74CGICT). You can also access the processing options through the Batch Versions program.

The Payment Print Program value must be P744003.


3.2 Generating the XML File for CGI Payments

When you use the automatic payment process in the JD Edwards EnterpriseOne software, you specify the payment print program to use. The payment print program controls how the system writes records to the database tables.

For CGI payments, you set the payment print program to P744003, version ZJDE0001, and run the Write process of the automatic payment process to create the XML file.


Note:

JD Edwards EnterpriseOne software does not support the transmission of the XML file to the bank. The software includes only the functionality to generate the XML file.

When you run the automatic payment process that is set to use the R744003 program for CGI payments, the system:

  • Generates a PDF file that shows whether the process completed successfully or with errors.

  • Generates the XML file.

  • Changes the payment status of the group from WRT (write) to UPD (update) if the process was completed successfully.

You can also write single payments of a group by using the Work With Payment Group - Write Status program (P04572W). The system generates the CGI Credit Transfer XML file only for payments written in the Work With Payment Group - Write Status form.

To write single payments:

  • Launch the Work With Payment Groups program (P04571).

  • Select the payment control group.

  • Access Payments from the Row menu.

  • In the Work With Payment Group - Write Status form, select one or multiple payments of the group, and select Write from the Row menu.

3.2.1 XML File

The XML includes three blocks of records. Block A is the message root. Block B is the Group Header block, which includes a description of the XML file and the initiating party. Block C is the Payment Information block and includes a set of parameters, which apply to the debit side of the credit transfer transaction. Block C also includes the Credit Transfer Information elements, which can have one or multiple transaction records.

See Bank Payment ISO20022 CGI Format - XML Layout (Doc ID 2259096.1)

3.2.2 Understanding Error Messages in the Payment Information Extractor Report for CGI (R744003)

The system displays an error in the following circumstances:

  • The Category Purpose processing option is blank.

  • The Payment Purpose processing option is blank.

  • The Debtor element is blank.

  • The Debtor ID element is blank.

  • The Ultimate Debtor element is blank.


    Note:

    If the Ultimate Debtor address book number is equal to Debtor address book number, the system does not print this tag or display an error.

  • The Ultimate Debtor ID element is blank.

  • The Creditor element is blank.

  • The Creditor ID element is blank.

  • The Ultimate Creditor element is blank.


    Note:

    If the Ultimate Creditor address book number is equal to Creditor address book number, the system does not print this tag or display an error.

  • The Ultimate Creditor ID element is blank.

  • The Address Line element is blank.

  • The payment currency specified in the Currency Code processing option for R744003, ZJDE0001 version is different from the currency of the payment group.

  • The IBAN and BIC (SWIFT Code) elements of the debtor and creditor are blank. This error message is displayed only if you set the processing options to validate the IBAN and the BIC for the debtor and the creditor bank accounts.

If there are errors, the system does not advance the payment group next status to UPD (update).

The system includes the Payment Group Control Number in error messages written to the Work Center. This number helps you identify payments that have errors.

If the system determines that the country of the company or supplier is blank, the system writes a warning message to the Work Center, and changes the status of the payments from Write to Update.

If a payment control group has two or more payments and some of them have errors, the system advances the payments without errors to the update status, but does not advance the payments with errors to the update status. In this case, the system generates the XML only for those payments that are written (the ones without errors).

3.2.3 Understanding Unacceptable Characters in the Output File

The Payment Information Extractor program (R744003) for CGI generates an XML file that you submit to the banking system. The program generates some information, such as addresses, using the language that is set up in your system. The banking system cannot process all of the special characters that exist in all languages. If your JD Edwards EnterpriseOne system generates the XML file with unacceptable characters, you can set up your system to substitute acceptable, alternative characters for the unacceptable characters.

You set up the Replace Character In String (70/RS) UDC table with the acceptable characters to use in place of the unacceptable characters. You then specify in a processing option in the ZJDE0001 version of the Payment Information Extractor program (R744003) that you want to use the 70/RS UDC table to substitute characters in the XML output file.

When you set up the 70/RS UDC table, you can specify one or more alternative characters. When you specify multiple alternative characters, the length of the string that is altered does not change; if the original string is three characters, the modified string is three characters. The system drops certain characters from the string if inserting all of the alternate characters will result in the modified string exceeding the allowed length of the string.

These examples illustrate how the system replaces a single character with multiple characters:

3.2.3.1 Example 1: Replacing A with FG

Original string is ABC.

Modified string is FGB.

To retain the field length of three, the system drops the C from the string.

3.2.3.2 Example 2: Replacing A with FG

Original string is ABC_ _ _ (where _ is blank).

Modified string is FGBC_ _.

To retain the field length of six, the system drops the last blank from the string.

3.2.3.3 Example 3: Replacing B with FGHI

String is ABC.

Result is AFG.

To retain the field length of three, the system replaces only the first two letters.

3.2.4 Setting Processing Options for the CGI Credit Transfer Processing Option (P744003)

Processing options enable you to set default processing values for programs and reports.


Note:

You can access the processing options by selecting CGI Credit Transfer Processing Options (P744003) from the General CGI XML menu (G74CGICT).

Before you begin, review the processing options for this program.

3.2.4.1 General

1. Payment Purpose

Specify an ISO standard code from the UDC table (74/PC) to identify the purpose of the collection. If you leave this field blank, the system displays an error in the report and does not advance the payment to the update status.

2. Category Purpose

Specify an ISO standard code from the UDC table (74/CP) to identify the category purpose of the collection. The categories can include salary payment, supplier payment, or tax payment. If you leave this processing option blank, the system displays an error in the report and does not advance the payment to the update status.

3. Instruction Priority

Specify a value from the UDC table (74/IP) that indicates the level of urgency applied to the processing of the instruction. Values are:

HIGH: Priority level is high.

NORM: Priority level is normal.

4. Batch Booking Flag

Specify if the batch booking element in the XML is TRUE or FALSE. Values are:

TRUE: It is a batch entry for the sum of the amounts.

FALSE: It is a single entry for each of the transactions in the message.

If you leave this processing option blank, the system does not populate <BtchBookg> tag in the XML file.

5. Local Instrument

Specify a local instrument or a local clearing option or both to further qualify the service or service level as published in an external local instrument code list.

3.2.4.2 Remittance Information

1. Remittance Information Mode

Specify the mode that the system uses for the remittance information. Values are:

Blank: Structured

1: Non-structured

2. Remittance Identification Issuer

Specify the field that the system uses to retrieve the remittance identification issuer if the remittance information mode is structured. Values are:

Blank: Mailing name of the supplier

1: Country of the supplier

The system retrieves the value from UDC 74/IC based on the supplier's country.

2: User-defined value

If you specify this value for this processing option, you must set the Remittance Identification Issuer value processing option.

If the remittance information mode is unstructured, you do not need to specify a value for this processing option.

3. Remittance Identification Issuer Value

If Remittance Information Mode is structured and the Remittance Identification Issuer processing option is set to the user-defined value, specify the value to populate the remittance identification issuer value into the XML. If you leave this field blank, the Issuer field will not be populated.

3.2.4.3 XML File

1. Debtor Town Name

Specify whether to include the XML element tag Town Name <TwnNm> for the Debtor in the XML output file. Values are: Blank: Include it. You must have a value set up in the Address Book.

1: Do not include it.

2. Debtor Postal Code

Specify whether to include the XML element tag Postal Code <PstCd> for the Debtor in the output XML file. Values are:

Blank: Include it. You must have a value set up in the Address Book.

1: Do not include it.

3. Creditor Town Name

Specify whether to include the XML element tag Town Name <TwnNm> for the Creditor in the output XML file. Values are:

Blank: Include it. You must have a value set up in the Address Book.

1: Do not include it.

4. Creditor Postal Code

Specify whether to include the XML element tag Postal Code <PstCd> for the Creditor in the output XML file. Values are:Blank: Include it (default). You must have a value set up in the Address Book.

1: Do not include it.

3.2.4.4 Validations

1. R744003 Version

Specify the version of the R744003 program that the system uses. If you leave this processing option blank, the system uses the ZJDE0001 version.

3.2.5 Setting Processing Options for CGI XML Credit Transfer Processing Option (R744003)

Processing options enable you to set default processing values for programs and reports.


Note:

You can access the processing options by selecting the CGI XML Credit Transfer (R744003) program from the General CGI XML menu (G74CGICT).

Before you begin, review the processing options for this program.

3.2.5.1 General

1. Translation Program

Enter a value from the Check Translation (98/CT) UDC table to specify the translation program to use to convert numbers to words. If you leave this processing option blank, the system uses the translation program that is associated with the currency of the payment.

2. Replace pre-defined characters using UDC 70/RS

Specify whether to use replacement characters from UDC 70/RS. Values are:

Y: Yes

N or Blank: No

3. Inform Multiple Invoice Occurrences

Specify if there will be single or multiple invoice occurrences per remittance information. Values are:

Y: Inform several invoices.

N or Blank: Inform only one invoice.

4. Payment Number for Matching Document PT

Specify the next number that the system will use for matching document with document type PT. Valid values are:

Blank: Use the payment next number from the General Ledger (G/L) Bank Account Information Program (P0030G).

1: Use the standard next number from the Next Numbers program (P0002)

3.2.5.2 Performance

Use these processing options to limit the data that is extracted from the JD Edwards Enterprise One tables.

1. Payer Information (Y/N)

Enter Y (yes) or leave this processing option blank to extract payor information, which is required for this payment format.

2. Bank Account Information (Y/N)

Enter Y (yes) or leave this processing option blank to include the extraction of bank account information, which is required for this payment format.

3. Ultimate Debtor (Y/N)

Enter Y (yes) or leave this processing option blank to include the extraction of ultimate debtor information.

4. Payee Information (Y/N)

Enter Y (yes) or leave this processing option blank to include the extraction of payee information, which is required for this payment format.

5. Payee Bank Account Information (Y/N)

Enter Y (yes) or leave this processing option blank to include the extraction of payee bank account information, which is required for this payment format.

6. Ultimate Creditor

Enter Y (yes) or leave this processing option blank to include the extraction of ultimate creditor information.

7. Document Payable Information (Y/N)

Enter Y (yes) or leave this processing option blank to extract document payable information, which is required for this payment format.

3.2.5.3 Validations

1. Supplier's IBAN (Y/N)

Enter Y (yes) to validate the supplier's IBAN (international bank account number), which is required for this payment format.

2. Company's account IBAN (Y/N)

Enter Y (yes) to validate the company's account IBAN, which is required for this payment format.

3. Supplier's SWIFT (Y/N)

Enter Y (yes) to validate the supplier's SWIFT number, which is required for this payment format.

4. Company's account SWIFT (Y/N)

Enter Y (yes) to validate the company's account SWIFT number, which is required for this payment format.

5. Payment Currency Code

Enter the currency code that you want to include in the payment format output. If you do not specify a currency code, the system uses the currency of the payment.

6. Special Validation Rules

Specify VLCGI to have the system apply validations for CGI credit transfer files and to print XML tags.

This is a mandatory field.

The system writes a warning message to the Work Center if the country of the company or supplier is blank. The system continues processing records if it issues a warning message.

3.2.5.4 Parameters

1. Ultimate Debtor Addr Line Number

Specify a value from the UDC table (70/UD) that identifies the address number line that the system uses for the ultimate debtor.

This processing option can have a value from 1 to 5. For example, if the Ultimate Debtor Addr Line Number processing option is equal to 2, then address number 2 from the address book is the ultimate debtor address number.

2. Ultimate Creditor Addr Line Number

Specify a value from UDC table (70/UC) that identifies the address number line that the system uses for the ultimate creditor.