Skip to main content
To start the reconciliation process, you usually need a left file and a right file that share some identifier: an invoice number, a payment ID, a reference string.

1. Infer a config

This writes a reconify.yaml mapping both files’ date, amount, and reference columns:
config infer only writes this file when it is confident in the date, amount, and reference mappings. If it isn’t, it exits with code 2 and writes nothing. See Create a config for the hand-written and wizard paths, and Run it with an agent for what “confident” means.

2. Check the mapping

Before you reconcile anything, look at three things in the output: the date hasn’t shifted by a day, the amount is in minor units (150000, not 1500.00), and the reference column is populated.

3. Reconcile

For a large file, stream NDJSON instead of buffering JSON. See Handle large files.

4. Read the summary

Open results.json and start with summary:
Every monetary field Reconify emits is in minor units: 150000 is 1,500.00. A healthy run looks like high matched, low everything else. Read Read the results for what to check first when it doesn’t.