Get versioned plan-fact for routes

  1. HTTP Request
  2. Path Parameters
  3. Query Parameters
  4. Responses
    1. Code 200
      1. Representation
      2. Fields
    2. Code 400
    3. Code 403
    4. Code 422
    5. Code 500

Returns all plan-fact updates occurring after the given previous version for the routes of the company.

HTTP Request

GET https://courier.yandex.ru/api/v1/analytics/companies/{company_id}/plan-fact/versioned/routes\
?prev_version={string}\
&page={integer}\
&per_page={integer}

Path Parameters

company_id *

integer

The ID of the company that is used in requests to the Track & Trace API.

company_id *

integer

The ID of the company that is used in requests to the Track & Trace API.

Query Parameters

prev_version *

string

Version returned by the previous call to this method. For the initial call, use the value 0

page

integer

Page number. Each page contains per_page objects sorted by route date in ascending order.

Minimum value: 1.
Default value: 1.

per_page

integer

Count of routes per page.

Minimum value: 1.
Maximum value: 1000.
Default value: 200.

prev_version *

string

Version returned by the previous call to this method. For the initial call, use the value 0

page

integer

Page number. Each page contains per_page objects sorted by route date in ascending order.

Minimum value: 1.
Default value: 1.

per_page

integer

Count of routes per page.

Minimum value: 1.
Maximum value: 1000.
Default value: 200.

Responses

Code 200

Success.

{
  "data": [
    {
      "courier": {
        "id": integer,
        "name": string,
        "number": string,
        "phone": string
      },
      "date": string,
      "depot": {
        "address": string,
        "id": integer,
        "name": string,
        "number": string,
        "timezone": string
      },
      "fact": {
        "courier_violated_route": boolean,
        "delivered_orders_count": integer,
        "has_positions": boolean,
        "nodes_count": integer,
        "orders_count": integer,
        "orders_with_status_comments_count": integer,
        "plan_violated": boolean,
        "processed_orders_count": integer,
        "total_depot_idle_count": integer,
        "total_depot_idle_duration_s": integer,
        "total_failed_time_window_count": integer,
        "total_no_connection_count": integer,
        "total_no_connection_duration_s": integer,
        "total_order_idle_count": integer,
        "total_order_idle_duration_s": integer,
        "total_service_duration_depots_s": integer,
        "total_service_duration_orders_s": integer,
        "total_transit_distance_m": number,
        "total_transit_duration_s": integer,
        "total_transit_idle_count": integer,
        "total_transit_idle_duration_s": integer
      },
      "id": integer,
      "imei": integer,
      "number": string,
      "plan": {
        "nodes_count": integer,
        "orders_count": integer,
        "total_duration_s": integer,
        "total_failed_time_window_count": integer,
        "total_service_duration_s": integer,
        "total_transit_distance_m": number,
        "total_transit_duration_s": integer
      },
      "version_status": string
    }
  ],
  "version": string
}
Copied to clipboard

Representation

Collapse all
Expand all

Fields

data[] *

array

data[].courier *

object

data[].courier.id *

integer

data[].courier.name *

string

data[].courier.number *

string

data[].courier.phone *

string

data[].date *

string

data[].depot *

object

data[].depot.address *

string

data[].depot.id *

integer

data[].depot.name *

string

data[].depot.number *

string

data[].depot.timezone *

string

data[].fact *

object

data[].fact.courier_violated_route *

boolean

data[].fact.delivered_orders_count *

integer

data[].fact.has_positions *

boolean

data[].fact.nodes_count *

integer

data[].fact.orders_count *

integer

data[].fact.orders_with_status_comments_count *

integer

data[].fact.plan_violated *

boolean

data[].fact.processed_orders_count *

integer

data[].fact.total_depot_idle_count *

integer

data[].fact.total_depot_idle_duration_s *

integer

data[].fact.total_failed_time_window_count *

integer

data[].fact.total_no_connection_count *

integer

data[].fact.total_no_connection_duration_s *

integer

data[].fact.total_order_idle_count *

integer

data[].fact.total_order_idle_duration_s *

integer

data[].fact.total_service_duration_depots_s *

integer

data[].fact.total_service_duration_orders_s *

integer

data[].fact.total_transit_distance_m *

number

data[].fact.total_transit_duration_s *

integer

data[].fact.total_transit_idle_count *

integer

data[].fact.total_transit_idle_duration_s *

integer

data[].id *

integer

data[].imei *

integer

data[].number *

string

data[].plan *

object

data[].plan.nodes_count *

integer

data[].plan.orders_count *

integer

data[].plan.total_duration_s *

integer

data[].plan.total_failed_time_window_count *

integer

data[].plan.total_service_duration_s *

integer

data[].plan.total_transit_distance_m *

number

data[].plan.total_transit_duration_s *

integer

data[].version_status *

string

Change type in version.

Allowed values
  1. added
  2. modified
  3. deleted

version *

string

data[] *

array

data[].courier *

object

data[].courier.id *

integer

data[].courier.name *

string

data[].courier.number *

string

data[].courier.phone *

string

data[].date *

string

data[].depot *

object

data[].depot.address *

string

data[].depot.id *

integer

data[].depot.name *

string

data[].depot.number *

string

data[].depot.timezone *

string

data[].fact *

object

data[].fact.courier_violated_route *

boolean

data[].fact.delivered_orders_count *

integer

data[].fact.has_positions *

boolean

data[].fact.nodes_count *

integer

data[].fact.orders_count *

integer

data[].fact.orders_with_status_comments_count *

integer

data[].fact.plan_violated *

boolean

data[].fact.processed_orders_count *

integer

data[].fact.total_depot_idle_count *

integer

data[].fact.total_depot_idle_duration_s *

integer

data[].fact.total_failed_time_window_count *

integer

data[].fact.total_no_connection_count *

integer

data[].fact.total_no_connection_duration_s *

integer

data[].fact.total_order_idle_count *

integer

data[].fact.total_order_idle_duration_s *

integer

data[].fact.total_service_duration_depots_s *

integer

data[].fact.total_service_duration_orders_s *

integer

data[].fact.total_transit_distance_m *

number

data[].fact.total_transit_duration_s *

integer

data[].fact.total_transit_idle_count *

integer

data[].fact.total_transit_idle_duration_s *

integer

data[].id *

integer

data[].imei *

integer

data[].number *

string

data[].plan *

object

data[].plan.nodes_count *

integer

data[].plan.orders_count *

integer

data[].plan.total_duration_s *

integer

data[].plan.total_failed_time_window_count *

integer

data[].plan.total_service_duration_s *

integer

data[].plan.total_transit_distance_m *

number

data[].plan.total_transit_duration_s *

integer

data[].version_status *

string

Change type in version.

Allowed values
  1. added
  2. modified
  3. deleted

version *

string

Code 400

Invalid parameters were passed.

Code 403

You do not have access to this object.

Code 422

Incorrect input.

Code 500

Server error during request processing.