Custom data fields for Electronic Funds Transfer (EFT) formats in Microsoft Dynamics GP

This article provides information about the custom data fields for Electronic Funds Transfer (EFT) formats in Microsoft Dynamics GP.

Applies to:   Microsoft Dynamics GP
Original KB number:   2956922


Many banks are offering check printing services, CEPS programs, and other services in which a flat payment file is needed. The EFT functionality in Microsoft Dynamics GP was designed to comply with the required fields for the standard published NACHA formats. So if you try to make a custom flat file for some of these other services provided by your bank, you will need to set up a custom format, and likely need a dexterity customization to achieve certain fields. Custom formats are not currently support in Microsoft Dynamics GP and our case policy is listed below. Keep in mind that just because a field can be selected in a particular line in the format, does not necessarily mean that it was designed to work in that line.

Review the case policy for EFT configurator files in the link below. The current policy is one field or error message per support incident. However, if the functionality for that field does not work in the line you are trying to use it in, a dexterity customization would be needed.

Guidelines that Microsoft support professionals use to determine when a support case becomes a consulting engagement for Report Writer, SSRS, Word Templates,SmartList Builder/Designer, SQL scripts, Business Alerts, VB Script, Modifier/VBA & Configurators, Workflow


If you are trying to obtain a custom EFT format that is not already provided in Microsoft Dynamics GP, you will likely need a dexterity customization to achieve a custom format to make a flat file for these other services offered by your bank.


Here are some custom fields to be aware of:

Unique file identifier / EFT document ID:

The Unique File Number functionality is a unique number per EFT file generated. If selected on several line types, the same number will print in each line, and increment each time a new EFT file is generated. This number is already available in Microsoft Dynamics GP by mapping the field as follows:

EFT Next File Number
Maps to: Data Field
Table: Checkbook Electronic Funds Transfer Master
Field: EFT Next File Number


The bank prenote file generated will print zeroes in this field.

Batch ID in batch header/batch control lines:

Microsoft Dynamics GP is designed to put all payments into a single batch in the EFT file, and this is acceptable. (Most banks don't care how many individual batch ID's were included in Microsoft Dynamics GP.) So all the batches pulled into the file will appear as one big batch in the EFT file. Therefore, you will only see one Batch Header, and one Batch Control line per file. This is by design and is acceptable to the bank.

Sequence number:

This field was designed to work in the Addenda Line type only. If this field does not work in any other line types, you will need to request a customization.

Invoice numbers:

The Invoice numbers and Amount were intended to be mapped in the Addenda Line of your format, and should be mapped as follows to pull the correct information:

Invoice Number:
Maps to: Data Field
Table: PM Apply To History File
Field: Apply To Document Number

Invoice Amount:
Maps to: Data Field
Table: PM Apply To History File
Field: Applied Amount (If that doesn't work, try Apply From Apply Amount next, and verify it is the correct amount.)

*For the invoice, you are only limited to the fields in the PM Apply to History table (PM30300), so you would not be able to get such fields as the invoice description or PO field. The EFT file is set up to get to payment record information, not invoice information, other than what is available on the apply record.

Any 'count' or 'sum' fields in header lines:

As a general rule, any 'count' or 'sum' fields will only work in footer lines, or AFTER the lines have been listed. Therefore, most of the 'count' or 'sum' fields only work in the Batch Control and File Control footer lines, and do not work in Header or Detail lines. You will need to test to verify.

Number of addenda records on Detail line:

The Addenda Count will only work in an Addenda line type, and does not work in a Detail, Batch Control or File Control line. The Addenda lines can only be counted after they're consecutively listed, and not before.

For example, the 'Addenda Count' won't work in a File Control header line, or the Detail payment line because the number of addenda records hasn't yet been listed. The system is unable to count or total them before they're listed. (So you wouldn't be able to fulfill this requirement of the CTX format without a dexterity customization.)

As a work-around, there's an option for 'Detail + Addenda' available in the Batch Control and File Control lines that have been accepted by most banks instead. So verify with your bank if they would accept this field instead. Another option is to generate the EFT file using 'one check per invoice' instead of 'one check per vendor'. Since you'll have one addenda line per Detail line with this option, you can then hard-code this as '1' in the Detail Line.

Line count:

The Line Count data field was designed to work in the File Control line and will count all lines of the file. This field does not work in any other line type.

For example, if you have 10 total lines in an EFT file, the Line count in the Batch Control line will list 9 because it can only list the preceding lines. The Line Count in the File Control Line will list the correct count of 10, as this field was designed to work in this line. However, the Line Count field won't work in the additional footer lines (Trailer Label 1 and Trailer Label 2) since these additional footer lines aren't part of a standard NACHA format.

More information

To open an advisory case to request a customization, contact your Partner first. An advisory case can be opened with Microsoft, but all customizations will be billed through the Partner. To submit an advisory service online, see the Support Benefits and Incidents page and sign in to Microsoft account associated with your Partner ID. Select View or use your benefits button and select Use to begin the request. Follow the step-by-step workflow to provide the proper details about the request. You will be contacted by a Microsoft Representative to begin to scope and assign the service to an engineer.

For more information on EFT set-up, and other Frequently Asked Questions, see Guidelines to follow when you generate EFT files or EFT prenote files in Electronic Funds Transfer for Payables Management or Receivables Management in Microsoft Dynamics GP.