Formats
warning
Documentation is released in preview, is not final, and may be subject to changes. Sandbox and Production environments will be available soon.
When managing domestic B2B transactions under the Slovak mandate, invoices cannot be exchanged as plain, unstructured PDFs or paper documents. Instead, they must be issued in standardized, machine-readable electronic formats. A-Cube natively supports:
- UBL (Universal Business Language): A standardized XML format widely used across international procurement and accounting systems.
For Slovak country, A-Cube accepts invoices in Peppol BIS Billing format. Documents can be sent to A-Cube in JSON or XML format. Over the Peppol network, documents must be exchanged in XML format, so all the JSON data submitted will be converted into a valid XML.
Received information about the invoice or the credit note is validated against XSD scheme. This schema handles all types of documents supported in Slovakia. A-Cube Platform provides an easy-to-use API to handle them.
Peppol BIS Billing Invoice UBL
Invoice XML in the Peppol BIS Billing UBL format example
<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>Invoice-1</cbc:ID>
<cbc:IssueDate>2017-11-13</cbc:IssueDate>
<cbc:DueDate>2017-12-01</cbc:DueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:AccountingCost>4025:123:4343</cbc:AccountingCost>
<cbc:BuyerReference>0150abc</cbc:BuyerReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">5555444444</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID>5555444444</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>SupplierTradingName Ltd.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Main street 1</cbc:StreetName>
<cbc:AdditionalStreetName>Postbox 123</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 234</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>SK5555444444</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>SupplierOfficialName Ltd</cbc:RegistrationName>
<cbc:CompanyID>SK5555444444</cbc:CompanyID>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">5554444445</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID>5554444445</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>CustomerTradingName Ltd.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Main Street 2</cbc:StreetName>
<cbc:AdditionalStreetName>Postbox 321</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 234</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>SK5554444445</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>CustomerOfficialName Ltd.</cbc:RegistrationName>
<cbc:CompanyID schemeID="0245">5554444445</cbc:CompanyID>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:Name>Lisa Johnson</cbc:Name>
<cbc:Telephone>23434234</cbc:Telephone>
<cbc:ElectronicMail>lj@buyer.sk</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:Delivery>
<cbc:ActualDeliveryDate>2017-11-01</cbc:ActualDeliveryDate>
<cac:DeliveryLocation>
<cbc:ID schemeID="0088">9483759475923478</cbc:ID>
<cac:Address>
<cbc:StreetName>Delivery street 2</cbc:StreetName>
<cbc:AdditionalStreetName>Building 56</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 234</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:Address>
</cac:DeliveryLocation>
<cac:DeliveryParty>
<cac:PartyName>
<cbc:Name>Delivery party Name</cbc:Name>
</cac:PartyName>
</cac:DeliveryParty>
</cac:Delivery>
<cac:PaymentMeans>
<cbc:PaymentMeansCode name="Credit transfer">30</cbc:PaymentMeansCode>
<cbc:PaymentID>Snippet1</cbc:PaymentID>
<cac:PayeeFinancialAccount>
<cbc:ID>IBAN32423940</cbc:ID>
<cbc:Name>AccountName</cbc:Name>
<cac:FinancialInstitutionBranch>
<cbc:ID>BIC324098</cbc:ID>
</cac:FinancialInstitutionBranch>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>Payment within 10 days, 2% discount</cbc:Note>
</cac:PaymentTerms>
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReason>Insurance</cbc:AllowanceChargeReason>
<cbc:Amount currencyID="EUR">25</cbc:Amount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:AllowanceCharge>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">331.25</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">1325</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">331.25</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">1300</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">1325</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">1656.25</cbc:TaxInclusiveAmount>
<cbc:ChargeTotalAmount currencyID="EUR">25</cbc:ChargeTotalAmount>
<cbc:PayableAmount currencyID="EUR">1656.25</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="DAY">7</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID= "EUR">2800</cbc:LineExtensionAmount>
<cbc:AccountingCost>Konteringsstreng</cbc:AccountingCost>
<cac:OrderLineReference>
<cbc:LineID>123</cbc:LineID>
</cac:OrderLineReference>
<cac:Item>
<cbc:Description>Description of item</cbc:Description>
<cbc:Name>item name</cbc:Name>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0088">21382183120983</cbc:ID>
</cac:StandardItemIdentification>
<cac:OriginCountry>
<cbc:IdentificationCode>NO</cbc:IdentificationCode>
</cac:OriginCountry>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listID="SRV">09348023</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">400</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
<cac:InvoiceLine>
<cbc:ID>2</cbc:ID>
<cbc:InvoicedQuantity unitCode="DAY">-3</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">-1500</cbc:LineExtensionAmount>
<cac:OrderLineReference>
<cbc:LineID>123</cbc:LineID>
</cac:OrderLineReference>
<cac:Item>
<cbc:Description>Description 2</cbc:Description>
<cbc:Name>item name 2</cbc:Name>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0088">21382183120983</cbc:ID>
</cac:StandardItemIdentification>
<cac:OriginCountry>
<cbc:IdentificationCode>NO</cbc:IdentificationCode>
</cac:OriginCountry>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listID="SRV">09348023</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">500</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</Invoice>
Invoice JSON in the Peppol BIS Billing UBL format example
In case you do not want to manage the XML format, you can define documents in JSON. In this case you must send the HTTP header Content-Type: application/json.
The structure and the naming is the same of the official XML, except for the case of XML attributes which is a concept that is not applicable to JSON documents .
We chose to manage XML attributes within object structures in JSON, so to specify the node value we chosen to use a naming convention, the key is __value.
So if you have this tag with attribute in XML
<cbc:PayableAmount currencyID="CAD">100.00</cbc:PayableAmount>
The JSON translation is
"PayableAmount": {
"__value": 100.0,
"currencyID": "CAD"
}
Invoice example:
{
"UBLExtensions": [],
"CustomizationID": {
"__value": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0"
},
"ProfileID": {
"__value": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
},
"ID": {
"__value": "Snippet1"
},
"IssueDate": "2017-11-13",
"DueDate": "2017-12-01",
"InvoiceTypeCode": {
"__value": "380"
},
"Note": [],
"DocumentCurrencyCode": {
"__value": "EUR"
},
"AccountingCost": {
"__value": "4025:123:4343"
},
"BuyerReference": {
"__value": "0150abc"
},
"InvoicePeriod": [],
"BillingReference": [],
"DespatchDocumentReference": [],
"ReceiptDocumentReference": [],
"StatementDocumentReference": [],
"OriginatorDocumentReference": [],
"ContractDocumentReference": [],
"AdditionalDocumentReference": [],
"ProjectReference": [],
"Signature": [],
"AccountingSupplierParty": {
"AdditionalAccountID": [],
"Party": {
"EndpointID": {
"__value": "5554444444",
"schemeID": "0245"
},
"PartyIdentification": [
{
"ID": {
"schemeID": "0245",
"__value": "5555444444"
}
}
],
"PartyName": [
{
"Name": {
"__value": "SupplierTradingName Ltd."
}
}
],
"PostalAddress": {
"StreetName": {
"__value": "Main street 1"
},
"AdditionalStreetName": {
"__value": "Postbox 123"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"PartyTaxScheme": [
{
"CompanyID": {
"__value": "SK5555444444"
},
"ExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PartyLegalEntity": [
{
"RegistrationName": {
"__value": "SupplierOfficialName Ltd"
},
"CompanyID": {
"__value": "55555543"
},
"ShareholderParty": []
}
],
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
}
},
"AccountingCustomerParty": {
"AdditionalAccountID": [],
"Party": {
"EndpointID": {
"__value": "5554444445",
"schemeID": "0245"
},
"PartyIdentification": [
{
"ID": {
"__value": "5554444445",
"schemeID": "0245"
}
}
],
"PartyName": [
{
"Name": {
"__value": "BuyerTradingName AS"
}
}
],
"PostalAddress": {
"StreetName": {
"__value": "Main Street 123"
},
"AdditionalStreetName": {
"__value": "Postbox 456"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"PartyTaxScheme": [
{
"CompanyID": {
"__value": "SK5554444445"
},
"ExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PartyLegalEntity": [
{
"RegistrationName": {
"__value": "Buyer Official Name"
},
"CompanyID": {
"__value": "5554444445",
"schemeID": "0245"
},
"ShareholderParty": []
}
],
"Contact": {
"Name": {
"__value": "Lisa Johnson"
},
"Telephone": {
"__value": "23434234"
},
"ElectronicMail": {
"__value": "lj@buyer.sk"
},
"Note": [],
"OtherCommunication": []
},
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
}
},
"Delivery": [
{
"ActualDeliveryDate": "2017-11-01",
"DeliveryLocation": {
"ID": {
"__value": "9483759475923478",
"schemeID": "0088"
},
"Description": [],
"Conditions": [],
"ValidityPeriod": [],
"Address": {
"StreetName": {
"__value": "Delivery street 2"
},
"AdditionalStreetName": {
"__value": "Building 56"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"SubsidiaryLocation": [],
"LocationCoordinate": []
},
"DeliveryParty": {
"PartyIdentification": [],
"PartyName": [
{
"Name": {
"__value": "Delivery party Name"
}
}
],
"PartyTaxScheme": [],
"PartyLegalEntity": [],
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
},
"NotifyParty": [],
"DeliveryTerms": []
}
],
"PaymentMeans": [
{
"PaymentMeansCode": {
"__value": "30",
"name": "Credit transfer"
},
"InstructionNote": [],
"PaymentID": [
{
"__value": "Snippet1"
}
],
"PayeeFinancialAccount": {
"ID": {
"__value": "IBAN32423940"
},
"Name": {
"__value": "AccountName"
},
"PaymentNote": [],
"FinancialInstitutionBranch": {
"ID": {
"__value": "BIC324098"
}
}
}
}
],
"PaymentTerms": [
{
"PaymentMeansID": [],
"Note": [
{
"__value": "Payment within 10 days, 2% discount"
}
]
}
],
"PrepaidPayment": [],
"AllowanceCharge": [
{
"ChargeIndicator": true,
"AllowanceChargeReason": [
{
"__value": "Insurance"
}
],
"Amount": {
"__value": 25.0,
"currencyID": "EUR"
},
"TaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PaymentMeans": []
}
],
"TaxTotal": [
{
"TaxAmount": {
"__value": 331.25,
"currencyID": "EUR"
},
"TaxSubtotal": [
{
"TaxableAmount": {
"__value": 1325.0,
"currencyID": "EUR"
},
"TaxAmount": {
"__value": 331.25,
"currencyID": "EUR"
},
"TaxCategory": {
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
}
]
}
],
"WithholdingTaxTotal": [],
"LegalMonetaryTotal": {
"LineExtensionAmount": {
"__value": 1300.0,
"currencyID": "EUR"
},
"TaxExclusiveAmount": {
"__value": 1325.0,
"currencyID": "EUR"
},
"TaxInclusiveAmount": {
"__value": 1656.25,
"currencyID": "EUR"
},
"ChargeTotalAmount": {
"__value": 25.0,
"currencyID": "EUR"
},
"PayableAmount": {
"__value": 1656.25,
"currencyID": "EUR"
}
},
"InvoiceLine": [
{
"ID": {
"__value": "1"
},
"Note": [],
"InvoicedQuantity": {
"__value": 7.0,
"unitCode": "DAY"
},
"LineExtensionAmount": {
"__value": 2800.0,
"currencyID": "EUR"
},
"AccountingCost": {
"__value": "Konteringsstreng"
},
"InvoicePeriod": [],
"OrderLineReference": [
{
"LineID": {
"__value": "123"
}
}
],
"DespatchLineReference": [],
"ReceiptLineReference": [],
"BillingReference": [],
"DocumentReference": [],
"Delivery": [],
"PaymentTerms": [],
"AllowanceCharge": [],
"TaxTotal": [],
"WithholdingTaxTotal": [],
"Item": {
"Description": [
{
"__value": "Description of item"
}
],
"Name": {
"__value": "item name"
},
"AdditionalInformation": [],
"Keyword": [],
"BrandName": [],
"ModelName": [],
"ManufacturersItemIdentification": [],
"StandardItemIdentification": {
"ID": {
"__value": "21382183120983",
"schemeID": "0088"
},
"PhysicalAttribute": [],
"MeasurementDimension": []
},
"AdditionalItemIdentification": [],
"ItemSpecificationDocumentReference": [],
"OriginCountry": {
"IdentificationCode": {
"__value": "NO"
}
},
"CommodityClassification": [
{
"ItemClassificationCode": {
"__value": "09348023",
"listID": "SRV"
}
}
],
"TransactionConditions": [],
"HazardousItem": [],
"ClassifiedTaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"AdditionalItemProperty": [],
"ManufacturerParty": [],
"OriginAddress": [],
"ItemInstance": [],
"Certificate": [],
"Dimension": []
},
"Price": {
"PriceAmount": {
"__value": 400.0,
"currencyID": "EUR"
},
"PriceChangeReason": [],
"ValidityPeriod": [],
"AllowanceCharge": []
},
"SubInvoiceLine": []
},
{
"ID": {
"__value": "2"
},
"Note": [],
"InvoicedQuantity": {
"__value": -3.0,
"unitCode": "DAY"
},
"LineExtensionAmount": {
"__value": -1500.0,
"currencyID": "EUR"
},
"InvoicePeriod": [],
"OrderLineReference": [
{
"LineID": {
"__value": "123"
}
}
],
"DespatchLineReference": [],
"ReceiptLineReference": [],
"BillingReference": [],
"DocumentReference": [],
"Delivery": [],
"PaymentTerms": [],
"AllowanceCharge": [],
"TaxTotal": [],
"WithholdingTaxTotal": [],
"Item": {
"Description": [
{
"__value": "Description 2"
}
],
"Name": {
"__value": "item name 2"
},
"AdditionalInformation": [],
"Keyword": [],
"BrandName": [],
"ModelName": [],
"ManufacturersItemIdentification": [],
"StandardItemIdentification": {
"ID": {
"__value": "21382183120983",
"schemeID": "0088"
},
"PhysicalAttribute": [],
"MeasurementDimension": []
},
"AdditionalItemIdentification": [],
"ItemSpecificationDocumentReference": [],
"OriginCountry": {
"IdentificationCode": {
"__value": "NO"
}
},
"CommodityClassification": [
{
"ItemClassificationCode": {
"__value": "09348023",
"listID": "SRV"
}
}
],
"TransactionConditions": [],
"HazardousItem": [],
"ClassifiedTaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"AdditionalItemProperty": [],
"ManufacturerParty": [],
"OriginAddress": [],
"ItemInstance": [],
"Certificate": [],
"Dimension": []
},
"Price": {
"PriceAmount": {
"__value": 500.0,
"currencyID": "EUR"
},
"PriceChangeReason": [],
"ValidityPeriod": [],
"AllowanceCharge": []
},
"SubInvoiceLine": []
}
]
}
Over the Peppol network, documents must be exchanged in XML format, so all the JSON data submitted will be converted in a valid XML.
When a document is sent in JSON format, the original JSON source and the XML document sent over Peppol network will be available for download.
Peppol BIS Billing CreditNote UBL
Credit Note XML in the Peppol BIS Billing UBL format example
<CreditNote xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"
xmlns:sh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader">
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0
</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>CreditNote-1</cbc:ID>
<cbc:IssueDate>2026-08-24</cbc:IssueDate>
<cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
<cbc:Note>Please note we have a new phone number: 22 22 22 22</cbc:Note>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:AccountingCost>ACC:COST:TC423</cbc:AccountingCost>
<cbc:BuyerReference>0150abc</cbc:BuyerReference>
<cac:OrderReference>
<cbc:ID>PO1245</cbc:ID>
<cbc:SalesOrderID>12345678</cbc:SalesOrderID>
</cac:OrderReference>
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID>Invoice-1</cbc:ID>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">5554444445</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID>5554444445</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>SupplierTradingName Ltd.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Main street 1</cbc:StreetName>
<cbc:AdditionalStreetName>Postbox 123</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 234</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>SK5554444445</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>SupplierOfficialName Ltd</cbc:RegistrationName>
<cbc:CompanyID>SK5554444445</cbc:CompanyID>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="0245">5555444444</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID>5555444444</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>BuyerTradingName AS</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Main Street 5</cbc:StreetName>
<cbc:AdditionalStreetName>Postbox 654</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 234</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>SK5555444444</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Buyer Official Name</cbc:RegistrationName>
<cbc:CompanyID schemeID="0245">5555444444</cbc:CompanyID>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:Name>Lisa Johnson</cbc:Name>
<cbc:Telephone>23434234</cbc:Telephone>
<cbc:ElectronicMail>lj@buyer.sk</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:Delivery>
<cbc:ActualDeliveryDate>2017-11-01</cbc:ActualDeliveryDate>
<cac:DeliveryLocation>
<cbc:ID schemeID="0088">9483759475923478</cbc:ID>
<cac:Address>
<cbc:StreetName>Delivery street 2</cbc:StreetName>
<cbc:AdditionalStreetName>Building 56</cbc:AdditionalStreetName>
<cbc:CityName>Bratislava</cbc:CityName>
<cbc:PostalZone>01 123</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:Country>
</cac:Address>
</cac:DeliveryLocation>
<cac:DeliveryParty>
<cac:PartyName>
<cbc:Name>Delivery party Name</cbc:Name>
</cac:PartyName>
</cac:DeliveryParty>
</cac:Delivery>
<cac:PaymentMeans>
<cbc:PaymentMeansCode name="Credit transfer">30</cbc:PaymentMeansCode>
<cbc:PaymentID>Snippet1</cbc:PaymentID>
<cac:PayeeFinancialAccount>
<cbc:ID>IBAN32423940</cbc:ID>
<cbc:Name>AccountName</cbc:Name>
<cac:FinancialInstitutionBranch>
<cbc:ID>BIC324098</cbc:ID>
</cac:FinancialInstitutionBranch>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>Payment within 10 days, 2% discount</cbc:Note>
</cac:PaymentTerms>
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReason>Insurance</cbc:AllowanceChargeReason>
<cbc:Amount currencyID="EUR">25</cbc:Amount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:AllowanceCharge>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">331.25</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">1325</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">331.25</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">1300</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">1325</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">1656.25</cbc:TaxInclusiveAmount>
<cbc:ChargeTotalAmount currencyID="EUR">25</cbc:ChargeTotalAmount>
<cbc:PayableAmount currencyID="EUR">1656.25</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:CreditNoteLine>
<cbc:ID>1</cbc:ID>
<cbc:CreditedQuantity unitCode="DAY">7</cbc:CreditedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">2800</cbc:LineExtensionAmount>
<cbc:AccountingCost>Konteringsstreng</cbc:AccountingCost>
<cac:OrderLineReference>
<cbc:LineID>123</cbc:LineID>
</cac:OrderLineReference>
<cac:Item>
<cbc:Description>Description of item</cbc:Description>
<cbc:Name>item name</cbc:Name>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0088">21382183120983</cbc:ID>
</cac:StandardItemIdentification>
<cac:OriginCountry>
<cbc:IdentificationCode>NO</cbc:IdentificationCode>
</cac:OriginCountry>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listID="SRV">09348023</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">400</cbc:PriceAmount>
</cac:Price>
</cac:CreditNoteLine>
<cac:CreditNoteLine>
<cbc:ID>2</cbc:ID>
<cbc:CreditedQuantity unitCode="DAY">-3</cbc:CreditedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">-1500</cbc:LineExtensionAmount>
<cac:OrderLineReference>
<cbc:LineID>123</cbc:LineID>
</cac:OrderLineReference>
<cac:Item>
<cbc:Description>Description 2</cbc:Description>
<cbc:Name>item name 2</cbc:Name>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0088">21382183120983</cbc:ID>
</cac:StandardItemIdentification>
<cac:OriginCountry>
<cbc:IdentificationCode>NO</cbc:IdentificationCode>
</cac:OriginCountry>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listID="SRV">09348023</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">500</cbc:PriceAmount>
</cac:Price>
</cac:CreditNoteLine>
</CreditNote>
Credit note JSON in the Peppol BIS Billing UBL format example
In case you do not want to manage the XML format, you can define documents in JSON. In this case you must send the HTTP header Content-Type: application/json.
The structure and the naming is the same of the official XML, except for the case of XML attributes which is a concept that is not applicable to JSON documents .
We chose to manage XML attributes within object structures in JSON, so to specify the node value we chosen to use a naming convention, the key is __value.
So if you have this tag with attribute in XML
<cbc:PayableAmount currencyID="CAD">100.00</cbc:PayableAmount>
The JSON translation is
"PayableAmount": {
"__value": 100.0,
"currencyID": "CAD"
}
Credit note example:
{
"UBLExtensions": [],
"CustomizationID": {
"__value": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0"
},
"ProfileID": {
"__value": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
},
"ID": {
"__value": "CreditNote-N1"
},
"IssueDate": "2017-11-13",
"CreditNoteTypeCode": {
"__value": "381"
},
"Note": [
{
"__value": "Please note we have a new phone number: 22 22 22 22"
}
],
"DocumentCurrencyCode": {
"__value": "EUR"
},
"AccountingCost": {
"__value": "4025:123:4343"
},
"BuyerReference": {
"__value": "0150abc"
},
"InvoicePeriod": [],
"DiscrepancyResponse": [],
"BillingReference": [
{
"InvoiceDocumentReference": {
"ID": {
"__value": "Invoice-1"
},
"XPath": [],
"DocumentDescription": []
},
"BillingReferenceLine": []
}
],
"DespatchDocumentReference": [],
"ReceiptDocumentReference": [],
"ContractDocumentReference": [],
"AdditionalDocumentReference": [],
"StatementDocumentReference": [],
"OriginatorDocumentReference": [],
"Signature": [],
"AccountingSupplierParty": {
"AdditionalAccountID": [],
"Party": {
"EndpointID": {
"__value": "5554444445",
"schemeID": "0245"
},
"PartyIdentification": [
{
"ID": {
"__value": "5554444445"
}
}
],
"PartyName": [
{
"Name": {
"__value": "SupplierTradingName Ltd."
}
}
],
"PostalAddress": {
"StreetName": {
"__value": "Main street 1"
},
"AdditionalStreetName": {
"__value": "Postbox 123"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"PartyTaxScheme": [
{
"CompanyID": {
"__value": "SK5554444445"
},
"ExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PartyLegalEntity": [
{
"RegistrationName": {
"__value": "SupplierOfficialName Ltd"
},
"CompanyID": {
"__value": "SK5554444445"
},
"ShareholderParty": []
}
],
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
}
},
"AccountingCustomerParty": {
"AdditionalAccountID": [],
"Party": {
"EndpointID": {
"__value": "5555444444",
"schemeID": "0245"
},
"PartyIdentification": [
{
"ID": {
"__value": "5555444444"
}
}
],
"PartyName": [
{
"Name": {
"__value": "BuyerTradingName AS"
}
}
],
"PostalAddress": {
"StreetName": {
"__value": "Main Street 4"
},
"AdditionalStreetName": {
"__value": "Postbox 123"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"PartyTaxScheme": [
{
"CompanyID": {
"__value": "SK5555444444"
},
"ExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PartyLegalEntity": [
{
"RegistrationName": {
"__value": "Buyer Official Name"
},
"CompanyID": {
"__value": "5555444444",
"schemeID": "0245"
},
"ShareholderParty": []
}
],
"Contact": {
"Name": {
"__value": "Lisa Johnson"
},
"Telephone": {
"__value": "23434234"
},
"ElectronicMail": {
"__value": "lj@buyer.sk"
},
"Note": [],
"OtherCommunication": []
},
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
}
},
"Delivery": [
{
"ActualDeliveryDate": "2017-11-01",
"DeliveryLocation": {
"ID": {
"__value": "9483759475923478",
"schemeID": "0088"
},
"Description": [],
"Conditions": [],
"ValidityPeriod": [],
"Address": {
"StreetName": {
"__value": "Delivery street 2"
},
"AdditionalStreetName": {
"__value": "Building 56"
},
"CityName": {
"__value": "Bratislava"
},
"PostalZone": {
"__value": "01 234"
},
"AddressLine": [],
"Country": {
"IdentificationCode": {
"__value": "SK"
}
},
"LocationCoordinate": []
},
"SubsidiaryLocation": [],
"LocationCoordinate": []
},
"DeliveryParty": {
"PartyIdentification": [],
"PartyName": [
{
"Name": {
"__value": "Delivery party Name"
}
}
],
"PartyTaxScheme": [],
"PartyLegalEntity": [],
"Person": [],
"ServiceProviderParty": [],
"PowerOfAttorney": []
},
"NotifyParty": [],
"DeliveryTerms": []
}
],
"DeliveryTerms": [],
"PaymentMeans": [
{
"PaymentMeansCode": {
"__value": "30",
"name": "Credit transfer"
},
"InstructionNote": [],
"PaymentID": [
{
"__value": "Snippet1"
}
],
"PayeeFinancialAccount": {
"ID": {
"__value": "IBAN32423940"
},
"Name": {
"__value": "AccountName"
},
"PaymentNote": [],
"FinancialInstitutionBranch": {
"ID": {
"__value": "BIC324098"
}
}
}
}
],
"PaymentTerms": [
{
"PaymentMeansID": [],
"Note": [
{
"__value": "Payment within 10 days, 2% discount"
}
]
}
],
"AllowanceCharge": [
{
"ChargeIndicator": true,
"AllowanceChargeReason": [
{
"__value": "Insurance"
}
],
"Amount": {
"__value": 25.0,
"currencyID": "EUR"
},
"TaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"PaymentMeans": []
}
],
"TaxTotal": [
{
"TaxAmount": {
"__value": 331.25,
"currencyID": "EUR"
},
"TaxSubtotal": [
{
"TaxableAmount": {
"__value": 1325.0,
"currencyID": "EUR"
},
"TaxAmount": {
"__value": 331.25,
"currencyID": "EUR"
},
"TaxCategory": {
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
}
]
}
],
"LegalMonetaryTotal": {
"LineExtensionAmount": {
"__value": 1300.0,
"currencyID": "EUR"
},
"TaxExclusiveAmount": {
"__value": 1325.0,
"currencyID": "EUR"
},
"TaxInclusiveAmount": {
"__value": 1656.25,
"currencyID": "EUR"
},
"ChargeTotalAmount": {
"__value": 25.0,
"currencyID": "EUR"
},
"PayableAmount": {
"__value": 1656.25,
"currencyID": "EUR"
}
},
"CreditNoteLine": [
{
"ID": {
"__value": "1"
},
"Note": [],
"CreditedQuantity": {
"__value": 7.0,
"unitCode": "DAY"
},
"LineExtensionAmount": {
"__value": 2800.0,
"currencyID": "EUR"
},
"AccountingCost": {
"__value": "Konteringsstreng"
},
"InvoicePeriod": [],
"OrderLineReference": [
{
"LineID": {
"__value": "123"
}
}
],
"DiscrepancyResponse": [],
"DespatchLineReference": [],
"ReceiptLineReference": [],
"BillingReference": [],
"DocumentReference": [],
"Delivery": [],
"PaymentTerms": [],
"TaxTotal": [],
"AllowanceCharge": [],
"Item": {
"Description": [
{
"__value": "Description of item"
}
],
"Name": {
"__value": "item name"
},
"AdditionalInformation": [],
"Keyword": [],
"BrandName": [],
"ModelName": [],
"ManufacturersItemIdentification": [],
"StandardItemIdentification": {
"ID": {
"__value": "21382183120983",
"schemeID": "0088"
},
"PhysicalAttribute": [],
"MeasurementDimension": []
},
"AdditionalItemIdentification": [],
"ItemSpecificationDocumentReference": [],
"OriginCountry": {
"IdentificationCode": {
"__value": "NO"
}
},
"CommodityClassification": [
{
"ItemClassificationCode": {
"__value": "09348023",
"listID": "SRV"
}
}
],
"TransactionConditions": [],
"HazardousItem": [],
"ClassifiedTaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"AdditionalItemProperty": [],
"ManufacturerParty": [],
"OriginAddress": [],
"ItemInstance": [],
"Certificate": [],
"Dimension": []
},
"Price": {
"PriceAmount": {
"__value": 400.0,
"currencyID": "EUR"
},
"PriceChangeReason": [],
"ValidityPeriod": [],
"AllowanceCharge": []
},
"DeliveryTerms": [],
"SubCreditNoteLine": []
},
{
"ID": {
"__value": "2"
},
"Note": [],
"CreditedQuantity": {
"__value": -3.0,
"unitCode": "DAY"
},
"LineExtensionAmount": {
"__value": -1500.0,
"currencyID": "EUR"
},
"InvoicePeriod": [],
"OrderLineReference": [
{
"LineID": {
"__value": "123"
}
}
],
"DiscrepancyResponse": [],
"DespatchLineReference": [],
"ReceiptLineReference": [],
"BillingReference": [],
"DocumentReference": [],
"Delivery": [],
"PaymentTerms": [],
"TaxTotal": [],
"AllowanceCharge": [],
"Item": {
"Description": [
{
"__value": "Description 2"
}
],
"Name": {
"__value": "item name 2"
},
"AdditionalInformation": [],
"Keyword": [],
"BrandName": [],
"ModelName": [],
"ManufacturersItemIdentification": [],
"StandardItemIdentification": {
"ID": {
"__value": "21382183120983",
"schemeID": "0088"
},
"PhysicalAttribute": [],
"MeasurementDimension": []
},
"AdditionalItemIdentification": [],
"ItemSpecificationDocumentReference": [],
"OriginCountry": {
"IdentificationCode": {
"__value": "NO"
}
},
"CommodityClassification": [
{
"ItemClassificationCode": {
"__value": "09348023",
"listID": "SRV"
}
}
],
"TransactionConditions": [],
"HazardousItem": [],
"ClassifiedTaxCategory": [
{
"ID": {
"__value": "S"
},
"Percent": {
"__value": 25.0
},
"TaxExemptionReason": [],
"TaxScheme": {
"ID": {
"__value": "VAT"
},
"JurisdictionRegionAddress": []
}
}
],
"AdditionalItemProperty": [],
"ManufacturerParty": [],
"OriginAddress": [],
"ItemInstance": [],
"Certificate": [],
"Dimension": []
},
"Price": {
"PriceAmount": {
"__value": 500.0,
"currencyID": "EUR"
},
"PriceChangeReason": [],
"ValidityPeriod": [],
"AllowanceCharge": []
},
"DeliveryTerms": [],
"SubCreditNoteLine": []
}
]
}