---
title: "Напечатать этикетки для сборки файлом по адресу"
method: POST
path: "/api/v1/marking/labels/assembly/file"
tags: ["Marking labels"]
---

# Напечатать этикетки для сборки файлом по адресу

`POST /api/v1/marking/labels/assembly/file`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marking/labels/assembly/file`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

То же, что «Печать для сборки» (POST /labels/assembly), но ответ — временный адрес готового PDF (ERP-2185, для агента по MCP). Что напечатается и какие карточки выбрать — akeda_go_marking_label_assembly_plan; выбор карточки — choices по id строки. Марки — только ещё не напечатанные, повтор — duplicate с причиной note; журнал марок и коробов пишется до ответа.

## Headers

- `X-Tenant` string, required

## Request body

- MarkingAssemblyLabelRequest
  - `document_type` string, required: Вид складского документа: stock_shipment, stock_transfer, stock_assembly …
  - `document_id` string, uuid, required
  - `products` boolean: Этикетки товаров по количеству строк
  - `marks` boolean: Марки «Честного знака» строк — ещё не напечатанные
  - `boxes` boolean: Этикетки коробов с марками документа
  - `line_ids` UUID[]: Строки документа; пусто — все
  - `product_template` string: Шаблон этикетки товара; пусто — умолчание документа
  - `marking_template` string: Шаблон этикетки марки; пусто — умолчание документа
  - `channel` string: Канал продаж; пусто — канал документа
  - `contact_id` string, uuid
  - `company_id` string, uuid
  - `choices` object: Карточка площадки по id строки
  - `copies` object: Своё число этикеток товара по id строки
  - `mark_lines` UUID[]: Строки, чьи марки печатаются; пусто — все
  - `duplicate` boolean: Повторить уже напечатанные марки дублем (нужна причина)
  - `note` string
  - `output` '' | 'html' | 'pdf': Формат ответа: html (по умолчанию) или pdf

## Response `200`

Адрес файла PDF и что в нём

- MarkingLabelFile: Печать этикеток файлом: временный адрес PDF и что в нём (ERP-2185).
  - `file` TransferDownloadLink, required: Временный адрес файла: подписанный адрес хранилища или адрес этого API.
    - `url` string, required
    - `method` 'GET', required
    - `direct` boolean, required: true — подписанный адрес хранилища, без заголовка авторизации; false — адрес этого API, с авторизацией
    - `requires_authorization` boolean, required: true — адрес требует токен API, агенту по MCP он недоступен
    - `expires_at` string, date-time: Срок подписанного адреса; у адреса API его нет
    - `name` string, required
    - `mime_type` string, required
    - `size_bytes` integer, required
    - `scan_status` 'clean' | 'skipped': Вердикт антивируса; skipped — файл антивирус не проверял
    - `facsimile` 'applied' | 'not_allowed': Что стало с просьбой о факсимиле у печатной формы
  - `labels` integer, required: Сколько этикеток в файле
  - `jobs` string[], required: Записи журнала печати марок и коробов; у этикеток товаров — пусто
  - `omitted` string[], required: Строки и поля, которым не хватило места

## Other responses

- `400`: Нечего печатать или дубль без причины
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Документ не найден
- `409`: Все марки уже напечатаны (повтор — дублем)
- `422`: Не выбрана карточка площадки или штрихкод не печатается
- `503`: Хранилище файлов кабинета не подключено

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)