This method allows adding an order object to a defined time window, together with a complete set of data regarding delivery, business partner, and cargo. As a result, the system can automatically link orders with the transport schedule and logistics processes.
Authorization and access
Authorization process is described here. Each API request must also consist of unique Api-key obtained during application registration together with client_id and client_secret.
Url parameters and connection settings
- URL: https://api.platform.trans.eu
- Endpoint: /ext/dock-scheduler-api/v1/warehouse/timeWindow
- Http Method: POST
Headers
- Accept: application/json
- Content-type: application/json
- Authorization: Bearer {access_token}
- Api-key: {unique_app_api-key}
Purchase order object
| Json | Description | Is required | Type |
| purchase_order.number | Purchase order number (size must be between 0 and 50) | YES | string |
| execution_constraints.delivery_date | Delivery date | NO | date |
| execution_constraints.delivery_time | Delivery time | NO | time |
| execution_constraints.delivery_conditions | Delivery conditions | NO | string |
| execution_constraints.payment_conditions | Payment conditions | NO | string |
| document.created_date | Creation date | NO | timestamp |
| document.author.created_by | Created by | NO | string |
| document.author.phone | Phone number | NO | string |
| document.author.email | Email address | NO | string |
| delivery_place.receiver_name | Receiver name | NO | string |
| delivery_place.country | Country | NO | string |
| delivery_place.city | City | NO | string |
| delivery_place.postal_code | Postal code | NO | string |
| delivery_place.street | Street | NO | string |
| business_partner.number | Business partner number | NO | string |
| business_partner.name | Business partner name | NO | string |
| business_partner.tax_id | Tax identification number | NO | string |
| business_partner.contact_person | Contact person | NO | string |
| shipment_document.number | Shipment document number | NO | string |
| invoice.number | Invoice number | NO | string |
| warehouse_issue.number | Warehouse issue (WZ) | NO | string |
| loads.name | Cargo name | NO | string |
| loads.type | Cargo type | NO | string |
| loads.quantity | Cargo quantity | NO | integer |
| loads.weight | Total weight | NO | decimal |
| loads.reference_number | Cargo reference number | NO | string |
| loads.warehouse_unit | Warehouse unit | NO | string |
| loads.category | Cargo category | NO | string |
| loads.business_partner_load_number | Business partner load number | NO | string |
| loads.commercial_number | Commercial cargo number | NO | string |
| loads.forwarding_number | Forwarding number | NO | string |
| loads.container_number | Container number | NO | string |
| loads.description | Cargo description | NO | string |
Request example
{
"valid_from": "2025-09-08",
"valid_to": "2025-09-08",
"start_time": "12:00:00",
"end_time": "18:00:00",
"remarks": "Test remark !@#$",
"range_type": "CYCLE",
"external_number": "1DX124DAW7871",
"carrier": {
"id": 956529
},
"purchase_order": {
"number": "purchase_order_number_46be0354e8ef",
"execution_constraints": {
"delivery_date": "2025-04-22",
"delivery_time": "14:50:19",
"delivery_conditions": "delivery_conditions_13f786506c62",
"payment_conditions": "payment_conditions_d3bc906c82b5"
},
"document": {
"created_date": "2099-01-05",
"author": {
"created_by": "Lincoln",
"phone": "0048 600600600",
"email": "lincoln@ford.com"
}
},
"delivery_place": {
"receiver_name": "receiver_name_fdcb53f26f0a",
"country": "country_48771b243932",
"city": "city_3db029c3ec4e",
"postal_code": "41a3e0797",
"street": "street_46cd2d92845b"
},
"business_partner": {
"number": "number_ca724db783c2",
"name": "name_a95a422817f1",
"tax_id": "tax_id_fae3d33b3bf7",
"contact_person": "contact_person_d985cf6abd8f"
},
"shipment_document": {
"number": "number_aa63e54e69ad"
},
"invoice": {
"number": "number_2f9bf43ad4c5"
},
"warehouse_issue": {
"number": "number_9db7225e175e"
},
"loads": [
{
"name": "name_ed0283531277",
"type": "type_37c574fa8fbc",
"quantity": "501",
"weight": "11",
"reference_number": "reference_number_0240404aedbf",
"warehouse_unit": "warehouse_unit_5e1adda5f496",
"category": "category_f660ad4f3d7c",
"business_partner_load_number": "business_partner_load_number_a7bb99929090",
"commercial_number": "commercial_number_e8fc8ee76056",
"forwarding_number": "forwarding_number_84ee71ccbda3",
"container_number": "container_number_ef12a0a869c8",
"description": "description_e68ae86cdffa"
},
{
"name": "name_ed0283531277_v2",
"type": "type_37c574fa8fbc_v2",
"quantity": "5012",
"weight": "112",
"reference_number": "reference_number_0240404aedbf_v2",
"warehouse_unit": "warehouse_unit_5e1adda5f496_v2",
"category": "category_f660ad4f3d7c_v2",
"business_partner_load_number": "business_partner_load_number_a7bb99929090_v2",
"commercial_number": "commercial_number_e8fc8ee76056_v2",
"forwarding_number": "forwarding_number_84ee71ccbda3_v2",
"container_number": "container_number_ef12a0a869c8_v2",
"description": "description_e68ae86cdffa_v2"
}
]
},
"route": {
"spots": [
{
"warehouse_id": 6596,
"order": 1,
"address": {
"country": "af",
"locality": "Kabul",
"street": "Testing Street",
"number": "12T",
"name": "Cypresss",
"remarks": null,
"postal_code": "1002"
},
"operations": [
{
"operation_type": "loading",
"order": 1,
"belongs_to_time_window": true
}
]
}
]
}
}