3.08. Получение интервалов доставки для нового места получения заказа

Получение интервалов доставки для нового места получения заказа.

Request

POST

b2b.taxi.tst.yandex.net/api/b2b/platform/request/redelivery_options

Тестовое окружение

POST

b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/redelivery_options

Продакшен-окружение

Body

application/json
{
  "request_id": "77241d8009bb46d0bff5c65a73077bcd-udp",
  "destination": {
    "type": "platform_station",
    "platform_station": {
      "platform_id": "e1139f6d-e34f-47a9-a55f-31f032a861a6"
    },
    "custom_location": {
      "latitude": 0.5,
      "longitude": 0.5,
      "details": {
        "geoId": 213,
        "country": "Россия",
        "region": "Москва",
        "subRegion": "Московская область",
        "locality": "Москва",
        "street": "Пролетарский проспект",
        "house": "19",
        "housing": "1",
        "apartment": "2",
        "building": "1",
        "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
        "full_address": "Москва, Пролетарский проспект, 19",
        "postal_code": "123182"
      }
    },
    "interval_utc": {
      "from": "2021-10-25T15:00:00.000000Z",
      "to": "2021-10-25T15:00:00.000000Z"
    }
  }
}

Name

Description

request_id

Type: unknown

Идентификатор заказа.

Example: 77241d8009bb46d0bff5c65a73077bcd-udp

destination

Type: DestinationRequestNode

Информация о точке получения заказа.
Желаемые интервалы доставки в этой ручке игнорируются.

Example
{
  "type": "platform_station",
  "platform_station": {
    "platform_id": "e1139f6d-e34f-47a9-a55f-31f032a861a6"
  },
  "custom_location": {
    "latitude": 0.5,
    "longitude": 0.5,
    "details": {
      "geoId": 213,
      "country": "Россия",
      "region": "Москва",
      "subRegion": "Московская область",
      "locality": "Москва",
      "street": "Пролетарский проспект",
      "house": "19",
      "housing": "1",
      "apartment": "2",
      "building": "1",
      "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
      "full_address": "Москва, Пролетарский проспект, 19",
      "postal_code": "123182"
    }
  },
  "interval_utc": {
    "from": "2021-10-25T15:00:00.000000Z",
    "to": "2021-10-25T15:00:00.000000Z"
  }
}

PlatformStation

Name

Description

platform_id

Type: string

Идентификатор станции в Логистической платформе (например, склад отгрузки или ПВЗ)

Example: e1139f6d-e34f-47a9-a55f-31f032a861a6

Example
{
  "platform_id": "e1139f6d-e34f-47a9-a55f-31f032a861a6"
}

LocationDetails

Адрес квартиры обязателен при наличии

Name

Description

apartment

Type: string

Номер квартиры

Example: 2

building

Type: string

Строение

Example: 1

comment

Type: string

Комментарий

Example: Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет

country

Type: string

Страна

Example: Россия

full_address

Type: string

Полный адрес с указанием города, улицы и номера дома

Example: Москва, Пролетарский проспект, 19

geoId

Type: number

Идентификатор города

house

Type: string

Номер дома

Example: 19

housing

Type: string

Корпус

Example: 1

locality

Type: string

Населенный пункт

Example: Москва

postal_code

Type: string

Индекс

Example: 123182

region

Type: string

Регион

Example: Москва

street

Type: string

Улица

Example: Пролетарский проспект

subRegion

Type: string

Область

Example: Московская область

Example
{
  "geoId": 213,
  "country": "Россия",
  "region": "Москва",
  "subRegion": "Московская область",
  "locality": "Москва",
  "street": "Пролетарский проспект",
  "house": "19",
  "housing": "1",
  "apartment": "2",
  "building": "1",
  "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
  "full_address": "Москва, Пролетарский проспект, 19",
  "postal_code": "123182"
}

CustomLocation

Информация о произвольной точке. Точка может быть задана либо своими координатами — пара (latitude, longitude), либо адресом

Name

Description

details

Type: LocationDetails

Дополнительная информация о расположении станции

Адрес квартиры обязателен при наличии

