3.06. Редактирование заказа

Заявка на редактирование заказа.

Метод позволяет редактировать:

  • данные получателя

  • интервал доставки для точки Б (destination)

  • грузоместа (штрих-код коробки и ВГХ)

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

Возможность редактирования можно посмотреть в поле available_actions метода Получение информации о заявке и ее текущем статусе:

  • update_recipient — Доступность изменения информации о получателе заказа;
  • update_places — Доступность изменения грузомест в заказе;
  • update_dates_available — Доступность изменения даты доставки.

Request

POST

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

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

POST

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

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

Body

application/json
{
  "request_id": "77241d8009bb46d0bff5c65a73077bcd-udp",
  "recipient_info": {
    "first_name": "Василий",
    "last_name": "Пупкин",
    "patronymic": "Михайлович",
    "phone": "+79529999999",
    "email": "pupkin@mail.ru"
  },
  "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"
    }
  },
  "places": [
    {
      "barcode": "Kia-01",
      "place": {
        "physical_dims": {
          "weight_gross": 100,
          "dx": 10,
          "dy": 10,
          "dz": 10
        },
        "barcode": "Kia-01"
      }
    }
  ]
}

Name

Description

request_id

Type: string

ID заказа

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"
  }
}

places

Type: EditPlace[]

Данные о грузоместах.

Example
[
  {
    "barcode": "Kia-01",
    "place": {
      "physical_dims": {
        "weight_gross": 100,
        "dx": 10,
        "dy": 10,
        "dz": 10
      },
      "barcode": "Kia-01"
    }
  }
]

recipient_info

Type: Contact

Данные о получателе.

Example
{
  "first_name": "Василий",
  "last_name": "Пупкин",
  "patronymic": "Михайлович",
  "phone": "+79529999999",
  "email": "pupkin@mail.ru"
}

Contact

Name

Description

first_name

Type: string

Имя

Example: Василий

phone

Type: string

Номер телефона

Example: +79529999999

email

Type: string

Адрес электронной почты

Example: pupkin@mail.ru

last_name

Type: string

Фамилия

Example: Пупкин

patronymic

Type: string

Отчество

Example: Михайлович
Example
{
  "first_name": "Василий",
  "last_name": "Пупкин",
  "patronymic": "Михайлович",
  "phone": "+79529999999",
  "email": "pupkin@mail.ru"
}

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"
  }
}

PlacePhysicalDimensions

Весогабаритные характеристики грузомест

Name

Description

dx

Type: integer

Длина, сантиметры

dy

Type: integer

Высота, сантиметры

dz

Type: integer

Ширина, сантиметры

weight_gross

Type: integer

Вес брутто, граммы
Example
{
  "weight_gross": 100,
  "dx": 10,
  "dy": 10,
  "dz": 10
}

ResourcePlace

Name

Description

barcode

Type: string

Штрихкод коробки.
По умолчанию штрихкод грузоместа подменяется на уникальный на стороне Яндекс Доставки.
Чтобы использовать собственные штрихкоды или работать с кастомными маркировками, обратитесь к менеджеру.
Для получения актуальных штрихкодов воспользуйтесь методом 3.03. Получение информации о заявке.

Example: Kia-01

physical_dims

Type: PlacePhysicalDimensions

Физические параметры места

Весогабаритные характеристики грузомест

Example
{
  "weight_gross": 100,
  "dx": 10,
  "dy": 10,
  "dz": 10
}
Example
{
  "physical_dims": {
    "weight_gross": 100,
    "dx": 10,
    "dy": 10,
    "dz": 10
  },
  "barcode": "Kia-01"
}

EditPlace

Редактируемое грузоместо

Name

Description

barcode

Type: string

Старый штрихкод грузоместа

Example: Kia-01

place

Type: ResourcePlace

Новое грузоместо

Example
{
  "physical_dims": {
    "weight_gross": 100,
    "dx": 10,
    "dy": 10,
    "dz": 10
  },
  "barcode": "Kia-01"
}
Example
{
  "barcode": "Kia-01",
  "place": {
    "physical_dims": {
      "weight_gross": 100,
      "dx": 10,
      "dy": 10,
      "dz": 10
    },
    "barcode": "Kia-01"
  }
}

Responses

200 OK

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

Body

application/json
{
  "edit_id": "efb951b3280b4924b46b61a5db20df85"
}

Name

Description

edit_id

Type: string

ID операции редактирования

Example: efb951b3280b4924b46b61a5db20df85
Предыдущая
3.05. Получение актуальной информации о доставке
Следующая
3.07. Получение интервалов доставки для текущего места получения заказа.