{"id":5097,"date":"2025-05-28T14:05:45","date_gmt":"2025-05-28T12:05:45","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5097"},"modified":"2025-12-29T10:09:42","modified_gmt":"2025-12-29T09:09:42","slug":"changing-the-terms-of-the-order-after-their-acceptance","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/orders\/changing-the-terms-of-the-order-after-their-acceptance\/","title":{"rendered":"Changing terms of the order after their acceptance"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Description<\/h2>\n\n\n\n<p>This method allows you to to change the con\u00addi\u00adtions in an accept\u00aded trans\u00adport order. This is a key func\u00adtion\u00adal\u00adi\u00adty for logis\u00adtics and trans\u00adport com\u00adpa\u00adnies that often have to react to dynam\u00adic changes in trans\u00adport plans \u2013 such as cor\u00adrec\u00adtions to address\u00ades, dates, loading\/unloading times, or pay\u00adment terms.<\/p>\n\n\n\n<p><strong>Con\u00addi\u00adtions that we can change<\/strong>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>loads (can be send as emp\u00adty array)<\/li>\n\n\n\n<li>shipment_external_id<\/li>\n\n\n\n<li>oper\u00ada\u00adtions<\/li>\n\n\n\n<li>spots <\/li>\n\n\n\n<li>pay\u00adment <\/li>\n\n\n\n<li>require\u00adments<\/li>\n<\/ul>\n\n\n\n<p>After such oper\u00ada\u00adtion car\u00adri\u00ader will be able to accept order terms.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Url parameters and connection settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>URL:<\/strong>&nbsp;https:\/\/api.platform.trans.eu<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong>&nbsp;\/ext\/orders-api\/v2\/{OrderId}\/amendment\/draft<\/li>\n\n\n\n<li><strong>Method:<\/strong>&nbsp;POST<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Headers<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Con\u00adtent-type: application\/json<\/li>\n\n\n\n<li>Accept: application\/json<\/li>\n\n\n\n<li>Autho\u00adriza\u00adtion: Bear\u00ader {access_token}<\/li>\n\n\n\n<li>Api-key: {unique_ap\u00adp_api-key}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization and access<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process&nbsp;<a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>is described here<\/a>.&nbsp; Each API request must also con\u00adsist of unique Api-key obtained dur\u00ading appli\u00adca\u00adtion reg\u00adis\u00adtra\u00adtion togeth\u00ader with client_id and client_secret.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Update order request<\/h2>\n\n\n\n<p>Exam\u00adple of request for chang\u00ading terms.<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"freight\": {\n        \"loads\": [],\n        \"requirements\": {\n            \"transport\": {\n                \"type\": \"ltl\"\n            }\n        },\n        \"shipment_external_id\": \"123\",\n        \"spots\": [\n            {\n                \"spot_order\": 1,\n                \"place\": {\n                    \"address\": {\n                        \"locality\": \"Krak\u00f3w\",\n                        \"postal_code\": \"31-001\",\n                        \"country\": \"PL\"\n                    }\n                },\n                \"operations\": [\n                    {\n                        \"operation_order\": 1,\n                        \"loads\": [],\n                        \"type\": \"loading\",\n                        \"timespans\": {\n                            \"begin\": \"2025-01-22T13:00:00+0200\",\n                            \"end\": \"2025-01-22T14:00:00+0200\"\n                        }\n                    }\n                ]\n            },\n            {\n                \"spot_order\": 2,\n                \"place\": {\n                    \"address\": {\n                        \"locality\": \"D\u0105browa \u015arodkowa\",\n                        \"postal_code\": \"59-330\",\n                        \"country\": \"PL\"\n                    }\n                },\n                \"operations\": [\n                    {\n                        \"type\": \"unloading\",\n                        \"operation_order\": 1,\n                        \"loads\": [],\n                        \"timespans\": {\n                            \"begin\": \"2025-01-23T11:00:00+0200\",\n                            \"end\": \"2025-01-23T11:00:00+0200\"\n                        }\n                    }\n                ]\n            }\n        ]\n    },\n    \"additional_terms\": \"string\",\n    \"payment\": {\n        \"days\": 12,\n        \"price\": {\n            \"value\": 999999,\n            \"currency\": \"pln\"\n        }\n    }\n}<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Response<\/h2>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https:\/\/service.freight-orders.query:80\/api\/rest\/v1\/orders\/5f932ac1-6d3e-4cff-b3d4-2357df4e938a\/amendment-drafts\"\n        }\n    },\n    \"id\": \"df256b9f-ff3c-46e5-8054-a0ded4e3503d\"\n}<\/code><\/pre><\/div>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Descrip\u00adtion This method allows you to to change the con\u00addi\u00adtions in an accept\u00aded trans\u00adport order. This is a key func\u00adtion\u00adal\u00adi\u00adty \u2026<\/p>\n","protected":false},"author":12,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[87,50],"tags":[],"class_list":["post-5097","post","type-post","status-publish","format-standard","hentry","category-order-conditions","category-orders"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5097},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5097","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=5097"}],"version-history":[{"count":5,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5097\/revisions"}],"predecessor-version":[{"id":5455,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5097\/revisions\/5455"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5097"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5097"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5097"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}