Background: AR Payment Import (EDI 820 Transaction Set)

Use the AR Payment Import (E820I) program to import customer payments from an ASCII file. Optionally, EDI payments can be automatically processed. See Drop File Interface Options - EDI 820. Payments that are imported using either method are transferred to a payment batch for updating in Cash Receipts Entry (RCE) if there are no errors. If there are errors in the transactions, the information is stored in a holding file where it can be viewed and corrected or deleted with EDI 820 Maintenance (PRCE) before further processing in Cash Receipts Entry (RCE).

This topic has these subtopics:

Import Process
Error Conditions
File Format

Import Process

If using a drop file process, the drop directory is continually polled for files matching the file prefix you have set in the Drop File Interface Options - EDI 820 maintained in System Options Maintenance. When a file is found, it is imported.

If you are manually importing the transactions, run program E820I and enter the file name (and full path) for the file you want to process.

See below for file layout and field parameters.

Whether doing the manual import or the drop file method, the process will parse the file, validate the data, and send the EDI administrator (specified in Drop File Interface Options - EDI 820 system options) EDI Payment Log and, if there are warnings and/or errors, the AR Pending Payment Error Report. If using a drop file process, it will also log the incoming file as received (in Interface Log Inquiry).

If there are errors in the transaction, they are written to a holding file that may be viewed or maintained using EDI 820 Maintenance (PRCE) (similar to Cash Receipts Entry (RCE)). When the problems have been corrected, PRCE can be used to transfer the batch to RCE for processing. The payment amount cannot be maintained as it is the amount the bank will have deposited.

If there were no errors, use Cash Receipts Entry (RCE) to run the cash receipts register/journal and update the payment transactions.

Error Conditions

Payment Record (HEADER)

Error Conditions

  • The customer number - must be a valid customer number, must be an active customer, and must be an AR customer.

  • The payment amount cannot be negative.

  • The cash account, if supplied, is validated as a PowerShift organization code and GL account number; it must be an active GL account.  If not supplied in the incoming record, the program will try to obtain the default cash account using the XPC parameters (CASH, for program RCJ) and the customer’s sales organization (from CM).  If there is no account set up in XPC, it is an error condition.

  • The payment method must be a valid code (set up in TPMM).

  • The payment number cannot already exist in PowerShift (if it does, the error message will indicate that payment number was already deposited and on what date.

Invoice Details (DETAIL)

Error Conditions

  • The payment transaction code is not valid. Currently IV for invoice payment or CM for credit taken are valid.

  • A discount is taken on an on-account payment.

  • The invoice number is not valid.

  • The cash and AR organizations are in different GL consolidations.

  • There is no GL account specified for adjustments (maintained in Posting Criteria Maintenance) or the account specified is invalid or inactive.

Warnings

  • Discount is greater than the allowed discount (based on terms and date of payment); invoice is not paid in full but a discount was taken.

  • The invoice balance – either before or after the payment is applied – does not match the invoice balance in PowerShift.

  • An adjustment amount is greater than adjustment or write-off limit.

  • The invoice balance left, after payments and adjustments, is less than the write-off limit; invoice has a credit balance (was overpaid).

File Format

The ASCII file can contain multiple payments. Each payment must have one HEADER record and at least one DETAIL record. Each HEADER can have multiple DETAIL records; each DETAIL record can have multiple notes (CMMTS).

R2F-H HEADER

Field

Length

Description

Notes

 

R2FRTYPE$

6

record type

Always "HEADER"

 

R2FHBATCH$

12

batch ID

All records in batch must have same ID

 

R2FHCUST$

10

customer no

Mapped to Customer number (maintained in Customer Maintenance)

 

R2FNAME$

35

customer name

For identification purposes only; not validated

 

R2FPYCODE$

2

payment method

Mapped to Payment method (maintained in AR Payment Method Codes Maintenance)

 

R2FHAMT$

18

payment amount

Amount of check or other payment type

 

R2FPAYNO$

25

payment no

Check or other payment type number (wire transfer no, credit card number, etc.)

 

R2FHCUR$

2

currency

Mapped to Currency code (maintained in Currency Codes Maintenance)

 

R2FIDNO$

15

ABA no

Information only; not validated

 

R2FACCT$

25

payee account no

 

 

R2FDATE$

8

payment date

Date of check or other payment type (CCYYMMDD)

 

R2FCASH$

12

bank org/GL acct

Mapped to GL org code followed by GL account no (maintained in GL Account Maintenance)

R2F-D DETAIL

 

 

 

 

 

R2FRTYPE$

6

record type

Always "DETAIL"

 

R2FDBATCH$

12

batch ID

Must match header and other detail records for this batch

 

R2FDCUST$

10

customer no

Mapped to Customer number (maintained in Customer Maintenance)

 

R2FDPAYNO$

25

payment no

Check or other payment type number

 

R2FDPYTYPE$

2

payment method

CK or other valid payment method (maintained in AR Payment Method Codes Maintenance)

 

R2FRINV$

12

invoice no

Must be a valid invoice number

 

R2FPAYCD$

2

payment code

IV if paying an invoice; CM if taking a credit

 

R2FINVAMT$

18

invoice amount

Invoice amount due. If it does not match the PowerShift invoice amount, a warning message is issued

 

R2FRPYAMT$

18

payment amount

Amount of payment applied to this invoice

 

R2FDISC$

18

discount amount

Discount being taken on this invoice/payment

 

R2FADJAMT$

18

adjustment amount

Amount of adjustment being made to invoice balance

 

R2FINVNET$

18

net invoice amt

Invoice amount after payments/adjustments; if it does not match the net invoice amount, a warning message is issued

 

R2FREF$

30

reference

Reference for payment or adjustment

R2F-C COMNTS

 

 

 

 

 

R2FRTYPE$

6

record type

Always "COMNTS"

 

R2FCBATCH$

12

batch ID

 

 

R2FCUST$

10

customer no

 

 

R2FCPAYNO$

25

payment no

 

 

R2FRINV$

12

invoice no

 

 

R2FCMCODE$

3

comment code

 

 

R2FCOMMT$

50

comment