Structure of the order

Our system receives orders exclusively in an xsd-valid OpenTrans version 2.1 format .

 

Description of individual elements within the order

Order number (ORDER_ID):

  • We regenerate these for each API import and copy the customer order number sent to us by the foreign system into the field CUSTOMER_ORDER_REFERENCE-> ORDER_ID
  • ie in the ORDER sent to us, we copy the ORDER_ID to CUSTOMER_ORDER_REFERENCE-> ORDER_ID and generate an ITscope order number in the ORDER_ID


Participants (PARTIES):

  • Distributor as a supplier with the PartyID which is deposited in your system for the distributor.
  • Buyer therefore Invoice recipient PARTY_ROLE-> buyer with the PartyID which is stored in your system as customer number for the customer at the distributor.
  • Delivery recipient delivery, may differ from the buyer, possibly due to dropshipment

Partial delivery (PARTIAL_SHIPMENT_ALLOWED):

  • Set this field if the order is to be sent in partial deliveries
  • The field is defined as a mandatory field in OpenTrans, so it must be set to false


Dropshipment (UDX.DROPSHIPMENT):

  • Set this field when Dropshipment is desired. Must be coordinated with the distributor before.
  • This UDX field is NOT an optional field
  •  

End customer number (UDX.BUYORDERID.ENDCUSTOMER):

  • This field is the number that the end customer receives as an order number
  • This UDX field is an optional field


Own order number (UDX.BUYORDERID.SELFASSIGNED):

  • This field is the number that the buyer can order for himself (internal company order number)
  • This UDX field is an optional field


Distributor Product number (SUPPLIER_PID type = "supplier_specific"):

  • We search for the article to be ordered from this number.

 

Download sample order files

The file Example_ORDER_Testdistributor_Bestellung.xml is provided with HTML comments in order to better understand the structure of an ORDER. This file can also be used as a reference file for the test sending of an order via the ITscope API method business/deals/send to the Partner Test DistributorId 10000735.

The file Example_ORDER_Testdistributor_Bestellung_Dropshipment.xml is provided with HTML comments in order to better understand the structure of an ORDER. This file can also be used as a reference file for the test sending of an order via the ITscope API method business/deals/send to the Partner Test DistributorId 10000735. This order is a Dropshipment order.

 

Note: This page has been translated with the Google Translation Service.

Have more questions? Submit a request