Buyer data (cbCustomer) in eInvoicing
This page maps the fields of cbCustomer to the buyer fields of the European eInvoicing standard EN 16931. The national eInvoicing formats are profiles of EN 16931 and use the same business terms (BT). For how invoices and invoice types are handled, see Invoices and invoice types.
EN 16931-1 is published by CEN and is not freely available. The links in the following table point to the Peppol BIS Billing 3.0 syntax reference, which documents every EN 16931 business term with its UBL element.
Field mapping
cbCustomer field | EN 16931 business term | UBL element |
|---|---|---|
CustomerName | BT-44 Buyer name | cac:PartyLegalEntity/cbc:RegistrationName |
CustomerId | BT-46 Buyer identifier | cac:PartyIdentification/cbc:ID |
CustomerStreet | BT-50 Buyer address line 1 | cac:PostalAddress/cbc:StreetName |
CustomerZip | BT-53 Buyer post code | cac:PostalAddress/cbc:PostalZone |
CustomerCity | BT-52 Buyer city | cac:PostalAddress/cbc:CityName |
CustomerCountrySubentity | BT-54 Buyer country subdivision | cac:PostalAddress/cbc:CountrySubentity |
CustomerCountry | BT-55 Buyer country code | cac:PostalAddress/cac:Country/cbc:IdentificationCode |
CustomerVATId | BT-48 Buyer VAT identifier | cac:PartyTaxScheme/cbc:CompanyID |
CustomerEndpointId | BT-49 Buyer electronic address and BT-49-1 scheme identifier | cbc:EndpointID and its schemeID attribute |
CustomerReference | BT-10 Buyer reference | cbc:BuyerReference |
CustomerTaxId | – | – |
Table 1. Mapping of cbCustomer fields to EN 16931 business terms. UBL elements of the buyer party are relative to cac:AccountingCustomerParty/cac:Party.
Mapping rules
Which fields are required, and what they contain, depends on the country and its format. See the eInvoicing setup page of the respective country.
CustomerEndpointIdis split at the first colon: the part before it is written to BT-49-1 (theschemeIDattribute), the part after it to BT-49.CustomerReferenceis written to BT-10.CustomerTaxIdhas no EN 16931 business term, because EN 16931 has no tax number of the buyer other than the VAT identifier. National formats can read it; see the eInvoicing pages of the respective country.