Nepal CBMS e-Billing
IRD Central Billing Monitoring System real-time e-billing for Odoo — CBMS sync, Bikram Sambat fiscal year & QR on every invoice
Connect Odoo to Nepal's Inland Revenue Department CBMS (Central Billing Monitoring System). Sales invoices and credit notes are pushed to IRD in real time, and the returned synchronisation reference, the Bikram Sambat fiscal year and a verification QR code are stored on the move — built for the IRD-approved billing-software regime.
Real-time CBMS push
Each issued bill is pushed to the documented IRD CBMS REST API the moment it is posted; sales returns go to the bill-return endpoint. Sandbox and production endpoints are editable; requests retry with exponential backoff and every call is logged.
Bikram Sambat fiscal year
The Gregorian invoice date is converted to its Bikram Sambat date and the Nepal BS fiscal-year label (Shrawan to Ashad) is derived and recorded on every CBMS bill, using an explicit Panchanga month-length table.
Accurate CBMS document
Lines are bucketed into taxable (13% VAT), exempt and zero-rated (export) supplies, with item codes and sales-return referencing of the original bill — matching the IRD CBMS billing-data fields.
NPR mandatory thresholds
The connector advises whether real-time CBMS linkage is mandatory: NPR 10 crore annual turnover for general businesses, or NPR 5 crore for hospitality (hotels and restaurants).
Real PAN validation
A nine-digit Nepal PAN validator (with an advisory ISO 7064 MOD 11-2 check digit) runs on the company and partners, blocking malformed identifiers before a bill is built.
Business-rule validation
A Nepal rule set layered on the engine's EN 16931-style core checks seller/buyer PANs, line tax categories, NPR currency and the fiscal year before anything is submitted.
Verification QR + bill reference
An IRD verification-URL QR is rendered to a PNG for the printed invoice, alongside an offline JSON QR carrying the seller PAN, invoice number, totals and the CBMS sync reference.
Bring-your-own-key
Your CBMS username and API password live on the connection record, never in the module. They are transmitted only to the IRD CBMS endpoint you configure — nowhere else.
Onboarding, configuration & logging
A guided onboarding wizard validates the PAN, advises the mandatory threshold and writes the connection in one step. A configuration model holds editable endpoints and BYOK credentials, an optional cron drains pending bills, and every CBMS call is captured in the transport log.
Compatible with Odoo 18 and Odoo 19. Built on the shared e-Invoice Core Engine — canonical JSON builder, validation framework and BYOK REST transport.
Disclosure: this module transmits invoice data only to the IRD CBMS endpoint you configure. Your CBMS username and API password are stored solely on your own database and are never sent anywhere else.
Screenshots
Posted Npr Invoice With Cbms
Generated Nepal Cbms E Billi
Update date: 2026-07-02