| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) • Invoicing (account) |
| Lines of code | 1430 |
| Technical Name |
fiscalisation |
| License | OPL-1 |
| Website | https://live.telco.co.zw |
ZIMRA Fiscalisation
Complete Fiscal Device Integration for ZIMRA Compliance
Overview
The ZIMRA Fiscalisation module provides a comprehensive solution for businesses in Zimbabwe to comply with the Zimbabwe Revenue Authority (ZIMRA) fiscal requirements. This module integrates your Odoo accounting system with approved fiscal devices, ensuring all transactions are properly reported to tax authorities.
Key Features
Automated Token Management
Automatic handling of authentication tokens with the fiscal server, including scheduled refreshing to maintain continuous connectivity.
Fiscal Day Management
Open and close fiscal days with proper tracking of fiscal day numbers, receipts, and status.
Invoice Fiscalisation
Seamless fiscalisation of customer invoices with proper tax calculations, buyer data submission, and HS code handling.
QR Code Generation
Automatic generation of QR codes for fiscalised invoices, providing easy verification of fiscal compliance.
Comprehensive Error Handling
Detailed error tracking and notification system to quickly identify and resolve integration issues.
Credit Note Support
Full support for credit notes and refund processes with proper fiscal reporting.
Technical Requirements
| Requirement | Details |
|---|---|
| Odoo Version | 16.0 - 18.0 |
| Python Dependencies | requests, qrcode |
| Internet Connectivity | Reliable internet connection for API communication |
Configuration Guide
Step 1: Fiscal Device Setup
- Navigate to Accounting → Configuration → Fiscal Devices
- Click Create to add a new fiscal device
- Enter the device name, device ID, and serial number
- Input the activation key provided by your fiscal service provider
- Verify the API base URL (usually
https://fiscal-demo.telco.co.zwfor testing or productionhttps://fiscal.telco.co.zwfor live environment) - Save the configuration
Step 2: Configure Products
- Ensure all products have the correct HS Code set
- Verify that appropriate taxes are configured for each product
- Make sure all product prices are correctly configured with tax inclusion settings
Step 3: Configure Customer Information
- Ensure all customers have complete information including:
- VAT Number (if applicable)
- TIN Number (if applicable)
- Complete address information
- Contact details (phone, email)
Daily Operations
Fiscalising Invoices
To fiscalise an invoice:
- Create and validate an invoice as usual in Odoo
- Open the validated invoice
- Click the Fiscalise button
- The system will communicate with the fiscal device and update the invoice with fiscal information
- A QR code will be generated and displayed on the printed invoice
Closing a Fiscal Day
At the end of business day:
- Navigate to Fiscalisation → Fiscal Devices
- Select your fiscal device
- Click the Close Day button
Troubleshooting
Common Issues
| Issue | Possible Solution |
|---|---|
| Token Refresh Failure | Check internet connection and device activation details. Use the manual token refresh button. |
| Device Not Found | Verify the device serial and activation key. Ensure the device is registered with ZIMRA. |
| Missing HS Code Error | Update product configuration with the correct HS Code. |
| Mixed Tax Inclusion Types | Ensure all invoice lines have consistent tax inclusion settings. |
| Duplicate Invoice Number | If you see error RCPT013, the invoice was likely already fiscalised. |
Support
For technical support or assistance with this module, please contact:
- Email: customer-care@teamtelco.co.zw
- Website: https://live.telco.co.zw
When reporting issues, please include:
- Odoo version
- Module version
- Detailed error messages or screenshots
- Steps to reproduce the issue
© 2025 TELCO. All rights reserved.
This module is published under the OPL-1 license.
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