| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 1514 |
| Technical Name |
l10n_gh_evat_inbound |
| 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) |
| Lines of code | 1514 |
| Technical Name |
l10n_gh_evat_inbound |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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
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