Remittance Advice Parser: Stop Decoding Payment Slips by Hand
Turn the remittance advices customers email you — PDFs, CSVs, message bodies — into a clean list of which invoices a payment covers, auto-match it to your open AR, flag deductions and short-pays for follow-up, and let AR approve the allocation before any payment is applied.
A logged-in tool where AR uploads a remittance advice, the agent parses the invoice numbers and amounts, matches them to your open AR, flags deductions and short-pays, AR reviews and approves the allocation, and you export a clean cash-application CSV in the columns your accounting system expects.
Before you start
- A Supabase account (free)
- A Vercel account (free)
- A Resend account (free)
- A few sample remittance advices (PDF, CSV, or pasted email text)
- An export of your open invoices / AR aging (CSV is fine)
- Claude Code or any AI coding agent
The problem this kills
A customer pays you $14,820.55 and sends a remittance advice — the slip that says which of your invoices that one lump sum is actually paying. Sometimes it's a tidy CSV. More often it's a PDF attachment, a portal screenshot, or a wall of text pasted into an email body, with invoice numbers formatted three different ways and a couple of unexplained deductions thrown in. Someone in AR has to sit down and decode it: read off each invoice, find it in the open-AR list, tick the amounts, figure out why the total is $112 short, and only then apply the cash.
It's slow, it's mind-numbing, and it's exactly the kind of repetitive matching that quietly eats a day a week. Worse, it's error-prone in expensive ways. Apply a payment to the wrong invoice and a customer gets dunned for something they already paid. Miss a short-pay and a deduction never gets investigated. Re-key the same remittance twice during a busy month-end and the cash is applied double. And because it all happens in someone's head and a scratch spreadsheet, there's no record of why a payment landed where it did.
Cash application is one of the highest-leverage things to automate in AR — and one of the safest, because the matching is mechanical but the approval should always stay human.
What you'll build
A simple internal web app for your AR and cash-application team. You drop in a remittance advice — upload the PDF or CSV, or paste the email text — and the tool parses out every invoice the customer is paying, with the amount against each. It loads your open invoices (from a CSV export or, later, your accounting system) and matches the parsed lines to your open AR: exact matches, fuzzy matches where the invoice number is formatted differently, and the leftovers it can't place.
It does the arithmetic you do by hand today: per invoice, does the amount paid equal what's open? If it's less, that's a short-pay or a deduction — the tool flags it with the gap so it can be sent for follow-up rather than silently written off. AR reviews the proposed allocation on one screen, fixes any mismatches, decides what to do with deductions, and approves. Only on approval does the tool produce the cash-application file — a clean CSV in the exact columns your accounting system expects — and mark the remittance done so the same payment can never be processed twice.
What's inside the Implementation Plan
The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — how remittances arrive today and who works them, what your open-AR export actually looks like, exactly how your invoice numbers are formatted (prefixes, leading zeros, PO references customers use instead), your typical and peak volumes, the deduction and short-pay rules you follow, and the messy exceptions that have bitten you. It reflects a short tailored spec back to you and waits for your thumbs-up before it builds anything, so the parser matches your invoice formats and your deduction rules — not a generic template.
From there it walks the agent through the data model, the remittance intake (PDF / CSV / pasted email), the parsing step, the open-AR import, the matching engine with fuzzy invoice-number handling, the short-pay and deduction flagging, the AR approval gate, and the clean cash-application export. Every step ends with a ready-to-copy prompt. There's a full "No API yet?" path that uses Google Sheet / CSV imports for both the remittances and the open-AR list and produces a clean cash-application CSV — so you can build and run the whole thing this weekend no matter what accounting system you're on.
The governance it includes (this is the point)
Cash application touches the system of record, so the controls aren't optional. The plan builds in login so only your AR team can use it, row-level security so you only ever see your own organization's invoices and payments, a complete audit trail of who parsed which remittance, who changed which match, and who approved which allocation, a hard human-approval gate so no payment is applied until AR signs off on the invoice allocation, and duplicate guards keyed on the payment / remittance ID so the same remittance can't be processed twice.
Who it's for
AR clerks, cash-application specialists, and AR managers — anyone who spends real hours each week decoding remittance advices and ticking invoices by hand, and who wants the matching done in seconds while keeping a person firmly in control of where the cash lands. If you can show how one of your customers' remittances looks and how your invoice numbers are formatted, you can build this.
You've got this — start with the plan, paste the first prompt, and answer the interview. You'll be parsing your first real remittance before the weekend's out.