Перенос заказов в следующую отгрузку

Info

Console

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

inventory-and-order-processing — Обработка заказов и учёт товаров
all-methods — Полное управление кабинетом

Переносит указанные заказы из указанной отгрузки в следующую отгрузку. Что такое отгрузка?

Используйте этот запрос, если не успеваете собрать и упаковать заказы вовремя.

Такие переносы снижают индекс качества магазина

Этот запрос предназначен для исключительных случаев. Если вы будете переносить заказы слишком часто, магазин столкнется с ограничениями. Что за ограничения?

Переносить заказы можно, если до формирования отгрузки осталось больше получаса.

Перенос происходит не мгновенно, а занимает несколько минут.

⚙️ Лимит: 200 запросов в час

Request

POST

https://api.partner.market.yandex.ru/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/orders/transfer

Path parameters

Name

Description

campaignId*

Type: integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Min value: 1

shipmentId*

Type: integer<int64>

Идентификатор отгрузки.

Min value: 1

Body

application/json

{
    "orderIds": [
        0
    ]
}

Name

Description

orderIds*

Type: integer<int64>[]

Список заказов, которые вы не успеваете подготовить.
Идентификатор заказа.

Max items: 500

Min items: 1

Responses

200 OK

Запрос на перенос заказов проверен и принят, и они будут перенесены спустя несколько минут.

Body

application/json

{
    "status": "OK"
}

Name

Description

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

ApiResponseStatusType

Тип ответа.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

400 Bad Request

Ошибка 400 обозначает, что в переданном вами списке заказов что-то не так — например, не все они относятся к заданной отгрузке. В сообщении об ошибке будут все подробности.

Частичное выполнение запроса невозможно

Если в списке есть хотя бы один проблемный идентификатор, не будет перенесен ни один заказ из списка.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

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

Подтверждение отгрузки и получение акта для нее

Информация об одной отгрузке