Ghana Inbound E-VAT
Parse GRA-certified E-VAT supplier invoices into vendor bills, with full fiscal-reference validation
Turn certified supplier invoices into clean vendor bills
Ghana's Ghana Revenue Authority (GRA) requires VAT-registered businesses to issue invoices through the certified E-VAT system. Each cleared invoice carries a Sales Data Controller (SDC) / E-VAT Data Controller (EDC) fiscal reference and is exchanged in XML or JSON. This module sits on the inbound side: it reads a certified supplier invoice your vendor already cleared with the GRA, verifies its fiscal reference and tax breakdown, and creates a matching vendor bill in Odoo.
No transmission. This module never contacts the GRA and never holds a GRA signing key. It parses and validates a file you already received, using only published GRA rates and the documented fiscal-reference structure.
Parse JSON & XML
Reads both certified formats the GRA mandates. Tolerates the field-name variants real vendor software emits (camelCase, snake_case, GRA labels) and normalises everything into one canonical document.
Fiscal-reference validation
Validates the full EDC block: EDC Time, EDC / SDC ID, Invoice Number, Machine / Device Number, Internal Data and Receipt Signature, including the Base32 signature grouping the certified device emits.
Tax reconciliation
Recomputes VAT (15%), NHIL (2.5%), GETFund (2.5%) and the COVID-19 Health Recovery Levy (1%, pre-2026) from the stated taxable value and supply date, and blocks any certified invoice whose declared breakdown does not match the GRA rates — catching tampered or mis-coded documents.
TIN & Ghana Card check
Structurally validates the supplier identifier — legacy GRA TIN (letter + 10 digits) or Ghana Card PIN (GHA-#########-#) — and matches or creates the vendor automatically.
The 2026 VAT reform, handled correctly
Ghana changed the VAT computation method on 1 January 2026. Before that date the levies cascaded into the VAT base (GHS 1,000 → GHS 1,219). From 2026 the 1% COVID-19 levy is abolished and VAT, NHIL and GETFund are each charged directly on the exclusive value (GHS 1,000 → GHS 1,200). The module picks the correct regime automatically from each invoice's supply date, so historical and current certified invoices both reconcile.
| Component | Cascading (up to 31 Dec 2025) | Flat (from 1 Jan 2026) |
|---|---|---|
| VAT | 15% of value × 1.06 | 15% of value |
| NHIL | 2.5% of value | 2.5% of value |
| GETFund Levy | 2.5% of value | 2.5% of value |
| COVID-19 HR Levy | 1% of value | Abolished |
| Total on GHS 1,000 | GHS 1,219.00 | GHS 1,200.00 |
What you get
| Inbound document workspace | A dedicated queue of imported certified invoices with status (draft, parsed, validated, billed, error) and a chatter audit trail. |
| One-step import wizard | Upload or paste a certified file, preview the reconciliation, then parse, validate and create the vendor bill in a single action. |
| Line extraction | Parses each invoice line (description, quantity, unit price, value) and flags standard-rated vs exempt / zero-rated supplies. |
| GRA verification link | Builds the GRA E-VAT verification URL for the certified reference so you can confirm the supplier invoice on the GRA back office. |
| Vendor bill linkage | Every generated bill carries the fiscal code, EDC / SDC ID and verification link, and links back to its source document. |
| Duplicate protection | The same certified fiscal code cannot be imported twice per company. |
How it works
- Receive a GRA-certified E-VAT invoice (JSON or XML) from your supplier.
- Upload or paste it into the import wizard, or create an inbound document.
- The module parses the header, lines and fiscal reference.
- It recomputes the VAT and levies and reconciles them against the declared amounts.
- On success, it creates a draft vendor bill linked to the certified source.
Disclosure: this module performs no network calls and stores no GRA credentials. It reads a certified file the supplier already cleared, validates it, and turns it into a vendor bill inside your own database.
Compatibility
Odoo 18.0 and 19.0 — Community and Enterprise. Builds on the standard Accounting (account) module only; no Enterprise-only dependency.
Screenshots
Inbound E Vat Documents
Import Certified Invoice
Update date: 2026-07-02