Description of individual freight elements with the application and conditions.

Freight Creation

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

Freight elements

Each freight consists of:

  • summary
  • carrier information
  • list of loads
  • spots, which are divided into:
    • addresses
    • operations

Summary

Freight summary and description for main or first level elements. Each object is described below using dedicated table.

Json Example Type Is required Description
id 12 int Yes Freight identification number.
external_shipment_id 12 int Yes TMS identification number
external_source 12 int Yes Freight source
capacity 12 int Yes Total freight capacity in tonnes. This value is being validated in comparison to the sum of all loads.
Range: 0,001 – 100000
loading_meters 8 int No Total freight loading meters
Range: 0,01 – 417
publish auto string Yes Determines if freight is automatically published using rules set on Platform’s user interface. If left empty or null, freight will be created and not published
publication_price float No Price sent during freight creation
publication_price.currency EUR float No ISO value of given currency
publication_price.value 123.22 float No Price value
accepted_price float No Price for freight accepted during publication and negotiation process.
accepted_price.currency 123.22 float No Currency  for freight price accepted during publication and negotiation process.
accepted_price.value 123.22 float No Price value for freight accepted during publication and negotiation process.
requirements {} Object Yes Main freight requirements
is_ftl true bool Yes Determines if it is a full truck load freight
required_truck_bodies curtainsider array Yes List of allowed truck bodies
carrier {} Object No Carrier
loads {} Object No Collection of freights’ loads. It is possible to send empty array of loads, nevertheless an array has to be set.
spots {} Object Yes Spots

Json example

{
  "id": "12345-abcd-123567",
  "external_shipment_id": "2020/01/abcdef123",
  "external_source": "1_system",
  "capacity": 12,
  "loading_meters": 8,
  "multistop": false,
  "requirements": {
    "is_ftl": true,
    "required_truck_bodies": [
      "curtainsider"
    ]
  },
  "publish": "auto",
  "publication_price": {
    "currency": "eur",
    "value": 123
  },
 "accepted_price": {
    "currency": "eur",
    "value": 123
  },
  "loads": [],
  "spots": [],
  "carrier": []
}

Carrier

Details of carrier chosen during freight publication and negotiation.

Json Example Type Is required Description
id 123456 string No Trans.eu company identifier
name Example name string No Company name
vat 987654321 string No Company tax identification number
address {} Object No Address
address.country PL string No Country ISO value
address.postal_code 00-111 string No Postal code
address.locality Warsaw string No Town
address.street Street name string No Street
address.number 1 string No Number
  "carrier" : {
      "id" : "123",  
      "name" : "Example company name",
      "vat" : "PL123456789",
      "address" : {
          "country" : "pl",
          "locality" : "Sopot",
          "postal_code" : "12-345",
          "street" : "Example street",
          "number" : "13a"
      }

Loads

Array of loads

Json Example Type Is required Description
id L123x string No Load id, which should help identify loads designated to freight
name Example name string No Name of a load
type_of_load europalette string No Type of cargo, also understood as a way of packing or transporting goods
weight 12 int or float No Load weight
height 3 int or float No Load height
width 2 int or float No Load width
length 8 int or float No Load length
volume 21 int or float No Load volume
amount 1 int or float No Amount of load types within given load
description Example description string No Load description
is_stackable true boolean No Specifies whether the type of load allows stacking
is_exchangable false boolean No Determines if there are palettes available for exchange at unloading place
  "loads": [{
      "id": 279606,
      "name": "Example load no 1",
      "type_of_load": "1_palette",
      "weight": 2,
      "height": 1,
      "width": 2,
      "length": 9,
      "volume": 20,
      "amount": 3,
      "description": null,
      "load_id": null,
      "is_stackable": false,
      "is_exchangeable": false
   }

Spots

Json Example Type Is required Description
name L123x string No Name of the loading or unloading place
description Example description string No Description of the loading or unloading place
spot_order 1 int Yes Information about the order of operations at this location
place {} Object Yes Information related to single place on freight’s route
operations {} Object Yes Array of operations to be completed in given spot
"spots": [
    {
      "name": "string",
      "description": "string",
      "spot_order": 0,
      "place": {
        "address": {
        },
        "coordinates": {
        }
      },
      "operations": {
      }
    }
  ]

Spots place

Address data

Json Example Type Is required Description
address Object Yes
address.country DE Yes Country code ISO value
address.postal_code 52-200 Yes Postal code
address.locality Paris Yes City name
address.street Champs elysees No Street name
address.number 44 No
address.coordinates Object No Longitude and latitude for selected point
address.coordinates.latitude 51.8338 float No Latitude of the point along the freight route
address.coordinates.longitude 16.5792 float No Longitude of the point along the freight route
"place": {
        "address": {
          "country": "pl",
          "street": "Racławicka",
          "number": "2-4",
          "locality": "Wrocław",
          "postal_code": "53-146",
          "description": "Trans.eu office"
        },
        "coordinates": {
          "latitude": 51.085615,
          "longitude": 17.0105
        }
      },

Spots operations

Array of operations to be completed in given spot

Json Example Type Is required Description
operations_order 1 int Yes The order of loading and unloading operations at a given spot.
loads L123x string No Reference to a previously defined load that is to be partially or completely unloaded or loaded at a given location.
type loading string Yes Could be either loading or unloading, at least one of each is required
timespans Object Yes Timespan for selected operation
timespans.begin 2018-07-18T14:30:00+0200 timestamp Yes Beginning of time slot for loading or unloading operation
timespans.end 2018-07-18T14:30:00+0200 timestamp Yes End of time slot for loading or unloading operation
      "operations": {[
        "operation_order": 0,
        "loads": [],
        "timespans": {
          "end": {},
          "begin": {}
        },
        "type": "loading"
      ]}