1. Trans.eu Api
  2. Orders
  3. Ask for entry execution data
  4. Adding new ask for entry execution data

Adding new ask for entry execution data

Cre­at­ing new ask for entry exe­cu­tion data for trans­port order in Trans.eu Plat­form and send­ing it direct­ly to cho­sen car­ri­er.

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • End­point: /ex­t/orders-api/v1/order­s/await­ing-entry-exe­cu­tion-data
  • Method: POST

Headers:

  • Con­tent-type: application/json
  • Accept: application/json
  • Autho­riza­tion: Bear­er {access_token}
  • Api-key: {unique_ap­p_api-key}

Authorization

Autho­riza­tion process is described here. Each API request must also con­sist of unique Api-key obtained dur­ing appli­ca­tion reg­is­tra­tion togeth­er with client_id and client_secret.

Data you can ask your carrier for:

  • Name and sur­name of the dri­ver (“driver.full_name”)
  • Dri­ver’s phone num­ber (“driver.contact_phone”)
  • Addi­tion­al dri­ver ID (“driver.identity_document_number”)
  • Vehi­cle reg­is­tra­tion num­ber (“vehicle.truck.registration_plate_number”)
  • Vehi­cle emis­sion class (“vehicle.truck.combustion_norm”,)

Json request example

{
    "required_execution_data": [
        "vehicle.truck.registration_plate_number",
        "vehicle.truck.combustion_norm",
        "driver.full_name",
        "driver.identity_document_number",
        "driver.contact_phone"
    ],
    "freight": {
        "requirements": {
            "is_ftl": true,
            "required_truck_bodies": [
                "cooler"
            ],
            "other_requirements": [
                "lift"
            ],
            "required_adr_classes": [
                "1_adr_1"
            ],
            "required_ways_of_loading": [
                "1_top"
            ],
            "vehicle_size_id": "5_solo",
            "shipping_remarks": "testowy komentarz 1"
        },
        "carrier": {
            "company_id": 9566291
        },
        "capacity": 20,
        "loads": [],
        "spots": [
            {
                "name": null,
                "spot_order": 1,
                "place": {
                    "address": {
                        "locality": "Kraków",
                        "postal_code": "31-008",
                        "country": "PL",
                        "street": "Stara",
                        "number": "12/2"
                    },
                    "coordinates": {
                        "latitude": 50.06143,
                        "longitude": 19.93658
                    }
                },
                "operations": [
                    {
                        "type": "loading",
                        "operation_order": 1,
                        "loads": [],
                        "timespans": {
                            "begin": "2024-09-20T10:00:00+0000",
                            "end": "2024-09-21T10:00:00+0000"
                        }
                    }
                ]
            },
            {
                "name": null,
                "spot_order": 2,
                "place": {
                    "address": {
                        "locality": "Dąbrowa Środkowa",
                        "postal_code": "59-330",
                        "country": "PL",
                        "street": "Średnia",
                        "number": "34"
                    },
                    "coordinates": {
                        "latitude": 51.41828,
                        "longitude": 16.33485
                    }
                },
                "operations": [
                    {
                        "type": "unloading",
                        "operation_order": 1,
                        "loads": [],
                        "timespans": {
                            "begin": "2024-09-23T10:00:00+0000",
                            "end": "2024-09-24T10:00:00+0000"
                        }
                    }
                ]
            }
        ]
    },
    "additional_terms": null,
    "payment": {
        "days": 365,
        "price": {
            "type": "km",
            "value": 100,
            "currency": "eur"
        }
    },
    "monitoring": {
        "required": true
    }
}