Introduction
OneFinOps is the operating system for finance operations — one unified platform that replaces the fragmented stack of tools finance teams stitch together today. AR, AP, accounting, catalog, expenses, procurement, and compliance live as peer modules on the same data plane, with one identity, one ledger, and one audit trail.
The OneFinOps API exposes that platform programmatically. This first release surfaces the India GST compliance module — register invoices on NIC IRP, issue and manage E-Way Bills, and onboard the NIC-portal credentials those flows depend on, all from your own systems. More modules will land on the same /v1/* surface, with the same auth and the same response envelope.
What this release covers
| Capability | API surface |
|---|---|
| E-Invoice (IRN) — generate, fetch, cancel, decode signed JWS, render QR | /v1/einvoices/* |
| E-Way Bill — generate, fetch, update Part-B, update transporter, extend validity, cancel, reject, list (assigned / received / generated / rejected) | /v1/ewaybills/* |
| GSP credentials — onboard IRP and EWB portal credentials per GSTIN | /v1/gsp-credentials/* |
On the roadmap: GSTR returns and 2A/2B reconciliation; AR / AP / catalog / expense endpoints as those modules open up for API access.
Design principles
- NIC-aligned naming. GST field names mirror NIC's published schemas wherever possible — anyone familiar with the IRP or EWB portal will find equivalents here by name.
- Stable contracts. OneFinOps absorbs NIC schema churn behind a versioned interface so your code doesn't have to follow every IRP / EWB-portal change.
- Per-GSTIN credentials. NIC binds credentials to a GSTIN. You seed each GSTIN's IRP / EWB-portal credential once through the Developer hub and pass the
gstinheader on every call; OneFinOps signs to NIC on your behalf.
Environments
| Environment | API host | Auth host | Client prefix |
|---|---|---|---|
| Production | https://api.in.onefinops.com | https://login.onefinops.com | ofin_live_* |
| Sandbox | https://sandbox-api.in.onefinops.com | https://login.onefinops.com | ofin_test_* |
Production and sandbox share the same login (Keycloak realm). The host you call decides which environment runs the request. See Sandbox vs production for what differs between NIC's sandbox and live portals.
Where to next
- Quickstart — mint a token, generate an IRN, fetch it back.
- Authentication — OAuth client credentials, token TTL, scopes.
- Generate an IRN — production-grade e-invoice flow.
- Generate an EWB — issue an E-Way Bill (standalone or linked to an IRN).