Connect Amazon.in for automatic ingest

One-tap Login-with-Amazon flow (or paste-token fallback) — Finocket pulls the GST Merchant Tax Report (B2B + B2C) and settlement reports nightly.

Finocket connects to Amazon SP-API and pulls your GST Merchant Tax Report (MTR) — both B2B and B2C — nightly, plus the settlement report roughly every two weeks. Two connect paths: one-tap Login-with-Amazon, or paste tokens you already have.

Path A — One-tap connect (recommended)

Open Profile → Integrations. Tap Amazon.in → Connect.
If Finocket has the LWA partner-app credentials set up (which we handle on the hosted product), you'll see a big "Connect via Amazon" button. Tap it.
You're redirected to Seller Central's consent page. Sign in with your Amazon Seller account and grant Finocket access to your Reports API.
Amazon redirects back to Finocket with an authorization code. Finocket exchanges it for a long-lived refresh token, encrypts it with AES-256-GCM, and stores it. Plaintext credentials never touch the database.
Success toast: "Amazon connected". First MTR sync runs tonight.

Path B — Paste tokens (advanced)

If your company registered its own SP-API app in Seller Central (some sellers prefer this for compliance reasons), pick "Advanced: paste refresh token instead". You need:

LWA client id and LWA client secret — from Developer Central → App details.
LWA refresh token — you can mint this from Seller Central → Manage Your Apps by authorising your own app.
Marketplace id — A21TJRUUN4KGV for India (default).
Ingest from — start date for the first sync. Later nightly syncs pick up from the last successful sync.

What Finocket pulls

GET_GST_MTR_B2B_CUSTOM — every B2B (registered-buyer) sale with buyer GSTIN, HSN, tax break-up. Runs nightly.
GET_GST_MTR_B2C_CUSTOM — every B2C (unregistered-buyer) sale. Runs nightly.
GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2 — the periodic settlement report showing gross, TCS-CGST/SGST/IGST, commission, shipping, net payout. Runs when Amazon generates one (~every 2 weeks).

Both are downloaded, gunzipped (if compressed), parsed, and upserted into your marketplace_orders, marketplace_returns, and marketplace_settlements tables — idempotent on the marketplace's order id / settlement id so re-fetches never duplicate.

Review ingested data

Open Reports → Marketplace orders. Three tabs — Orders, Settlements, Returns. Filter by kind (Amazon.in vs Flipkart vs Meesho, etc.). Summary tiles show total gross, total net payout, total returns for the current filter.

Convert to invoices

On the Orders tab, tick the boxes next to any unconverted orders. Tap "Convert to invoice" in the bulk-action bar. Finocket creates real invoices (with the right CGST/SGST/IGST split based on the buyer state vs your principal state), links them back to the marketplace order via invoice_id, and they flow into your GSTR-1 the same as any other invoice.

GSTR-8 reconciliation

Once you have orders and settlements ingested, run GSTR-8 reconciliation at month-end to diff your own outward supplies against Amazon's settlement view. Catch mismatches before filing.