{"id":2114,"date":"2020-09-23T13:55:20","date_gmt":"2020-09-23T13:55:20","guid":{"rendered":"https:\/\/support.itscope.hostpress.me\/?post_type=kb&#038;p=2114"},"modified":"2025-12-03T17:58:55","modified_gmt":"2025-12-03T15:58:55","slug":"structure-of-the-order-document-for-a-standard-purchase-order","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/structure-of-the-order-document-for-a-standard-purchase-order\/","title":{"rendered":"Structure of the ORDER document for a standard purchase order"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Structure of the order<\/h2>\n\n\n\n<p>Our system exclusively receives orders in an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">XSD-valid OpenTrans version 2.1 format<\/a>.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Description of the individual order elements<\/h2>\n\n\n\n<p><strong>Order number (ORDER_ID):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Own order number, maximum length: 18 characters.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;ORDER_INFO&gt;\n  &lt;!-- Unique order ID for the customer --&gt;\n  &lt;ORDER_ID&gt;ORDER_180801-004&lt;\/ORDER_ID&gt;<\/code><\/pre>\n\n\n\n<p><strong>Participants (PARTIES):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The distributor (as the supplier) with the PartyID that is deposited in your system for the distributor<\/li>\n\n\n\n<li>Buyer, i.e. invoice recipient, PARTY_ROLE->buyer with the PartyID that is deposited in your system as the customer number for the buyer<\/li>\n\n\n\n<li>Recipient of delivery, may differ from the buyer, for example due to drop shipment.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- MANDATORY: Delivery address for the order --&gt;\n&lt;PARTY&gt;\n  &lt;ns2:PARTY_ID type=\"supplier_specific\"&gt;123456&lt;\/ns2:PARTY_ID&gt;\n  &lt;PARTY_ROLE&gt;delivery&lt;\/PARTY_ROLE&gt;\n  &lt;ADDRESS&gt;\n    &lt;!-- MANDATORY: Company name --&gt;\n    &lt;ns2:NAME&gt;ITscope GmbH&lt;\/ns2:NAME&gt;\n    &lt;!-- Address supplement 1 --&gt;\n    &lt;ns2:NAME2&gt;5th floor&lt;\/ns2:NAME2&gt;\n    &lt;!-- Address supplement 2 --&gt;\n    &lt;ns2:NAME3&gt;Attn. Peter M\u00fcller&lt;\/ns2:NAME3&gt;\n    &lt;CONTACT_DETAILS&gt;\n      &lt;ns2:CONTACT_NAME&gt;Support&lt;\/ns2:CONTACT_NAME&gt;\n      &lt;ns2:FIRST_NAME&gt;ITscope&lt;\/ns2:FIRST_NAME&gt;\n      &lt;ns2:PHONE type=\"office\"&gt;+49 721\/6273760&lt;\/ns2:PHONE&gt;\n      &lt;ns2:EMAILS&gt;\n        &lt;ns2:EMAIL&gt;support@itscope.com&lt;\/ns2:EMAIL&gt;\n      &lt;\/ns2:EMAILS&gt;\n    &lt;\/CONTACT_DETAILS&gt;\n    &lt;ns2:STREET&gt;Ludwig-Erhard-Allee 20&lt;\/ns2:STREET&gt;\n    &lt;ns2:ZIP&gt;76131&lt;\/ns2:ZIP&gt;\n    &lt;ns2:CITY&gt;Karlsruhe&lt;\/ns2:CITY&gt;\n    &lt;ns2:COUNTRY&gt;Deutschland&lt;\/ns2:COUNTRY&gt;\n    &lt;ns2:COUNTRY_CODED&gt;DE&lt;\/ns2:COUNTRY_CODED&gt;\n  &lt;\/ADDRESS&gt;\n&lt;\/PARTY&gt;<\/code><\/pre>\n\n\n\n<p><strong>Partial delivery (PARTIAL_SHIPMENT_ALLOWED):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Set this field if the order is to be split into partial deliveries<\/li>\n\n\n\n<li>This field is defined as a mandatory field in OpenTrans, so it must be set to false as default value.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- Indication of whether partial delivery is allowed --&gt;\n&lt;PARTIAL_SHIPMENT_ALLOWED&gt;true&lt;\/PARTIAL_SHIPMENT_ALLOWED&gt;<\/code><\/pre>\n\n\n\n<p><strong>Delivery date (DELIVERY_DATE):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Set this field if the order is to be sent with a fixed or requested delivery date<\/li>\n\n\n\n<li>The attribute type=&#8221;fixed&#8221; indicates that it is a fixed delivery date, the value type=&#8221;optional&#8221; indicates that it is a requested delivery date.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;DELIVERY_DATE type=\"fixed\"&gt;\n  &lt;DELIVERY_START_DATE&gt;2021-10-22T00:00:00&lt;\/DELIVERY_START_DATE&gt;\n  &lt;DELIVERY_END_DATE&gt;2021-10-22T00:00:00&lt;\/DELIVERY_END_DATE&gt;\n&lt;\/DELIVERY_DATE&gt;<\/code><\/pre>\n\n\n\n<p><strong>Remarks at order level or item level:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Order remarks can be added at the top of the order or as item remarks directly attached to the item.<\/li>\n\n\n\n<li>The type attribute can be used to communicate different remark types to the seller.\n<ul class=\"wp-block-list\">\n<li>For example, DEP data or license contract IDs can also be sent via the item remarks.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;REMARKS&nbsp;type=\"general\"&gt;wie vereinbart...&lt;\/REMARKS&gt;<br>&lt;REMARKS&nbsp;type=\"general\"&gt;Adobe AccountID: abc1234&lt;\/REMARKS&gt;<br>&lt;REMARKS&nbsp;type=\"DEP\"&gt;DEPNummer: 1234&lt;\/REMARKS&gt;<\/code><\/pre>\n\n\n\n<p><strong>Own delivery note (UDX.DROPSHIPMENT):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This field must be set if shipping with your own delivery note (drop shipment) is desired. The custom delivery note can be requested from the respective supplier. Costs may be involved in this, meaning this should be coordinated in advance with the distributor.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;HEADER_UDX&gt;\n  &lt;!-- Own delivery note (i.e. drop shipping) should be used (true) \/ should NOT be used (false) --&gt;\n  &lt;UDX.DROPSHIPMENT&gt;true&lt;\/UDX.DROPSHIPMENT&gt;\n&lt;\/HEADER_UDX&gt;<\/code><\/pre>\n\n\n\n<p><strong>Customer order reference (CUSTOMER_ORDER_REFERENCE -&gt; ORDER_ID):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This field is the end customer&#8217;s order ID<\/li>\n\n\n\n<li>This field is optional.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;CUSTOMER_ORDER_REFERENCE&gt;\n&lt;!-- End customer order reference (the end order ID that is given to the end customer --&gt;\n  &lt;ORDER_ID&gt;ORDER_019203&lt;\/ORDER_ID&gt;\n&lt;\/CUSTOMER_ORDER_REFERENCE&gt;<\/code><\/pre>\n\n\n\n<p><strong>Distributor product number (SUPPLIER_PID type=&#8221;supplier_specific&#8221;):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This number is the supplier&#8217;s unique item number (SKU). We use this number to search for the item that is to be ordered. This information is given at line item level.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- Supplier's product ID - mandatory field --&gt;\n&lt;ns2:SUPPLIER_PID type=\"supplier_specific\"&gt;123002&lt;\/ns2:SUPPLIER_PID&gt;<\/code><\/pre>\n\n\n\n<p><strong>ITscope PUID (INTERNATIONAL_PID type=&#8221;itscope&#8221;):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This number is the ITscope product number. It is a unique reference to the ITscope product. This information is given at line item level.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- ITscope product ID - not a mandatory field --&gt;\n&lt;ns2:INTERNATIONAL_PID type=\"itscope\"&gt;6676919000&lt;\/ns2:INTERNATIONAL_PID&gt;<\/code><\/pre>\n\n\n\n<p><strong>Quote number for an order referencing to a quote (QUOTATION_ID):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This number is the unique quote number for a specific quote from the supplier. This information is given at line item level.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- Supplier quote reference --&gt;\n&lt;SOURCING_INFO&gt;\n&lt;!-- Distributor quote number - mandatory field --&gt;\n  &lt;QUOTATION_ID&gt;1040104240&lt;\/QUOTATION_ID&gt;\n&lt;\/SOURCING_INFO&gt;<\/code><\/pre>\n\n\n\n<p><strong>Project number for project orders (AGREEMENT_ID):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This number is the manufacturer project number for a project order. With this number, the Sales Team can assign the correct items to the corresponding manufacturer project. This information is given at line item level.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!-- Conditions for the project price --&gt;\n&lt;SOURCING_INFO&gt;\n&lt;!-- Distributor project\/quote number - not a mandatory field --&gt;\n  &lt;QUOTATION_ID&gt;1040104240&lt;\/QUOTATION_ID&gt;\n  &lt;AGREEMENT&gt;\n    &lt;!-- Manufacturer project number - Mandatory, so that the supplier can assign the project price --&gt;\n    &lt;ns2:<strong>AGREEMENT_ID<\/strong>&gt;HPPSK1234500&lt;\/ns2:<strong>AGREEMENT_ID<\/strong>&gt;\n    &lt;!-- Time period during which the project conditions are valid <meta charset=\"utf-8\">- not mandatory fields --&gt;\n    &lt;ns2:AGREEMENT_START_DATE&gt;2018-09-05T00:00:00&lt;\/ns2:AGREEMENT_START_DATE&gt;\n    &lt;ns2:AGREEMENT_END_DATE&gt;2019-12-31T00:00:00&lt;\/ns2:AGREEMENT_END_DATE&gt;\n    &lt;!-- End customer of the project item <meta charset=\"utf-8\">- not a mandatory field --&gt;\n    &lt;AGREEMENT_DESCR&gt;City of Karlsruhe&lt;\/AGREEMENT_DESCR&gt;\n  &lt;\/AGREEMENT&gt;\n&lt;\/SOURCING_INFO&gt;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Download sample order files<\/h2>\n\n\n\n<p>The sample order files linked at the end of this article contain XML comments (in German), in order to simplify the understanding of the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/business-deals-send-method\/\">structure of an ORDER<\/a>. These files can also be used as reference files, for sending a&nbsp;test order with the ITscope API method&nbsp;<strong><a href=\"https:\/\/guide.itscope.com\/en\/kb\/business-deals-send-method\/\">business\/deals\/send<\/a><\/strong> to the &#8216;Partner Test&#8217; (SupplierId 10000735).<\/p>\n\n\n\n<p>The file&nbsp;<strong><em>Example_ORDER_Testdistributor_Bestellung.xml<\/em>&nbsp;<\/strong>is an ordinary order.<\/p>\n\n\n\n<p>The file&nbsp;<strong><em>Example_ORDER_Testdistributor_Bestellung_Eigener_Lieferschein.xml<\/em> <\/strong>is an order with own delivery note (drop shipment).<\/p>\n\n\n\n<p>The file&nbsp;<strong><em>Example_ORDER_Testdistributor_Bestellung_Projekt.xml<\/em>&nbsp;<\/strong>is an order with a project price. The third line item in this sample contains exemplary project conditions. From this sample, it can be seen that it is possible to have a mix of different prices (&#8216;normal&#8217; or project prices) as well as different projects within the same order, as the project is specified on a line-by-line basis.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Structure of the order Our system exclusively receives orders in an&nbsp;XSD-valid OpenTrans version 2.1 format. Description of the individual order elements Order number (ORDER_ID): Participants (PARTIES): Partial delivery (PARTIAL_SHIPMENT_ALLOWED): Delivery &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[183],"kbtag":[],"class_list":["post-2114","kb","type-kb","status-publish","hentry","kbtopic-api-orders-quotes"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2114","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/comments?post=2114"}],"version-history":[{"count":8,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2114\/revisions"}],"predecessor-version":[{"id":19674,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2114\/revisions\/19674"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=2114"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=2114"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=2114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}