Freight description

Description of freight elements with the usage and conditions.

Freight allows to search for the best carriers for given shipment. You can use publication to selected companies, automation rules previously created at Platform, publication to freight exchange or with the help of Trans.eu matching algorithm – Smart match.

Creating new freight

With the use of Trans.eu API it is possible to create new own freight, displayed at Trans.eu Platform in Freights Sent module. After the freight is created, it is also possible to update it’s content if it was not yet published.

Freight publication

If a freight was not published, it is not visible to other Trans.eu users. For a freight to be successfully published it has to meet several criteria:

• the “publish” parameter must be set to “true”
• if a freight is being published to selected companies, at least one of company id’s must be valid
• if freight is being published using automation rules, at least one automation rule must be created and active at Platform

Freight price

Depending of method and freight status, there are three different parameters related to freight price:

• payment  – initial freight price for publication using freight exchange, smart match and groups
• publication_price – freight price set during publication
• accepted_price – freight price agreed upon during negotiation process, the final freight price

Components of a single freight

Each freight consists of:

• summary and requirements
• publication status
• carrier information, available to be read after the acceptance of freight
• list of loads
• spots, which are divided into:
  • addresses
  • operations

Validation rules

Most important validation rules considering freight publication

• all dates must be greater or equal today
• first operation date has to be lower than last operation date
• first operation always has to be loading
• last operation always has to be unloading
• each spot has own sequence of operations performed, therefore in each spot first operation always has operation_order set to 1
• address must consists of country, postal code and locality
• for list of required fields please refer to structure of posting new freight below

Freight statuses

• accepted,
• in_progress,
• new,
• unsuccessful_publication,
• waiting_for_publication,
• closed,
• waiting_for_accept,
• waiting_for_chain_accept

Diagram

Visualization of freight management process.

Structure of posting new freight

Json example (publication to companies)

{
  "publish": true,
  "external_source": "api_trans",
  "shipment_external_id": "1/1/1234",
  "multistop": true,
  "publish_date": "2021-07-30T13:10:00+0000",
  "decision_date": "2021-08-03T13:00:00+0000",
  "carriers": [
    {
      "company_id": 10
    },
    {
      "company_id": 1111111
    }
  ],
  "contact_employees": [
  "12345-1",
  "12345-2"
  ],
  "payment": {
    "price": {
      "value": 1200,
      "currency": "eur",
      "period": {
        "payment": "deferred",
        "days": 5
      }
    }
  },
  "quick_pay": false,
  "is_first_buy": true,
  "capacity": 29,
  "loading_meters": 2,
  "height": 4, 
  "width": 3, 
  "length": 8, 
  "volume": 25,
  "requirements": {
    "is_ftl": true,
    "required_truck_bodies": [
      "curtainsider",
      "cooler"
    ],
    "temperature": {
      "min": 3,
      "max": 10
    },
    "shipping_remarks": "shipping remarks",
    "vehicle_size": "bus",
    "required_adr_classes": [
      "adr_1"
    ],
    "required_ways_of_loading": [
      "top"
    ],
    "other_requirements": [
      "lift",
      "hds"
    ]
  },
  "loads": [
    {
      "load_id": "L123x",
      "name": "example name",
      "description": "Description",
      "weight": 12,
      "height": 3,
      "width": 2,
      "length": 8,
      "volume": 21,
      "amount": 1,
      "type_of_load": "europalette",
      "is_stackable": true,
      "is_exchangeable": true
    }
  ],
  "spots": [
    {
      "description": "Example description",
      "name": "Spot name",
      "spot_order": 1,
      "place": {
        "address": {
          "country": "GB",
          "postal_code": "SK7 1",
          "locality": "London",
          "street": "The Mall",
          "number": "1",
          "description": "Address description"
        },
        "coordinates": {
          "latitude": 53.35801,
          "longitude": -2.16539
        }
      },
      "operations": [
        {
          "operation_order": 1,
          "loads": [
            {
              "load_id": "L123x",
              "weight": 12
            }
          ],
          "timespans": {
            "begin": "2021-08-03T13:10:00+0000",
            "end": "2021-08-03T15:10:00+0000"
          },
          "type": "loading"
        }
      ]
    },
    {
      "name": "Spot name 2",
      "description": "Description2",
      "spot_order": 2,
      "place": {
        "address": {
          "country": "PL",
          "postal_code": "61-625",
          "locality": "Poznań",
          "street": "Rynek",
          "number": "1",
          "description": "Address 2"
        },
        "coordinates": {
          "latitude": 52.43457,
          "longitude": 16.95141
        }
      },
      "operations": [
        {
          "operation_order": 1,
          "loads": [
            {
              "load_id": "L123x",
              "weight": 10
            }
          ],
          "type": "unloading",
          "timespans": {
            "begin": "2021-08-04T13:00:00+0000",
            "end": "2021-08-04T14:00:00+0000"
          }
        }
      ]
    },
    {
      "name": "Spot name 3",
      "description": "Description3",
      "spot_order": 3,
      "place": {
        "address": {
          "country": "DE",
          "postal_code": "09000",
          "locality": "Brieselang",
          "street": "Strasse",
          "number": "3",
          "description": "Address 3"
        },
        "coordinates": {
          "latitude": 52.58216,
          "longitude": 12.99756
        }
      },
      "operations": [
        {
          "operation_order": 1,
          "loads": [
            {
              "load_id": "L123x",
              "weight": 2
            }
          ],
          "type": "unloading",
          "timespans": {
            "begin": "2021-08-05T01:00:00+0000",
            "end": "2021-08-05T01:00:00+0000"
          }
        }
      ]
    }
  ]
}

Structure of response, structure of getting single freight