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

<div class="openapi">

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

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

Возвращает ярлыки доставки по частям заказа. Ярлык — это PDF‑файл с адресом, трек‑номером и штрихкодом. Его наклеивают на отправление.

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

Некоторые части заказа не попадают в `delivery_labels`:

* самовывоз;
* собственная доставка магазина;
* заказ еще не передан в службу доставки.
Они перечисляются в `skipped` c указыванием причины.

Если служба доставки отказала по одной части заказа, остальные не затрагиваются. Проблемную часть переносят в `skipped` с причиной `GENERATION_FAILED`, ярлыки для других частей возвращают как обычно.
Код `500` означает, что запрос не удалось обработать целиком.

{% note info %}

Ссылки на ярлыки подписаны и действуют ограниченное время. Момент истечения срока указан в поле `expires_at`.
Не храните ссылку — получите новую сделав повторный запрос.

{% endnote %}

## Request

<div class="openapi__requests">

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

<div class="openapi__request">

GET {.openapi__method}
```text translate=no
https://api.kit.yandex.net/v1/orders/{id}/delivery-labels
```

</div>

</div>

</div>

### Query parameters

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

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

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

Размеры зависят от службы доставки. Список размеров получают запросом `GET /v1/delivery/label-formats`. Если служба работает в режиме mode: `EXPLICIT_FORMATS` и запрошенного размера нет в списке, часть заказа попадает в `skipped` с причиной `FORMAT_NOT_SUPPORTED`.

Службы в режиме `mode: PROVIDER_DEFAULT` не учитывают размер. Они печатают ярлык в своем стандартном размере.
Для таких частей в ответе поле `label_format` будет пустым.

Размер ярлыка доставки в миллиметрах.

_Enum:_{.json-schema-reset .json-schema-value} `210x297`, `148x210`, `105x148`, `100x150`, `74x105`, `75x120`, `120x75`, `58x60`, `58x40`
{.table-cell}
||
|#{.json-schema-properties}

<div class="openapi-entity">

### DeliveryLabelFormatType {#entity-DeliveryLabelFormatType}

Размер ярлыка доставки в миллиметрах.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `210x297`, `148x210`, `105x148`, `100x150`, `74x105`, `75x120`, `120x75`, `58x60`, `58x40`

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

Ярлыки доставки заказа.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "delivery_labels": [
    {
      "delivery_chunk_id": 1,
      "delivery_service": "YANDEX_DELIVERY",
      "url": "https://example.com/order-labels/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
      "expires_at": "2026-08-18T12:00:00Z",
      "label_format": "210x297"
    }
  ],
  "skipped": [
    {
      "delivery_chunk_id": 1,
      "reason": "SELF_PICKUP"
    }
  ]
}
```

{% endcut %}

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

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

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

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

```json translate=no
[
  {
    "delivery_chunk_id": 1,
    "delivery_service": "YANDEX_DELIVERY",
    "url": "https://example.com/order-labels/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
    "expires_at": "2026-08-18T12:00:00Z",
    "label_format": "210x297"
  }
]
```

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

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

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

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

```json translate=no
[
  {
    "delivery_chunk_id": 1,
    "reason": "SELF_PICKUP"
  }
]
```

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

</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">

### OrderDeliveryLabel {#entity-OrderDeliveryLabel}

Ярлык доставки одной части заказа.

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

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

Идентификатор чанка заказа.
{.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/order-labels/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890`
{.table-cell}
||
||

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

Размер ярлыка доставки в миллиметрах.

_Enum:_{.json-schema-reset .json-schema-value} `210x297`, `148x210`, `105x148`, `100x150`, `74x105`, `75x120`, `120x75`, `58x60`, `58x40`
{.table-cell}
||
|#{.json-schema-properties}

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

```json translate=no
{
  "delivery_chunk_id": 1,
  "delivery_service": "YANDEX_DELIVERY",
  "url": "https://example.com/order-labels/550e8400-e29b-41d4-a716-446655440000.pdf?X-Amz-Signature=1234567890",
  "expires_at": "2026-08-18T12:00:00Z",
  "label_format": "210x297"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### SkippedOrderDeliveryLabelReason {#entity-SkippedOrderDeliveryLabelReason}

Причина, по которой ярлык не сформирован:
- `SELF_PICKUP` — самовывоз, отправления нет и ярлык не нужен.

- `DELIVERY_NOT_CREATED` — доставка еще не создана в службе доставки, трек-номера нет.

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

- `FORMAT_NOT_SUPPORTED` — служба доставки печатает по списку размеров и запрошенного
  `label_format` среди них нет. Службы с `mode: PROVIDER_DEFAULT` этой причины не дают:
  они игнорируют `label_format` и печатают в своем размере.

- `GENERATION_FAILED` — служба доставки не отдала ярлык (ошибка или таймаут на ее
  стороне). Причина временная: повторите запрос позже. Остальные части заказа
  при этом возвращаются в `delivery_labels`.

**Type**: string

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

</div>

<div class="openapi-entity">

### SkippedOrderDeliveryLabel {#entity-SkippedOrderDeliveryLabel}

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

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

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

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

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

Причина, по которой ярлык не сформирован:
- `SELF_PICKUP` — самовывоз, отправления нет и ярлык не нужен.

- `DELIVERY_NOT_CREATED` — доставка еще не создана в службе доставки, трек-номера нет.

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

- `FORMAT_NOT_SUPPORTED` — служба доставки печатает по списку размеров и запрошенного
  `label_format` среди них нет. Службы с `mode: PROVIDER_DEFAULT` этой причины не дают:
  они игнорируют `label_format` и печатают в своем размере.

- `GENERATION_FAILED` — служба доставки не отдала ярлык (ошибка или таймаут на ее
  стороне). Причина временная: повторите запрос позже. Остальные части заказа
  при этом возвращаются в `delivery_labels`.

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

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

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