Skip to main content
Key: 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 KeyUNTDID 5305 CodeDescription
standardSStandard rate
zeroZZero rated goods
exemptEExempt from tax
reverse-chargeAEVAT Reverse Charge
intra-communityKIntra-community supply
exportGExport outside the EU
outside-scopeONot 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).

Note Key Mappings

The following table shows how GOBL note keys are mapped to UNTDID 4451 text subject qualifier codes. The mapped code is set in the untdid-text-subject extension field.
GOBL Note KeyUNTDID 4451 CodeDescription
goodsAAAGoods description
paymentPMTTerms of payment
payment-methodPMDPayment method or remittance information
payment-termAABPayment term details
generalAAIGeneral information
legalABYLegal or regulatory information
dangerous-goodsAACDangerous goods additional information
ackAAEAcknowledgement description
rateAAFRate additional information
reasonACDExplanation of something relevant to the document
disputeACEDetails on a dispute
customerCURCustomer remarks
glossaryACZGlossary of terms
customsCUSCustoms declaration information
handlingHANHandling instructions
packagingPKGPackaging information
loadingLOILoading instructions
priceAAKPrice conditions
priorityPRIPriority information
regulatoryREGRegulatory information
safetySAFSafety instructions
ship-lineSLRShip line
supplierSURSupplier remarks
transportTRATransportation information
deliveryDELDelivery information
quarantineQINQuarantine information
taxTXDTax declaration
otherZZZMutually defined

Identity Scheme Mappings

The following tables show how GOBL identity keys and types are mapped to ISO/IEC 6523 scheme codes, set in the iso-scheme-id extension field.

Identity Keys

GOBL Identity KeyISO/IEC 6523 CodeDescription
gln0088GS1 Global Location Number
gtin0160GS1 Global Trade Item Number

Identity Types (regime-specific)

GOBL Identity TypeISO/IEC 6523 CodeDescription
SIREN0002French SIREN (legal entity identifier)
SIRET0009French SIRET (establishment identifier)
CVR0184Danish CVR-nummer