This profile constitutes an extension of EN16931 (Comfort) aimed at supporting complex business processes (i.e. invoices which are being invoiced across multiple deliveries or delivery locations, structured terms of payment, further details at item level to facilitate warehousing etc.), and any business case inventoried in France (gathered in a subset named EXTENDED B2B FR and its subset EXTENDED-CTC-FR, as referenced by the French Tax Administration and National Platform PPF – Portail Public de Facturation). This includes additional code lists values which are not part of the European Norm EN 16931 code lists.
import { EXTENDED, type ProfileExtended } from "node-zugferd/profile/extended";Basic Usage
Setup the Profile
First configure the zugferd instance (invoicer) to use the Extended profile.
This defines the standard and complexity level of the invoice.
import { EXTENDED } from "node-zugferd/profile/extended";
export const invoicer = zugferd({
profile: EXTENDED,
});Define Invoice Data
Now define the actual invoice content, including all required fields of the
profile, using the ProfileExtended type for type safety.
import { ProfileExtended } from "node-zugferd/profile/extended";
const data: ProfileExtended = {
number: "INV-001",
// ...
};Create Invoice
Use the previously created instance (invoicer) to generate the invoice from your data. You can either:
- Generate standalone XML
- Embed the XML inside a PDF/A-3b compliant file.
import fs from "fs";
import { invoicer } from "./invoicer";
const invoice = invoicer.create(data);
// Only generate xml
const xml = await invoice.toXML();
// Or embed xml in a PDF-A/3b
const pdf = fs.readFileSync("./your/invoice.pdf");
const pdfA = await invoicer.embedInPdf(pdf); 🎉 That's it
Your invoice is now ready! You've successfully created a ZUGFeRD invoice using the Extended profile.
Schema
Extends EN16931 (COMFORT)
stringbooleanTest Indicator
The Indicator type may be used when implementing a new system in order to mark the invoice as „test invoice“.
To be used only in case of a test invoice, with Indicator = true
stringDocument name
Text is the actual wording of anything written or printed. This EN 16931_ Text. Type is based on the Text. Type as defined in ISO 15000-5:2014, Annex B. Line breaks in the text may be present.
booleanCopy Indicator
Indicates if the invoice document is a copy of another invoice document.
With indicator = true, the document is a copy.
stringInvoice language code
Indicates the language used in the invoice document.
Valid languages are registered with the ISO 639-2 "Codes for the representation of names of languages" Maintenance Agency.
object[]stringFree text on header level (qualifying the content)
A code to classify the content of the invoice note.
The code is bilaterally agreed on and must have the same meaning as BT-22.
dateContractual due date of the invoice
Indication of the due date of the invoice if this differs from the payment.
Information only required if the contractual due date differs from due date of the payment (i.e. for SEPA direct debit).
objectobjectobjectstringSeller Role (code)
A code qualifying the role of the party
To be chosen from UNTDID 3035.
objectobjectSeller legal address
Legal address of the seller in case the seller address is different
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectstringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringSeller contact fax number
A fax number for the contact point.
objectstringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
stringBuyer additional legal information
Additional legal information relevant for the buyer.
Such as share capital.
objectobjectDetailed information about the business address
Legal address of the buyerr in case the Buyer address is different
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectstringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringBuyer contact fax number
A fax number for the contact point.
objectDetailed information about the sales agent
A group of business terms providing information about the Sales Agent
stringSales agent identifier
A previously exchanged assigned identifier of the business partner.
objectSales agent global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringSales agent global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringSales agent identifier Name / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectSales Agent Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringSales Agent Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
Legal address of the buyer in case the Sales Agent address is different
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information of the deviating end user
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectDetailed information about the buyer tax representative
stringIdentifier
A previously exchanged assigned identifier of the business partner.
objectGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringIdentifier Name / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information of the deviating end user
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectstringIdentifier
A previously exchanged assigned identifier of the business partner.
objectGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectLegal registration identifier
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringLegal registration identifier
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
stringDepartment name
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information about the deviating end user
stringDeviating end user identifier
A previously exchanged assigned identifier of the business partner.
objectDeviating end user global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating end user global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringDeviating end user identifier Name / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information of the deviating end user
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number, value
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address of the deviating end user
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectDetails of the delivery conditions
stringDelivery condition (Code)
The code specifying the type of delivery for these trade delivery terms.
To be chosen from the entries in UNTDID 4053 + INCOTERMS List
objectdateOrder confirmation date
object[]Details on referenced quotation
stringQuotation number
dateDocument date
objectstringType of contract (code)
Use codes from UNTDID 1153
CHORUSPRO: To qualify a contract (CT) or a procurement contract "Marché" (BC)
dateContract Date
objectDetailed information about the buyer agent
stringIdentifier
A previously exchanged assigned identifier of the business partner.
objectGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringGlobal identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringName / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
The identification scheme identifier of the Buyer Agent legal registration identifier.
If the identification scheme is used, it must be selected from the entries in the list published by the ISO/IEC 6523 Maintenance Agency.
stringCompany Registration Number
The identification scheme identifier of the Buyer Agent legal registration identifier.
If the identification scheme is used, it must be selected from the entries in the list published by the ISO/IEC 6523 Maintenance Agency.
stringScheme identifier
The identification scheme identifier of the Buyer Agent legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information of the deviating buyer agent
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
object[]Details on referenced customer order
stringUltimate Customer Order number of the final customer
dateDocument date
objectobjectRelated SupplyChain Consignment
A consignment, at header level, related to this trade delivery.
stringSpecified Logistics Transport Movement
The code specifying the mode, such as air, sea, rail, road or inland waterway, for this logistics transport movement.
stringDelivery method (Code)
A logistics transport movement specified for this supply chain consignment.
objectstringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035, for instance:
- DL: Factor
- DS: Distributor
- MOP: Market operator
objectDetails about the organization
objectLegal registration identifier
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringLegal registration identifier
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
stringDepartment name
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information of the goods recipient
stringVAT identifier
objectDetailed information about the final recipient
stringFinal recipient identifier
objectFinal recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringFinal recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringFinal Recipient Name / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address of the final recipient
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectIdentification of the deviating sender
stringDeviating sender identifier
objectDeviating sender global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating sender global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringDeviating sender name / company name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address of the deviating sender
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectdateGoods receipt date
object[]Detailed information about the corresponding delivery note
stringDelivery note reference
dateDelivery note date
objectstringSeller reference number
Given seller reference number for routing purposes after biliteral agreement
objectDeviating invoicing party
stringDeviating invoicer identifier
objectDeviating invoicer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating invoicer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringName
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectDetailed information about the deviating invoice recipient
stringDeviating invoice recipient identifier
objectDeviating invoice recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating invoice recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringDeviating invoice recipient name / company name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code) * * The code specifying the type of trade contact * * To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectstringPayee role (code)
A code qualifying the role of the payee
To be chosen from UNTDID 3035, for instance:
- DL: Factor
objectstringTrading name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
stringDepartment name
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the payee postal address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed tax information
stringVAT identifier
objectDetailed information about the deviating invoice payer
A group of business terms providing information about the Payer, i.e. the role that makes the payment.
The role of Payer may be fulfilled by another party than the Buyer, e.g. a third Party like a mother company
stringDeviating invoice payer identifier
objectDeviating invoice payer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating invoice payer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringPayer identifier Scheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringName/company name of the deviating invoice payer
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Payer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringPayer Electronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
objectSpecification of the invoice currency, local currency and exchange rate
stringInvoice currency
stringLocal currency
string | numberExchange rate
dateExchange rate date
object[]string | numberLine Total Basis Amount
A monetary value used as the line total basis on which this trade related tax, levy or duty is calculated
string | numberTotal amount of charges / allowances on document level
objectstringInvoicing period description (free text)
object[]string | numberCalculation sequence
objectAllowance / charge base quantity
string | numberAllowance / charge base quantity
stringUnit code
object[]string | numberCalculation sequence
objectAllowance / charge base quantity
string | numberAllowance / charge base quantity
stringUnit code
object[]stringService fee description
string | numberService fee amount
objectDetailed tax information
stringTax type (Code)
stringVAT category code
Coded identification of a VAT category.
string | numberVAT category rate
objectstring | numberPartial payment amount
object[]Detailed information about penalties
dateMaturity Reference Date
objectDue date period basis
The period for the due date, e.g. as a number of days (15 days)
string | numberDue date period basis
The period for the due date, e.g. as a number of days (15 days)
stringMaturity Period, Unit code
string | numberPayment penalty base amount
string | numberPayment penalty percentage
string | numberPayment penalty amount
object[]Detailed information about payment discounts
dateMaturity Reference Date
objectDue date period basis
The period for the due date, e.g. as a number of days (15 days)
string | numberDue date period basis
The period for the due date, e.g. as a number of days (15 days)
stringMaturity Period, Unit code
string | numberPayment discount base amount
string | numberPayment discount percentage
string | numberPayment discount amount
objectDeviating payee per payment
Group of business terms providing information about the payee, i.e. the role that receives the payment, IN CASE OF MULTIPLE PAYEES
The role of beneficiary may be filled by a party other than the seller, e.g. a factoring service. THIS GROUP IS ONLY USED WHEN THERE ARE MULTIPLE BENEFICIARIES (e.g. withholding tax or split payment).
stringDeviating invoice payee identifier
objectDeviating invoice payer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringDeviating invoice payer global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringPayee scheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringName/company name of Payee
The name of the Payee.
Shall be used when the Payee is different from the Seller. The Payee name may however be the same as the Seller name.
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Payee legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed information about the business address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetailed contact information
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information
stringVAT ID
object[]stringPreceding incoive type code
The same rules apply as for BT-3
objectstringAccounting reference type (Code)
object[]Included tax for advanced payment
string | numberAdvanced payment, value
dateDate of advanced payment
object[]Tax information on advanced payments
string | numberIncluded tax
stringVAT exemption reason text
A textual statement of the reason why the amount is exempted from VAT or why no VAT is being charged
stringVAT exemption reason code
A coded statement of the reason for why the amount is exempted from VAT.
Code list issued and maintained by the Connecting Europe Facility.
stringVAT category code
Coded identification of a VAT category.
The following entries of UNTDID 5305 [6] are used (further clarification between brackets):
- Standard rate (Liable for VAT in a standard way)
- Zero rated goods (Liable for VAT with a percentage rate of zero)
- Exempt from tax (VAT/IGIC/IPSI)
- VAT Reverse Charge (Reverse charge VAT/IGIC/IPSI rules apply)
- VAT exempt for intra community supply of goods (VAT/IGIC/IPSI not levied due to Intra-community supply rules)
- Free export item, tax not charged (VAT/IGIC/IPSI not levied due to export outside of the EU)
- Services outside scope of tax (Sale is not subject to VAT/IGIC/IPSI)
- Canary Islands General Indirect Tax (Liable for IGIC tax)
- Liable for IPSI (Ceuta/Melilla tax)
stringVAT category rate
The VAT rate, represented as percentage that applies for the relevant VAT category.
The VAT category code and the VAT category rate shall be consistent.
objectPrecending invoice reference for advance payment
A group of business terms providing information on the advance payment related preceding invoice. The individual invoide shall be stated so that combined payments need to be split per invoice.
To be used in case:
- preceding partial invoices are refered to from a final invoice
- preceding pre-payment invoices are refered to from a final invoice
stringPreceding Invoice reference
The identification of an Invoice that was previously sent by the Seller.
stringPreceding incoive type code
The same rules apply as for BT-3
datePreceding Invoice issue date
The date when the Preceding Invoice was issued.
The Preceding Invoice issue date shall be provided in case the Preceding Invoice identifier is not unique.
object[]stringParent line ID
The value given here refers to the superior line. In this way, a hierarchy tree of invoice items can be mapped.
stringType of the inovice line item (Code)
Indicating whether an item includes the prices which must be taken into account when calculating the invoice amount, or whether it only contains information.
Use codes from codelist UNTDID 1229. The following code should be applied per default: 39
stringSubtype of the invoice line item
Complements the type to clarify whether the invoice item is one of the following:
- Detail (default positioning)
- Subtotal
- Solely information
If the LineStatusCode element is used, the LineStatusReasonCode must be filled in: DETAIL, GROUP, INFORMATION
stringFree text on line level (code)
A code to classify the content of the invoice note.
The code is agreed bilaterally and must have the same meaning as BT-127.
stringInvoice line note subject code
To be chosen from the entries in UNTDID 4451 [6].
objectstringProduct identifier
This identifier can be additionally specified to be interoperable with Order-X.
stringIndustry assigned product identifier
An identifier, assigned by the Industry, for the item.
stringModel identification of the item
A unique model identifier for this item.
stringBatch (lot) identification of the item
A batch identifier for this item.
stringItem brand name
The brand name, expressed as text, for this item.
stringItem model name
object[]stringItem Attribute Type (Code)
To ensure automated processing of the article attributes without bilateral reconciliation, only values from the code list UNTDED 6313+Factur-X-Extension should be used.
string | numberItem Attribute Value (numerical measurand)
stringUnit of measure
objectstringClassification name
Name used to classify an item according to its type or nature.
object[]Item (Trade Product) Instances
stringItem (Trade Product) Instances Batch ID
The unique batch identifier for this trade product instance
stringItem (Trade Product) Instances Supplier Serial ID
The unique supplier assigned serial identifier for this trade product instance
object[]An included product referenced from this trade product.
stringID of Included Referenced Product
Article identifier for interoperability with Order-X
objectGlobal ID of Included Referenced Product
An item identifier based on a registered scheme.
stringGlobal ID of Included Referenced Product
An item identifier based on a registered scheme.
stringScheme identifier
The identification scheme identifier of the Item standard identifier
The identification scheme shall be identified from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringSellerAssignedID of Included Referenced Product
An identifier, assigned by the Seller, for the item.
stringBuyerAssignedID of Included Referenced Product
An identifier, assigned by the Buyer, for the item.
stringIndustryAssignedID of Included Referenced Product
Article identifier for interoperability with Order-X
stringName of Included Referenced Product
stringDescription of Included Referenced Product
A description for an item.
The Item description allows for describing the item and its features in more detail than the Item name.
string | numberUnitQuantity of Included Referenced Product
stringMeasurement unit
objectobjectDetails of an seller order document reference
string | numberDocument number
string | numberReferenced position
dateDocument date
objectstringOrder Id
dateOrder date
objectDetails of an quotation document reference
stringDocument number
string | numberReferenced position
dateDocument date
objectDetailed information on the associated contract
stringContract number
string | numberContract position
dateContract Date
object[]Details of an additional document reference
stringDocument number
stringExternal document location
The URL (Uniform Resource Locator) that identifies where the external document is located.
A means of locating the resource including its primary access mechanism, e.g. http:// or ftp://. External document location shall be used if the Buyer requires additional information to support the Invoice. External documents do not form part of the invoice. Risks can be involved when accessing external documents.
string | numberReferenced position
stringType of the document (code)
stringDocument description
stringAttached document
An attached document embedded as binary object or sent together with the invoice.
Attached document is used when documentation shall be stored with the Invoice for future reference or audit purposes.
stringAttached document Mime code
The mime code of the attached document.
stringAttached document Filename
The file name of the attached document
stringType of the document reference (code)
dateDocument date
objectobjectstring | numberDiscount in percent
string | numberDiscount base amount
stringReason for the discount (code)
Use entries of the UNTDID 5189 code list [6]. The Invoice line level allowance reason code and the Invoice line level allowance reason shall indicate the same allowance reason.
stringReason for the discount (free text)
object[]Price-related surcharges
string | numberCharge in percent
string | numberCharge base amount
string | numberCharge amount
The surcharge added to the gross price to calculate the net price
Only applies if the surcharge is given per unit and is not included in the gross price.
stringReason for the charge (code)
Use entries of the UNTDID 7161 code list [6]. The Invoice line charge reason code and the Invoice line charge reason shall indicate the same charge reason.
stringReason for the charge (free text)
objectobjectIncluded tax for B2C
string | numberIncluded tax for B2C
stringVAT exemption reason text
A textual statement of the reason why the amount is exempted from VAT or why no VAT is being charged
stringVAT exemption reason code
A coded statement of the reason for why the amount is exempted from VAT.
Code list issued and maintained by the Connecting Europe Facility.
stringVAT category code
Coded identification of a VAT category.
The following entries of UNTDID 5305 [6] are used (further clarification between brackets):
- Standard rate (Liable for VAT in a standard way)
- Zero rated goods (Liable for VAT with a percentage rate of zero)
- Exempt from tax (VAT/IGIC/IPSI)
- VAT Reverse Charge (Reverse charge VAT/IGIC/IPSI rules apply)
- VAT exempt for intra community supply of goods (VAT/IGIC/IPSI not levied due to Intra-community supply rules)
- Free export item, tax not charged (VAT/IGIC/IPSI not levied due to export outside of the EU)
- Services outside scope of tax (Sale is not subject to VAT/IGIC/IPSI)
- Canary Islands General Indirect Tax (Liable for IGIC tax)
- Liable for IPSI (Ceuta/Melilla tax)
string | numberVAT category rate
The VAT rate, represented as percentage that applies for the relevant VAT category.
The VAT category code and the VAT category rate shall be consistent.
object[]Details on referenced customer order
stringOrder number of the final customer
string | numberOrder item (ultimate customer)
dateDocument date
objectobjectQuantity, without charge
string | numberQuantity, without charge
stringUnit of measure
objectPackage quantity
string | numberPackage quantity
stringUnit of measure
objectDetailed information on the deviating goods recipient
stringGoods recipient identifier
A previously exchanged assigned identifier of the business partner.
objectGoods recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringGoods recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringShipTo name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectShipTo details about the organization
objectShipTo Legal ID
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringShipTo Legal ID
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
This may be used if different from the party name.
objectDetailed contact information of the goods recipient
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address of the goods recipient
string | numberPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCity
The common name of the city, town or village.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information of the goods recipient
stringVAT ID
objectDetailed information on the deviating final recipient
stringFinal recipient identifier
A previously exchanged assigned identifier of the business partner.
objectFinal recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringFinal recipient global identifier
GlobalID, if a global identifier exists and can be determined in the @schemeID, otherwise use ID
stringScheme identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
stringFinal Recipient Name / Company Name
stringRole (code)
A code qualifying the role
To be chosen from UNTDID 3035.
objectDetails about the organization
objectCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringCompany Registration Number
An identifier issued by an official registrar that identifies the party as a legal entity or person.
stringScheme identifier
The identification scheme identifier of the Buyer legal registration identifier.
If used, the identification scheme shall be chosen from the entries of the list published by the ISO 6523 maintenance agency.
stringTrading Business Name
A name by which the party is known, other than party name (also known as business name).
This may be used if different from the party name.
objectDetailed contact information of the final goods recipient
stringName of the contact
If a contact person is indicated, either the name or the department is to be transmitted.
stringDepartment name
If a contact person is indicated, either the name or the department is to be transmitted.
stringType of contact (code)
The code specifying the type of trade contact
To be chosen from the entries of UNTDID 3139
stringContact telephone number
A phone number for the contact point.
stringContact point fax number
stringContact email address
An e-mail address for the contact point.
objectDetailed information about the address of the final goods recipient
stringPost code
The identifier for an addressable group of properties according to the relevant postal service.
Such as a ZIP code or a post code.
stringAddress line 1
The main address line in an address.
Usually the street name and number or post office box.
stringAddress line 2
An additional address line in an address that can be used to give further details supplementing the main line.
stringAddress line 3
An additional address line in an address that can be used to give further details supplementing the main line.
stringCountry code
A code that identifies the country.
The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
stringCountry subdivision
The subdivision of a country.
Such as a region, a county, a state, a province, etc.
objectDetails about the electronic address
stringElectronic address
stringScheme identifier
objectDetailed information on tax information of the final goods recipient
stringVAT ID
objectDetailed information about the actual delivery
dateActual delivery date for this line
The VAT relevant date of delivery and achievement must be specified on the level of document.
objectDetailed information on the corresponding despatch advice
stringDespatch advice number
string | numberDespatch advice item
dateDocument date
objectDetailed information on the corresponding goods receipt
stringGoods receipt number
string | numberGoods receipt item
dateDocument date
objectDetailed information about the corresponding delivery note
stringDelivery note number
string | numberDelivery note item
dateDocument date
objectobjectstring | numberTax amount
Specification only for taxes that are not VAT
stringVAT exemption reason text
A textual statement of the reason why the amount is exempted from VAT or why no VAT is being charged
stringVAT exemption reason code
A coded statement of the reason for why the amount is exempted from VAT.
Code list issued and maintained by the Connecting Europe Facility.
objectstring | numberTotal amount of line item charges
string | numberTotal amount of line item allowances
string | numberTotal amount of line item taxes
string | numberTotal line item gross amount
string | numberTotal amount of allowances / charges
object[]Precending invoice reference
A group of business terms providing information on one or more preceding Invoices.
To be used in case:
- a preceding invoice is corrected
- preceding partial invoices are refered to from a final invoice
- preceding pre-payment invoices are refered to from a final invoice
stringPreceding Invoice reference
The identification of an Invoice that was previously sent by the Seller.
string | numberReferenced position
stringPreceding incoive type code
Can be used in case of final invoive after prepaid invoice, in order to refernce the previous prepaid invoices. Codelist UNCL 1001 restricted like BT-3.
datePreceding Invoice issue date
The date on which the preceding Invoice was issued.
The Preceding Invoice issue date shall be provided in case the Preceding Invoice identifier is not unique.
objectstringAccounting reference (Code)