{"id":1168,"date":"2019-11-05T09:57:50","date_gmt":"2019-11-05T08:57:50","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=1168"},"modified":"2026-01-08T12:10:02","modified_gmt":"2026-01-08T11:10:02","slug":"freight-description","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights\/freight-description\/","title":{"rendered":"Freight description"},"content":{"rendered":"\n

Descrip\u00adtion of freight ele\u00adments with the usage and con\u00addi\u00adtions.<\/p>\n\n\n\n\n\n\n\n

Freight allows to search for the best car\u00adri\u00aders for giv\u00aden ship\u00adment. You can use pub\u00adli\u00adca\u00adtion to select\u00aded com\u00adpa\u00adnies, automa\u00adtion rules pre\u00advi\u00adous\u00adly cre\u00adat\u00aded at Plat\u00adform or pub\u00adli\u00adca\u00adtion to freight exchange. <\/p>\n\n\n\n

Creating new freight<\/h2>\n\n\n\n

With the use of Trans.eu API it is pos\u00adsi\u00adble to cre\u00adate new own freight, dis\u00adplayed at Trans.eu Plat\u00adform in Freights Sent<\/strong> mod\u00adule. After the freight is cre\u00adat\u00aded, it is also pos\u00adsi\u00adble to update it\u2019s con\u00adtent if it was not yet pub\u00adlished.<\/p>\n\n\n\n

<\/figure>\n\n\n\n

Freight publication<\/h2>\n\n\n\n

If a freight was not pub\u00adlished, it is not vis\u00adi\u00adble to oth\u00ader Trans.eu users. For a freight to be suc\u00adcess\u00adful\u00adly pub\u00adlished it has to meet sev\u00ader\u00adal cri\u00adte\u00adria:<\/p>\n\n\n\n

    \n
  • the \u201cpub\u00adlish\u201d para\u00adme\u00adter must be set to \u201ctrue\u201d<\/li>\n\n\n\n
  • if a freight is being pub\u00adlished to select\u00aded com\u00adpa\u00adnies, at least one of com\u00adpa\u00adny id\u2019s must be valid<\/li>\n\n\n\n
  • if freight is being pub\u00adlished using automa\u00adtion rules, at least one automa\u00adtion rule must be cre\u00adat\u00aded and active at Plat\u00adform<\/li>\n<\/ul>\n\n\n\n

    Freight price<\/h2>\n\n\n\n

    Depend\u00ading of method and freight sta\u00adtus, there are three dif\u00adfer\u00adent para\u00adme\u00adters relat\u00aded to freight price:<\/p>\n\n\n\n

      \n
    • pay\u00adment  \u2014 ini\u00adtial freight price for pub\u00adli\u00adca\u00adtion using freight exchange, smart match and groups<\/li>\n\n\n\n
    • publication_price \u2014 freight price set dur\u00ading pub\u00adli\u00adca\u00adtion<\/li>\n\n\n\n
    • accepted_price \u2014 freight price agreed upon dur\u00ading nego\u00adti\u00ada\u00adtion process, the final freight price<\/li>\n<\/ul>\n\n\n\n

      Components of a single freight<\/h2>\n\n\n\n

      Each freight con\u00adsists of:<\/p>\n\n\n\n

        \n
      • sum\u00adma\u00adry and require\u00adments<\/li>\n\n\n\n
      • pub\u00adli\u00adca\u00adtion sta\u00adtus<\/li>\n\n\n\n
      • car\u00adri\u00ader infor\u00adma\u00adtion, avail\u00adable to be read after the accep\u00adtance of freight<\/li>\n\n\n\n
      • list of loads<\/li>\n\n\n\n
      • spots, which are divid\u00aded into:\n
          \n
        • address\u00ades<\/li>\n\n\n\n
        • oper\u00ada\u00adtions<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

          Validation rules<\/h2>\n\n\n\n

          Most impor\u00adtant val\u00adi\u00adda\u00adtion rules con\u00adsid\u00ader\u00ading freight pub\u00adli\u00adca\u00adtion<\/p>\n\n\n\n

            \n
          • all dates<\/strong> must be greater or equal today<\/li>\n\n\n\n
          • first oper\u00ada\u00adtion date<\/strong> has to be low\u00ader than last oper\u00ada\u00adtion date<\/li>\n\n\n\n
          • first oper\u00ada\u00adtion<\/strong> always has to be load\u00ading<\/li>\n\n\n\n
          • last oper\u00ada\u00adtion<\/strong> always has to be unload\u00ading<\/li>\n\n\n\n
          • each spot<\/strong> has own sequence of oper\u00ada\u00adtions per\u00adformed, there\u00adfore in each spot first oper\u00ada\u00adtion always has operation_order set to 1<\/li>\n\n\n\n
          • address<\/strong> must con\u00adsists of coun\u00adtry, postal code and local\u00adi\u00adty<\/li>\n\n\n\n
          • for list of required fields please refer to struc\u00adture of post\u00ading new freight below<\/li>\n<\/ul>\n\n\n\n

            Date Format<\/h3>\n\n\n\n

            All dates and times in the API are returned in the ISO 8601<\/strong> for\u00admat.<\/p>\n\n\n\n

            Exam\u00adple:<\/strong><\/p>\n\n\n\n

            2021\u201308-03T13:10:00+0000<\/p>\n\n\n\n

              \n
            • 2021-08-03<\/code> \u2013 date (year-month-day)<\/li>\n\n\n\n
            • T<\/code> \u2013 sep\u00ada\u00adra\u00adtor between date and time<\/li>\n\n\n\n
            • 13:10:00<\/code> \u2013 time in 24-hour for\u00admat (hh:mm:ss)<\/li>\n\n\n\n
            • +0000<\/code> \u2013 off\u00adset from UTC (in this case, uni\u00adver\u00adsal time UTC+0).<\/li>\n<\/ul>\n\n\n\n

              Freight statuses<\/h2>\n\n\n\n
              Sta\u00adtus<\/td>Descrip\u00adtion<\/td><\/tr>
              accept\u00aded<\/td>The freight has been accept\u00aded and the car\u00adri\u00ader has been select\u00aded<\/td><\/tr>
              in_progress<\/td>The freight has been pub\u00adlished, is under nego\u00adti\u00ada\u00adtion or is in the process of select\u00ading offers<\/td><\/tr>
              new<\/td>New\u00adly cre\u00adat\u00aded freight<\/td><\/tr>
              unsuccessful_publication<\/td>Freight pub\u00adli\u00adca\u00adtion failed, re-pub\u00adli\u00adca\u00adtion pos\u00adsi\u00adble<\/td><\/tr>
              waiting_for_publication<\/td>Await\u00ading pub\u00adli\u00adca\u00adtion<\/td><\/tr>
              closed<\/td>The freight has been closed, com\u00adplet\u00aded \u2014 an unac\u00adcept\u00aded freight that is in the archive<\/td><\/tr>
              waiting_for_accept<\/td>Freight wait\u00ading for accept<\/td><\/tr>
              waiting_for_chain_accept<\/td>In the for\u00adward\u00ading chain, pre-approved child freight (child)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              Diagram<\/h2>\n\n\n\n

              Visu\u00adal\u00adiza\u00adtion of freight man\u00adage\u00adment process.<\/p>\n\n\n

              \n
              <\/figure>\n<\/div>\n\n\n

              Structure of posting new freight<\/h2>\n\n\n\n
              Json<\/td>Exam\u00adple<\/td>Type<\/td>Is required<\/td>Descrip\u00adtion<\/td><\/tr>
              pub\u00adlish<\/td>True<\/td>Boolean<\/td>Yes<\/td>Deter\u00admines if the freight is auto\u00admat\u00adi\u00adcal\u00adly pub\u00adlished or only cre\u00adat\u00aded<\/td><\/tr>
              external_source<\/td>api_trans<\/td>String<\/td>No<\/td>Freight source iden\u00adti\u00adfi\u00ader assigned to client_id pro\u00advid\u00aded by Trans.eu<\/td><\/tr>
              send_order_proposal_automatically<\/td>true\/false<\/td>Boolean<\/td>No<\/td>Sends the order con\u00addi\u00adtions auto\u00admat\u00adi\u00adcal\u00adly. This means that when the car\u00adri\u00ader accepts such freight, an order is cre\u00adat\u00aded with the terms of the order, and the ship\u00adper does not have to com\u00adplete them man\u00adu\u00adal\u00adly.<\/td><\/tr>
              shipment_external_id<\/td>1\/1\/1234<\/td>String<\/td>No<\/td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr>
              mul\u00adti\u00adstop<\/td>True<\/td>Boolean<\/td>No<\/td>Freight with more than two stops needs to be declared as mul\u00adti\u00adstop<\/td><\/tr>
              publish_date<\/td>\n
              \n
              2021\u201307-30T13:10:00+0000<\/div>\n<\/div>\n<\/td>
              		Time\u00adstamp<\/td>No<\/td>Defines when freight will be pub\u00adlished. Pub\u00adlish date has to be low\u00ader than deci\u00adsion date<\/td><\/tr>
              decision_date<\/td>\n
              \n
              2021\u201308-03T13:00:00+0000<\/div>\n<\/div>\n<\/td>
              		Time\u00adstamp<\/td>No<\/td>Defines time up to which car\u00adri\u00aders can send offers. It can be max:\n

              <\/p>\n

                \n
              • 23:00 on the day of unload\u00ading for freight exchange pub\u00adli\u00adca\u00adtion<\/li>\n
              • equal load\u00ading date for smart match pub\u00adli\u00adca\u00adtion<\/li>\n
              • equal unload\u00ading date for com\u00adpa\u00adnies pub\u00adli\u00adca\u00adtion<\/li>\n<\/ul>\n<\/td><\/tr>
              car\u00adri\u00aders<\/td>Array of objects<\/td><\/td>Yes<\/td>For pub\u00adli\u00adca\u00adtion to com\u00adpa\u00adnies only, con\u00adtains of carrier\u2019s com\u00adpa\u00adny iden\u00adti\u00adfiers<\/td><\/tr>
              carriers.company_id<\/td>{\u201ccompany_id\u201d: 10}, {\u201ccompany_id\u201d: 1111111}<\/td>Int<\/td>Yes<\/td>Car\u00adri\u00ader com\u00adpa\u00adnies id\u2019s<\/td><\/tr>
              contact_employees<\/td>[\u201c12345\u20131\u201d, \u201c12345\u20132\u201d]<\/td>Array<\/td>No<\/td>The default con\u00adtact per\u00adson is always the pub\u00adlish\u00ader. If the field is sent, the con\u00adtact per\u00adsons will be only the ID\u2019s sent in it<\/td><\/tr>
              pay\u00adment<\/td>Object<\/td><\/td>Yes<\/td>Pub\u00adli\u00adca\u00adtion price for freight pub\u00adlished using freight exchange, com\u00adpa\u00adnies or auto\u00admat\u00adic rules. Sub\u00admit this object for the asso\u00adci\u00adat\u00aded offers to qual\u00adi\u00adfy for the \u201cquick\u00adpay\u201d and \u201cbona\u00adban\u00adco\u201d des\u00adig\u00adna\u00adtions<\/td><\/tr>
              payment.price<\/td>Object<\/td><\/td>No<\/td>Freight price val\u00adue and cur\u00adren\u00adcy<\/td><\/tr>
              payment.price.value<\/td>1200<\/td>Int<\/td>No<\/td>Val\u00adue of freight price (min\u00adi\u00admum val\u00adue is 1)<\/td><\/tr>
              payment.price.currency<\/td>Eur<\/td>String<\/td>Yes<\/td>Cur\u00adren\u00adcy for freight price<\/a><\/td><\/tr>
              payment.price.period<\/td>Object<\/td><\/td>Yes<\/td>Infor\u00adma\u00adtion about pay\u00adment time<\/td><\/tr>
              payment.price.period.payment<\/td>Deferred<\/td>String<\/td>Yes<\/td>Allowed freight pay\u00adment types<\/a><\/td><\/tr>
              payment.price.period.days<\/td>5<\/td>Int<\/td>Yes<\/td>Num\u00adber of days for deferred pay\u00adment only<\/td><\/tr>
              \n
              \n
              is_first_buy<\/div>\n<\/div>\n<\/td>
              		True<\/td>Boolean<\/td>No<\/td>Freights with para\u00adme\u00adter is_first_buy = true can be only accept\u00aded or reject\u00aded, they can\u00adnot be nego\u00adti\u00adat\u00aded (val\u00adue for pub\u00adli\u00adca\u00adtion to com\u00adpa\u00adnies only)<\/td><\/tr>
              capac\u00adi\u00adty<\/td>29<\/td>Float<\/td>Yes<\/td>Total freight capac\u00adi\u00adty in tonnes. This val\u00adue is being val\u00adi\u00addat\u00aded in com\u00adpar\u00adi\u00adson to the sum of all loads weight (range 0.001 \u2013 100000)<\/td><\/tr>
              loading_meters<\/td>2<\/td>Float<\/td>No<\/td>Total freight load\u00ading meters (range: 0,01 \u2014 417)<\/td><\/tr>
              height<\/td>4<\/td>Int or float<\/td>No<\/td>Vehi\u00adcle height (range 0.01\u201310)<\/td><\/tr>
              width<\/td>3<\/td>Int or float<\/td>No<\/td>Vehi\u00adcle width (range 0.01\u201310)<\/td><\/tr>
              length<\/td>8<\/td>Int or float<\/td>No<\/td>Vehi\u00adcle length (range 0.01\u2013100)<\/td><\/tr>
              vol\u00adume<\/td>25<\/td>Int or float<\/td>No<\/td>Vehi\u00adcle vol\u00adume (range 0.01\u201310000)<\/td><\/tr>
              require\u00adments<\/td>Object<\/td><\/td>Yes<\/td>Main freight require\u00adments, includ\u00ading truck body and size, adr class\u00ades, ways of load\u00ading<\/td><\/tr>
              requirements.monitoring<\/td>without_monitoring<\/td>String<\/td>No<\/td>Mon\u00adi\u00adtor\u00ading require\u00adment can be select\u00aded with mon\u00adi\u00adtor\u00ading require\u00adment (required) or with\u00adout mon\u00adi\u00adtor\u00ading require\u00adment (without_monitoring)<\/td><\/tr>
              requirements.is_ftl<\/td>True<\/td>Boolean<\/td>Yes<\/td>Deter\u00admines if freight is a full truck load or less than truck\u00adload<\/td><\/tr>
              requirements.required_truck_bodies<\/td>Cur\u00adtain\u00adsid\u00ader, cool\u00ader<\/td>Array<\/td>Yes<\/td>Allowed vehi\u00adcle types<\/a> (array can con\u00adtain max 5 val\u00adues)<\/td><\/tr>
              requirements.temperature<\/td>Object<\/td><\/td>No<\/td>Can be added for one of fol\u00adlow\u00ading truck bod\u00adies: cool\u00ader, isotherm, hook truck<\/td><\/tr>
              requirements.temperature.min<\/td>3<\/td>Int<\/td>No<\/td>The input is between \u2018-999\u2019 and \u2018999\u2019, inclu\u00adsive\u00adly\u201d<\/td><\/tr>
              requirements.temperature.max<\/td>10<\/td>Int<\/td>No<\/td>The input is between \u2018-999\u2019 and \u2018999\u2019, inclu\u00adsive\u00adly\u201d<\/td><\/tr>
              requirements.shipping_remarks<\/td>Ship\u00adping remarks<\/td>String<\/td>No<\/td>Addi\u00adtion\u00adal ship\u00adping remarks<\/td><\/tr>
              requirements.vehicle_size<\/td>Bus<\/td>String<\/td>No<\/td>Default val\u00adue is any_size \u2014 if you want to use vehi\u00adcle type from beyond the any_size list (Allowed vehi\u00adcle types<\/a>), you have to give prop\u00ader vehi\u00adcle size<\/td><\/tr>
              requirements.required_adr_classes<\/td>Adr_1<\/td>Array<\/td>No<\/td>Allowed ADR class\u00ades<\/a><\/td><\/tr>
              requirements.required_ways_of_loading<\/td>Top<\/td>Array<\/td>No<\/td>Allowed ways of load\u00ading<\/a><\/td><\/tr>
              requirements.other_requirements<\/td>Lift, Hds<\/td>Array<\/td>No<\/td>Allowed addi\u00adtion\u00adal require\u00adments<\/a><\/td><\/tr>
              loads<\/td><\/td>Array of objects<\/td>No<\/td>Col\u00adlec\u00adtion of freights\u2019 loads<\/td><\/tr>
              loads.load_id<\/td>L123x<\/td>String<\/td>Yes<\/td>Load id, which should help iden\u00adti\u00adfy loads des\u00adig\u00adnat\u00aded to freight<\/td><\/tr>
              loads.name<\/td>Exam\u00adple name<\/td>String<\/td>Yes<\/td>Name of a load<\/td><\/tr>
              loads.description<\/td>Descrip\u00adtion<\/td>String<\/td>No<\/td>Load descrip\u00adtion<\/td><\/tr>
              loads.weight<\/td>12<\/td>Int or float<\/td>No<\/td>Load weight (range 0.001 \u2013 100000)<\/td><\/tr>
              loads.height<\/td>3<\/td>Int or float<\/td>No<\/td>Load height (range 0.01\u201310)<\/td><\/tr>
              loads.width<\/td>2<\/td>Int or float<\/td>No<\/td>Load width (range 0.01\u201310)<\/td><\/tr>
              loads.length<\/td>8<\/td>Int or float<\/td>No<\/td>Load length (range 0.01\u2013100)<\/td><\/tr>
              loads.volume<\/td>21<\/td>Int or float<\/td>No<\/td>Load vol\u00adume (range 0.01\u201310000)<\/td><\/tr>
              loads.amount<\/td>1<\/td>Int or float<\/td>No<\/td>Amount of load types with\u00adin giv\u00aden load<\/td><\/tr>
              loads.type_of_load<\/td>Europalette<\/td>String<\/td>Yes<\/td>Name of sup\u00adport\u00aded load types<\/a><\/td><\/tr>
              loads.is_stackable<\/td>True<\/td>Boolean<\/td>No<\/td>Spec\u00adi\u00adfies whether the type of load allows stack\u00ading<\/td><\/tr>
              loads.is_exchangeable<\/td>True<\/td>Boolean<\/td>No<\/td>Deter\u00admines if type of load is avail\u00adable for exchange at unload\u00ading place<\/td><\/tr>
              spots<\/td>Array of objects<\/td><\/td>Yes<\/td>Col\u00adlec\u00adtion of freights\u2019 spots \u2013 at least one load\u00ading and one unload\u00ading is required<\/td><\/tr>
              spots.description<\/td>Exam\u00adple descrip\u00adtion<\/td>String<\/td>No<\/td>Descrip\u00adtion of the load\u00ading or unload\u00ading place<\/td><\/tr>
              spots.name<\/td>Spot name<\/td>String<\/td>No<\/td>Name of spot<\/td><\/tr>
              spots.spot_order<\/td>1<\/td>Int<\/td>Yes<\/td>Infor\u00adma\u00adtion about the order of spot places \u2013 first spot always has spot_order set to 1<\/td><\/tr>
              spots.place<\/td>Object<\/td><\/td>Yes<\/td>Infor\u00adma\u00adtion relat\u00aded to sin\u00adgle place on freight\u2019s route<\/td><\/tr>
              spots.place.address<\/td>Object<\/td><\/td>Yes<\/td>Address<\/td><\/tr>
              spots.place.address.country<\/td>GB<\/td>String<\/td>Yes<\/td>Coun\u00adtry using ISO val\u00adues<\/a><\/td><\/tr>
              spots.place.address.postal_code<\/td>SK7 1<\/td>String<\/td>Yes<\/td>Postal code<\/td><\/tr>
              spots.place.address.locality<\/td>Lon\u00addon<\/td>String<\/td>Yes<\/td>City name<\/td><\/tr>
              spots.place.address.street<\/td>The Mall<\/td>String<\/td>No<\/td>Street name<\/td><\/tr>
              spots.place.address.number<\/td>1<\/td>String<\/td>No<\/td>Num\u00adber<\/td><\/tr>
              spots.place.address.description<\/td>Address descrip\u00adtion<\/td>String<\/td>No<\/td>Address descrip\u00adtion<\/td><\/tr>
              spots.place.coordinates<\/td>Object<\/td><\/td>No<\/td>Lon\u00adgi\u00adtude and lat\u00adi\u00adtude for select\u00aded point<\/td><\/tr>
              spots.place.coordinates.latitude<\/td>53.35801<\/td>Float<\/td>No<\/td>Lat\u00adi\u00adtude of the point along the freight route<\/td><\/tr>
              spots.place.coordinates.longitude<\/td>-2.16539<\/td>Float<\/td>No<\/td>Lon\u00adgi\u00adtude of the point along the freight route<\/td><\/tr>
              spots.operations<\/td>Array of objects<\/td><\/td>Yes<\/td>Array of oper\u00ada\u00adtions to be com\u00adplet\u00aded in giv\u00aden spot<\/td><\/tr>
              spots.operations.operation_order<\/td>1<\/td>Int<\/td>Yes<\/td>The order of load\u00ading and unload\u00ading oper\u00ada\u00adtions at a giv\u00aden spot \u2013 first oper\u00ada\u00adtion always has operation_order set to 1<\/td><\/tr>
              spots.operations.loads<\/td>Object<\/td><\/td>No<\/td>Array of loads to be loaded or unloaded dur\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.loads.load_id<\/td>\n
              \n
              L123x<\/div>\n<\/div>\n<\/td>
              		String<\/td>No<\/td>Ref\u00ader\u00adence to a pre\u00advi\u00adous\u00adly defined load<\/td><\/tr>
              spots.operations.loads.weight<\/td>12<\/td>Int<\/td>No<\/td>Weight of load to be loaded or unloaded in oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans<\/td>Object<\/td><\/td>Yes<\/td>Times\u00adpan for select\u00aded oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans.begin<\/td>\n
              \n
              2021\u201308-03T13:10:00+0000<\/div>\n<\/div>\n<\/td>
              		Time\u00adstamp<\/td>Yes<\/td>Begin\u00adning of time slot for load\u00ading or unload\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans.end<\/td>\n
              \n
              2021\u201308-03T15:10:00+0000<\/div>\n<\/div>\n<\/td>
              		Time\u00adstamp<\/td>Yes<\/td>End of time slot for load\u00ading or unload\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.type<\/td>Load\u00ading<\/td>String<\/td>Yes<\/td>Could be either load\u00ading or unload\u00ading, at least one of each is required<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              Json example (publication to companies)<\/h2>\n\n\n\n
              {\n  \"publish\": true,\n  \"external_source\": \"api_trans\",\n  \"shipment_external_id\": \"1\/1\/1234\",\n  \"multistop\": true,\n  \"publish_date\": \"2021-07-30T13:10:00+0000\",\n  \"decision_date\": \"2021-08-03T13:00:00+0000\",\n  \"carriers\": [\n    {\n      \"company_id\": 10\n    },\n    {\n      \"company_id\": 1111111\n    }\n  ],\n  \"contact_employees\": [\n    \"12345-1\",\n    \"12345-2\"\n  ],\n  \"payment\": {\n    \"price\": {\n      \"value\": 1200,\n      \"currency\": \"eur\",\n      \"period\": {\n        \"payment\": \"deferred\",\n        \"days\": 5\n      }\n    }\n  },\n  \"is_first_buy\": true,\n  \"capacity\": 29,\n  \"loading_meters\": 2,\n  \"height\": 4,\n  \"width\": 3,\n  \"length\": 8,\n  \"volume\": 25,\n  \"requirements\": {\n    \"monitoring\": \"without_monitoring\",\n    \"is_ftl\": true,\n    \"required_truck_bodies\": [\n      \"curtainsider\",\n      \"cooler\"\n    ],\n    \"temperature\": {\n      \"min\": 3,\n      \"max\": 10\n    },\n    \"shipping_remarks\": \"shipping remarks\",\n    \"vehicle_size\": \"bus\",\n    \"required_adr_classes\": [\n      \"adr_1\"\n    ],\n    \"required_ways_of_loading\": [\n      \"top\"\n    ],\n    \"other_requirements\": [\n      \"lift\",\n      \"hds\"\n    ]\n  },\n  \"loads\": [\n    {\n      \"load_id\": \"L123x\",\n      \"name\": \"example name\",\n      \"description\": \"Description\",\n      \"weight\": 12,\n      \"height\": 3,\n      \"width\": 2,\n      \"length\": 8,\n      \"volume\": 21,\n      \"amount\": 1,\n      \"type_of_load\": \"europalette\",\n      \"is_stackable\": true,\n      \"is_exchangeable\": true\n    }\n  ],\n  \"spots\": [\n    {\n      \"description\": \"Example description\",\n      \"name\": \"Spot name\",\n      \"spot_order\": 1,\n      \"place\": {\n        \"address\": {\n          \"country\": \"GB\",\n          \"postal_code\": \"SK7 1\",\n          \"locality\": \"London\",\n          \"street\": \"The Mall\",\n          \"number\": \"1\",\n          \"description\": \"Address description\"\n        },\n        \"coordinates\": {\n          \"latitude\": 53.35801,\n          \"longitude\": -2.16539\n        }\n      },\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"loads\": [\n            {\n              \"load_id\": \"L123x\",\n              \"weight\": 12\n            }\n          ],\n          \"timespans\": {\n            \"begin\": \"2021-08-03T13:10:00+0000\",\n            \"end\": \"2021-08-03T15:10:00+0000\"\n          },\n          \"type\": \"loading\"\n        }\n      ]\n    },\n    {\n      \"name\": \"Spot name 2\",\n      \"description\": \"Description2\",\n      \"spot_order\": 2,\n      \"place\": {\n        \"address\": {\n          \"country\": \"PL\",\n          \"postal_code\": \"61-625\",\n          \"locality\": \"Pozna\u0144\",\n          \"street\": \"Rynek\",\n          \"number\": \"1\",\n          \"description\": \"Address 2\"\n        },\n        \"coordinates\": {\n          \"latitude\": 52.43457,\n          \"longitude\": 16.95141\n        }\n      },\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"loads\": [\n            {\n              \"load_id\": \"L123x\",\n              \"weight\": 10\n            }\n          ],\n          \"type\": \"unloading\",\n          \"timespans\": {\n            \"begin\": \"2021-08-04T13:00:00+0000\",\n            \"end\": \"2021-08-04T14:00:00+0000\"\n          }\n        }\n      ]\n    },\n    {\n      \"name\": \"Spot name 3\",\n      \"description\": \"Description3\",\n      \"spot_order\": 3,\n      \"place\": {\n        \"address\": {\n          \"country\": \"DE\",\n          \"postal_code\": \"09000\",\n          \"locality\": \"Brieselang\",\n          \"street\": \"Strasse\",\n          \"number\": \"3\",\n          \"description\": \"Address 3\"\n        },\n        \"coordinates\": {\n          \"latitude\": 52.58216,\n          \"longitude\": 12.99756\n        }\n      },\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"loads\": [\n            {\n              \"load_id\": \"L123x\",\n              \"weight\": 2\n            }\n          ],\n          \"type\": \"unloading\",\n          \"timespans\": {\n            \"begin\": \"2021-08-05T01:00:00+0000\",\n            \"end\": \"2021-08-05T01:00:00+0000\"\n          }\n        }\n      ]\n    }\n  ]\n}<\/code><\/pre><\/div>\n\n\n\n
              Structure of response, structure of getting single freight<\/h2>\n\n\n\n
              Json<\/td>Exam\u00adple<\/td>Type<\/td>Descrip\u00adtion<\/td><\/tr>
              accepted_price<\/td>Object<\/td><\/td>Final price for freight accept\u00aded dur\u00ading pub\u00adli\u00adca\u00adtion and nego\u00adti\u00ada\u00adtion process<\/td><\/tr>
              accepted_price.currency<\/td>Eur<\/td>String<\/td>Final price cur\u00adren\u00adcy<\/a><\/td><\/tr>
              accepted_price.value<\/td>110<\/td>Int<\/td>Final price val\u00adue<\/td><\/tr>
              capac\u00adi\u00adty<\/td>29<\/td>Float<\/td>Total freight capac\u00adi\u00adty in tonnes. This val\u00adue is being val\u00adi\u00addat\u00aded in com\u00adpar\u00adi\u00adson to the sum of all loads weight.
              Range: 0,001 \u2013 100000<\/td><\/tr>
              car\u00adri\u00ader<\/td>Object<\/td><\/td>Car\u00adri\u00ader select\u00aded dur\u00ading pub\u00adli\u00adca\u00adtion and nego\u00adti\u00ada\u00adtion process<\/td><\/tr>
              carrier.address<\/td>Object<\/td><\/td>Car\u00adri\u00ader address infor\u00adma\u00adtion<\/td><\/tr>
              carrier.address.country<\/td>PL<\/td>String<\/td>Coun\u00adtry ISO val\u00adue<\/a><\/td><\/tr>
              carrier.address.locality<\/td>War\u00adsaw<\/td>String<\/td>Town<\/td><\/tr>
              carrier.address.postal_code<\/td>00\u2013111<\/td>String<\/td>Postal code<\/td><\/tr>
              carrier.address.street<\/td>Street name<\/td>String<\/td>Street<\/td><\/tr>
              carrier.email<\/td>abc@trans.eu<\/td>String<\/td>E\u2011mail address<\/td><\/tr>
              carrier.id<\/td>1111111<\/td>Int<\/td>Com\u00adpa\u00adny ofice id<\/td><\/tr>
              carrier.name<\/td>Exam\u00adple name<\/td>String<\/td>Com\u00adpa\u00adny name<\/td><\/tr>
              carrier.telephone<\/td>0048 111111111<\/td>Num\u00adber<\/td>Tele\u00adphone num\u00adber<\/td><\/tr>
              carrier.vat_id<\/td>11111111111<\/td>String<\/td>Com\u00adpa\u00adny tax iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr>
              dis\u00adtance<\/td>1234<\/td>Int<\/td>Dis\u00adtance from the point of load\u00ading to the point of unload\u00ading<\/td><\/tr>
              end_reason<\/td>null<\/td>String<\/td>Pub\u00adli\u00adca\u00adtion end rea\u00adson (can be one from the fol\u00adlow\u00ading: null, time\u00adout, reject\u00aded, accept\u00aded,<\/span><\/span>\n
              <\/p>\n
              can\u00adceled, fail\u00adure, <\/span><\/span>exchange_limit)<\/span><\/div>\n<\/td><\/tr>
              height<\/td>null<\/td>Float<\/td>Vehi\u00adcle height (range 0.01\u201310)<\/td><\/tr>
              id<\/td>820283<\/td>Int<\/td>Freight iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber, assigned auto\u00admat\u00adi\u00adcal\u00adly dur\u00ading cre\u00adation of a new freight<\/td><\/tr>
              length<\/td>null<\/td>Float<\/td>Vehi\u00adcle length (range 0.01\u2013100)<\/td><\/tr>
              loading_meters<\/td>2<\/td>Float<\/td>Total freight load\u00ading meters
              Range: 0,01 \u2014 417<\/td><\/tr>
              loads<\/td>Object<\/td><\/td>Col\u00adlec\u00adtion of freights\u2019 loads. It is pos\u00adsi\u00adble to send emp\u00adty array of loads, nev\u00ader\u00adthe\u00adless an array has to be set<\/td><\/tr>
              loads.load_id<\/td>L123x<\/td>String<\/td>Load id, which should help iden\u00adti\u00adfy loads des\u00adig\u00adnat\u00aded to freight<\/td><\/tr>
              loads.name<\/td>Exam\u00adple name<\/td>String<\/td>Name of a load<\/td><\/tr>
              loads.description<\/td>No<\/td>String<\/td>Load descrip\u00adtion<\/td><\/tr>
              loads.weight<\/td>12<\/td>Int or float<\/td>Load weight (range 0.001 \u2013 100000)<\/td><\/tr>
              loads.height<\/td>3<\/td>Int or float<\/td>Load height (range 0.01\u201310)<\/td><\/tr>
              loads.width<\/td>2<\/td>Int or float<\/td>Load width (range 0.01\u201310)<\/td><\/tr>
              loads.length<\/td>8<\/td>Int or float<\/td>Load length (range 0.01\u2013100)<\/td><\/tr>
              loads.volume<\/td>21<\/td>Int or float<\/td>Load vol\u00adume (range 0.01\u201310000)<\/td><\/tr>
              loads.amount<\/td>1<\/td>Int or float<\/td>Amount of load types with\u00adin giv\u00aden load<\/td><\/tr>
              loads.type_of_load<\/td>Europalette<\/td>String<\/td>Name of sup\u00adport\u00aded type of load<\/a><\/td><\/tr>
              loads.is_stackable<\/td>True<\/td>Boolean<\/td>Spec\u00adi\u00adfies whether the type of load allows stack\u00ading<\/td><\/tr>
              loads.is_exchangeable<\/td>True<\/td>Boolean<\/td>Deter\u00admines if type of load is avail\u00adable for exchange at unload\u00ading place<\/td><\/tr>
              publication_price<\/td>Object<\/td><\/td>Pub\u00adli\u00adca\u00adtion price infor\u00adma\u00adtion<\/td><\/tr>
              cur\u00adren\u00adcy<\/td>Eur<\/td>String<\/td>Pub\u00adli\u00adca\u00adtion price cur\u00adren\u00adcy<\/a><\/td><\/tr>
              val\u00adue<\/td>110<\/td>Int<\/td>Pub\u00adli\u00adca\u00adtion price val\u00adue<\/td><\/tr>
              publication_status<\/td>active<\/td>String<\/td>Can be null, active or fin\u00adished<\/td><\/tr>
              reference_number<\/td>FR\/2021\/07\/23\/TLUH<\/td>String<\/td>Freight ref\u00ader\u00adence num\u00adber<\/td><\/tr>
              require\u00adments<\/td>Object<\/td><\/td>Main freight require\u00adments, includ\u00ading truck body and size, adr class\u00ades, ways of load\u00ading<\/td><\/tr>
              requirements.is_ftl<\/td>True<\/td>Boolean<\/td>Deter\u00admines if freight is a full truck load or less than truck\u00adload<\/td><\/tr>
              requirements.required_truck_bodies<\/td>Cur\u00adtain\u00adsid\u00ader, cool\u00ader<\/td>Array<\/td>Allowed vehi\u00adcle types<\/a><\/td><\/tr>
              requirements.temperature<\/td>Object<\/td><\/td>Can be added for one of fol\u00adlow\u00ading truck bod\u00adies: cool\u00ader, isotherm, hook truck<\/td><\/tr>
              requirements.temperature.min<\/td>3<\/td>Int<\/td>The input is between \u2018-999\u2019 and \u2018999\u2019, inclu\u00adsive\u00adly\u201d<\/td><\/tr>
              requirements.temperature.max<\/td>10<\/td>Int<\/td>The input is between \u2018-999\u2019 and \u2018999\u2019, inclu\u00adsive\u00adly\u201d<\/td><\/tr>
              requirements.shipping_remarks<\/td>Ship\u00adping remarks<\/td>String<\/td>Addi\u00adtion\u00adal ship\u00adping remarks<\/td><\/tr>
              requirements.vehicle_size<\/td>Bus<\/td>String<\/td>Default val\u00adue is any_size \u2014 if you want to use vehi\u00adcle type from beyond the any_size list (Allowed vehi\u00adcle types<\/a>), you have to give prop\u00ader vehi\u00adcle size<\/td><\/tr>
              requirements.required_adr_classes<\/td>Adr_1<\/td>Array<\/td>Allowed ADR class\u00ades<\/a><\/td><\/tr>
              requirements.required_ways_of_loading<\/td>Top<\/td>Array<\/td>Allowed ways of load\u00ading<\/a><\/td><\/tr>
              requirements.other_requirements<\/td>Lift, Hds<\/td>Array<\/td>Allowed addi\u00adtion\u00adal require\u00adments<\/a><\/td><\/tr>
              \n
              \n
              shipment_external_id<\/div>\n<\/div>\n<\/td>
              		null<\/td>String<\/td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr>
              spots<\/td>Array of objects<\/td><\/td>Col\u00adlec\u00adtion of freights\u2019 spots \u2013 at least one load\u00ading and one unload\u00ading is required<\/td><\/tr>
              spots.description<\/td>Exam\u00adple descrip\u00adtion<\/td>String<\/td>Descrip\u00adtion of the load\u00ading or unload\u00ading place<\/td><\/tr>
              spots.name<\/td>Spot name<\/td>String<\/td>Name of spot<\/td><\/tr>
              spots.operations<\/td>Array of objects<\/td><\/td>Array of oper\u00ada\u00adtions to be com\u00adplet\u00aded in giv\u00aden spot<\/td><\/tr>
              spots.operations.operation_order<\/td>1<\/td>Int<\/td>The order of load\u00ading and unload\u00ading oper\u00ada\u00adtions at a giv\u00aden spot \u2013 first oper\u00ada\u00adtion always has operation_order set to 1<\/td><\/tr>
              spots.operations.loads<\/td>Object<\/td><\/td>Array of loads to be loaded in unloaded dur\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.loads.load_id<\/td>279606<\/td>String<\/td>Ref\u00ader\u00adence to a pre\u00advi\u00adous\u00adly defined load<\/td><\/tr>
              spots.operations.loads.weight<\/td>10<\/td>Int<\/td>Weight of load to be loaded or unloaded in this oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans<\/td>Object<\/td><\/td>Times\u00adpan for select\u00aded oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans.begin<\/td>2021\u201301-23T18:00:00+01:00<\/td>Time\u00adstamp<\/td>Begin\u00adning of time slot for load\u00ading or unload\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.timespans.end<\/td>2021\u201301-23T18:30:00+01:00<\/td>Time\u00adstamp<\/td>End of time slot for load\u00ading or unload\u00ading oper\u00ada\u00adtion<\/td><\/tr>
              spots.operations.type<\/td>Load\u00ading<\/td>String<\/td>Could be either load\u00ading or unload\u00ading, at least one of each is required<\/td><\/tr>
              spots.place<\/td>Object<\/td><\/td>Infor\u00adma\u00adtion relat\u00aded to sin\u00adgle place on freight\u2019s route<\/td><\/tr>
              spots.place.address<\/td>Object<\/td><\/td>Address<\/td><\/tr>
              spots.place.address.country<\/td>GB<\/td>String<\/td>Coun\u00adtry using ISO val\u00adues<\/a><\/td><\/tr>
              spots.place.address.postal_code<\/td>SK7 1<\/td>String<\/td>Postal code<\/td><\/tr>
              spots.place.address.locality<\/td>Lon\u00addon<\/td>String<\/td>City name<\/td><\/tr>
              spots.place.address.street<\/td>The Mall<\/td>String<\/td>Street name<\/td><\/tr>
              spots.place.address.number<\/td>1<\/td>String<\/td>Num\u00adber<\/td><\/tr>
              spots.place.address.description<\/td>Address descrip\u00adtion<\/td>String<\/td>Descrip\u00adtion of load\u00ading point<\/td><\/tr>
              spots.place.coordinates<\/td>Object<\/td><\/td>Lon\u00adgi\u00adtude and lat\u00adi\u00adtude for select\u00aded point<\/td><\/tr>
              spots.place.coordinates.latitude<\/td>53.35801<\/td>Float<\/td>Lat\u00adi\u00adtude of the point along the freight route<\/td><\/tr>
              spots.place.coordinates.longitude<\/td>-2.16539<\/td>Float<\/td>Lon\u00adgi\u00adtude of the point along the freight route<\/td><\/tr>
              spots.spot_order<\/td>1<\/td>Int<\/td>Infor\u00adma\u00adtion about the order of oper\u00ada\u00adtions at this loca\u00adtion<\/td><\/tr>
              sta\u00adtus<\/td>Accept\u00aded<\/td>String<\/td>Freight sta\u00adtus<\/td><\/tr>
              vol\u00adume<\/td>null<\/td>Float<\/td>Vehi\u00adcle vol\u00adume (range 0.01\u201310000)<\/td><\/tr>
              width<\/td>null<\/td>Float<\/td>Vehi\u00adcle width (range 0.01\u201310)<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"
              Descrip\u00adtion of freight ele\u00adments with the usage and con\u00addi\u00adtions.<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":true,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[42],"tags":[],"class_list":["post-1168","post","type-post","status-publish","format-standard","hentry","category-freights"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":1168},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1168","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\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=1168"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1168\/revisions"}],"predecessor-version":[{"id":5728,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1168\/revisions\/5728"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=1168"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=1168"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=1168"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}