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": "string",
"places": {
"dimensions": {
"weight_gross": 0,
"dx": 0,
"dy": 0,
"dz": 0
},
"barcode": "string",
"items": [
{
"count": 0,
"item_barcode": "string"
}
]
}
}
|
Name |
Description |
|
places* |
Type: PlacesEditRequestPlace Информация о местах в заказе |
|
request_id* |
Type: string Идентификатор заказа в системе |
PlacesEditRequestPlace
По умолчанию штрихкод грузоместа подменяется на уникальный на стороне Яндекс Доставки.
Чтобы использовать собственные штрихкоды или работать с кастомными маркировками, обратитесь к менеджеру.
Для получения актуальных штрихкодов возмользуйтесь методом 3.03. Получение информации о заявке.
|
Name |
Description |
|
barcode* |
Type: string Штрихкод коробки |
|
dimensions* |
Type: PlaceDimensions Физические параметры места |
|
items* |
Type: PlacesEditRequestItems[] Информация о предметах в заказе |
PlaceDimensions
Указываются габариты (dx, dy, dz).
|
Name |
Description |
|
dx* |
Type: integer Длина, сантиметры Min value: |
|
dy* |
Type: integer Высота, сантиметры Min value: |
|
dz* |
Type: integer Ширина, сантиметры Min value: |
|
weight_gross* |
Type: integer Вес брутто, граммы Min value: |
PlacesEditRequestItems
|
Name |
Description |
|
count* |
Type: integer Количество товара в коробке |
|
item_barcode* |
Type: string Штрихкод товара, который находится в этой коробке |
Responses
202 Accepted
Запрос на редактирование принят
Body
application/json
{
"editing_task_id": "string"
}
|
Name |
Description |
|
editing_task_id* |
Type: string Идентификатор созданного запроса на редактирование для уточнения его статуса |
400 Bad Request
400 error
Body
application/json
{
"code": "bad_request",
"message": "Missing field request_id"
}
|
Name |
Description |
|
code* |
Type: string Код ошибки Example: |
|
message* |
Type: string Человекочитаемые детали ошибки Example: |
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: |
|
message* |
Type: string Человекочитаемые детали ошибки Example: |
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: |
|
message* |
Type: string Человекочитаемые детали ошибки Example: |
409 Conflict
409 error
Body
application/json
{
"code": "conflict",
"message": "Another editing request with conflict data execution"
}
|
Name |
Description |
|
code* |
Type: string Код ошибки Example: |
|
message* |
Type: string Человекочитаемые детали ошибки Example: |
No longer supported, please use an alternative and newer version.