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
subsidyWorkflowon). - 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/ewaybillGET /finance/ledgers/:partnerId(scoped),POST /finance/payoutsGET /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.