Получение накладных для частей заказов

Система формирует накладные (акты приема‑передачи отправлений) для указанных частей заказов и возвращает ссылки на PDF‑файлы с документами.

Правила и ограничения:

Накладная оформляется на партию — части заказов автоматически группируются по складу и службе доставки, для каждой такой группы создается отдельный документ.
При каждом запросе система запрашивает накладную у службы доставки — повторный запрос не использует ранее сгенерированный документ, а формирует новый.
Части заказов, для которых невозможно получить накладную (например, при самовывозе, если доставка еще не создана в службе или служба не предоставляет накладные), не включаются в массив waybills. Такие части заказов отображаются в массиве skipped — с указанием причины, по которой накладная не была сформирована.
Ссылки на PDF‑файлы подписаны и имеют ограниченный срок действия. Дата истечения срока указана в поле expires_at. Хранить ссылку не требуется — для получения актуальной ссылки выполните повторный запрос.

Request

POST

https://api.kit.yandex.net/v1/orders/waybills

Body

application/json

{
  "items": [
    {
      "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
      "delivery_chunk_id": 1
    }
  ]
}

Name

Description

items

Type: OrderDeliveryChunkRef[]

Части заказов, для которых нужны накладные. Пара заказ + чанк не может повторяться.

Min items: 1

Max items: 100

Example

[
  {
    "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
    "delivery_chunk_id": 1
  }
]

OrderID

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

Type: string<uuid>

Example: 019b56d1-5ef0-7ed2-a155-7110d25ca5ce

OrderDeliveryChunkRef

Ссылка на часть заказа.

Name

Description

delivery_chunk_id

Type: integer

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

order_id

Type: OrderID

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

Example: 019b56d1-5ef0-7ed2-a155-7110d25ca5ce

Example

{
  "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
  "delivery_chunk_id": 1
}

Responses

200 OK

Накладные сформированы.

Body

application/json

{
  "waybills": [
    {
      "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "delivery_service": "YANDEX_DELIVERY",
      "url": "https://example.com/waybills/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
      "expires_at": "2026-08-18T12:00:00Z",
      "delivery_chunks": [
        {
          "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
          "delivery_chunk_id": 1
        }
      ]
    }
  ],
  "skipped": [
    {
      "order_id": null,
      "delivery_chunk_id": 1,
      "reason": "SELF_PICKUP"
    }
  ]
}

Name

Description

skipped

Type: SkippedOrderWaybill[]

Части заказов, для которых накладная не сформирована.

Example

[
  {
    "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
    "delivery_chunk_id": 1,
    "reason": "SELF_PICKUP"
  }
]

waybills

Type: OrderWaybill[]

Сформированные накладные.

Example

[
  {
    "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "delivery_service": "YANDEX_DELIVERY",
    "url": "https://example.com/waybills/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
    "expires_at": "2026-08-18T12:00:00Z",
    "delivery_chunks": [
      {
        "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
        "delivery_chunk_id": 1
      }
    ]
  }
]

WarehouseID

Идентификатор склада.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

DeliveryServiceType

Служба доставки:

YANDEX_DELIVERY — Яндекс Доставка.
CDEK — СДЭК.
META_SHIP_DALLI — Dalli через MetaShip.
META_SHIP_RUSSIAN_POST — Почта России через MetaShip.
META_SHIP_PECOM — ПЭК через MetaShip.
OZON — Ozon Доставка.
MERCHANT_SHIP — собственная служба доставки магазина.
YANDEX_MARKET_FBO — Фулфилмент Яндекс Маркета.

Type: string

Enum: YANDEX_DELIVERY, CDEK, META_SHIP_DALLI, META_SHIP_RUSSIAN_POST, META_SHIP_PECOM, OZON, MERCHANT_SHIP, YANDEX_MARKET_FBO

OrderWaybill

Накладная на партию отправлений одного склада, отправляемых одной службой доставки.

Name	Description
delivery_chunks	Type: OrderDeliveryChunkRef[] Части заказов, вошедшие в накладную. Example `[ { "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce", "delivery_chunk_id": 1 } ]`
delivery_service	Type: DeliveryServiceType Служба доставки: `YANDEX_DELIVERY` — Яндекс Доставка. `CDEK` — СДЭК. `META_SHIP_DALLI` — Dalli через MetaShip. `META_SHIP_RUSSIAN_POST` — Почта России через MetaShip. `META_SHIP_PECOM` — ПЭК через MetaShip. `OZON` — Ozon Доставка. `MERCHANT_SHIP` — собственная служба доставки магазина. `YANDEX_MARKET_FBO` — Фулфилмент Яндекс Маркета. Enum: `YANDEX_DELIVERY`, `CDEK`, `META_SHIP_DALLI`, `META_SHIP_RUSSIAN_POST`, `META_SHIP_PECOM`, `OZON`, `MERCHANT_SHIP`, `YANDEX_MARKET_FBO`
expires_at	Type: string<date-time> Момент, после которого ссылка перестает работать. Example: `2026-08-18T12:00:00Z`
url	Type: string<uri> Подписанная ссылка на PDF-файл с накладной. Example: `https://example.com/waybills/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890`
warehouse_id	Type: WarehouseID Идентификатор склада. Example: `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

Example

{
  "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "delivery_service": "YANDEX_DELIVERY",
  "url": "https://example.com/waybills/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
  "expires_at": "2026-08-18T12:00:00Z",
  "delivery_chunks": [
    {
      "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
      "delivery_chunk_id": 1
    }
  ]
}

SkippedOrderWaybillReason

Причина, по которой накладная не сформирована:

SELF_PICKUP — самовывоз, отправления нет и накладная не нужна.
DELIVERY_NOT_CREATED — доставка еще не создана в службе доставки, трек-номера нет.
NO_WAREHOUSE — у части заказа не указан склад отправления.
SERVICE_NOT_SUPPORTED — служба доставки не выдает накладные (собственная доставка магазина и часть служб).

Type: string

Enum: SELF_PICKUP, DELIVERY_NOT_CREATED, NO_WAREHOUSE, SERVICE_NOT_SUPPORTED

SkippedOrderWaybill

Часть заказа, для которой накладная не сформирована.

Name	Description
delivery_chunk_id	Type: integer Идентификатор чанка заказа.
order_id	Type: OrderID Идентификатор заказа. Example: `019b56d1-5ef0-7ed2-a155-7110d25ca5ce`
reason	Type: SkippedOrderWaybillReason Причина, по которой накладная не сформирована: `SELF_PICKUP` — самовывоз, отправления нет и накладная не нужна. `DELIVERY_NOT_CREATED` — доставка еще не создана в службе доставки, трек-номера нет. `NO_WAREHOUSE` — у части заказа не указан склад отправления. `SERVICE_NOT_SUPPORTED` — служба доставки не выдает накладные (собственная доставка магазина и часть служб). Enum: `SELF_PICKUP`, `DELIVERY_NOT_CREATED`, `NO_WAREHOUSE`, `SERVICE_NOT_SUPPORTED`

Example

{
  "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
  "delivery_chunk_id": 1,
  "reason": "SELF_PICKUP"
}

400 Bad Request

Некорректный запрос.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

401 Unauthorized

Не авторизован.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

404 Not Found

Ресурс не найден.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name	Description
code	Type: string Example: `VALIDATION_ERROR`
message	Type: string Example: `Invalid input`
trace_id	Type: string Уникальный идентификатор запроса для отладки. Example: `00000000000000000000000000000000`

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

Получение списка заказов

Получение заказа по ID