Mandatory.
Document reference number used by Supplier for internal tracking purpose.
| | IssueDate | String |Format:
YYYY-MM-DD
|Mandatory.
Date of issuance of the e-Invoice
\*Note that the date must be the current date
| | InvoiceTypeCode | String | - |Mandatory.
Invoice Type Code.
Identifies the document type (e.g., Sales invoice, credit note, debit note, refund note, etc.)
Invoice type code list:
Optional.
A textual note that gives unstructured information that is relevant to the Invoice or document
| | DocumentCurrencyCode | String | Enum: ISO code list 4217 alpha-3 |Mandatory.
Specific currency that is used to represent the monetary value stated in the e-Invoice.
| | TaxCurrencyCode | String | Enum: ISO code list 4217 alpha-3 |Optional.
Specific currency that is used to represent the tax monetary value stated in the e-Invoice.
If provided, it must be different than Document currency code, and the TaxTotal\[1].TaxAmount object must also be provided, in the tax currency, as described in TaxTotal array description. |
|
Otherwise, exactly one object must be present in the TaxTotal array.
Mandatory.
If OrderReference.ID is not present. An identifier assigned by the Buyer used for internal routing purposes.
| | InvoicePeriod | Object | - |Optional.
Represents Billing Period Details. Refer to Invoice Period Object
| | OrderReference.ID | String | An invoice must have buyer reference or order reference. |Mandatory.
If BuyerReference is not present. An identifier of a referenced purchase order, issued by the Buyer.
| | BillingReference | Array | - |Conditional.
A group of business terms providing information on one or more preceding Invoices.
Refer Billing Reference Object.
-
Optional.
The identification of a contract.
| | ProjectReference.ID | String |-
Optional.
The identification of the project the invoice refers to.
| |AccountingSupplierParty
| Object | - |Mandatory.
Accounting Supplier Party Object
| | AccountingCustomerParty | Object | - |Mandatory.
Accounting Customer Party Object
| | TaxRepresentativeParty | Object | - |Conditional.
Required in case seller is represented by a tax representative.
| | TaxPointDate | String | - |Optional.
The date when the TAX becomes accountable for the Seller and for the Buyer in so far as that date can be determined.
| | DueDate | String | - |Conditional mandatory.
The date when the payment is due. If the Amount due for payment is positive |
|
either the due date or the Payment terms shall be present.
Conditional.
Required in case payee is different from seller.
| | Delivery | Object | - |Conditional.
A group of business terms providing information about where and when the goods and services invoiced are delivered.
| | PaymentMeans | Object | - |Mandatory.
Payment instructions. Refer Payment Means object
| | PaymentTerms | Object | - |Conditional mandatory.
Refer Payment Terms Object. If the Amount due for payment is positive |
|
either the due date or the Payment terms shall be present.
Conditional.
Required in case of invoice level discount. Allowance Charge Object
| | TaxTotal | Array | - |Mandatory.
Array of Tax Total Objects.
| | TaxTotal\[0] | Object |
-
Mandatory.
Tax amount and breakdown in document currency.
| | TaxTotal\[1] | Object |
-
Conditional.
Mandatory when tax currency is provided.
| | LegalMonetaryTotal | Object | - |Mandatory.
Legal Monetary Total Object
| | InvoiceLine | Array | - |Mandatory.
Array of Invoice Line Item Objects
| **Payment Terms Object** | Parameter | Data Type | Field Validations | Description | | --------- | --------- | ----------------- | ----------------------------------------------------------------------------------------------------- | | Note | String | Max Length: 300 |Optional.
An agreed-upon payment terms and conditions e.g., timing and method of payment
| **Billing Reference Object** | Parameter | Data Type | Field Validations | Description | | ---------------------------------- | --------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | InvoiceDocumentReference | Object | - |Conditional Mandatory.
Document number of original invoice / document that is being affected / adjusted.
If "Invoice type code" (BT-3) contains the code 384 (Corrected invoice), reference should be provided at least once.
| | InvoiceDocumentReference.ID | String | MaxLength: 150 |Mandatory.
When InvoiceDocumentReference object is present.
The identification of an Invoice that was previously sent by the Seller.
yyyy-mm-dd
Max Length: 10
| Optional. | **Legal Monetary Total Object** Note: All amounts will be accepted in document currency | Parameter | Data Type | Field Validations | Description | | ------------------------------------------ | --------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | LineExtensionAmount.Value | Number | - |Mandatory.
Sum of all Invoice line net amounts in the Invoice, excluding any applicable taxes.
| |TaxExclusiveAmount.Value
-
Mandatory.
The total amount of the Invoice without TAX, inclusive of invoice level allowances and charges.
| |TaxInclusiveAmount.Value
Mandatory.
The total amount of the Invoice inclusive of tax.
| | AllowanceTotalAmount.Value | Number |
-
Conditional mandatory.
Total of document level allowance amounts. Must be present when document level allowances are present.
| | ChargeTotalAmount.Value | Number |
-
Conditional mandatory.
Total of document level charge amounts. Must be present when document level charges are present.
| | PrepaidAmount.Value | Number |-
Optional.
The sum of amounts which have been paid in advance.
| | PayableRoundingAmount.Value | Number | - |Optional.
Where applicable. Rounding amount added to the amount payable.
| | PayableAmount.Value | Number | - |Mandatory.
Sum of amount payable (inclusive of total taxes chargeable) excluding any amount paid in advance and any rounding adjustment.
| **Tax Total Object (Document Currency)** | Parameter | Data Type | Field Validations | Description | | --------------- | --------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | TaxAmount.Value | Number | - |Mandatory.
Total amount of tax payable
| | TaxSubtotal\[] | Array | - |Mandatory for document currency tax total object. One or more Tax Subtotal objects.
Must be absent in case of TaxTotal object having accounting currency tax amount.
Mandatory.
Total amount of tax payable for each tax type
| | TaxCategory | Object | - |Mandatory.
Tax Category Object
| **Tax Category Object** | Parameter | Data Type | Field Validations | Description | | | ---------------------- | --------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | ID | String | - |Mandatory.
Tax category code.
Aligned tax category codes | Peppol Specifications for the EU implementation of PINT
Conditional Mandatory.
VAT rate for the category. Must be present if and only if the ClassifiedTaxCategory objects of invoice line items which are consolidated in this object contain the Percent (i.e. line item VAT rate) element.
| | | TaxExemptionReason | String | Description of reason for VAT exemption |Conditional Mandatory.
Description of reason for VAT exemption
| | | TaxExemptionReasonCode | Enum |
-
Conditional.
Based on VAT category.
A coded statement of the reason for why the amount is exempted from TAX.
Mandatory.
Total amount of tax payable, in tax currency
| **Document Allowance Charge Object** | Parameter | Data Type | Field Validations | Description | | ------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ChargeIndicator | Boolean | - |Mandatory.
An indicator that this AllowanceCharge describes a discount. The value of this tag indicating discount (Allowance) must be "false", and for fee/charge it must be “true”
| | AllowanceChargeReasonCode | Enum |Code Column Here:
Allowance reasons:
Charge reasons:
|Conditional Mandatory.
Contain the description code of the additional discount applied or description of the additional fees.
When the allowance charge object is present either allowance charge reason or reason code must be provided.
| | AllowanceChargReason | String |Description Column Here:
Allowance reasons:
Charge reasons:
|Conditional Mandatory.
Contain the description of the additional discount applied or description of the additional fees.
When the allowance charge object is present either allowance charge reason or reason code must be provided.
| | MultiplierFactorNumeric | Number |
-
Conditional.
The discount/charge rate. E.g. If the rate is 5%, the value of this element shall be “5”.
| | Amount.Value | Number | - |Mandatory.
Total amount deducted from the original price of a product or service
| | BaseAmount.Value | Number |
-
Mandatory.
The amount based on which allowance or charge is calculated. Equal to invoice level total before taxes, charges, and discounts.
| | TaxCategory | Object |-
-
Mandatory.
Document level allowance TAX category code
Aligned tax category codes | Peppol Specifications for the EU implementation of PINT
Conditional Mandatory.
The TAX rate, represented as the percentage that applies to the document level allowance.
Must be absent when the VAT category is “Not subject to VAT”, otherwise mandatory.
| | | TaxScheme.ID | String |
-
Optional.
A code indicating the type of tax.
Default: “VAT”
Format:
YYYY-MM-DD
|Optional.
Actual delivery date
the date on which the supply of goods or services was made or completed.
| | DeliveryLocation | Object |-
Conditional Mandatory.
If the VAT category code is "Intra-community supply". Delivery location information.
| | DeliveryParty | Object |
-
Conditional Mandatory.
If the VAT category code is "Intra-community supply". Delivery Party information.
| **Delivery Location Object** | Parameter | Data Type | Field Validations | Description | | ----------- | ----------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID.Value | String |
-
Conditional Mandatory.
If the VAT category code is "Intra-community supply".
Delivery location ID.
| | ID.SchemeID | Enum |
-
Conditional Mandatory.
If the VAT category code is "Intra-community supply" and Delivery Location ID is present.
ISO 6523 ICD list - Peppol BIS Billing 3.0
| | Address | Object. Postal Address Object | - |Conditional Mandatory.
If the VAT category code is "Intra-community supply". Delivery to address.
| **Delivery Party Object** | Parameter | Data Type | Field Validations | Description | | -------------- | --------- | ----------------- | ------------------------------------------------------------------------------------------------ | | PartyName.Name | String | - | Name of shipping recipient of the products included in the e-Invoice in a commercial transaction | **Accounting Supplier Party Object** | Parameter | Data Type | Field Validations | Description | | | ----------------------------------------- | ----------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | Party | Object | - |Mandatory.
Supplier Party Object.
| | | Party.EndpointID.Value | String |-
Mandatory.
Seller’s electronic address to which the application level response to the invoice may be delivered.
| | | Party.EndpointID.SchemeID | Enum |-
Mandatory.
The identification scheme identifier of the Seller electronic address.
Electronic Address Scheme (EAS) | Peppol Specifications for the EU implementation of PINT
| | Party.PartyIdentification | Array | - |Optional.
Supplier Party Identification Object.
| | | Party.PartyIdentification.ID | Object | - |Optional.
Supplier Party Identification ID Object.
| | | Party.PartyIdentification.ID.Value | String | Alphanumeric |Optional.
Seller identifier -
An identification of the Seller.
| | | Party.PartyIdentification.ID.SchemeID | Enum |
-
Optional.
The identification scheme identifier shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
ISO 6523 ICD list - Peppol BIS Billing 3.0
Mandatory.
Seller Postal Address object. Seller address must contain street name, additional street name, postal code, city, state, and country code.
| | | PartyTaxScheme | Object |-
Mandatory.
Seller party tax information.
| | | PartyTaxScheme.CompanyID | String |-
Mandatory.
Supplier VAT identifier.
| | | PartyTaxScheme.TaxScheme.ID | String |-
Optional.
The scheme of the TAX identifier.
Default: VAT
Mandatory.
Seller Party Legal Entity Object
| | | Party.PartyLegalEntity.RegistrationName | String | - |Mandatory.
Name of business or individual who will be the issuer of the e-Invoice.
| | | Party.PartyLegalEntity.CompanyID.Value | String | - |Optional.
The official company-register number of the Seller. In Belgium, that’s the CBE/KBO enterprise number
| | | Party.PartyLegalEntity.CompanyID.SchemeID | String | - |Conditional Mandatory.
If legal identifier is present. The identification scheme identifier of the company-register number of the seller.
| | | Party.Contact | Object | - |Optional.
A group of business terms providing contact information about the Seller.
| | | Party.Contact.Name | String | MaxLength: 300 |Optional. | |
Seller contact point - A contact point for a legal entity or person.
| | Party.Contact.Telephone | String | MaxLength: 20 |Optional.
Seller contact telephone number - A phone number for the contact point.
| | Party.Contact.ElectronicMail | String | MaxLength: 320 |Optional.
Seller contact email address - An e-mail address for the contact point.
| **Postal Address Object** | Parameter | Data Type | Field Validations | Description | | -------------------------- | --------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | StreetName | String | MaxLength: 150 |Optional.
Seller address line 1.
| | AdditionalStreetName | String | MaxLength: 150 |Optional.
Seller address line 2.
Numerals
MinLen: 5
MaxLen: 5
Optional.
The identifier for an addressable group of properties according to the relevant postal service. Ex 50480
| | CountrySubentity | String | - |Optional.
The state of a country.
| | AddressLine | Array |Min Size: 0
Max Size: 1
| Optional. | | AddressLine.Line | String | MaxLength: 150 |Mandatory if AddressLine object is present.
Seller address line 3.
Mandatory.
Seller country code. Country codes in an invoice MUST be coded using ISO3166-1:Alpha2.
Mandatory.
Buyer Party Object.
| | Party.EndpointID.Value | String |-
Mandatory.
Buyer’s electronic address to which the invoice is delivered.
| | Party.EndpointID.SchemeID | Enum |-
Mandatory.
Optional.
Buyer Party Identification Object.
| | Party.PartyIdentification.ID | Object | - |Optional.
Buyer Party Identification ID Object.
| | Party.PartyIdentification.ID.Value | String | Alphanumeric |Optional.
An identification of the Buyer. The Buyer VAT can be mentioned here.
| | Party.PartyIdentification.ID.SchemeID | String |Optional.
| | Party.PostalAddress | Object. Postal Address Object | - |Mandatory.
Buyer Postal Address object. Buyer address must contain additional number, street name, building number, postal code, city, Neighborhood, country code.
| | Party.PartyLegalEntity | Object | - |Conditional.
Buyer Party Legal Entity Object
| | Party.PartyLegalEntity.RegistrationName | String | - |Mandatory.
Name of recipient of the e-Invoice in a commercial transaction
| | Party.PartyLegalEntity.CompanyID.Value | String | - |Optional.
The official company-register number of the buyer. In Belgium, that’s the CBE/KBO enterprise number
| | Party.PartyLegalEntity.CompanyID.SchemeID | String | - |Conditional Mandatory.
If legal identifier is present.The identification scheme identifier of the Buyer legal registration number.
| | Party.Contact | Object | - | Optional | | Party.Contact.Name | String | MaxLength: 300 | Optional | | Party.Contact.Telephone | String | MaxLength: 20 | Optional | | Party.Contact.ElectronicMail | String | MaxLength: 320 | Optional. | | PartyTaxScheme | Object | - |Optional.
Buyer party tax information.
| | PartyTaxScheme.CompanyID | String | - |Optional.
Buyer TAX identifier.
| | PartyTaxScheme.TaxScheme.ID | String | - |Optional.
The scheme of the TAX identifier. |
|
Default: VAT
Mandatory.
Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
A unique identifier for the individual line within the Invoice.
An Invoice shall have at least one Invoice line (BG-25)
| | | InvoicedQuantity | Object | - |Mandatory.
The quantity of items object
| | | InvoicedQuantity.Quantity | Number | - |Mandatory.
Number of units of a particular product or service in a commercial transaction
| | | InvoicedQuantity.UnitCode | String | Unit code (ibt-130), (ibt-150) MUST be coded according to the UN/ECE Recommendation 20 with Rec 21 extension.Mandatory.
Standard unit or system used to measure the product or service.
| | | LineExtensionAmount.Value | Number | - |Mandatory.
Total Excluding Tax. Sum of amount payable (inclusive of applicable discounts and charges), excluding any applicable taxes (e.g., sales tax, service tax)
| | | AllowanceCharge\[] | Array | - |Conditional.
Required only if there is invoice line item level allowance.
One or more Invoice level allowance charge objects.
| | | Item | Object | - |Mandatory.
Each Invoice line (BG-25) shall contain the Item name (BT-153).
| | | Item.Description | String | MaxLength: 300 |Optional.
Details of products or services being billed as a result of a commercial transaction
| | | Item.Name | String | MaxLength: 300 | Mandatory. A name for an item. | | | Item.OriginCountry.IdentificationCode | String | - |Optional.
The code identifying the country from which the item originates.
| | | Item.CommodityClassification\[] | Array | - |Optional.
Commodity classification information.
| | | Item.CommodityClassification\[].ItemClassificationCode.Value | String |
-
Optional.
A code for classifying the item by its type or nature.
| | | Item.CommodityClassification\[].ItemClassificationCode.SchemeID | Enum |
The identification scheme shall be chosen from the entries in UNTDID 7143.
Optional.
Invoiced item TAX category code.
-
Mandatory.
Invoice Line Tax information.
| | | Item.ClassifiedTaxCategory.ID | Enum |
-
Mandatory.
Aligned tax category codes | Peppol Specifications for the EU implementation of PINT
| | Item.ClassifiedTaxCategory.Percent | Number |
-
Conditional.
The TAX rate, represented as the percentage that applies to the invoiced item.
Must be absent when the VAT category is “Not subject to VAT”, otherwise mandatory.
| | | Price | Object | - |Mandatory.
Each Invoice line shall contain the Item net price
| | | Price.PriceAmount.Value | Number | - |Mandatory.
Price assigned to a single unit of a product or service after subtracting discount (Item Net price)
| | | Price.AllowanceCharge.Amount.Value | Number | - |Optional.
The total discount subtracted from the Unit price to calculate the Item net price.
| | | Price.AllowanceCharge.BaseAmount.Value | Number | - |Mandatory.
Price assigned to a single unit of a product or service before subtracting discount. (Unit Price)
| | | AllowanceCharge\[].ChargeIndicator | Boolean | - |Conditional.
Required in case of parent context exists.
An indicator that this AllowanceCharge describes a discount. The value of this tag indicating discount (Allowance) must be "false". The value of this tag indicating Charge (Allowance) must be "true".
| | | AllowanceCharge\[].AllowanceChargeReasonCode | Enum |
Code Column Here:
Allowance reasons:
Charge reasons:
|Conditional Mandatory.
Contain the description code of the additional discount applied or description of the additional fees.
If parent object is present either allowance charge reason or reason code must be provided.
| | | AllowanceCharge\[].AllowanceChargReason | String |Description Column Here:
Allowance reasons:
Charge reasons:
|Conditional Mandatory.
Contain the description of the additional discount applied or description of the additional fees.
If parent object is present either allowance charge reason or reason code must be provided.
| | | AllowanceCharge\[].MultiplierFactorNumeric | Number |Min: 0.00
Max: 100.00
|Conditional.
Discount Rate or Charge Rate.
MultiplierFactorNumeric. Charge associated with the product or service (be it in the form of percentage (%) or prevailing specified rate) imposed after tax OR
Percentage of deduction from the original price of a product or service
| | | AllowanceCharge\[].Amount.Value | Number | - |Amount deducted from the original price of a product or service.
OR
Charge associated with the product or service imposed after tax.
Currency will be overridden by document currency, if other currency is specified.
| | | AllowanceCharge\[].BaseAmount.Value | Number |Conditional.
The amount on which allowance/charge is calculated. Should be same as unitPrice \* quantity.
Currency will be overridden by document currency, if other currency is specified.
Mandatory.
The means, expressed as code, for how a payment is expected to be or has been settled.
Payment means code | Peppol Specifications for the EU implementation of PINT
Conditional.
Payee Financial Account Payment Note object.
| | | PayeeFinancialAccount.ID | String | MaxLength: 150 |Conditional.
A unique identifier of the financial payment account of the supplier, at a payment service provider, to which payment should be made.
| | | PayeeFinancialAccount.Name | String | MaxLength: 150 |Optional.
The Supplier’s bank account name
| | | PayeeFinancialAccount.FinancialInstitutionBranch.ID | String | MaxLength: 150 |Conditional.
The Supplier’s bank’s branch ID
| | **Tax Representative Party Object** | Parameter | Data Type | Field Validations | Description | | --------------------------- | ----------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PartyTaxScheme | Object |-
Conditional Mandatory
If seller has a tax representative party.Seller party tax information.
| | PartyTaxScheme.CompanyID | String |
-
Conditional Mandatory
If seller has a tax representative party. Tax Representative Tax identifier.
| | PartyTaxScheme.TaxScheme.ID | String |
-
Optional.
The scheme of the Tax Representative tax identifier.
Default: VAT
-
Conditional Mandatory
If seller has a tax representative party. Tax representative name.
| | PostalAddress | Object. Postal Address Object | - |Conditional Mandatory
If seller has a tax representative party. Tax Representative Postal Address object. Tax representative address must contain street name, additional street name, postal code, and country code.
| **Payee Party Object** | Parameter | Data Type | Field Validations | Description | | ------------------------------------- | --------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PartyIdentification | Array | - |Conditional Mandatory.
If payee is different from the seller. Payee Party Identification Object.
| | Party.PartyIdentification.ID | Object | - |Conditional Mandatory.
If payee is different from the seller. Payee Party Identification ID Object.
| | Party.PartyIdentification.ID.Value | String | Alphanumeric |Conditional Mandatory.
If payee is different from the seller.
Seller identifier -
An identification of the Seller.
| | Party.PartyIdentification.ID.SchemeID | Enum |-
Conditional Mandatory.
If payee is different from the seller.
The identification scheme identifier shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
ISO 6523 ICD list - Peppol BIS Billing 3.0
| | PartyName.Name | String |Conditional Mandatory.
If payee is different from the seller. Payee party name.
|