1. Trans.eu Api
  2. Orders
  3. Getting lists
  4. List of archived orders created

List of archived orders created

Allows to access list of cre­at­ed trans­port orders which have been already archived.

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • End­point: /ex­t/orders-api/v1/archive-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

  • has attach­ments (?fil­ter={“has_attachments”: true})
  • load­ing place postal code (?filter={“loading_place.postal_code”: {“$regex”: “5.*”}})
  • load­ing place city (?fil­ter={“loading_place.locality”: “Wro­claw”})
  • load­ing place coun­try (?filter={“loading_place.country”: {“$eq”: “PL”}})
  • load­ing place date (?fil­ter={“loading_place.date”:{“$gte”: “2020–09-16T15:00:00.000Z”, “$lte”: “2020–12-31T15:00:00.000Z”}})
  • unload­ing place postal code (?filter={“unloading_place.postal_code”: {“$regex”: “53.*”}})
  • unload­ing place city (?fil­ter={“unloading_place.locality”: {“$regex”: “Wro.*”}})
  • unload­ing place coun­try (?filter={“unloading_place.country”: {“$eq”: “PL”}})
  • unload­ing place date (?fil­ter={“unloading_place.date”:{“$gte”: “2020–09-16T15:00:00.000Z”}})

Sort by

  • num­ber (?sortBy=number&order=asc)
  • cre­ation date (?sortBy=created_at&order=asc)
  • archiv­ing date (?sortBy=archived_at&order=desc)

Search

  • freight ref­er­ence num­ber (?search={“reference_number”:“FR/2021/03/08/IZO8”})

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/archive-orders-created?page=4

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

{
  "orders-archive": [
    {
      "archived_at": "2020-08-10T10:42:34.669Z",
      "attachments": [],
      "created_at": "2019-09-06T09:33:10.865Z",
      "driver": {
        "account_id": 754221,
        "contact_phone": null,
        "family_name": "Kierowca",
        "full_name": "Test Kierowca",
        "given_name": "Test"
      },
      "freight": {
        "carrier": {
          "assignee": {
            "account_id": 749989,
            "family_name": "Nowak",
            "given_name": "Adam",
            "trans_id": "1007374-1"
          },
          "legal_name": "Test company",
          "vat_id": "PL11111111111"
        },
        "id": "24dc2802-5189-48f4-a0d8-6a7a1c4c0b1c",
        "reference_number": "FR/2019/09/06/0BSR",
        "shipper": {
          "assignee": {
            "account_id": 750005,
            "family_name": "Kowalski",
            "given_name": "Jan",
            "trans_id": "1007386-1"
          },
          "legal_name": "Test shipper",
          "vat_id": "PL22222222222"
        },
        "spots": [
          {
            "description": null,
            "name": "Początek",
            "operations": [
              {
                "loads": [],
                "operation_order": 1,
                "time_window": null,
                "time_window_reason": null,
                "timespans": {
                  "begin": "2019-09-09T10:00:00.000Z",
                  "end": "2019-09-09T10:00:00.000Z"
                },
                "type": "loading"
              }
            ],
            "place": {
              "address": {
                "country": "pl",
                "description": null,
                "locality": "Mirosławiec",
                "number": null,
                "postal_code": "78-650",
                "street": null
              },
              "coordinates": {
                "latitude": 53.34071,
                "longitude": 16.08793
              }
            },
            "spot_order": 1
          },
          {
            "description": null,
            "name": "Koniec",
            "operations": [
              {
                "loads": [],
                "operation_order": 1,
                "time_window": null,
                "time_window_reason": null,
                "timespans": {
                  "begin": "2019-09-10T10:00:00.000Z",
                  "end": "2019-09-10T10:00:00.000Z"
                },
                "type": "unloading"
              }
            ],
            "place": {
              "address": {
                "country": "pl",
                "description": null,
                "locality": "Kołobrzeg",
                "number": null,
                "postal_code": "78-100",
                "street": null
              },
              "coordinates": {
                "latitude": 54.17565,
                "longitude": 15.58342
              }
            },
            "spot_order": 2
          }
        ]
      },
      "invoice": null,
      "legacy_freight_id": 208051,
      "monitoring": {
        "providers": [
          "trans_task"
        ],
        "required": true
      },
      "number": "2019/09/06/17",
      "payment": {
        "days": 12,
        "price": {
          "currency": "pln",
          "protected": true,
          "type": "route",
          "value": 333
        }
      },
      "source": null,
      "status": {
        "comment": null,
        "value": "archived"
      },
      "vehicle": {
        "semi_trailer": null,
        "truck": {
          "dispatcher_id": 22075,
          "id": 219179,
          "registration_plate_number": "PL1111111",
          "revision": 2
        }
      }
    },
    {
      "next_order": "next_order"
    }
  ],
  "page": 3,
  "page_count": 3
}