Получение вариантов доставки (для РФ)

items

Type: Item[]

Параметры товаров

Min items: 1

[
  {
    "size": {
      "length": 0.1,
      "width": 0.2,
      "height": 0.3
    },
    "weight": 2.105,
    "quantity": 1,
    "pickup_point": 1,
    "dropoff_point": 2
  }
]

route_points

Type: RoutePointWithAddress[]

Точки маршрута. Отсортированы в порядке посещения А-Б1....БN

Min items: 2

[
  {
    "id": 1,
    "coordinates": [
      0.1,
      0.1
    ],
    "fullname": "Санкт-Петербург, Большая Монетная улица, 1к1А",
    "country": "Россия",
    "city": "Санкт-Петербург",
    "street": "Большая Монетная улица",
    "building": "23к1А",
    "porch": "A",
    "sfloor": "1",
    "sflat": "1"
  },
  {
    "id": 1,
    "coordinates": [
      0.1,
      0.1
    ],
    "fullname": "Санкт-Петербург, Большая Монетная улица, 1к1А",
    "country": "Россия",
    "city": "Санкт-Петербург",
    "street": "Большая Монетная улица",
    "building": "23к1А",
    "porch": "A",
    "sfloor": "1",
    "sflat": "1"
  }
]

requirements

Type: OfferRequirements

Требования к доставке

{
  "taxi_classes": [
    "cargo"
  ],
  "cargo_type": "lcv_m",
  "cargo_loaders": 1,
  "pro_courier": false,
  "cargo_options": [
    "thermobag"
  ],
  "skip_door_to_door": false,
  "due": "2020-01-01T00:00:00+00:00",
  "rental_duration": 0
}

height

Type: number

Высота в метрах

Min value: 0

Max value: 500

length

Type: number

Длина в метрах

Min value: 0

Max value: 500

width

Type: number

Ширина в метрах

Min value: 0

Max value: 500

quantity

Type: integer

Количество единиц товара

Min value: 1

dropoff_point

Type: integer

Идентификатор точки (int64), куда нужно доставить товар.
Может быть любым числом. Должен соответствовать значению route_points[].id у точки назначения.
Параметр обязательный, если в заказе несколько точек доставки.

pickup_point

Type: integer

Идентификатор точки (int64), откуда нужно забрать товар.
Может быть любым числом. Должен соответствовать значению route_points[].id у точки отправки.
Параметр обязательный, если в заказе несколько точек доставки.

size

Type: CargoItemSizes

Габариты товара в метрах. В полях следует передавать актуальные значения.

Если габариты не были переданы, заказ оформляется с учетом
максимально допустимых габаритов для выбранного тарифа.

Если фактические характеристики товара превысят допустимые,
курьер вправе отказаться от выполнения такого заказа на месте.
В этом случае будет удержана стоимость подачи.

Курьер (courier): до 0.80 м × 0.50 м × 0.50 м
Экспресс (express): до 1.00 м × 0.60 м × 0.50 м
Грузовой (cargo):

• Маленький кузов: до 1.70 м × 0.96 м × 0.90 м
• Средний кузов: до 2.60 м × 1.30 м × 1.50 м
• Большой кузов: до 3.80 м × 1.80 м × 1.80 м

{
  "length": 0.1,
  "width": 0.2,
  "height": 0.3
}

weight

Type: number

Вес товара в килограммах.
Пример: 2.105

building

Type: string

Строение

Example: 23к1А

city

Type: string

Город

Example: Санкт-Петербург

coordinates

Type: Point

Координаты точек в виде массива из двух вещественных чисел: долгота, широта — именно в таком порядке.

Min items: 2

Max items: 2

[
  0.1,
  0.1
]

country

Type: string

Страна

Example: Россия

fullname

Type: AddressFullname

Полный адрес с указанием города, улицы и номера дома.
Номер квартиры, подъезда и этаж указывать не нужно.

Example: Санкт-Петербург, Большая Монетная улица, 1к1А

id

Type: integer

Числовой id точки(int64). Параметр обязательный, если в заказе несколько точек доставки

porch

Type: string

Подъезд (может быть A)

Example: A

sflat

Type: string

Квартира

Example: 1

sfloor

Type: string

Этаж

Example: 1

street

Type: string

Улица

Example: Большая Монетная улица

cargo_loaders

Type: integer

Число грузчиков для грузового тарифа.
Возможные значения: 0, 1, 2.

Точный список возможных значений для конкретной геоточки
уточните с помощью метода получения тарифов tariffs

cargo_options

Type: CargoOptions

Список дополнительных опций тарифа.

Возможные отдельные опции:

• auto_courier (курьер только на автомобиле)
• thermobag (курьер с термосумкой)

Пример списка опций: ["auto_courier"].

Точный список возможных значений для конкретной геоточки
уточните с помощью метода получения тарифов tariffs

[
  "thermobag"
]

cargo_type

Type: CargoType

Тип (размер) кузова для грузового тарифа.
Возможные значения:

• van ("Маленький кузов")
• lcv_m ("Средний кузов")
• lcv_l ("Большой кузов")
• lcv_xl ("Кузов XL")
  Точный список возможных значений для конкретной геоточки уточняйте с помощью метода получения тарифов tariffs

Enum: van, lcv_m, lcv_l, lcv_xl

due

Type: string<date-time>

Желаемое время прибытия исполнителя на точку А (source).
В РФ отложить расчетное время прибытия исполнителя можно:
- на 30-240 минут от текущего момента – для тарифа express;
- на пять суток от текущего момента – для тарифа cargo.

Параметр не совместим с опциями замедления в тарифе express на территории РФ.
Если этот параметр не задан, то запустится поиск исполнителя на ближайшее время.

Example: 2020-01-01T00:00:00+00:00

pro_courier

Type: boolean

Включить опцию "Профи" для тарифов "Экспресс" и "Курьер".
Поиск исполнителя будет происходить только среди опытных курьеров.

rental_duration

Type: integer

Время аренды, которое планирует клиент. Указывается в минутах.
Указывайте этот параметр только для почасового тарифа

skip_door_to_door

Type: boolean

Отключить доставку до двери (выключить опцию "От двери до двери").

Возможные значения:

• true (курьер доставит заказ только на улицу, до подъезда)
• false (курьер доставит заказ до двери)

Default: false

taxi_classes

Type: string[]

Класс автомобиля для доставки.
Возможные значения: courier, express, cargo.

Точный список возможных значений для конкретной геоточки
уточните с помощью метода получения тарифов tariffs

Min items: 1

[
  "cargo"
]