Single Invoice

Retrieve a specific invoice

This endpoint returns details of a specific invoice. Using the invoice-id from an InvoiceListItem from the previous call and the appropriate InvoiceMediaTypes (e.g. application/xml), the invoice can be obtained. When requesting the specific invoice in PDF format, you will retrieve the invoice as it’s given in the sellers dashboard. If you choose to retrieve it as XML or JSON, the invoice will be sent in the SI-UBL 1.1 format. This format is described on http://www.simplerinvoicing.org/ and is based on the larger specification UBL 2.1, which can be found at http://docs.oasis-open.org/ubl/UBL-2.1.html.

GET /services/rest/invoices/:invoice-id

Accept-headers

You can choose which format you with to receive the data in by setting the correct accept-header. The available formats are part of the result you get when using the Invoice List. And will be:

  • application/json
  • application/xml
  • application/pdf

Parameters

Name Type Description
invoice-id integer Required. This is the invoice id that’s given in the InvoiceListItem from the previous call.

Example request and response

GET /services/rest/invoices/78910
Status: 200 OK
<?xml version="1.0"encoding="UTF-8"standalone="yes"?>
<ns4:Invoicexmlns="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns:ns3="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:ns4="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
<UBLVersionID>2.1</UBLVersionID>
<CustomizationID>
urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol4a:ver2.0:extended:urn:www.simplerinvoicing.org:si:si-ubl:ver1.1.x
</CustomizationID>
<ProfileID>urn:www.cenbii.eu:profile:bii04:ver2.0</ProfileID>
<ID>78910</ID>
<IssueDate>2017-01-19+01:00</IssueDate>
<InvoiceTypeCodelistID="UNCL1001">380</InvoiceTypeCode>
<DocumentCurrencyCode>EUR</DocumentCurrencyCode>
<ns3:AccountingSupplierParty> <!-- Contact details of Bol.com -->
<ns3:Party>
<ns3:PartyIdentification>
<IDschemeID="NL:KVK">32147382</ID>
</ns3:PartyIdentification>
<ns3:PartyName>
<Name>Bol.com B.V.</Name>
</ns3:PartyName>
<ns3:PostalAddress>
<StreetName>Papendorpseweg</StreetName>
<BuildingNumber>100</BuildingNumber>
<CityName>Utrecht</CityName>
<PostalZone>3528 BJ</PostalZone>
<ns3:Country>
<IdentificationCodelistID="ISO3166-1:Alpha2"listAgencyID="6">NL</IdentificationCode>
</ns3:Country>
</ns3:PostalAddress>
<ns3:PartyTaxScheme>
<CompanyIDschemeID="NL:VAT"schemeAgencyID="ZZZ">NL820471616B01</CompanyID>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:PartyTaxScheme>
<ns3:PartyLegalEntity>
<CompanyIDschemeID="NL:KVK"schemeAgencyID="ZZZ">32147382</CompanyID>
</ns3:PartyLegalEntity>
<ns3:Contact>
<Name>Bol.com B.V.</Name>
<Telephone>+31 (0)30 6008888</Telephone>
</ns3:Contact>
</ns3:Party>
</ns3:AccountingSupplierParty>
<ns3:AccountingCustomerParty> <!-- Contact details of the retailer -->
<SupplierAssignedAccountID>1205373</SupplierAssignedAccountID>
<ns3:Party>
<ns3:PartyIdentification>
<IDschemeID="NL:KVK">8180178</ID>
</ns3:PartyIdentification>
<ns3:PartyName>
<Name>Pietje Bel Inc.</Name>
</ns3:PartyName>
<ns3:PostalAddress>
<StreetName>Lindelaan</StreetName>
<BuildingNumber>8</BuildingNumber>
<CityName>Ons Dorp</CityName>
<PostalZone>1234 AB</PostalZone>
<ns3:Country>
<IdentificationCodelistID="ISO3166-1:Alpha2"listAgencyID="6">NL</IdentificationCode>
</ns3:Country>
</ns3:PostalAddress>
<ns3:PartyTaxScheme>
<CompanyIDschemeID="NL:VAT"schemeAgencyID="ZZZ">10080178</CompanyID>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:PartyTaxScheme>
<ns3:PartyLegalEntity>
<CompanyIDschemeID="NL:KVK"schemeAgencyID="ZZZ">8180178</CompanyID>
</ns3:PartyLegalEntity>
<ns3:Contact>
<Name>Pietje Bel Inc.</Name>
</ns3:Contact>
</ns3:Party>
</ns3:AccountingCustomerParty>
<ns3:TaxTotal>
<TaxAmountcurrencyID="EUR">0.82</TaxAmount>
<ns3:TaxSubtotal>
<TaxableAmountcurrencyID="EUR">-25.00</TaxableAmount>
<TaxAmountcurrencyID="EUR">0.00</TaxAmount>
<ns3:TaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">B</ID>
<Percent>0.00</Percent>
<TaxExemptionReasonCodelistID="CWA 15577"listAgencyID="ZZZ">AAN</TaxExemptionReasonCode>
<TaxExemptionReason>Verkoopprijs artikel(en), ontvangen van kopers en door bol.com door te storten.
</TaxExemptionReason>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:TaxCategory>
</ns3:TaxSubtotal>
<ns3:TaxSubtotal>
<TaxableAmountcurrencyID="EUR">3.92</TaxableAmount>
<TaxAmountcurrencyID="EUR">0.82</TaxAmount>
<ns3:TaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">S</ID>
<Percent>21.00</Percent>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:TaxCategory>
</ns3:TaxSubtotal>
</ns3:TaxTotal>
<ns3:LegalMonetaryTotal>
<LineExtensionAmountcurrencyID="EUR">-21.08</LineExtensionAmount>
<TaxExclusiveAmountcurrencyID="EUR">-21.08</TaxExclusiveAmount>
<TaxInclusiveAmountcurrencyID="EUR">-20.26</TaxInclusiveAmount>
<PayableAmountcurrencyID="EUR">-20.26</PayableAmount>
</ns3:LegalMonetaryTotal>
<ns3:InvoiceLine>
<ID>78910#TURNOVER</ID> <!-- See table below for an explanation about InvoiceLine types -->
<InvoicedQuantityunitCode="ZZ"unitCodeListID="UNECERec20">1.00</InvoicedQuantity>
<LineExtensionAmountcurrencyID="EUR">-25.00</LineExtensionAmount>
<ns3:TaxTotal>
<TaxAmountcurrencyID="EUR">0.00</TaxAmount>
<ns3:TaxSubtotal>
<TaxableAmountcurrencyID="EUR">-25.00</TaxableAmount>
<TaxAmountcurrencyID="EUR">0.00</TaxAmount>
<ns3:TaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">B</ID>
<Percent>0.00</Percent>
<TaxExemptionReasonCodelistID="CWA 15577"listAgencyID="ZZZ">AAN</TaxExemptionReasonCode>
<TaxExemptionReason>Verkoopprijs artikel(en), ontvangen van kopers en door bol.com door te
storten.
</TaxExemptionReason>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:TaxCategory>
</ns3:TaxSubtotal>
</ns3:TaxTotal>
<ns3:Item>
<Description>Verkoopprijs artikel(en), ontvangen van kopers en door bol.com door te storten</Description>
<Name>TURNOVER</Name>
<ns3:ClassifiedTaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">B</ID>
<Percent>0.00</Percent>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:ClassifiedTaxCategory>
</ns3:Item>
<ns3:Price>
<PriceAmountcurrencyID="EUR">-25.00</PriceAmount>
<BaseQuantityunitCode="ZZ"unitCodeListID="UNECERec20">1.00</BaseQuantity>
</ns3:Price>
</ns3:InvoiceLine>
<ns3:InvoiceLine>
<ID>78910#COMMISSION</ID> <!-- See table below for an explanation about InvoiceLine types -->
<InvoicedQuantityunitCode="ZZ"unitCodeListID="UNECERec20">1.00</InvoicedQuantity>
<LineExtensionAmountcurrencyID="EUR">3.92</LineExtensionAmount>
<ns3:TaxTotal>
<TaxAmountcurrencyID="EUR">0.82</TaxAmount>
<ns3:TaxSubtotal>
<TaxableAmountcurrencyID="EUR">3.92</TaxableAmount>
<TaxAmountcurrencyID="EUR">0.82</TaxAmount>
<ns3:TaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">S</ID>
<Percent>21.00</Percent>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:TaxCategory>
</ns3:TaxSubtotal>
</ns3:TaxTotal>
<ns3:Item>
<Description>Bemiddelingsbijdrage</Description>
<Name>COMMISSION</Name>
<ns3:ClassifiedTaxCategory>
<IDschemeID="UNCL5305"schemeAgencyID="6">S</ID>
<Percent>21.00</Percent>
<ns3:TaxScheme>
<IDschemeID="UN/ECE 5153"schemeAgencyID="6">VAT</ID>
</ns3:TaxScheme>
</ns3:ClassifiedTaxCategory>
</ns3:Item>
<ns3:Price>
<PriceAmountcurrencyID="EUR">3.92</PriceAmount>
<BaseQuantityunitCode="ZZ"unitCodeListID="UNECERec20">1.00</BaseQuantity>
</ns3:Price>
</ns3:InvoiceLine>
</ns4:Invoice>

Note: Please refer to Appendix F for a list of Invoice line types.