{"id":2180,"date":"2020-09-24T10:35:40","date_gmt":"2020-09-24T10:35:40","guid":{"rendered":"https:\/\/support.itscope.hostpress.me\/?post_type=kb&#038;p=2180"},"modified":"2024-08-02T17:50:33","modified_gmt":"2024-08-02T15:50:33","slug":"business-documents-method","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/business-documents-method\/","title":{"rendered":"business\/documents method"},"content":{"rendered":"\n<p>This method allows&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> documents to be retrieved for existing orders and quotes. The corresponding transaction IDs can be obtained using the respective <a href=\"https:\/\/guide.itscope.com\/en\/kb\/business-deals-methods\/\"><em>business\/deals<\/em><\/a> or <a href=\"https:\/\/guide.itscope.com\/en\/kb\/business-quotes-methods\/\">business\/quotes<\/a> API methods.<br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"1\">OpenTrans 2.1 ORDER download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> ORDER document for an ITscope order that has already been created or sent, using the transaction ID &#8216;<em>acb-sxf-sswa-1241541&#8242;:<\/em><\/p>\n\n\n\n<p><a href=\"https:\/\/api.itscope.com\/2.0\/business\/documents\/acb-sxf-sswa-1241541\/ORDER.xml\">https:\/\/api.itscope.com\/2.0\/business\/documents\/acb-sxf-sswa-1241541\/ORDER.xml<\/a><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"2\">OpenTrans 2.1 ORDERRESPONSE download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> ORDERRESPONSE document for an ITscope order that has already been sent, using the transaction ID &#8216;<em>acb-sxf-bbaaa-35461541&#8242;:<\/em><\/p>\n\n\n\n<p><a href=\"https:\/\/api.itscope.com\/2.0\/business\/documents\/acb-sxf-bbaaa-35461541\/ORDERRESPONSE.xml\">https:\/\/api.itscope.com\/2.0\/business\/documents\/acb-sxf-bbaaa-35461541\/ORDERRESPONSE.xml<\/a><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"3\">OpenTrans 2.1 DISPATCHNOTIFICATION download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> DISPATCHNOTIFICATION document for an ITscope order that has already been sent, using the transaction ID &#8216;<em>bdh-aur-bbey-887523435&#8242;:<\/em><\/p>\n\n\n\n<p><em>https:\/\/api.itscope.com\/2.0\/business\/documents\/bdh -aur-bbey-887523435 \/DISPATCHNOTIFICATION.xml<\/em><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"4\">OpenTrans 2.1 INVOICE download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> INVOICE document for an ITscope order that has already been sent, using the transaction ID &#8216;<em>buik-oikje-uiohd-98792874&#8242;:<\/em><\/p>\n\n\n\n<p><em>https:\/\/api.itscope.com\/2.0\/business\/documents\/ buik-oikje-uiohd-98792874 \/INVOICE.xml<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">ZUGFerd Download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/www.ferd-net.de\/\">ZUGFerd<\/a> Invoide pdf document for an ITscope order that has already been sent, using the transaction ID &#8216;<em>buik-oikje-uiohd-98792874&#8242;:<\/em>  The <a href=\"https:\/\/www.ferd-net.de\/\">ZUGFerd<\/a> Format will be only available from specific <a href=\"https:\/\/guide.itscope.com\/en\/kb\/edi-order-service\/\">suppliers<\/a>.<\/p>\n\n\n\n<p>Bsp:&nbsp;<em>https:\/\/api.itscope.com\/2.0\/business\/documents\/buik-oikje-uiohd-98792874\/INVOICE.pdf<\/em><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"5\">OpenTrans 2.1 QUOTATION download<\/h2>\n\n\n\n<p>The following URL is an example of retrieving an&nbsp;<a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> QUOTATION document for an ITscope order that has already been created or sent, using the transaction ID &#8216;<em>123-agfa-1254-579a653bd&#8217;:<\/em><\/p>\n\n\n\n<p><a href=\"https:\/\/api.itscope.com\/2.0\/business\/documents\/123-agfa-1254-579a653bd\/QUOTATION.xml\">https:\/\/api.itscope.com\/2.0\/business\/documents\/123-agfa-1254-579a653bd\/QUOTATION.xml<\/a><br><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"6\">Semantic validation of OpenTrans 2.1 order and order response documents against the OpenTrans XSD schema<\/h2>\n\n\n\n<p>This can be used to validate all order and response documents in <a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> format during development or before sending via our API. Here only a semantic validation takes place against the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> XSD schema.<\/p>\n\n\n\n<p>This concerns the following documents<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> ORDER document in XML format<\/li>\n\n\n\n<li><a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> ORDERRESPONSE document in XML format<\/li>\n\n\n\n<li><a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> DISPATCHNOTIFICATION document in XML format<\/li>\n\n\n\n<li><a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> INVOICE document in XML format<\/li>\n<\/ul>\n\n\n\n<p>In case of an incorrect document, the lines and column numbers that led to an invalid result are listed in the error outputs.<\/p>\n\n\n\n<p>Example.:\u00a0<em>https:\/\/api.itscope.com\/2.0\/business\/documents\/validateschema<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Semantic and content validation of the OpenTrans 2.1 ORDER order document before sending an order to a supplier<\/h2>\n\n\n\n<p>This method can only be used to validate the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> ORDER document, i.e. the order via API.<\/p>\n\n\n\n<p>This method requires a correct order document that is addressed to a supplier listed in ITscope. On the one hand, a semantic validation takes place against the <a href=\"https:\/\/guide.itscope.com\/en\/kb\/order-and-quote-data-in-opentrans-2-1-format\/\">OpenTrans 2.1<\/a> XSD schema, but also an additional content check of the document in relation to certain settings of the supplier from whom the order is to be placed. (e.g. article numbers, prices, addresses, and also whether the necessary services for the supplier are all set up correctly in ITscope.<\/p>\n\n\n\n<p><strong>We only recommend using this method if you want to make sure that the order will go through without errors before sending a real LIVE order to a supplier.<\/strong><\/p>\n\n\n\n<p>In the event of an incorrect document, the rows and column numbers that led to an invalid result are listed in the error outputs<\/p>\n\n\n\n<p>Example: <em>https:\/\/api.itscope.com\/2.0\/business\/documents\/validate<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This method allows&nbsp;OpenTrans 2.1 documents to be retrieved for existing orders and quotes. The corresponding transaction IDs can be obtained using the respective business\/deals or business\/quotes API methods. OpenTrans 2.1 &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[181],"kbtag":[],"class_list":["post-2180","kb","type-kb","status-publish","hentry","kbtopic-api-methods-business"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2180","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=2180"}],"version-history":[{"count":5,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2180\/revisions"}],"predecessor-version":[{"id":16723,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/2180\/revisions\/16723"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=2180"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=2180"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=2180"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}