Перенос заказов в следующую отгрузку
Переносит указанные заказы из указанной отгрузки в следующую отгрузку. Что такое отгрузка?
Используйте этот запрос, если не успеваете собрать и упаковать заказы вовремя.
Такие переносы снижают индекс качества магазина
Этот запрос предназначен для исключительных случаев. Если вы будете переносить заказы слишком часто, магазин столкнется с ограничениями. Что за ограничения?
Переносить заказы можно, если до формирования отгрузки осталось больше получаса.
Перенос происходит не мгновенно, а занимает несколько минут.
| ⚙️ Лимит: 200 запросов в час |
|---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/orders/transfer
Path parameters
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
|
shipmentId* |
integer<int64> |
Идентификатор отгрузки. |
Body
{
"orderIds": [
0
]
}
|
Name |
Type |
Description |
|
orderIds* |
integer<int64>[] |
Список заказов, которые вы не успеваете подготовить. |
Responses
200 OK
Запрос на перенос заказов проверен и принят, и они будут перенесены спустя несколько минут.
Body
{
"status": "OK"
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
ApiResponseStatusType
Тип ответа.
|
Type |
Description |
|
Enum: |
400 Bad Request
Ошибка 400 обозначает, что в переданном вами списке заказов что-то не так — например, не все они относятся к заданной отгрузке. В сообщении об ошибке будут все подробности.
Частичное выполнение запроса невозможно
Если в списке есть хотя бы один проблемный идентификатор, не будет перенесен ни один заказ из списка.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
|
Name |
Type |
Description |
|
code* |
string |
Код ошибки. |
|
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
|
|
errors |
Список ошибок. |