{"id":5227,"date":"2025-09-08T14:44:50","date_gmt":"2025-09-08T12:44:50","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5227"},"modified":"2025-12-29T10:03:52","modified_gmt":"2025-12-29T09:03:52","slug":"add-time-window-with-purchase-order","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/dock-scheduler\/add-time-window-with-purchase-order\/","title":{"rendered":"Add time window with purchase order"},"content":{"rendered":"\n

This method allows adding an order object<\/strong> to a defined time win\u00addow<\/strong>, togeth\u00ader with a com\u00adplete set of data regard\u00ading deliv\u00adery, busi\u00adness part\u00adner, and car\u00adgo<\/strong>. As a result, the sys\u00adtem can auto\u00admat\u00adi\u00adcal\u00adly link orders with the trans\u00adport sched\u00adule and logis\u00adtics process\u00ades<\/strong>.<\/p>\n\n\n\n

Authorization and access<\/h2>\n\n\n\n

Autho\u00adriza\u00adtion process is described here<\/a>. 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

Url parameters and connection settings<\/h2>\n\n\n\n
    \n
  • URL: <\/strong>https:\/\/api.platform.trans.eu<\/li>\n\n\n\n
  • End\u00adpoint:<\/strong> \/ex\u00adt\/\u00addock-sched\u00aduler-api\/v1\/ware\u00adhouse\u00ad\/\u00adtimeWin\u00addow<\/li>\n\n\n\n
  • Http Method:<\/strong> POST<\/li>\n<\/ul>\n\n\n\n

    Headers<\/h2>\n\n\n\n
      \n
    • Accept: application\/json<\/li>\n\n\n\n
    • Con\u00adtent-type: application\/json<\/li>\n\n\n\n
    • Autho\u00adriza\u00adtion: Bear\u00ader {access_token}<\/li>\n\n\n\n
    • Api-key: {unique_ap\u00adp_api-key}<\/li>\n<\/ul>\n\n\n\n

      Purchase order object<\/h2>\n\n\n\n
      \n
      \n
      \n
      \n
      \n
      Json<\/td>Descrip\u00adtion<\/td>Is required<\/td>Type<\/td><\/tr>
      purchase_order.number<\/td>Pur\u00adchase order num\u00adber (size must be between 0 and 50)<\/td>YES<\/td>string<\/td><\/tr>
      execution_constraints.delivery_date<\/td>Deliv\u00adery date<\/td>NO<\/td>date<\/td><\/tr>
      execution_constraints.delivery_time<\/td>Deliv\u00adery time<\/td>NO<\/td>time<\/td><\/tr>
      execution_constraints.delivery_conditions<\/td>Deliv\u00adery con\u00addi\u00adtions<\/td>NO<\/td>string<\/td><\/tr>
      execution_constraints.payment_conditions<\/td>Pay\u00adment con\u00addi\u00adtions<\/td>NO<\/td>string<\/td><\/tr>
      document.created_date<\/td>Cre\u00adation date<\/td>NO<\/td>time\u00adstamp<\/td><\/tr>
      document.author.created_by<\/td>Cre\u00adat\u00aded by<\/td>NO<\/td>string<\/td><\/tr>
      document.author.phone<\/td>Phone num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      document.author.email<\/td>Email address<\/td>NO<\/td>string<\/td><\/tr>
      delivery_place.receiver_name<\/td>Receiv\u00ader name<\/td>NO<\/td>string<\/td><\/tr>
      delivery_place.country<\/td>Coun\u00adtry<\/td>NO<\/td>string<\/td><\/tr>
      delivery_place.city<\/td>City<\/td>NO<\/td>string<\/td><\/tr>
      delivery_place.postal_code<\/td>Postal code<\/td>NO<\/td>string<\/td><\/tr>
      delivery_place.street<\/td>Street<\/td>NO<\/td>string<\/td><\/tr>
      business_partner.number<\/td>Busi\u00adness part\u00adner num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      business_partner.name<\/td>Busi\u00adness part\u00adner name<\/td>NO<\/td>string<\/td><\/tr>
      business_partner.tax_id<\/td>Tax iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      business_partner.contact_person<\/td>Con\u00adtact per\u00adson<\/td>NO<\/td>string<\/td><\/tr>
      shipment_document.number<\/td>Ship\u00adment doc\u00adu\u00adment num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      invoice.number<\/td>Invoice num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      warehouse_issue.number<\/td>Ware\u00adhouse issue (WZ)<\/td>NO<\/td>string<\/td><\/tr>
      loads.name<\/td>Car\u00adgo name<\/td>NO<\/td>string<\/td><\/tr>
      loads.type<\/td>Car\u00adgo type<\/td>NO<\/td>string<\/td><\/tr>
      loads.quantity<\/td>Car\u00adgo quan\u00adti\u00adty<\/td>NO<\/td>inte\u00adger<\/td><\/tr>
      loads.weight<\/td>Total weight<\/td>NO<\/td>dec\u00adi\u00admal<\/td><\/tr>
      loads.reference_number<\/td>Car\u00adgo ref\u00ader\u00adence num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      loads.warehouse_unit<\/td>Ware\u00adhouse unit<\/td>NO<\/td>string<\/td><\/tr>
      loads.category<\/td>Car\u00adgo cat\u00ade\u00adgo\u00adry<\/td>NO<\/td>string<\/td><\/tr>
      loads.business_partner_load_number<\/td>Busi\u00adness part\u00adner load num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      loads.commercial_number<\/td>Com\u00admer\u00adcial car\u00adgo num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      loads.forwarding_number<\/td>For\u00adward\u00ading num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      loads.container_number<\/td>Con\u00adtain\u00ader num\u00adber<\/td>NO<\/td>string<\/td><\/tr>
      loads.description<\/td>Car\u00adgo descrip\u00adtion<\/td>NO<\/td>string<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
      <\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n

      Request exam\u00adple<\/p>\n\n\n\n

      {\n    \"valid_from\": \"2025-09-08\",\n    \"valid_to\": \"2025-09-08\",\n    \"start_time\": \"12:00:00\",\n    \"end_time\": \"18:00:00\",\n    \"remarks\": \"Test remark !@#$\",\n    \"range_type\": \"CYCLE\",\n    \"external_number\": \"1DX124DAW7871\",\n    \"carrier\": {\n        \"id\": 956529\n    },\n    \"purchase_order\": {\n        \"number\": \"purchase_order_number_46be0354e8ef\",\n        \"execution_constraints\": {\n            \"delivery_date\": \"2025-04-22\",\n            \"delivery_time\": \"14:50:19\",\n            \"delivery_conditions\": \"delivery_conditions_13f786506c62\",\n            \"payment_conditions\": \"payment_conditions_d3bc906c82b5\"\n        },\n        \"document\": {\n            \"created_date\": \"2099-01-05\",\n            \"author\": {\n                \"created_by\": \"Lincoln\",\n                \"phone\": \"0048 600600600\",\n                \"email\": \"lincoln@ford.com\"\n            }\n        },\n        \"delivery_place\": {\n            \"receiver_name\": \"receiver_name_fdcb53f26f0a\",\n            \"country\": \"country_48771b243932\",\n            \"city\": \"city_3db029c3ec4e\",\n            \"postal_code\": \"41a3e0797\",\n            \"street\": \"street_46cd2d92845b\"\n        },\n        \"business_partner\": {\n            \"number\": \"number_ca724db783c2\",\n            \"name\": \"name_a95a422817f1\",\n            \"tax_id\": \"tax_id_fae3d33b3bf7\",\n            \"contact_person\": \"contact_person_d985cf6abd8f\"\n        },\n        \"shipment_document\": {\n            \"number\": \"number_aa63e54e69ad\"\n        },\n        \"invoice\": {\n            \"number\": \"number_2f9bf43ad4c5\"\n        },\n        \"warehouse_issue\": {\n            \"number\": \"number_9db7225e175e\"\n        },\n        \"loads\": [\n            {\n                \"name\": \"name_ed0283531277\",\n                \"type\": \"type_37c574fa8fbc\",\n                \"quantity\": \"501\",\n                \"weight\": \"11\",\n                \"reference_number\": \"reference_number_0240404aedbf\",\n                \"warehouse_unit\": \"warehouse_unit_5e1adda5f496\",\n                \"category\": \"category_f660ad4f3d7c\",\n                \"business_partner_load_number\": \"business_partner_load_number_a7bb99929090\",\n                \"commercial_number\": \"commercial_number_e8fc8ee76056\",\n                \"forwarding_number\": \"forwarding_number_84ee71ccbda3\",\n                \"container_number\": \"container_number_ef12a0a869c8\",\n                \"description\": \"description_e68ae86cdffa\"\n            },\n            {\n                \"name\": \"name_ed0283531277_v2\",\n                \"type\": \"type_37c574fa8fbc_v2\",\n                \"quantity\": \"5012\",\n                \"weight\": \"112\",\n                \"reference_number\": \"reference_number_0240404aedbf_v2\",\n                \"warehouse_unit\": \"warehouse_unit_5e1adda5f496_v2\",\n                \"category\": \"category_f660ad4f3d7c_v2\",\n                \"business_partner_load_number\": \"business_partner_load_number_a7bb99929090_v2\",\n                \"commercial_number\": \"commercial_number_e8fc8ee76056_v2\",\n                \"forwarding_number\": \"forwarding_number_84ee71ccbda3_v2\",\n                \"container_number\": \"container_number_ef12a0a869c8_v2\",\n                \"description\": \"description_e68ae86cdffa_v2\"\n            }\n        ]\n    },\n    \"route\": {\n        \"spots\": [\n            {\n                \"warehouse_id\": 6596,\n                \"order\": 1,\n                \"address\": {\n                    \"country\": \"af\",\n                    \"locality\": \"Kabul\",\n                    \"street\": \"Testing Street\",\n                    \"number\": \"12T\",\n                    \"name\": \"Cypresss\",\n                    \"remarks\": null,\n                    \"postal_code\": \"1002\"\n                },\n                \"operations\": [\n                    {\n                        \"operation_type\": \"loading\",\n                        \"order\": 1,\n                        \"belongs_to_time_window\": true\n                    }\n                ]\n            }\n        ]\n    }\n}<\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"
      This method allows adding an order object to a defined time win\u00addow, togeth\u00ader with a com\u00adplete set of data regard\u00ading \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":[68,89],"tags":[],"class_list":["post-5227","post","type-post","status-publish","format-standard","hentry","category-dock-scheduler","category-time-window"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5227},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5227","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=5227"}],"version-history":[{"count":6,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5227\/revisions"}],"predecessor-version":[{"id":5446,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5227\/revisions\/5446"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5227"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5227"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5227"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}