Please enable JavaScript to view this site.

 

Navigation: Zetadocs Expenses System Settings Help > Payment Card Types

Transaction Import Format

Scroll Prev Top Next More

Transaction Import Format

Relevant to the hmtoggle_arrow0Expenses Administrators role.

Accessed via: main_menu1 > System Settings > Payment Card Types > Configure Format


note_image Note: This help is applicable for all editions of Zetadocs expenses. Where features are only available they are marked according to the table below.

1 - This option is only available in the Essentials and Plus editions.

2 - This option is only available in the Plus edition.

 


File Format

Setting

Details

File format

CSV with header line - Standard comma separated (CSV) text file containing a line at the start with a heading (label) for each column. You specify each field to be imported by entering the column heading in the settings below.  This is the recommended format for most banks.

CSV without header - CSV text file which includes just the transaction data without any heading line.  You specify each field to be imported by entering the column number in the settings below, starting from 1 for the first column.

Field Separator

Specifies the character which is used to separate fields (columns) in the import file.

Auto Detect - the system will determine the separator character automatically each time a file is imported.

(Other values) - the system will use the character specified.

Header line number

Specify the line number for the header line, starting from 1. Lines above the header will be ignored when importing the file.

Date Format

This is the format of the Transaction Date and Posting Date fields in the file.

note_image Note: You should check this by opening the CSV file in a text editor like Notepad as the format may be changed if you display the file in Excel!

odd - day of the month (2 digits)

oddd - day name (3 letters)

oMM - month number (2 digits)

oyyyy - year (4 digits)

 

The following table shows the formats available and how they would be presented in the import file.

note_image Note: For consistency, these examples are all based on the date of Fri 29th Jan 2021.

Format

Example

dd/MM/yyyy

29/01/2021

dd.MM.yyyy

29.01.2021

MM/dd/yyyy

01/29/2021

MM/dd/yyyy ddd

01/29/2021 Fri

MM.dd.yyyy

01.29.2021

yyyy-MM-dd

2021-01-29

 

Field Information

The format of CSV payment card statements varies depending on your bank card issuer. Therefore, you need to use the settings detailed below to tell Zetadocs Expenses where to find the transaction information in the CSV statements that your bank provides.

The way in which you should specify the field/column information below depends on the file formation option selected above.

If CSV with header line is selected the column heading (e.g. Date) should be entered in the settings below.

If CSV without header is selected the column number (e.g. 1) should be entered in the settings below.

 

Required Fields

Setting

Details

Transaction Date Column

Specify where the date the payment was made appears in the CSV file.

Transaction Amount Column

Specify where the amount of the transaction (in the Home Currency – as per the Zetadocs Expenses System Settings) appears.

Vendor Name Column

Specify where the name of the vendor/merchant appears.

 

Optional Fields

In additional to the three required fields above, there may be other information included in the statement CSV file that your bank provides which you would like to make visible to submitters/cardholders in Zetadocs Expenses (in order to make it easier for them to identify their transactions/expenses).

Below are some of the common fields that you may wish to include. If you do want to include any of these, you will need to specify either the name or number of the column that contains the relevant piece of information in the CSV statement file provided to you by your bank.

Setting

Details

Card Number Column

Specify where the card number appears in the CSV file.

This may be the full card number, or a masked (partial) card number. It is matched against the card suffix for the payment method to separate transactions for multiple cards.

Cardholder First Name Column

Specify where the cardholder's first name appears.

This may be the First name or the full name of the cardholder.

Cardholder Last Name Column

Specify where the last name of the cardholder appears.

Transaction Reference Column

Specify where the Transaction reference number of ID appears.

This may help to identify the transaction on the monthly card statement.

Posting Date Column

Specify where the date when the payment was processed by the bank and debited from the card amount appears.

Original Currency Code Column

Specify where the 3 letter code for the original currency of the transaction appears.

This helps the cardholder to match foreign currency payments if available.

Original Currency Amount Column

Specify where the original currency amount of the transaction appears.

 

Vendor Details

If you wish to display any other information about the transaction vendor to cardholders/submitters, then you can do this by specifying the column that contains the relevant piece of information (up to a maximum of 5 additional fields).

Setting

Details

Vendor Details Columns

The vendor details columns give extra information about the vendor - for example, their location or website.

These fields are displayed in the client View Transaction screen to help the cardholder to identify a transaction, and are optional.

Vendor Category Column

The category gives the merchant type, typically as a standard 4 digit Merchant Category Code (MCC) or a short text description.

 

Refunds

The way in which refunds are displayed within CSV payment card statements again varies depending on your bank card issuer. Therefore, you need to use the settings detailed below to tell Zetadocs Expenses how to recognise a refund transaction on the CSV statements that your bank provides.

Setting

Details

Refund Identification

Please select how Zetadocs Expense should recognise a refund transaction:

Negative Amount -  Refund transactions are included with a negative amount  (e.g. –£19.99), in the same column as other payment transactions.

Debit/Credit Column (Recommended) - Refund transactions have positive amounts, like any other payment transactions on the statement, however there is a separate column which shows whether the transaction is a payment or refund.

Credit Amount Column - Refund transactions have positive amounts, and the file includes a separate column which shows whether the transaction is a payment or a refund.

Debit/Credit Column

Specify where the column that indicates whether the transaction is a debit (payment) or credit (refund) appears in the CSV file.

Leave this blank if refund transactions are indicated with a negative amount.

This is a required field.

note_image Note: Only displayed if {Refund Identification} is set to Debit/Credit Column

Debit Match Text

Specify where the text which will be shown for a debit transaction in the column that indicates whether the transaction is a debit (payment) or credit (refund) appears.

This is a required field.

note_image Note: Only displayed if {Refund Identification} is set to Debit/Credit Column

Credit Match Text

Specify where the text which will be shown for a credit transaction in the column that indicates whether the transaction is a debit (payment) or credit (refund) appears.

This is a required field.

note_image Note: Only displayed if {Refund Identification} is set to Debit/Credit Column

Credit Amount Column

Specify where the column that shows the amount of a credit (refund) transaction appears.

This is a required field.

note_image Note: Only displayed if {Refund Identification} is set to Credit Amount Column

 

Balance Payments

(i.e. a credit shown on the statement to settle the balance in part or full)

Setting

Details

Balance Payment Identification

Select what information Zetadocs Expenses should use on the CSV statement to recognise a balance payment (which cardholders will then not see listed as a transaction that needs matching to an expense).

Two options:

Vendor name match - balance payments have a fixed value for the vendor name.

Cardholder name match - balance payments have a fixed value for the cardholder name.

Balance Payment Text

Specify the text (Vendor name or cardholder name), that, if included in a transaction, will mean it is ignored when importing the file because it is a balance payment.