ZIMRA Fiscal Compliance Module for Odoo
This module provides complete integration with Zimbabwe's Fiscalisation Data Management System (FDMS) and ensures compliance with ZIMRA fiscal requirements.
Core Functionality
- **Electronic Fiscal Device (EFD) Integration**: Connect and manage fiscal devices
- **FDMS Communication**: Real-time synchronization with ZIMRA's FDMS system
- **Fiscal Receipts**: Automatic generation of ZIMRA-compliant receipts
- **VAT Compliance**: Proper tax calculations and reporting
- **Tax Returns**: Automated VAT return generation and submission
Key Components
1. **Fiscal Device Management**: Configure and monitor fiscal devices
2. **Receipt Processing**: Handle fiscal receipts for all sales transactions
3. **Tax Reporting**: Generate and submit tax returns to ZIMRA
4. **Compliance Monitoring**: Track fiscal compliance status
5. **Webhook Integration**: Receive real-time updates from FDMS
Features:
Tax Configuration
The module automatically creates ZIMRA-compliant taxes:
- VAT 15% (Standard)
- VAT 0% (Zero Rated)
- VAT Exempt
- Purchase VAT 15%
Product Classification
For each product, configure:
- ZIMRA Product Code
- Tax Category (Standard/Zero/Exempt)
- Controlled Product status
- Excise tax if applicable
Automatic Fiscal Processing
1. **Invoice Posting**: Fiscal receipts are automatically created when customer invoices are posted
2. **FDMS Submission**: Receipts are automatically sent to FDMS if auto-sync is enabled
3. **Status Updates**: Real-time status updates via webhooksv
Manual Operations
1. **Sync Devices**: Use "Sync with FDMS" wizard for manual synchronization
2. **Generate Reports**: Create VAT returns and other tax reports
3. **Submit Returns**: Submit tax returns directly to ZIMRA
Usage:
Monitoring
Chief Executive Officer
- **Device Logs**: Monitor all fiscal device operations
- **Receipt Status**: Track fiscal receipt processing
- **Compliance Dashboard**: Overview of fiscal compliance status
API Integration
FDMS Endpoints
The module integrates with these FDMS endpoints:
- `/device/register` - Device registration
- `/device/{id}/status` - Device status check
- `/receipt/submit` - Receipt submission
- Webhook notifications for real-time updates
VAT Compliance
Automatic VAT calculation per ZIMRA rates
- Zero-rated and exempt transaction handling
- Input/Output VAT tracking
- VAT return generation
Fiscal Receipts
ZIMRA-compliant receipt format
- Digital signatures and QR codes
- Receipt verification system
- Audit trail maintenance
1. **Device Registration Failed**
- Check FDMS URL and API key
- Verify network connectivity
- Ensure device ID is unique
2. **Receipt Submission Error**
- Check device status (must be active)
- Verify fiscal data completeness
- Check FDMS connectivity
3. **Tax Calculation Issues**
- Verify product tax categories
- Check tax configuration
- Ensure VAT rates are correct