Free agents + LAUNCH30: 30% off paid agents until 31 Dec 2026 (one-time purchases only) See free agents
Oarsman AI Sign in

Marketplace Settlement Reconciler / Docs

Marketplace Settlement Reconciler: setup guide

One orders report and one settlement report become a per-order status: paid, unpaid and overdue, charged after cancellation, paid nothing, high deductions, duplicate lines and unknown orders, with deductions totalled by type.

Who it is for: Seller or accountant for an Indian brand selling on Meesho, Flipkart, Amazon.in or Myntra, who checks every month whether each order was paid and what was deducted.

Format: Claude skill pack · Version: 1.0.1 · Tested on: Python 3.13.5 (standard library only)

What it does

It finds the header row in both reports and reads common column names from Meesho, Flipkart, Amazon.in and Myntra downloads (sub order no, order id, amazon-order-id; settlement amount, final settlement amount, amount). Settlement lines are summed per order. Fee columns (commission, shipping, fixed fee, return charges, TCS, TDS, penalty) are totalled, and one-row-per-amount reports are classified by their description. Each order then gets a status from its order status and its net settlement: paid, not paid after your overdue days, charged on a cancelled order, paid nothing on a delivered order, deductions above your threshold, or sale money still sitting on a returned order. Repeated settlement lines and settlements for orders not in your report are listed.

What you need

  • Claude.ai with code execution switched on (or Claude Code, or just Python 3.10+)
  • Your orders report and payments/settlement report downloaded from the seller panel as CSV or Excel

5-minute setup

  1. Claude.ai: open Settings → Capabilities → Skills, click Upload skill and pick claude-ai-upload/marketplace-settlement-reconciler.zip.
  2. Claude Code: copy the folder skills/marketplace-settlement-reconciler into ~/.claude/skills/.
  3. Start a new chat. Attach your file and say: "Use marketplace-settlement-reconciler. Check this Meesho orders report against the payments report and tell me what was not paid".
  4. Claude runs the script and gives you the files listed under Outputs. Check them before you act on them.

Try it with the sample

Run the sample (fictional Meesho-style October 2026 reports):

python3 skills/marketplace-settlement-reconciler/scripts/core.py --orders samples/meesho-orders-oct-2026.csv --settlement samples/meesho-payments-oct-2026.csv --out out

You should see 14 orders: 8 ok, 1 charged on a cancelled order, 1 paid nothing, 1 overdue, 1 high deductions, 1 duplicate settlement line and 1 unknown order, with ₹544.00 to claim. In Claude, attach both reports and use the prompt above.

Settings you can change

Option Default What it is
--orders (required) Orders report CSV/XLSX downloaded from your seller panel (up to 300 orders)
--settlement (required) Settlement / payments report CSV/XLSX for the same period
--as-of (latest date in files) Date used to judge overdue payments, YYYY-MM-DD
--pending-days 15 Days after the order date before a missing payment counts as overdue (1-90)
--max-deduction 0.40 Share of order value deducted above which an order is flagged (0.05-0.95)
--out out Output folder

What goes in and what comes out

Inputs: Orders report CSV/XLSX (up to 300 orders); Settlement / payments report CSV/XLSX for the same period; Optional: as-of date, overdue days, deduction threshold

Outputs: report.md with the results, unpaid and claim totals, deductions by type and a to-do list; recon.csv with one row per order

What Pro adds

  • Any number of orders, several settlement files and several marketplaces in one run
  • Commission and shipping checked against your rate card
  • Each payout found in your bank statement by UTR or amount
  • Profit per SKU from your unit costs

Pro: https://oarsmanai.com/agents/marketplace-settlement-reconciler-pro/

AI disclosure and limits

This product does not call an AI model at run time. It was built by Oarsman AI's AI agents and checked by the automated tests shipped with it.

Limits: - One marketplace and one settlement file per run, up to 300 orders. - Reads CSV/XLSX downloads, not PDF invoices or payment advice. - Does not know each marketplace's fee rules; it flags high deductions against your threshold. - Does not raise tickets or claims; you raise them in your seller panel. - Reconciliation help, not accounting or tax advice.

Not tested by us: - real downloads from each marketplace (the samples follow common column names) - XLSX reports in the shipped tests (CSV only) - Myntra and Flipkart layouts specifically

Files

  • oarsman-marketplace-settlement-reconciler-v1.0.1.zip
  • CHANGELOG.md
  • QA-REPORT.json
  • README.md
  • SPEC.md
  • SUPPORT.md
  • TROUBLESHOOTING.md
  • VERSION
  • VIDEO-SCRIPT.md
  • claude-ai-upload
  • diagram.mmd
  • diagram.png
  • preview.png
  • samples
  • skills
  • tests

Help

Self-serve: see TROUBLESHOOTING.md (fixes and FAQ). There is no call, chat or email support. Fixes ship as new versions at your download link. Refund: 14 days, works as described, through the checkout platform.