eu-en16931-v2017
Support for the European Norm (EN) 16931-1:2017 standard for electronic invoicing.
This addon ensures the basic rules and mappings are applied to the GOBL document
ensure that it is compliant and easily convertible to other formats.
We strongly recommend checking the output and specifically the extension codes
used to ensure that any assumptions do not need be adjusted.
Tax Code Extension Mappings
The following tables show how GOBL tax keys/categories are mapped to UNTDID 5305 tax category codes:VAT
| GOBL Tax Key | UNTDID 5305 Code | Description |
|---|---|---|
| standard | S | Standard rate |
| zero | Z | Zero rated goods |
| exempt | E | Exempt from tax |
| reverse-charge | AE | VAT Reverse Charge |
| intra-community | K | Intra-community supply |
| export | G | Export outside the EU |
| outside-scope | O | Not subject to VAT |
Other
For Spanish special territories, IGIC (Canary Islands) maps to code L and IPSI (Ceuta and Melilla) maps to code M. Any other tax category defaults to UNTDID 5305 code O (Outside Scope).Exemption Notes
Exempt tax categories (E, AE, K, G, O) require either a CEF VATEX code (cef-vatex) on the tax combo, or an exemption note in tax.notes.
Exemption notes use the tax.Note struct with cat, key, and text fields.
During normalization, the note’s key is mapped to the corresponding
untdid-tax-category extension (e.g. exempt → E,
reverse-charge → AE).
Each exempt tax category without a VATEX code must have at least one
exemption note covering it.