Example
{
  "geoId": 213,
  "country": "Россия",
  "region": "Москва",
  "subRegion": "Московская область",
  "locality": "Москва",
  "street": "Пролетарский проспект",
  "house": "19",
  "housing": "1",
  "apartment": "2",
  "building": "1",
  "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
  "full_address": "Москва, Пролетарский проспект, 19",
  "postal_code": "123182"
}

latitude

Type: number

Широта

longitude

Type: number

Долгота

Example
{
  "latitude": 0.5,
  "longitude": 0.5,
  "details": {
    "geoId": 213,
    "country": "Россия",
    "region": "Москва",
    "subRegion": "Московская область",
    "locality": "Москва",
    "street": "Пролетарский проспект",
    "house": "19",
    "housing": "1",
    "apartment": "2",
    "building": "1",
    "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
    "full_address": "Москва, Пролетарский проспект, 19",
    "postal_code": "123182"
  }
}

TimestampUNIX

Type: integer

TimestampUTC

Type: string

Example: 2021-10-25T15:00:00.000000Z

TimeIntervalUTC

Интервал времени в формате UTC.

Name

Description

from

Type: TimestampUNIX

UTC timestamp для нижней границы интервала

Example: 2021-10-25T15:00:00.000000Z

to

Type: TimestampUTC

UTC timestamp для верхней границы интервала

Example: 2021-10-25T15:00:00.000000Z

Example
{
  "from": "2021-10-25T15:00:00.000000Z",
  "to": "2021-10-25T15:00:00.000000Z"
}

DestinationRequestNode

Name

Description

type

Type: string

Тип целевой точки. Для доставки до двери — custom_location (2), для доставки до ПВЗ — platform_station (1)

Enum: platform_station, custom_location

custom_location

Type: CustomLocation

Полное описание целевого адреса доставки

Информация о произвольной точке. Точка может быть задана либо своими координатами — пара (latitude, longitude), либо адресом

Example
{
  "latitude": 0.5,
  "longitude": 0.5,
  "details": {
    "geoId": 213,
    "country": "Россия",
    "region": "Москва",
    "subRegion": "Московская область",
    "locality": "Москва",
    "street": "Пролетарский проспект",
    "house": "19",
    "housing": "1",
    "apartment": "2",
    "building": "1",
    "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
    "full_address": "Москва, Пролетарский проспект, 19",
    "postal_code": "123182"
  }
}

interval_utc

Type: TimeIntervalUTC

Временной интервал (в UTC)

Интервал времени в формате UTC.

Example
{
  "from": "2021-10-25T15:00:00.000000Z",
  "to": "2021-10-25T15:00:00.000000Z"
}

platform_station

Type: PlatformStation

Описание целевой станции в случае, если она зарегистрирована в платформе

Example
{
  "platform_id": "e1139f6d-e34f-47a9-a55f-31f032a861a6"
}
Example
{
  "type": "platform_station",
  "platform_station": {
    "platform_id": "e1139f6d-e34f-47a9-a55f-31f032a861a6"
  },
  "custom_location": {
    "latitude": 0.5,
    "longitude": 0.5,
    "details": {
      "geoId": 213,
      "country": "Россия",
      "region": "Москва",
      "subRegion": "Московская область",
      "locality": "Москва",
      "street": "Пролетарский проспект",
      "house": "19",
      "housing": "1",
      "apartment": "2",
      "building": "1",
      "comment": "Станция метро Щукинская (4выход) второй дом слева. Вход со двора с дальнего края дома. Ориентир вывеска Яндекс Маркет",
      "full_address": "Москва, Пролетарский проспект, 19",
      "postal_code": "123182"
    }
  },
  "interval_utc": {
    "from": "2021-10-25T15:00:00.000000Z",
    "to": "2021-10-25T15:00:00.000000Z"
  }
}

Responses

200 OK

Успешный запрос

Body

application/json
{
  "options": [
    {
      "from": "2021-10-25T15:00:00.000000Z",
      "to": "2021-10-25T15:00:00.000000Z"
    }
  ]
}

Name

Description

options

Type: TimeIntervalUTC[]

Возможные интервалы доставки

Example
[
  {
    "from": "2021-10-25T15:00:00.000000Z",
    "to": "2021-10-25T15:00:00.000000Z"
  }
]