How do I map Date, Amount and Reference columns when configuring an uploaded file?
Short Answer: Open the file's 'Configure file' modal, use the Data preview to pick the Date column, choose how amounts
are represented single signed column or separate Credit/Debit, and select Reference / Identifier columns.
PreRequisites
1. File uploaded to Books or Credit card statement panel.
2. Know which columns in your file contain Date, Credit, Debit, and any reference/identifier values.
Steps
1. From the upload page click the pencil edit icon on the file card to open 'Configure file - Books' or 'Configure file
- Credit card statement'.
The 'Configure file' modal opens e.g., 'Configure file - Credit card statement' or 'Configure file - Books'.
2. Use the Data preview on the left to identify column headers and sample rows examples: 'Trans Date', 'Description',
'Reference' or 'Date', 'Num', 'Memo/Description'.
You can see the actual column names to map.
3. Under 'Date (optional)' select the column that contains transaction date e.g., 'Trans Date' or 'Date'.
The Date field is mapped.
4. Under 'Amount' choose if amounts are a 'Single signed amount column' or 'Separate credit and debit columns' then map
'Credit amount' and 'Debit amount' accordingly e.g., 'Credit (USD)', 'Debit (USD)'.
Amounts are interpreted according to the mapping; helper text clarifies the net calculation.
5. Under 'Reference / Identifier' select one or more columns to use for matching. Selected columns appear as tags e.g.,
'Reference', 'Description', 'Num'.
Reference / Identifier tags are set for matching.
6. Close the modal by clicking 'X' to apply mapping and return to the reconciliation page, then re-run reconciliation.
Mapping is applied for the next run.
Troubleshooting
1. Transactions still show wrong totals or the Difference is non-zero after running.
LikelyCause: Incorrect amount representation or swapped Credit/Debit mappings.
Action: Open 'Configure file' and ensure you selected the correct option under 'How is the amount represented in
this file?' and that 'Credit amount' and 'Debit amount' are mapped to the correct columns.
2. Matches are not happening using the expected identifier.
LikelyCause: The Reference / Identifier column is not selected or is inconsistent between the two files.
Action: Edit both files' Configure file settings and select matching identifier columns. Add multiple identifiers if
needed so both sides contain the same identifier values.
Note: Helper text in each Configure file modal shows the net calculation used example: 'Net amount = Credit - Debit' on
the Credit card statement modal and 'Net amount = Debit - Credit' on the Books modal.