Подтверждение ближайшей отгрузки и получение акта приема-передачи для нее
Запрос подтверждает ближайшую отгрузку и возвращает акт приема-передачи в формате PDF. Можно запросить акт в день отгрузки или накануне — в зависимости от указанного времени формирования отгрузки в кабинете.
Важно
Если ваш магазин подключен к экспресс‑доставке и вы отгружаете заказы курьерам Яндекс Go, подготавливать акт приема‑передачи не нужно.
В акт входят собранные и готовые к отправке заказы, которые отгружаются в сортировочный центр / пункт приема или курьерам Маркета.
При формировании акта Маркет автоматически находит и подставляет в шаблон следующие данные:
| Данные в акте | Описание |
|---|---|
| Отправитель | Название вашего юридического лица, указанное в кабинете продавца на Маркете. |
| Исполнитель | Название юридического лица сортировочного центра или службы доставки. |
| № отправления в системе заказчика | Ваш идентификатор заказа, который вы указали в ответе на запрос POST order/accept от Маркета. |
| № отправления в системе исполнителя (субподрядчика) | Идентификатор заказа на Маркете, как в выходных данных запроса GET campaigns/{campaignId}/orders. |
| Объявленная ценность | Общая сумма заказа без учета стоимости доставки, как в выходных данных запроса GET campaigns/{campaignId}/orders или GET campaigns/{campaignId}/orders/{orderId}. |
| Стоимость всех товаров в заказе | Стоимость всех заказанных товаров. |
| Вес | Масса брутто грузового места (суммарная масса упаковки и содержимого), как в выходных данных запроса GET campaigns/{campaignId}/orders или GET campaigns/{campaignId}/orders/{orderId}. |
| Количество мест | Количество грузовых мест в заказе, как в выходных данных запроса GET campaigns/{campaignId}/orders или GET campaigns/{campaignId}/orders/{orderId}. |
Остальные поля нужно заполнить самостоятельно в распечатанном акте.
| ⚙️ Лимит: 100 запросов в час |
|---|
Request
GET
https://api.partner.market.yandex.ru/campaigns/{campaignId}/shipments/reception-transfer-act
Path parameters
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Query parameters
|
Name |
Type |
Description |
|
warehouse_id |
integer<int32> |
Идентификатор склада |
Responses
200 OK
Акт приема-передачи в формате pdf
Body
application/pdf
Type: string
Format: binary
400 Bad Request
| Описание | Пояснение | Способы решения |
|---|---|---|
| No orders for closest shipment found. | Нет заказов в ближайшей отгрузке. | Проверьте, что у заказов параметр status имеет значение PROCESSING, а параметр substatus — READY_TO_SHIP. Получить статусы и даты отгрузки заказов можно с помощью запросов GET campaigns/{campaignId}/orders и GET campaigns/{campaignId}/orders/{orderId}, изменить статусы заказов — с помощью запросов PUT campaigns/{campaignId}/orders/{orderId}/status и POST campaigns/{campaignId}/orders/status‑update. |
| Closest shipment for reception transfer act generation not found. | Отгрузки в статусе Можно обрабатывать не найдены. | Создайте заявку на поставку или дождитесь перехода существующей заявки в нужный статус. |
| Some orders have not been processed yet. Please change the status of orders to READY_TO_SHIP and try again. {orders id}. | Идентификаторы заказов в ближайшей отгрузке, которые еще не обработаны. | Передайте для заказов с указанными идентификаторами status: PROCESSING и substatus: READY_TO_SHIP и попробуйте еще раз. Изменить статусы заказов можно с помощью запросов PUT campaigns/{campaignId}/orders/{orderId}/status и POST campaigns/{campaignId}/orders/status‑update. |
| Some orders are in the process of being excluded from shipment {orders id}. Please wait up to 30 minutes and try again. | Идентификаторы заказов в ближайшей отгрузке, которые в процессе удаления из нее. | Перенос заказов может занимать до 30 минут. Дождитесь окончания переноса и попробуйте снова. |
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 |
Список ошибок. |