Home Reconciliation How do I create a new reconciliation?

How do I create a new reconciliation?

Last updated on Aug 27, 2026

Short Answer: Open the New reconciliation page, upload the source and ledger files in the left/right 'Upload file' cards, confirm column mapping in the Import modal, then use the page’s primary action to save the reconciliation.

PreRequisites

  1. Signed in to the app and on the New reconciliation page

  2. You have the source bank statement and ledger files available for upload

Steps

  1. Open the New reconciliation page.
    Header 'New reconciliation' is visible and the page shows two upload areas left and right.

  2. Upload the source/bank file: click the left 'Upload file' card the blank upload area with an upload icon.
    Your file chooser opens or the Import modal appears to begin processing the file.

  3. Upload the ledger file: click the right 'Upload file' card and select the ledger file.
    The Import modal shows a preview of the uploaded ledger file.

  4. In the Import modal, review the sample rows and map each column to the correct system field using the controls on the right, then confirm/save the mapping.
    Mapping is saved and the modal closes; uploaded file appears attached to its card.

  5. Click the page’s primary action the prominent button in the top-right header to save/create the reconciliation.
    Reconciliation is saved and you get a confirmation or are taken to the reconciliation list/detail.

Troubleshooting

  1. Clicking an 'Upload file' card does nothing.
    LikelyCause: Browser popup/file picker blocked or a temporary JS error.
    Action: Refresh the page, try a different browser, or disable extensions that block pop-ups. Then retry the upload.

  2. Primary action top-right is disabled or not saving.
    LikelyCause: Required files not uploaded or column mapping incomplete.
    Action: Ensure both source and ledger files are uploaded and the Import modal mapping is completed for required fields; then try saving again.

  3. Import/modal shows an error or 'Upload failed'.
    LikelyCause: File format or content issue unsupported format, corrupted file, or missing headers.
    Action: Open the file in Excel/text editor, ensure it has headers and proper data, re-save CSV/XLSX, then re-upload. If problem persists, export again from the source system.

Note: After mapping, the Import modal displays a preview of sample rows on the left and mapping controls on the right. If you only see one upload card filled, the primary save action may remain disabled until both sides are completed.