Skip to main content

10. Finance, Billing & Compliance

Purpose — India-compliant invoicing and the money layer: GST/e-invoicing, dealer ledgers, payments (Hyperswitch + gateways), subsidy tracking, commissions/payouts, and reconciliation. Financial truth lives in Postgres.

Personas served​

Finance admin, Dealer (own ledger), Manager (scoped), Super admin.

Key capabilities​

  • GST-compliant invoicing — tax invoice, e-invoice (IRN/QR), e-way bill for goods movement.
  • Multi-entity / branch accounting — dealer ledgers, credit notes, debit notes.
  • Payments — Hyperswitch orchestration → Razorpay / CCAvenue / Cashfree; EMI, COD, partial payments (advance + balance for installs). See Payments.
  • Subsidy tracking — solar DISCOM / PM Surya Ghar disbursement workflow (when subsidyWorkflow on).
  • Commission / payout engine — dealers, installers, affiliates.
  • Reconciliation — courier COD, marketplace settlements, gateway settlements.

Data owned​

Postgres (Finance): invoices, ledgers, credit/debit notes, payouts, reconciliation, GST/e-invoice records, subsidy claims. Payment sessions in Medusa; orchestration in Hyperswitch.

Events​

  • Emits: invoice.issued, payout.created, subsidy.updated, reconciliation.completed.
  • Consumes: payment.captured, order.placed, secondary_sale.recorded, claim.approved (cost recovery), affiliate.conversion, visit.completed (paid service billing).

APIs​

  • POST /finance/invoices, GET /finance/invoices/:id/einvoice, POST /finance/ewaybill
  • GET /finance/ledgers/:partnerId (scoped), POST /finance/payouts
  • GET /finance/subsidy/:assetId, POST /finance/reconcile

Tenant-config knobs​

GSTIN, legal entity, e-invoice creds, subsidyWorkflow flag, commission rules, EMI/COD policy, invoice template/branding.

Dependencies​

Orders, DMS, FSM, Payments, CRM/Loyalty.

Open questions​

  • e-invoice/e-way provider (GSP) choice; phase (v2 per roadmap).
  • Depth of accounting in-platform vs Tally/ERP integration.