3.12. Редактирование грузомест заказа

Создание заявки на редактирование грузомест заказа.
Принимает полный набор новых коробок с товарами внутри. Метод позволяет как удалить, так и добавить новое грузоместо.
Если товары в заказе и запросе не совпадут, редактирование завершится с ошибкой.
Редактирование происходит асинхронно. Чтобы узнать текущий статус, введите запрос на получение статуса запроса на редактирование /api/b2b/platform/request/edit/status.

Request

POST

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

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

POST

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

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

Body

application/json

{
  "request_id": "77241d8009bb46d0bff5c65a73077bcd-udp",
  "places": {
    "dimensions": {
      "weight_gross": 1,
      "dx": 1,
      "dy": 1,
      "dz": 1
    },
    "barcode": "Kia-01",
    "items": [
      {
        "count": 0,
        "item_barcode": "9f210a050a7282f353d9ab9ac9e27cb4"
      }
    ]
  }
}

Name

Description

places

Type: PlacesEditRequestPlace

Информация о местах в заказе

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

Example

{
  "dimensions": {
    "weight_gross": 1,
    "dx": 1,
    "dy": 1,
    "dz": 1
  },
  "barcode": "Kia-01",
  "items": [
    {
      "count": 0,
      "item_barcode": "9f210a050a7282f353d9ab9ac9e27cb4"
    }
  ]
}

request_id

Type: string

Идентификатор заказа в системе

Example: 77241d8009bb46d0bff5c65a73077bcd-udp

PlaceDimensions

Указываются габариты (dx, dy, dz).

Name	Description
dx	Type: integer Длина, сантиметры Min value: `1`
dy	Type: integer Высота, сантиметры Min value: `1`
dz	Type: integer Ширина, сантиметры Min value: `1`
weight_gross	Type: integer Вес брутто, граммы Min value: `1`

Example

{
  "weight_gross": 1,
  "dx": 1,
  "dy": 1,
  "dz": 1
}

PlacesEditRequestItems

Name

Description

count

Type: integer

Количество товара в коробке

item_barcode

Type: string

Штрихкод товара, который находится в этой коробке

Example: 9f210a050a7282f353d9ab9ac9e27cb4

Example

{
  "count": 0,
  "item_barcode": "9f210a050a7282f353d9ab9ac9e27cb4"
}

PlacesEditRequestPlace

Name	Description
barcode	Type: string Штрихкод коробки Example: `Kia-01`
dimensions	Type: PlaceDimensions Физические параметры места Указываются габариты (dx, dy, dz). Example `{ "weight_gross": 1, "dx": 1, "dy": 1, "dz": 1 }`
items	Type: PlacesEditRequestItems[] Example `[ { "count": 0, "item_barcode": "9f210a050a7282f353d9ab9ac9e27cb4" } ]`

Example

{
  "dimensions": {
    "weight_gross": 1,
    "dx": 1,
    "dy": 1,
    "dz": 1
  },
  "barcode": "Kia-01",
  "items": [
    {
      "count": 0,
      "item_barcode": "9f210a050a7282f353d9ab9ac9e27cb4"
    }
  ]
}

Responses

202 Accepted

Запрос на редактирование принят

Body

application/json

{
  "editing_task_id": "51487d835c3444e9b157b1061567f10a"
}

Name

Description

editing_task_id

Type: string

Идентификатор созданного запроса на редактирование для уточнения его статуса

Example: 51487d835c3444e9b157b1061567f10a

400 Bad Request

400 error

Body

application/json

{
  "code": "bad_request",
  "message": "Missing field request_id"
}

Name

Description

code

Type: string

Example: bad_request

message

Type: string

Example: Missing field request_id

403 Forbidden

403 error

Body

application/json

{
  "code": "customer_order_not_found",
  "message": "There is no customer_order with such ID  in platform, the order belongs to another employer"
}

Name

Description

code

Type: string

Код ошибки

Example: customer_order_not_found

message

Type: string

Человекочитаемые детали ошибки

Example: There is no customer_order with such ID in platform, the order belongs to another employer

404 Not Found

404 error

Body

application/json

{
  "code": "not_found",
  "message": "Order with ID  some_id not found"
}

Name

Description

code

Type: string

Код ошибки

Example: not_found

message

Type: string

Человекочитаемые детали ошибки

Example: Order with ID some_id not found

409 Conflict

409 error

Body

application/json

{
  "code": "conflict",
  "message": "Another editing request with conflict data execution"
}

Name

Description

code

Type: string

Код ошибки

Example: conflict

message

Type: string

Человекочитаемые детали ошибки

Example: Another editing request with conflict data execution

Была ли статья полезна?

3.11. Создание заказа

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