| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2941 |
| Technical Name |
l10n_np_cbms_ebilling |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2941 |
| Technical Name |
l10n_np_cbms_ebilling |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module