List of created orders

Allows to access list of cre­at­ed trans­port orders.

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • End­point: /ex­t/orders-api/v1/orders-cre­at­ed
  • Method: GET

Headers:

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

Authorization and access

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.

Order

Details of order para­me­ters, data range and descrip­tion can be found here.

Available filters

List of avail­able fil­ters

  • sta­tus (?fil­ter={“status”:“proposal-rejected”})
  • has_attachments (?fil­ter={“has_attachments”: true})
  • has_invoice (?filter={“has_invoice”:true})
  • vat_id (?filter={“vat_id”:“1111111111”})
  • cre­at­ed at: ?filter={“created_at”:{“$gt”: “2023–09-04T13:24:00.000Z”, “$lt”: “2023–11-03T13:24:00.000Z”}}

Filter example

https://api.platform.trans.eu/ext/orders-api/v1/orders-created?filter={"created_at":{"$gt": "2023-09-04T13:24:00.000Z", "$lt": "2023-11-03T13:24:00.000Z"}}

Sort by

  • num­ber (?sortBy=number&order=asc)
  • load­ing date (?sortBy=freight.first_loading_place.date&order=desc)
  • unload­ing date (?sortBy=freight.last_unloading_place.date&order=asc)
  • cre­ation date (?sortBy=created_at&order=asc)
  • sta­tus (?sortBy=status.value&order=desc)

Paging

When call­ing GET method, page should be added as para­me­ter in the URL, for exam­ple:

https://api.platform.trans.eu/ext/orders-api/v1/orders-created?page=4

Search

  • ship­ment exter­nal id (?search={“shipment_external_id”: “1/1/1235”})

Json example

List of orders con­tain­ing one enti­ty, each addi­tion­al enti­ty will repeat sim­i­lar pay­load struc­ture

[
  {
    "attachments": [
      {
        "description": "description",
        "media_id": "5425ef8b-6bd6-47e5-bd8a-f452f5af6fa7",
        "media_name": "9c2f2f2fac7ddef2c23be429e8f8862a.png",
        "type_id": "2_transport_order"
      }
    ],
    "created_at": "2021-07-01T08:54:07.008Z",
    "driver": {
      "account_id": 771476,
      "contact_phone": {
        "number": "11111111111",
        "prefix": "0048"
      },
      "family_name": "Driver",
      "full_name": "Jan Driver",
      "given_name": "Jan"
    },
    "freight": {
      "carrier": {
        "assignee": null,
        "legal_name": "Test company",
        "vat_id": "11111111111"
      },
      "reference_number": null,
      "shipper": {
        "assignee": {
          "account_id": 749989,
          "family_name": "Kowalski",
          "given_name": "Krzysztof",
          "trans_id": "1007374-1"
        },
        "legal_name": "Test spedition company",
        "vat_id": "22222222222"
      },
      "spots": [
        {
          "description": "Example description",
          "name": "Magazine 1",
          "operations": [
            {
              "loads": [],
              "operation_order": 1,
              "time_window": null,
              "time_window_reason": null,
              "timespans": {
                "begin": "2021-06-22T09:00:00.000Z",
                "end": "2021-06-22T10:00:00.000Z"
              },
              "type": "loading"
            }
          ],
          "place": {
            "address": {
              "country": "pl",
              "description": null,
              "locality": "Kraków",
              "number": "5",
              "postal_code": "31-001",
              "street": "Wawel"
            },
            "coordinates": {
              "latitude": 50.06143,
              "longitude": 19.93658
            }
          },
          "spot_order": 1
        },
        {
          "description": null,
          "name": null,
          "operations": [
            {
              "loads": [],
              "operation_order": 1,
              "time_window": null,
              "time_window_reason": null,
              "timespans": {
                "begin": "2021-06-23T09:00:00.000Z",
                "end": "2021-06-23T09:00:00.000Z"
              },
              "type": "unloading"
            }
          ],
          "place": {
            "address": {
              "country": "pl",
              "description": null,
              "locality": "Dąbrowa Środkowa",
              "number": "34",
              "postal_code": "59-330",
              "street": "Średnia"
            },
            "coordinates": {
              "latitude": 51.41828,
              "longitude": 16.33485
            }
          },
          "spot_order": 2
        }
      ]
    },
    "id": "da012de9-faca-4b14-b380-9b94aadff6fa",
    "invoice": null,
    "legacy_freight_id": null,
    "monitoring": {
      "providers": [
        "trans_task",
        "external_telematics"
      ],
      "required": true
    },
    "number": "2021/07/01/1",
    "payment": {
      "days": 30,
      "price": {
        "currency": "pln",
        "protected": false,
        "type": "km",
        "value": 1500
      }
    },
    "source": null,
    "status": {
      "comment": null,
      "value": "waiting-for-confirmation"
    },
    "vehicle": {
      "semi_trailer": {
        "dispatcher_id": 54083,
        "id": 501737,
        "kind": "4_semi_trailer",
        "registration_plate_number": "PL11111111",
        "type": "5_tent"
      },
      "truck": {
        "dispatcher_id": 41483,
        "id": 236503,
        "kind": "5_truck",
        "registration_plate_number": "DW1111111",
        "revision": 1,
        "type": null
      }
    }
  },
  {
    "next_order": "next_order"
  }
]