{"id":5182,"date":"2025-07-23T09:41:06","date_gmt":"2025-07-23T07:41:06","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5182"},"modified":"2025-12-29T10:05:08","modified_gmt":"2025-12-29T09:05:08","slug":"creating-new-multifreight","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights\/creating-new-multifreight\/","title":{"rendered":"Creating multifreight"},"content":{"rendered":"\n<p>Mul\u00adti\u00adfreight allows pub\u00adlish\u00ading a freight offer that includes mul\u00adti\u00adple trans\u00adport oper\u00ada\u00adtions, with set\u00adtle\u00adment per route or per ton of car\u00adgo. <\/p>\n\n\n\n<!--more-->\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> https:\/\/api.platform.trans.eu<\/li>\n<\/ul>\n\n\n\n<p>You can use any pub\u00adlish\u00ading method:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>End\u00adpoint:<\/strong> \/ext<span style=\"font-weight: 400;\">\/freights-api\/v1\/freight-exchange<\/span><\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/freight-employ\u00adees<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v2\/freights<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/freight-com\u00adpa\u00adnies<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/freight-auto<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/pri\u00advate-exchange<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/freight-cor\u00adpo\u00adrate<\/li>\n\n\n\n<li><strong>Method:<\/strong> 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_app_api_key}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process is described <a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>here<\/a>.<\/p>\n\n\n\n<p><strong>Fields in requirements.transport<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong><strong>Json<\/strong><\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Descrip\u00adtion<\/strong><\/td><\/tr><tr><td>type<\/td><td>string<\/td><td>Always <strong>multi_ftl<\/strong> for mul\u00adti\u00adfreight.<\/td><\/tr><tr><td>set\u00adtle\u00adment<\/td><td>string<\/td><td>Set\u00adtle\u00adment method: <strong>route<\/strong> (per course) or <strong>ton<\/strong> (per ton).<\/td><\/tr><tr><td>settlement_basis<\/td><td>string<\/td><td>Required when <strong>set\u00adtle\u00adment = ton<\/strong>. Val\u00adues: load\u00ading, unload\u00ading.<\/td><\/tr><tr><td>schedule_type<\/td><td>string<\/td><td>Who defines sched\u00adule: car\u00adri\u00ader, ship\u00adper, togeth\u00ader.<\/td><\/tr><tr><td>count<\/td><td>inte\u00adger<\/td><td>Total num\u00adber of cours\u00ades.<\/td><\/tr><tr><td>total_weight<\/td><td>inte\u00adger<\/td><td>Total weight in tons. Required when set\u00adtle\u00adment = ton.<\/td><\/tr><tr><td>per_order_min<\/td><td>inte\u00adger<\/td><td>Min\u00adi\u00admum num\u00adber of cours\u00ades per car\u00adri\u00ader.<\/td><\/tr><tr><td>per_order_max<\/td><td>inte\u00adger<\/td><td>Max\u00adi\u00admum num\u00adber of cours\u00ades per car\u00adri\u00ader.<\/td><\/tr><tr><td>proposed_count<\/td><td>inte\u00adger<\/td><td>Pre\u00adferred num\u00adber of cours\u00ades per car\u00adri\u00ader.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Exam\u00adple request \u2013 Set\u00adtle\u00adment per Route<\/strong><\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"publish\": true,\n  \"capacity\": 24,\n  \"requirements\": {\n    \"transport\": {\n      \"type\": \"multi_ftl\",\n      \"settlement\": \"route\",\n      \"schedule_type\": \"carrier\",\n      \"per_order_min\": 4,\n      \"per_order_max\": 5,\n      \"proposed_count\": 4,\n      \"count\": 5\n    },\n    \"required_truck_bodies\": [\n      \"dump-truck\"\n    ]\n  },\n  \"loads\": [\n    {\n      \"load_id\": \"some-id\",\n      \"name\": \"Load name 1\",\n      \"amount\": 33,\n      \"type_of_load\": \"europalette\"\n    }\n  ],\n  \"spots\": [\n    {\n      \"name\": \"Some place\",\n      \"spot_order\": 1,\n      \"place\": {\n        \"address\": {\n          \"country\": \"pl\",\n          \"street\": \"Rac\u0142awicka\",\n          \"locality\": \"Wroc\u0142aw\",\n          \"postal_code\": \"53-146\"\n        },\n        \"coordinates\": {\n          \"latitude\": 51.085615,\n          \"longitude\": 17.0105\n        }\n      },\n      \"operations\": [\n        {\n          \"type\": \"loading\",\n          \"operation_order\": 1,\n          \"operation_time\": 15,\n          \"timespans\": {\n            \"end\": \"2024-04-03T13:10:00+0000\",\n            \"begin\": \"2024-04-03T13:10:00+0000\"\n          }\n        }\n      ]\n    },\n    {\n      \"name\": \"Other place\",\n      \"spot_order\": 2,\n      \"place\": {\n        \"address\": {\n          \"country\": \"de\",\n          \"street\": \"Aktienstra\u00dfe 177\",\n          \"locality\": \"Essen\",\n          \"postal_code\": \"45359\"\n        },\n        \"coordinates\": {\n          \"latitude\": 51.4518992,\n          \"longitude\": 6.9190441\n        }\n      },\n      \"operations\": [\n        {\n          \"type\": \"unloading\",\n          \"operation_order\": 1,\n          \"operation_time\": 15,\n          \"timespans\": {\n            \"end\": \"2024-04-04T13:10:00+0000\",\n            \"begin\": \"2024-04-04T13:10:00+0000\"\n          }\n        }\n      ]\n    }\n  ],\n  \"payment\": {\n    \"price\": {\n      \"value\": 100,\n      \"currency\": \"eur\"\n    }\n  }\n}<\/code><\/pre><\/div>\n\n\n\n<p><strong>Exam\u00adple Request \u2013 Set\u00adtle\u00adment per Ton<\/strong><\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"publish\": true,\n    \"capacity\": 24,\n    \"requirements\": {\n        \"transport\": {\n            \"type\": \"multi_ftl\",\n            \"settlement\": \"ton\",\n            \"settlement_basis\": \"loading\",\n            \"schedule_type\": \"carrier\",\n            \"count\": 5,\n            \"total_weight\": 120,\n            \"per_order_min\": 4,\n            \"per_order_max\": 5,\n            \"proposed_count\": 4\n        },\n        \"required_truck_bodies\": [\n            \"dump-truck\"\n        ]\n    },\n    \"loads\": [\n        {\n            \"load_id\": \"some-id\",\n            \"name\": \"Load name 1\",\n            \"amount\": 33,\n            \"type_of_load\": \"europalette\"\n        }\n    ],\n    \"spots\": [\n        {\n            \"name\": \"Some place\",\n            \"spot_order\": 1,\n            \"place\": {\n                \"address\": {\n                    \"country\": \"pl\",\n                    \"street\": \"Rac\u0142awicka\",\n                    \"locality\": \"Wroc\u0142aw\",\n                    \"postal_code\": \"53-146\"\n                },\n                \"coordinates\": {\n                    \"latitude\": 51.085615,\n                    \"longitude\": 17.0105\n                }\n            },\n            \"operations\": [\n                {\n                    \"type\": \"loading\",\n                    \"operation_order\": 1,\n                    \"operation_time\": 15,\n                    \"timespans\": {\n                        \"end\": \"2024-04-03T13:10:00+0000\",\n                        \"begin\": \"2024-04-03T13:10:00+0000\"\n                    }\n                }\n            ]\n        },\n        {\n            \"name\": \"Other place\",\n            \"spot_order\": 2,\n            \"place\": {\n                \"address\": {\n                    \"country\": \"de\",\n                    \"street\": \"Aktienstra\u00dfe 177\",\n                    \"locality\": \"Essen\",\n                    \"postal_code\": \"45359\"\n                },\n                \"coordinates\": {\n                    \"latitude\": 51.4518992,\n                    \"longitude\": 6.9190441\n                }\n            },\n            \"operations\": [\n                {\n                    \"type\": \"unloading\",\n                    \"operation_order\": 1,\n                    \"operation_time\": 15,\n                    \"timespans\": {\n                        \"end\": \"2024-04-04T13:10:00+0000\",\n                        \"begin\": \"2024-04-04T13:10:00+0000\"\n                    }\n                }\n            ]\n        }\n    ],\n    \"payment\": {\n        \"price\": {\n            \"value\": 100,\n            \"currency\": \"eur\"\n        }\n    }\n}<\/code><\/pre><\/div>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Mul\u00adti\u00adfreight allows pub\u00adlish\u00ading a freight offer that includes mul\u00adti\u00adple trans\u00adport oper\u00ada\u00adtions, with set\u00adtle\u00adment per route or per ton of car\u00adgo.<\/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":[83,42],"tags":[],"class_list":["post-5182","post","type-post","status-publish","format-standard","hentry","category-create-new-freight","category-freights"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5182},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5182","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=5182"}],"version-history":[{"count":6,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5182\/revisions"}],"predecessor-version":[{"id":5448,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5182\/revisions\/5448"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5182"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5182"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5182"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}