---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://yandex.ru/dev/kit/ru/openapi/Zakazy/GenerateOrderWaybills.md
  - href: https://yandex.ru/dev/kit/ru/openapi/Zakazy/GenerateOrderWaybills.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/kit/ru/llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/kit/ru/llms.txt

<div class="openapi">

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

<!-- markdownlint-disable-file -->

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

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

- Накладная оформляется на партию — части заказов автоматически группируются по складу и службе доставки, для каждой такой группы создается отдельный документ.

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

- Части заказов, для которых невозможно получить накладную (например, при самовывозе, если доставка еще не создана в службе или служба не предоставляет накладные), не включаются в массив `waybills`.
  Такие части заказов отображаются в массиве `skipped` — с указанием причины, по которой накладная не была сформирована.

- Ссылки на PDF‑файлы подписаны и имеют ограниченный срок действия. Дата истечения срока указана в поле `expires_at`.
  Хранить ссылку не требуется — для получения актуальной ссылки выполните повторный запрос.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
https://api.kit.yandex.net/v1/orders/waybills
```

</div>

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

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

{% endcut %}

#|
|| **Name** | **Description** ||
||

_items_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderDeliveryChunkRef](#entity-OrderDeliveryChunkRef)[]

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

_Min items:_{.json-schema-reset .json-schema-assertion} `1`

_Max items:_{.json-schema-reset .json-schema-assertion} `100`

{% cut "**Example**" %}{.json-schema-example}

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

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### OrderID {#entity-OrderID}

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

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b56d1-5ef0-7ed2-a155-7110d25ca5ce`

</div>

<div class="openapi-entity">

### OrderDeliveryChunkRef {#entity-OrderDeliveryChunkRef}

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

#|
|| **Name** | **Description** ||
||

_delivery_chunk_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Идентификатор чанка заказа.
{.table-cell}
||
||

_order_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderID](#entity-OrderID)

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

_Example:_{.json-schema-reset .json-schema-example} `019b56d1-5ef0-7ed2-a155-7110d25ca5ce`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "order_id": "019b56d1-5ef0-7ed2-a155-7110d25ca5ce",
  "delivery_chunk_id": 1
}
```

{% endcut %}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "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"
    }
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_skipped_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [SkippedOrderWaybill](#entity-SkippedOrderWaybill)[]

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

{% cut "**Example**" %}{.json-schema-example}

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

{% endcut %}
{.table-cell}
||
||

_waybills_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderWaybill](#entity-OrderWaybill)[]

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

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "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
      }
    ]
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### WarehouseID {#entity-WarehouseID}

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

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### DeliveryServiceType {#entity-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:_{.json-schema-reset .json-schema-value} `YANDEX_DELIVERY`, `CDEK`, `META_SHIP_DALLI`, `META_SHIP_RUSSIAN_POST`, `META_SHIP_PECOM`, `OZON`, `MERCHANT_SHIP`, `YANDEX_MARKET_FBO`

</div>

<div class="openapi-entity">

### OrderWaybill {#entity-OrderWaybill}

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

#|
|| **Name** | **Description** ||
||

_delivery_chunks_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderDeliveryChunkRef](#entity-OrderDeliveryChunkRef)[]

Части заказов, вошедшие в накладную.

{% cut "**Example**" %}{.json-schema-example}

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

{% endcut %}
{.table-cell}
||
||

_delivery_service_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [DeliveryServiceType](#entity-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:_{.json-schema-reset .json-schema-value} `YANDEX_DELIVERY`, `CDEK`, `META_SHIP_DALLI`, `META_SHIP_RUSSIAN_POST`, `META_SHIP_PECOM`, `OZON`, `MERCHANT_SHIP`, `YANDEX_MARKET_FBO`
{.table-cell}
||
||

_expires_at_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

Момент, после которого ссылка перестает работать.

_Example:_{.json-schema-reset .json-schema-example} `2026-08-18T12:00:00Z`
{.table-cell}
||
||

_url_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;uri&gt;

Подписанная ссылка на PDF-файл с накладной.

_Example:_{.json-schema-reset .json-schema-example} `https://example.com/waybills/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890`
{.table-cell}
||
||

_warehouse_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [WarehouseID](#entity-WarehouseID)

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

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "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
    }
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### SkippedOrderWaybillReason {#entity-SkippedOrderWaybillReason}

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

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `SELF_PICKUP`, `DELIVERY_NOT_CREATED`, `NO_WAREHOUSE`, `SERVICE_NOT_SUPPORTED`

</div>

<div class="openapi-entity">

### SkippedOrderWaybill {#entity-SkippedOrderWaybill}

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

#|
|| **Name** | **Description** ||
||

_delivery_chunk_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Идентификатор чанка заказа.
{.table-cell}
||
||

_order_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [OrderID](#entity-OrderID)

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

_Example:_{.json-schema-reset .json-schema-example} `019b56d1-5ef0-7ed2-a155-7110d25ca5ce`
{.table-cell}
||
||

_reason_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [SkippedOrderWaybillReason](#entity-SkippedOrderWaybillReason)

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

_Enum:_{.json-schema-reset .json-schema-value} `SELF_PICKUP`, `DELIVERY_NOT_CREATED`, `NO_WAREHOUSE`, `SERVICE_NOT_SUPPORTED`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

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

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__404">

## 404 Not Found

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.