Retrieve an invoice specification

  1. This endpoint returns a specification of a specific invoice. All of the transactions that belong to a specific invoice will show up in the response below. We made the endpoint paginated because of the possibility that an invoice has hundreds, if not thousands, of transactions. The response body will use the UBL format standard.
GET /services/rest/invoices/invoice-id/specification
 

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
page integer default value=1.

Example request and response

GET /services/rest/invoices/invoice-id/specification?page=1
Status: 200 OK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <InvoiceSpecifications xmlns:ns2="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:ns3="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2">
    <InvoiceSpecification>
      <ID>514884517#1#TURNOVER</ID>
      <InvoiceLineRef>9891954#TURNOVER</InvoiceLineRef>
      <InvoicedQuantity unitCode="ZZ" unitCodeListID="UNECERec20">1.00</InvoicedQuantity>
      <LineExtensionAmount currencyID="EUR">-23.99</LineExtensionAmount>
      <TaxTotal>
        <ns2:TaxAmount currencyID="EUR">0.00</ns2:TaxAmount>
      </TaxTotal>
      <Item>
        <ns2:Description>Verkoopprijs artikel(en), ontvangen van kopers en door bol.com door te storten</ns2:Description>
        <ns2:Name>TURNOVER</ns2:Name>
        <ns3:ClassifiedTaxCategory>
          <ns2:ID schemeID="UNCL5305" schemeAgencyID="6">B</ns2:ID>
          <ns2:Percent>0.00</ns2:Percent>
          <ns3:TaxScheme>
            <ns2:ID schemeID="UN/ECE 5153" schemeAgencyID="6">VAT</ns2:ID>
          </ns3:TaxScheme>
        </ns3:ClassifiedTaxCategory>
        <ns3:AdditionalItemProperty>
          <ns2:Name>OrderId</ns2:Name>
          <ns2:Value>4118857880</ns2:Value>
        </ns3:AdditionalItemProperty>
        <ns3:AdditionalItemProperty>
          <ns2:Name>EAN</ns2:Name>
          <ns2:Value>8433325504083</ns2:Value>
        </ns3:AdditionalItemProperty>
      </Item>
      <Price>
        <ns2:PriceAmount currencyID="EUR">23.99</ns2:PriceAmount>
        <ns2:BaseQuantity unitCode="ZZ" unitCodeListID="UNECERec20">1.00</ns2:BaseQuantity>
      </Price>
  </InvoiceSpecification>
  <InvoiceSpecification>
      <ID>514884517#1#COMMISSION</ID>
      <InvoiceLineRef>9891954#COMMISSION</InvoiceLineRef>
      <InvoicedQuantity unitCode="ZZ" unitCodeListID="UNECERec20">1.00</InvoicedQuantity>
      <LineExtensionAmount currencyID="EUR">2.01</LineExtensionAmount>
      <TaxTotal>
        <ns2:TaxAmount currencyID="EUR">0.42</ns2:TaxAmount>
      </TaxTotal>
      <Item>
        <ns2:Description>Bemiddelingsbijdrage</ns2:Description>
        <ns2:Name>COMMISSION</ns2:Name>
        <ns3:ClassifiedTaxCategory>
          <ns2:ID schemeID="UNCL5305" schemeAgencyID="6">S</ns2:ID>
          <ns2:Percent>21.00</ns2:Percent>
          <ns3:TaxScheme>
            <ns2:ID schemeID="UN/ECE 5153" schemeAgencyID="6">VAT</ns2:ID>
          </ns3:TaxScheme>
        </ns3:ClassifiedTaxCategory>
        <ns3:AdditionalItemProperty>
          <ns2:Name>OrderId</ns2:Name>
          <ns2:Value>4118857880</ns2:Value>
        </ns3:AdditionalItemProperty>
        <ns3:AdditionalItemProperty>
          <ns2:Name>EAN</ns2:Name>
          <ns2:Value>8433325504083</ns2:Value>
        </ns3:AdditionalItemProperty>
      </Item>
      <Price>
        <ns2:PriceAmount currencyID="EUR">2.01</ns2:PriceAmount>
        <ns2:BaseQuantity unitCode="ZZ" unitCodeListID="UNECERec20">1.00</ns2:BaseQuantity>
      </Price>
  </InvoiceSpecification>
</InvoiceSpecifications>