Please note that all element names are inhereted from EN16931 and naming use the term invoice, but this covers both invoice and credit notes. The tag names are correct according to the UBL Credit note schema
Card | Name | Description | |
---|---|---|---|
1..1 | ubl:CreditNote | ||
1..1 | • cbc:CustomizationID |
Specification identifier
Default value: |
|
1..1 | • cbc:ProfileID |
Business process type
Default value: |
|
1..1 | • cbc:ID |
Invoice number
Example value: |
|
1..1 | • cbc:IssueDate |
Invoice issue date
Example value: |
|
0..1 | • cbc:TaxPointDate |
Value added tax point date
Example value: |
|
1..1 | • cbc:CreditNoteTypeCode |
Invoice type code
Example value: |
|
0..1 | • cbc:Note |
Invoice note
Example value: |
|
1..1 | • cbc:DocumentCurrencyCode |
Invoice currency code
Example value: |
|
0..1 | • cbc:TaxCurrencyCode |
VAT accounting currency code
Example value: |
|
0..1 | • cbc:AccountingCost |
Buyer accounting reference
Example value: |
|
0..1 | • cbc:BuyerReference |
Buyer reference
Example value: |
|
0..1 | • cac:InvoicePeriod |
DELIVERY OR INVOICE PERIOD |
|
0..1 | • • cbc:StartDate |
Invoicing period start date
Example value: |
|
0..1 | • • cbc:EndDate |
Invoicing period end date
Example value: |
|
0..1 | • • cbc:DescriptionCode |
Value added tax point date code
Example value: |
|
0..1 | • cac:OrderReference |
ORDER AND SALES ORDER REFERENCE |
|
1..1 | • • cbc:ID |
Purchase order reference
Example value: |
|
0..1 | • • cbc:SalesOrderID |
Sales order reference
Example value: |
|
0..n | • cac:BillingReference |
PRECEDING INVOICE REFERENCE |
|
1..1 | • • cac:InvoiceDocumentReference |
INVOICE DOCUMENT REFERENCE |
|
1..1 | • • • cbc:ID |
Preceding Invoice number
Example value: |
|
0..1 | • • • cbc:IssueDate |
Preceding Invoice issue date
Example value: |
|
0..1 | • cac:DespatchDocumentReference |
DESPATCH ADVICE REFERENCE |
|
1..1 | • • cbc:ID |
Despatch advice reference
Example value: |
|
0..1 | • cac:ReceiptDocumentReference |
RECEIPT ADVICE REFERENCE |
|
1..1 | • • cbc:ID |
Receiving advice reference
Example value: |
|
0..1 | • cac:ContractDocumentReference |
CONTRACT REFERENCE |
|
1..1 | • • cbc:ID |
Contract reference
Example value: |
|
0..n | • cac:AdditionalDocumentReference |
ADDITIONAL SUPPORTING DOCUMENTS |
|
1..1 | • • cbc:ID |
Invoiced object identifier, Supporting document reference or project reference
Example value: |
|
O | • • • @schemeID |
Scheme identifier
Example value: |
|
0..1 | • • cbc:DocumentTypeCode |
Document type code
Example value: |
|
0..1 | • • cbc:DocumentDescription |
Supporting document description
Example value: |
|
0..1 | • • cac:Attachment |
ATTACHMENT |
|
0..1 | • • • cbc:EmbeddedDocumentBinaryObject |
Attached document
Example value: |
|
M | • • • • @mimeCode |
Attached document Mime code
Example value: |
|
M | • • • • @filename |
Attached document Filename
Example value: |
|
0..1 | • • • cac:ExternalReference |
EXTERNAL REFERENCE |
|
1..1 | • • • • cbc:URI |
External document location
Example value: |
|
0..1 | • cac:OriginatorDocumentReference |
TENDER OR LOT REFERENCE |
|
1..1 | • • cbc:ID |
Tender or lot reference
Example value: |
|
1..1 | • cac:AccountingSupplierParty |
SELLER |
|
1..1 | • • cac:Party |
PARTY |
|
1..1 | • • • cbc:EndpointID |
Seller electronic address
Example value: |
|
M | • • • • @schemeID |
Seller electronic address identification scheme identifier
Example value: |
|
0..n | • • • cac:PartyIdentification |
PARTY IDENTIFICATION |
|
1..1 | • • • • cbc:ID |
Seller identifier or bank assigned creditor identifier
Example value: |
|
O | • • • • • @schemeID |
Seller or bank assigned creditor identifier identification scheme identifier
Example value: |
|
0..1 | • • • cac:PartyName |
PARTY NAME |
|
1..1 | • • • • cbc:Name |
Seller trading name
Example value: |
|
1..1 | • • • cac:PostalAddress |
SELLER POSTAL ADDRESS |
|
0..1 | • • • • cbc:StreetName |
Seller address line 1
Example value: |
|
0..1 | • • • • cbc:AdditionalStreetName |
Seller address line 2
Example value: |
|
0..1 | • • • • cbc:CityName |
Seller city
Example value: |
|
0..1 | • • • • cbc:PostalZone |
Seller post code
Example value: |
|
0..1 | • • • • cbc:CountrySubentity |
Seller country subdivision
Example value: |
|
0..1 | • • • • cac:AddressLine |
ADDRESS LINE |
|
1..1 | • • • • • cbc:Line |
Seller address line 3
Example value: |
|
1..1 | • • • • cac:Country |
COUNTRY |
|
1..1 | • • • • • cbc:IdentificationCode |
Seller country code
Example value: |
|
0..2 | • • • cac:PartyTaxScheme |
PARTY VAT/TAX IDENTIFIERS |
|
1..1 | • • • • cbc:CompanyID |
Seller VAT identifier, Seller tax registration identifier
Example value: |
|
1..1 | • • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • • cbc:ID |
Mandatory element. For Seller VAT identifier (BT-31), use value “VAT”, for the seller tax registration identifier (BT-32), use != "VAT"
Example value: |
|
1..1 | • • • cac:PartyLegalEntity |
PARTY LEGAL ENTITY |
|
1..1 | • • • • cbc:RegistrationName |
Seller name
Example value: |
|
0..1 | • • • • cbc:CompanyID |
Seller legal registration identifier
Example value: |
|
O | • • • • • @schemeID |
Seller legal registration identifier identification scheme identifier
Example value: |
|
0..1 | • • • • cbc:CompanyLegalForm |
Seller additional legal information
Example value: |
|
0..1 | • • • cac:Contact |
SELLER CONTACT |
|
0..1 | • • • • cbc:Name |
Seller contact point
Example value: |
|
0..1 | • • • • cbc:Telephone |
Seller contact telephone number
Example value: |
|
0..1 | • • • • cbc:ElectronicMail |
Seller contact email address
Example value: |
|
1..1 | • cac:AccountingCustomerParty |
BUYER |
|
1..1 | • • cac:Party |
PARTY |
|
1..1 | • • • cbc:EndpointID |
Buyer electronic address
Example value: |
|
M | • • • • @schemeID |
Buyer electronic address identification scheme identifier
Example value: |
|
0..1 | • • • cac:PartyIdentification |
PARTY IDENTIFICATION |
|
1..1 | • • • • cbc:ID |
Buyer identifier
Example value: |
|
O | • • • • • @schemeID |
Buyer identifier identification scheme identifier
Example value: |
|
0..1 | • • • cac:PartyName |
PARTY NAME |
|
1..1 | • • • • cbc:Name |
Buyer trading name
Example value: |
|
1..1 | • • • cac:PostalAddress |
BUYER POSTAL ADDRESS |
|
0..1 | • • • • cbc:StreetName |
Buyer address line 1
Example value: |
|
0..1 | • • • • cbc:AdditionalStreetName |
Buyer address line 2
Example value: |
|
0..1 | • • • • cbc:CityName |
Buyer city
Example value: |
|
0..1 | • • • • cbc:PostalZone |
Buyer post code
Example value: |
|
0..1 | • • • • cbc:CountrySubentity |
Buyer country subdivision
Example value: |
|
0..1 | • • • • cac:AddressLine |
ADDRESS LINE |
|
1..1 | • • • • • cbc:Line |
Buyer address line 3
Example value: |
|
1..1 | • • • • cac:Country |
COUNTRY |
|
1..1 | • • • • • cbc:IdentificationCode |
Buyer country code
Example value: |
|
0..1 | • • • cac:PartyTaxScheme |
PARTY VAT IDENTIFIER |
|
1..1 | • • • • cbc:CompanyID |
Buyer VAT identifier
Example value: |
|
1..1 | • • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • • cbc:ID |
Mandatory element. Use “VAT”
Default value: |
|
1..1 | • • • cac:PartyLegalEntity |
PARTY LEGAL ENTITY |
|
1..1 | • • • • cbc:RegistrationName |
Buyer name
Example value: |
|
0..1 | • • • • cbc:CompanyID |
Buyer legal registration identifier
Example value: |
|
O | • • • • • @schemeID |
Buyer legal registration identifier identification scheme identifier
Example value: |
|
0..1 | • • • cac:Contact |
BUYER CONTACT |
|
0..1 | • • • • cbc:Name |
Buyer contact point
Example value: |
|
0..1 | • • • • cbc:Telephone |
Buyer contact telephone number
Example value: |
|
0..1 | • • • • cbc:ElectronicMail |
Buyer contact email address
Example value: |
|
0..1 | • cac:PayeeParty |
PAYEE |
|
0..1 | • • cac:PartyIdentification |
PARTY IDENTIFICATION |
|
1..1 | • • • cbc:ID |
Payee identifier or bank assigned creditor identifier
Example value: |
|
O | • • • • @schemeID |
Payee or bank assigned creditor identifier identification scheme identifier
Example value: |
|
1..1 | • • cac:PartyName |
PARTY NAME |
|
1..1 | • • • cbc:Name |
Payee name
Example value: |
|
0..1 | • • cac:PartyLegalEntity |
PARTY LEGAL ENTITY |
|
1..1 | • • • cbc:CompanyID |
Payee legal registration identifier
Example value: |
|
O | • • • • @schemeID |
Payee legal registration identifier identification scheme identifier
Example value: |
|
0..1 | • cac:TaxRepresentativeParty |
SELLER TAX REPRESENTATIVE PARTY |
|
1..1 | • • cac:PartyName |
PARTY NAME |
|
1..1 | • • • cbc:Name |
Seller tax representative name
Example value: |
|
1..1 | • • cac:PostalAddress |
SELLER TAX REPRESENTATIVE POSTAL ADDRESS |
|
0..1 | • • • cbc:StreetName |
Tax representative address line 1
Example value: |
|
0..1 | • • • cbc:AdditionalStreetName |
Tax representative address line 2
Example value: |
|
0..1 | • • • cbc:CityName |
Tax representative city
Example value: |
|
0..1 | • • • cbc:PostalZone |
Tax representative post code
Example value: |
|
0..1 | • • • cbc:CountrySubentity |
Tax representative country subdivision
Example value: |
|
0..1 | • • • cac:AddressLine |
ADDRESS LINE |
|
1..1 | • • • • cbc:Line |
Tax representative address line 3
Example value: |
|
1..1 | • • • cac:Country |
COUNTRY |
|
1..1 | • • • • cbc:IdentificationCode |
Tax representative country code
Example value: |
|
1..1 | • • cac:PartyTaxScheme |
PARTY VAT IDENTIFIER |
|
1..1 | • • • cbc:CompanyID |
Seller tax representative VAT identifier
Example value: |
|
1..1 | • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • cbc:ID |
Mandatory element. Use “VAT”
Default value: |
|
0..1 | • cac:Delivery |
DELIVERY INFORMATION |
|
0..1 | • • cbc:ActualDeliveryDate |
Actual delivery date
Example value: |
|
0..1 | • • cac:DeliveryLocation | ||
0..1 | • • • cbc:ID |
Deliver to location identifier
Example value: |
|
O | • • • • @schemeID |
Deliver to location identifier identification scheme identifier
Example value: |
|
0..1 | • • • cac:Address |
DELIVER TO ADDRESS |
|
0..1 | • • • • cbc:StreetName |
Deliver to address line 1
Example value: |
|
0..1 | • • • • cbc:AdditionalStreetName |
Deliver to address line 2
Example value: |
|
0..1 | • • • • cbc:CityName |
Deliver to city
Example value: |
|
0..1 | • • • • cbc:PostalZone |
Deliver to post code
Example value: |
|
0..1 | • • • • cbc:CountrySubentity |
Deliver to country subdivision
Example value: |
|
0..1 | • • • • cac:AddressLine |
ADDRESS LINE |
|
1..1 | • • • • • cbc:Line |
Deliver to address line 3
Example value: |
|
1..1 | • • • • cac:Country |
COUNTRY |
|
1..1 | • • • • • cbc:IdentificationCode |
Deliver to country code
Example value: |
|
0..1 | • • cac:DeliveryParty |
DELIVER PARTY |
|
1..1 | • • • cac:PartyName |
PARTY NAME |
|
1..1 | • • • • cbc:Name |
Deliver to party name
Example value: |
|
0..n | • cac:PaymentMeans |
PAYMENT INSTRUCTIONS |
|
1..1 | • • cbc:PaymentMeansCode |
Payment means type code
Example value: |
|
O | • • • @name |
Payment means text
Example value: |
|
0..1 | • • cbc:PaymentDueDate |
Payment due date
Example value: |
|
0..1 | • • cbc:PaymentID |
Remittance information
Example value: |
|
0..1 | • • cac:CardAccount |
PAYMENT CARD INFORMATION |
|
1..1 | • • • cbc:PrimaryAccountNumberID |
Payment card primary account number
Example value: |
|
1..1 | • • • cbc:NetworkID |
Syntax required element not related to a business term.
Example value: |
|
0..1 | • • • cbc:HolderName |
Payment card holder name
Example value: |
|
0..1 | • • cac:PayeeFinancialAccount |
CREDIT TRANSFER |
|
1..1 | • • • cbc:ID |
Payment account identifier
Example value: |
|
0..1 | • • • cbc:Name |
Payment account name
Example value: |
|
0..1 | • • • cac:FinancialInstitutionBranch |
FINANCIAL INSTITUTION BRANCH |
|
1..1 | • • • • cbc:ID |
Payment service provider identifier
Example value: |
|
0..1 | • • cac:PaymentMandate |
DIRECT DEBIT |
|
0..1 | • • • cbc:ID |
Mandate reference identifier
Example value: |
|
0..1 | • • • cac:PayerFinancialAccount |
PAYER FINANCIAL ACCOUNT |
|
1..1 | • • • • cbc:ID |
Debited account identifier
Example value: |
|
0..1 | • cac:PaymentTerms |
PAYMENT TERMS |
|
1..1 | • • cbc:Note |
Payment terms
Example value: |
|
0..n | • cac:AllowanceCharge |
DOCUMENT LEVEL ALLOWANCES AND CHARGES |
|
1..1 | • • cbc:ChargeIndicator |
Use “true” when informing about Charges and “false” when informing about Allowances.
Example value: |
|
0..1 | • • cbc:AllowanceChargeReasonCode |
Document level allowance or charge reason code
Example value: |
|
0..1 | • • cbc:AllowanceChargeReason |
Document level allowance or charge reason
Example value: |
|
0..1 | • • cbc:MultiplierFactorNumeric |
Document level allowance or charge percentage
Example value: |
|
1..1 | • • cbc:Amount |
Document level allowance or charge amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:BaseAmount |
Document level allowance or charge base amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • cac:TaxCategory |
TAX CATEGORY |
|
1..1 | • • • cbc:ID |
Document level allowance or charge VAT category code
Example value: |
|
0..1 | • • • cbc:Percent |
Document level allowance or charge VAT rate
Example value: |
|
1..1 | • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • cbc:ID |
Mandatory element. Use “VAT”
Default value: |
|
1..2 | • cac:TaxTotal |
TAX TOTAL |
|
1..1 | • • cbc:TaxAmount |
Invoice total VAT amount, Invoice total VAT amount in accounting currency
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5 or BT-6.
Example value: |
|
0..n | • • cac:TaxSubtotal |
VAT BREAKDOWN |
|
1..1 | • • • cbc:TaxableAmount |
VAT category taxable amount
Example value: |
|
M | • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • • cbc:TaxAmount |
VAT category tax amount
Example value: |
|
M | • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • • cac:TaxCategory |
VAT CATEGORY |
|
1..1 | • • • • cbc:ID |
VAT category code
Example value: |
|
0..1 | • • • • cbc:Percent |
VAT category rate
Example value: |
|
0..1 | • • • • cbc:TaxExemptionReasonCode |
VAT exemption reason code |
|
0..1 | • • • • cbc:TaxExemptionReason |
VAT exemption reason text
Example value: |
|
1..1 | • • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • • cbc:ID |
Mandatory element. Use “VAT”
Default value: |
|
1..1 | • cac:LegalMonetaryTotal |
DOCUMENT TOTALS |
|
1..1 | • • cbc:LineExtensionAmount |
Sum of Invoice line net amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • cbc:TaxExclusiveAmount |
Invoice total amount without VAT
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • cbc:TaxInclusiveAmount |
Invoice total amount with VAT
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:AllowanceTotalAmount |
Sum of allowances on document level
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:ChargeTotalAmount |
Sum of charges on document level
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:PrepaidAmount |
Paid amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:PayableRoundingAmount |
Rounding amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • cbc:PayableAmount |
Amount due for payment
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..n | • cac:CreditNoteLine |
INVOICE LINE |
|
1..1 | • • cbc:ID |
Invoice line identifier
Example value: |
|
0..1 | • • cbc:Note |
Invoice line note
Example value: |
|
1..1 | • • cbc:CreditedQuantity |
Invoiced quantity
Example value: |
|
M | • • • @unitCode |
Invoiced quantity unit of measure
Example value: |
|
1..1 | • • cbc:LineExtensionAmount |
Invoice line net amount
Example value: |
|
M | • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • cbc:AccountingCost |
Invoice line Buyer accounting reference
Example value: |
|
0..1 | • • cac:InvoicePeriod |
INVOICE LINE PERIOD |
|
0..1 | • • • cbc:StartDate |
Invoice line period start date
Example value: |
|
0..1 | • • • cbc:EndDate |
Invoice line period end date
Example value: |
|
0..1 | • • cac:OrderLineReference |
ORDER LINE REFERENCE |
|
1..1 | • • • cbc:LineID |
Referenced purchase order line reference
Example value: |
|
0..1 | • • cac:DocumentReference |
LINE OBJECT IDENTIFIER |
|
1..1 | • • • cbc:ID |
Invoice line object identifier
Example value: |
|
O | • • • • @schemeID |
Invoice line object identifier identification scheme identifier
Example value: |
|
1..1 | • • • cbc:DocumentTypeCode |
Document type code
Default value: |
|
0..n | • • cac:AllowanceCharge |
INVOICE LINE ALLOWANCES OR CHARGES |
|
1..1 | • • • cbc:ChargeIndicator |
Use “true” when informing about Charges and “false” when informing about Allowances
Example value: |
|
0..1 | • • • cbc:AllowanceChargeReasonCode |
Line level allowance or charge reason code
Example value: |
|
0..1 | • • • cbc:AllowanceChargeReason |
Line level allowance or charge reason
Example value: |
|
0..1 | • • • cbc:MultiplierFactorNumeric |
Line level allowance or charge percentage
Example value: |
|
1..1 | • • • cbc:Amount |
Line level allowance or charge amount
Example value: |
|
M | • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • • cbc:BaseAmount |
Line level allowance or charge base amount
Example value: |
|
M | • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
1..1 | • • cac:Item |
ITEM INFORMATION |
|
0..1 | • • • cbc:Description |
Item description
Example value: |
|
1..1 | • • • cbc:Name |
Item name
Example value: |
|
0..1 | • • • cac:BuyersItemIdentification |
BUYERS ITEM IDENTIFICATION |
|
1..1 | • • • • cbc:ID |
Item Buyer's identifier
Example value: |
|
0..1 | • • • cac:SellersItemIdentification |
SELLERS ITEM IDENTIFICATION |
|
1..1 | • • • • cbc:ID |
Item Seller's identifier
Example value: |
|
0..1 | • • • cac:StandardItemIdentification |
STANDARD ITEM IDENTIFICATION |
|
1..1 | • • • • cbc:ID |
Item standard identifier
Example value: |
|
M | • • • • • @schemeID |
Item standard identifier identification scheme identifier
Example value: |
|
0..1 | • • • cac:OriginCountry |
ORIGIN COUNTRY |
|
1..1 | • • • • cbc:IdentificationCode |
Item country of origin
Example value: |
|
0..n | • • • cac:CommodityClassification |
COMMODITY CLASSIFICATION |
|
1..1 | • • • • cbc:ItemClassificationCode |
Item classification identifier
Example value: |
|
M | • • • • • @listID |
Item classification identifier identification scheme identifier
Example value: |
|
O | • • • • • @listVersionID |
Item classification identifier version identification scheme identifier |
|
1..1 | • • • cac:ClassifiedTaxCategory |
LINE VAT INFORMATION |
|
1..1 | • • • • cbc:ID |
Invoiced item VAT category code
Example value: |
|
0..1 | • • • • cbc:Percent |
Invoiced item VAT rate
Example value: |
|
1..1 | • • • • cac:TaxScheme |
TAX SCHEME |
|
1..1 | • • • • • cbc:ID |
Mandatory element. Use “VAT”
Default value: |
|
0..n | • • • cac:AdditionalItemProperty |
ITEM ATTRIBUTES |
|
1..1 | • • • • cbc:Name |
Item attribute name
Example value: |
|
1..1 | • • • • cbc:Value |
Item attribute value
Example value: |
|
1..1 | • • cac:Price |
PRICE DETAILS |
|
1..1 | • • • cbc:PriceAmount |
Item net price
Example value: |
|
M | • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • • cbc:BaseQuantity |
Item price base quantity
Example value: |
|
O | • • • • @unitCode |
Item price base quantity unit of measure code
Example value: |
|
0..1 | • • • cac:AllowanceCharge |
ALLOWANCE |
|
1..1 | • • • • cbc:ChargeIndicator |
Mandatory element. Value must be “false”
Fixed value: |
|
1..1 | • • • • cbc:Amount |
Item price discount
Example value: |
|
M | • • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |
|
0..1 | • • • • cbc:BaseAmount |
Item gross price
Example value: |
|
M | • • • • • @currencyID |
Mandatory attribute. Use BT-5
Example value: |