Order response documents (orderResponse, dispatchNotification, invoice)

General

• ORDERRESPONSE – order response document that is sent back to ITscope by many suppliers. Depending on the supplier, different information about the current status of the order processing is displayed:

1. The supplier order ID, for any follow up questions that may arise, e.g.:

 <ORDERRESPONSE_INFO>
   <ORDERRESPONSE_DATE>2018-05-25</ORDERRESPONSE_DATE>
   <ORDER_DATE>2018-05-25</ORDER_DATE>
   <SUPPLIER_ORDER_ID>1970218</SUPPLIER_ORDER_ID>

2. Estimated (type=optional) or fixed (type=fixed) delivery outbound time window from distributor per item e.g.:

<ORDERRESPONSE_ITEM>
 <LINE_ITEM_ID>1</LINE_ITEM_ID>
 ....
    <DELIVERY_DATE type="optional">
      <DELIVERY_START_DATE>2018-05-25</DELIVERY_START_DATE>
      <DELIVERY_END_DATE>2018-05-25</DELIVERY_END_DATE>
    </DELIVERY_DATE>
 ....

3. Cancellation of a line item (Quantity <= 0). If all items are cancelled, the order is cancelled completely

<ORDERRESPONSE_ITEM>
 <LINE_ITEM_ID>1</LINE_ITEM_ID>
 ....
   <QUANTITY>0</QUANTITY>
 ....

• DISPATCHNOTFICATION – dispatch notification document, which is sent back to ITscope by many suppliers. Depending on the supplier, different information about the shipping of the goods is given:

1. Shipment tracking numbers including the transportation company (remarks type = ‘delivererCode’). The following transport company codes are supported. DACHSER, DB SCHENKER, Deutsche Post, DHL, DPD, ENGLMAYER, FEDEX, GLS, HERMES, TOF (Trans-O-Flex), TNT, UPS. We can add further transport companies on request.

<LOGISTIC_DETAILS_INFO>
 <PACKAGE_INFO>
   <PACKAGE>
    <PACKAGE_ID>00000000305474401482</PACKAGE_ID>
    <PACKAGE_DESCR>Parcel</PACKAGE_DESCR>
    <PACKAGE_ORDER_UNIT_QUANTITY>3</PACKAGE_ORDER_UNIT_QUANTITY>
    <PACKAGE_DIMENSIONS>
      <ns2:WEIGHT>0.36</ns2:WEIGHT>
    </PACKAGE_DIMENSIONS>
   </PACKAGE>
  </PACKAGE_INFO>
 </LOGISTIC_DETAILS_INFO>
 <REMARKS type="delivererCode">Trans-O-Flex GmbH &amp; Co. KG</REMARKS>

2. Serial numbers for each item. There may be different serial number types for mobile phones, e.g. Imei and Imei2. If no type is given, it is a normal serial number.

<DISPATCHNOTIFICATION_ITEM>
 <LINE_ITEM_ID>1</LINE_ITEM_ID>
 <PRODUCT_ID>
   <ns2:SUPPLIER_PID type="supplier_specific">123002</ns2:SUPPLIER_PID>
   <SERIAL_NUMBER>123002-001</SERIAL_NUMBER>
   <SERIAL_NUMBER type="imei">123002-001-imei</SERIAL_NUMBER>
   <SERIAL_NUMBER type="imei2">123002-001-imei2</SERIAL_NUMBER>

3. Estimated (type=optional) or fixed (type=fixed) delivery window from distributor for each delivery note

<DISPATCHNOTIFICATION_INFO>
  <DISPATCHNOTIFICATION_ID>2457985</DISPATCHNOTIFICATION_ID>
  <DISPATCHNOTIFICATION_DATE>2021-04-26</DISPATCHNOTIFICATION_DATE>
  <DELIVERY_DATE type="fixed">
    <DELIVERY_START_DATE>2021-04-26</DELIVERY_START_DATE>
    <DELIVERY_END_DATE>2021-04-27</DELIVERY_END_DATE>
  </DELIVERY_DATE>

4. Delivery note number

<DISPATCHNOTIFICATION_INFO>
  <DISPATCHNOTIFICATION_ID>2457985</DISPATCHNOTIFICATION_ID>

• INVOICE – the invoice document that is sent back to ITscope by many suppliers. Depending on the supplier, different information is given for the calculation of the goods.

1. Invoice number

<INVOICE_INFO>
  <INVOICE_ID>3087450</INVOICE_ID>
  <INVOICE_DATE>2021-06-14</INVOICE_DATE>

2. Reference to the order at invoice header level

  <ORDER_HISTORY>
    <ORDER_ID>ABC-210611-12345</ORDER_ID>
  </ORDER_HISTORY>
</INVOICE_HEADER>

3. Reference to the order at item level, the item number for the order must be specified here

<INVOICE_ITEM>
  <LINE_ITEM_ID>1</LINE_ITEM_ID>
...
  <ORDER_REFERENCE>
    <ORDER_ID>ABC-210611-12345</ORDER_ID>
    <LINE_ITEM_ID>1</LINE_ITEM_ID>
  </ORDER_REFERENCE>
....

4. Additional costs as ALLOW_OR_CHARGE_FIX entries in the Invoice Summary

<INVOICE_SUMMARY>
  <TOTAL_ITEM_NUM>1</TOTAL_ITEM_NUM>
...
  <ALLOW_OR_CHARGES_FIX>
    <ALLOW_OR_CHARGE type="surcharge">
      <ALLOW_OR_CHARGE_TYPE>Shipping costs</ALLOW_OR_CHARGE_TYPE>
      <ALLOW_OR_CHARGE_VALUE>
        <AOC_MONETARY_AMOUNT>6.0</AOC_MONETARY_AMOUNT>
      </ALLOW_OR_CHARGE_VALUE>
    </ALLOW_OR_CHARGE>
    <ALLOW_OR_CHARGE type="surcharge">
      <ALLOW_OR_CHARGE_TYPE>Insurance</ALLOW_OR_CHARGE_TYPE>
      <ALLOW_OR_CHARGE_VALUE>
        <AOC_MONETARY_AMOUNT>2.0</AOC_MONETARY_AMOUNT>
      </ALLOW_OR_CHARGE_VALUE>
    </ALLOW_OR_CHARGE>
    <ALLOW_OR_CHARGES_TOTAL_AMOUNT>8.0</ALLOW_OR_CHARGES_TOTAL_AMOUNT>
  </ALLOW_OR_CHARGES_FIX>

5. Additional costs as an additional invoice item

<INVOICE_ITEM>
  <LINE_ITEM_ID>2</LINE_ITEM_ID>
  <PRODUCT_ID>
    <ns2:SUPPLIER_PID>PCS000001</ns2:SUPPLIER_PID>
    <ns2:DESCRIPTION_SHORT>Shipping and processing costs</ns2:DESCRIPTION_SHORT>
  </PRODUCT_ID>
  <QUANTITY>1</QUANTITY>
  <ns2:ORDER_UNIT>C62</ns2:ORDER_UNIT>
  <PRODUCT_PRICE_FIX>
    <ns2:PRICE_AMOUNT>4.00</ns2:PRICE_AMOUNT>
  </PRODUCT_PRICE_FIX>
  <PRICE_LINE_AMOUNT>4.00</PRICE_LINE_AMOUNT>
  <ORDER_REFERENCE>
    <ORDER_ID>ABC-210611-12345</ORDER_ID>
    <LINE_ITEM_ID>2</LINE_ITEM_ID>
  </ORDER_REFERENCE>
</INVOICE_ITEM>

Download sample order response documents