{"id":4789,"date":"2023-07-13T12:23:35","date_gmt":"2023-07-13T10:23:35","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=4789"},"modified":"2025-12-29T10:39:21","modified_gmt":"2025-12-29T09:39:21","slug":"add-announcement","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/dock-scheduler\/announcements\/add-announcement\/","title":{"rendered":"Add announcement"},"content":{"rendered":"\n<p>This method allows you to add announce\u00adments on a sched\u00adule.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization and access<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process is described&nbsp;<a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>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<h2 class=\"wp-block-heading\">Url parameters and connection settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>URL:&nbsp;<\/strong>https:\/\/api.platform.trans.eu<\/li>\n\n\n\n<li><strong>End\u00adpoint: <\/strong>\/ex\u00adt\/\u00addock-sched\u00aduler-api\/v1\/an\u00adnounce\u00adment<\/li>\n\n\n\n<li><strong>Http 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>Accept: application\/json<\/li>\n\n\n\n<li>Con\u00adtent-type: 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\">Json request body example<\/h2>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"carrier_id\": 1013865,\n  \"date_from\": \"2023-07-14T08:00:00\",\n  \"date_to\": \"2023-07-14T10:00:00\",\n  \"external_reference_number\": \"123test\"  \n  \"ramp_id\": 2006,\n  \"warehouse_id\": 1567,\n  \"operation_type\": \"unloading\",\n  \"vehicle\": {\n    \"truck_plate_number\": \"123string\",\n    \"trailer_plate_number\": \"456string\",\n    \"vehicle_manufacturer\": \"SCANIA\",\n    \"combustion_norm\": \"EURO 6\"\n  },\n  \"driver\": {\n    \"full_name\": \"Jan Kowalski\",\n    \"phone_number\": \"+48888123456\",\n    \"country\": \"PL\",\n    \"languages\": [\n      \"Polish\"\n    ],\n    \"first_document\": {\n      \"issuing_authority\": \"string\",\n      \"number\": \"string\",\n      \"type\": \"IDENTITY_CARD\"\n    },\n    \"second_document\": {\n      \"issuing_authority\": \"string\",\n      \"number\": \"string\",\n      \"type\": \"IDENTITY_CARD\"\n    }\n  },\n  \"second_driver\": {\n    \"full_name\": \"Jan Kowalski\",\n    \"phone_number\": \"+48888123456\",\n    \"country\": \"PL\",\n    \"languages\": [\n      \"Polish\"\n    ],\n    \"first_document\": {\n      \"issuing_authority\": \"string\",\n      \"number\": \"string\",\n      \"type\": \"IDENTITY_CARD\"\n    },\n    \"second_document\": {\n      \"issuing_authority\": \"string\",\n      \"number\": \"string\",\n      \"type\": \"IDENTITY_CARD\"\n    }\n  },\n  \"remark\": \"Example note\",\n  \"remark_internal\": \"Example internal note\"\n}<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Json response example<\/h2>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"arrival_delay\": null,\n    \"attachments\": null,\n    \"cargo\": null,\n    \"carrier\": {\n        \"address\": {\n            \"country\": \"PL\",\n            \"locality\": \"Tcfwuroyni\",\n            \"postal_code\": \"53-604\",\n            \"street\": \"Kelkcvuw 93\",\n            \"street_address\": \"Kelkcvuw 93\"\n        },\n        \"email\": \"bdemczyszak@trans.eu\",\n        \"id\": 1013865,\n        \"legal_name\": \"Firma Testowa Przewo\u017anik IIT 2\",\n        \"subcontractor\": null,\n        \"telephone\": \"(0048) 633833929\",\n        \"type\": \"REGISTERED\"\n    },\n    \"date_from\": \"2023-07-14T08:00:00\",\n    \"date_to\": \"2023-07-14T10:00:00\",\n    \"driver\": {\n        \"country\": \"pl\",\n        \"first_document\": {\n            \"issuing_authority\": \"string\",\n            \"number\": \"string\",\n            \"type\": \"IDENTITY_CARD\"\n        },\n        \"full_name\": \"Jan Kowalski\",\n        \"languages\": [\n            \"Polish\"\n        ],\n        \"phone_number\": \"+48888123456\",\n        \"second_document\": {\n            \"issuing_authority\": \"string\",\n            \"number\": \"string\",\n            \"type\": \"IDENTITY_CARD\"\n        }\n    },\n    \"external_reference_number\": \"123test\",\n    \"id\": 38602,\n    \"notes\": null,\n    \"operation_time\": \"PT2H\",\n    \"operation_type\": \"unloading\",\n    \"ramp\": {\n        \"id\": 2006,\n        \"is_active\": true,\n        \"is_locked\": false,\n        \"name\": \"Suwnica A 1\",\n        \"operation_type\": \"unloading\",\n        \"ramp_type\": \"GANTRY\",\n        \"warehouse\": {\n            \"address\": {\n                \"coordinates\": {\n                    \"latitude\": 50,\n                    \"longitude\": 21\n                },\n                \"country\": \"pl\",\n                \"id\": 1705,\n                \"locality\": \"Wielog\u0142owy\",\n                \"name\": \"Magazyn Stali\",\n                \"number\": \"153\",\n                \"postal_code\": \"33-311\",\n                \"remarks\": null,\n                \"street\": \"Wielog\u0142owy\"\n            },\n            \"configurations\": [\n                {\n                    \"id\": 1812,\n                    \"quantity_of_slots\": 3,\n                    \"slot\": 15,\n                    \"valid_from\": \"2018-11-10\",\n                    \"valid_until\": null\n                }\n            ],\n            \"id\": 1567,\n            \"is_active\": true,\n            \"is_locked\": false,\n            \"name\": \"Magazyn Stali\",\n            \"operation_type\": \"any\",\n            \"quantity_of_slots\": 3,\n            \"rules_file_id\": null,\n            \"rules_file_name\": null,\n            \"rules_file_original_name\": null,\n            \"slot\": 15,\n            \"time_zone\": {\n                \"id\": \"Europe\/Warsaw\",\n                \"offset\": \"+02:00\",\n                \"offset_minutes\": 120\n            }\n        }\n    },\n    \"reference_number\": \"DS\/16365BE\/1\",\n    \"route\": {\n        \"spots\": [\n            {\n                \"address\": {\n                    \"coordinates\": {\n                        \"latitude\": 50,\n                        \"longitude\": 21\n                    },\n                    \"country\": \"pl\",\n                    \"locality\": \"Wielog\u0142owy\",\n                    \"name\": \"Magazyn Stali\",\n                    \"number\": \"153\",\n                    \"postal_code\": \"33-311\",\n                    \"street\": \"Wielog\u0142owy\"\n                },\n                \"operations\": [\n                    {\n                        \"operation_type\": \"unloading\",\n                        \"order\": 1,\n                        \"time_window_id\": null\n                    }\n                ],\n                \"order\": 1\n            }\n        ]\n    },\n    \"second_driver\": {\n        \"country\": \"pl\",\n        \"first_document\": {\n            \"issuing_authority\": \"string\",\n            \"number\": \"string\",\n            \"type\": \"IDENTITY_CARD\"\n        },\n        \"full_name\": \"Jan Kowalski\",\n        \"languages\": [\n            \"Polish\"\n        ],\n        \"phone_number\": \"+48888123456\",\n        \"second_document\": {\n            \"issuing_authority\": \"string\",\n            \"number\": \"string\",\n            \"type\": \"IDENTITY_CARD\"\n        }\n    },\n    \"shipper\": {\n        \"address\": {\n            \"country\": \"PL\",\n            \"locality\": \"Vhqwtwrqgi\",\n            \"postal_code\": \"74-507\",\n            \"street\": \"Orfaliko 03\",\n            \"street_address\": \"Orfaliko 03\"\n        },\n        \"email\": \"bde@trans.eu\",\n        \"id\": 1007386,\n        \"legal_name\": \"Firma Testowa Za\u0142adowca IIT\",\n        \"telephone\": \"(0048) 660490583\"\n    },\n    \"stage\": null,\n    \"status\": \"CONFIRMED\",\n    \"time_window\": null,\n    \"vehicle\": {\n        \"combustion_norm\": \"EURO 6\",\n        \"trailer_plate_number\": \"456string\",\n        \"truck_plate_number\": \"123string\",\n        \"vehicle_manufacturer\": \"SCANIA\",\n        \"weight\": null\n    }\n}<\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">This method allows you to add announce\u00adments on a sched\u00adule. Autho\u00adriza\u00adtion and access Autho\u00adriza\u00adtion process is described&nbsp;here. Each API request \u2026<\/p>\n","protected":false},"author":7,"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":[93],"tags":[],"class_list":["post-4789","post","type-post","status-publish","format-standard","hentry","category-announcements"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":4789},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/4789","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\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=4789"}],"version-history":[{"count":3,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/4789\/revisions"}],"predecessor-version":[{"id":5469,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/4789\/revisions\/5469"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=4789"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=4789"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=4789"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}