The eBMS Settings doctype is the central configuration hub that connects your ERPNext system to Burundi's electronic tax system (eBMS) managed by the OBR (Office Burundais des Recettes)
To access eBMS Settings, go to:
eBMS > Home > eBMS Settings
1. Details Tab
This section manages the basic connection settings used to communicate with the OBR servers.
- Authentication: Fields for the
UsernameandPasswordprovided by the OBR upon account registration. - Environment: A Sandbox checkbox allows you to test the connection in a non-production environment before going live.
- Company: Allows you to select which company in your ERPNext system these settings apply to (useful if you manage multiple companies)
- Start Date: Specifies the date from which transactions should be sent to OBR.
- TIN: Auto-filled from the company's Tax ID.
- Is Active: Enables or disables the setting.
2. Tax Details Tab
This tab stores your company's official legal and tax identification details. The system requires this information to be included on every electronic invoice sent to the OBR.
Taxpayer's Sector of Activity: - Specifies the Sector of Activity.
Taxpayer's Legal Form: -
The taxpayer's commercial register number:- This is the company's trade number.
Subject to VAT: - Specifies whether the taxpayer is subject to VAT or not.
System Identification:- Taxpayer's system number(computer serial no.)
Type of Taxpayer: - Can be individual or company.
Subject to Consumption Tax: - Defines whether taxpayer is subject to consumption tax or not.
Subject to FlatRate Withholding Tax: - Defines whether taxpayer can Withhold tax.
3. More Info Tab
This section controls how the system behaves automatically, allowing you to manage communication retries and data synchronization schedules.
3.1 Retry Rules:
Maximum Attempts: How many times to try resending if the OBR server is down.
Retry Delay: The waiting time (in seconds) between each retry attempt.
3.2 Posting Schedule
Allows you to configure time slots for sending transactions (both invoices and stock movements) to OBR.
- Limit timeslot for Invoice Posting: Enables or disables time restrictions for invoice posting.
- Start Time & End Time: Defines the period during which invoice posting is allowed.
- Limits Don't Apply On: Specifies the days of the week when the time restrictions should be ignored.
Note: The same functionality is available for stock transactions using separate fields.
3.3 Data Sync Frequency:
Invoice Event Frequency: How often the system automatically sends invoices (e.g., daily, hourly).
Stock Movement Event Frequency: How often stock updates are sent to the OBR.
3.4 Feature Toggles:
Allow OBR to track sales: Master switch to enable/disable sending invoices.
Allow OBR to track stock movement: Master switch to enable/disable sending stock data.
Advanced Scheduling: Option to use Cron format to set a specific time each day for sending invoices.