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

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

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

данные получателя
интервал доставки для точки Б (destination)
грузоместа (штрих-код коробки и ВГХ)

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

Редактировать заказ можно:

До момента выезда курьера клиенту (до статуса DELIVERY_TRANSPORTATION_RECIPIENT)
До момента отгрузки заказа с СЦ на ПВЗ (до статуса DELIVERY_ARRIVED_PICKUP_POINT)

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

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. Получение интервалов доставки для текущего места получения заказа.