---
title: "Получить коды маркировки строк УПД или накладной"
method: GET
path: "/api/v1/docflow/flow/documents/{id}/marks"
tags: ["Docflow flow"]
---

# Получить коды маркировки строк УПД или накладной

`GET /api/v1/docflow/flow/documents/{id}/marks`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/flow/documents/{id}/marks`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Коды маркировки, которые уйдут с исходящей УПД или товарной накладной по отгрузке склада: по каждой строке бумаги — сколько кодов нужно и сколько подставлено, сами коды (КИЗ), коды групповых упаковок, коды не в обороте у продавца и режим строки (поштучно или по GTIN). Раскладка по строкам — та же, что пишет коды в XML УПД и печатает перечень кодов листом к бланку. Кабинет без модуля маркировки, бумага без отгрузки или без маркируемого товара отвечают пустым списком, а не ошибкой. Статусы кодов спрашиваются у ГИС МТ, если у юрлица действующий вход; иначе — последний известный статус.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Коды маркировки строк бумаги

- DocflowFlowMarks: Коды маркировки строк исходящей бумаги по отгрузке склада и итог для шапки таблицы «Товары и услуги». Пустой список строк — маркируемого товара нет.
  - `lines` DocflowFlowLineMarks[], required
    - `number` integer, required: Номер строки в бланке и XML с единицы
    - `line_id` string, uuid, required
    - `name` string, required
    - `quantity` string, required
    - `unit` string
    - `mode` 'unit' | 'gtin', required: unit — поштучно, коды КИЗ; gtin — объёмно-сортовой учёт: ГТИН и количество без кодов
    - `required` integer, required: Сколько единиц строки ждут кода
    - `assigned` integer, required: Сколько кодов единиц досталось строке; у строки по GTIN — количество, если ГТИН у товара есть
    - `complete` boolean, required: Строка закрыта кодами: единиц хватает, групповые упаковки покрывают строку или у строки по GTIN есть ГТИН
    - `codes` string[], required: Коды идентификации единиц (КИЗ) без криптохвоста
    - `packages` string[], required: Коды групповых упаковок без криптохвоста
    - `not_in_circulation` string[], required: Коды строки не в обороте у продавца — покупатель их не примет
    - `gtin` string: ГТИН строки по объёмно-сортовому учёту: первой части gtins, без частей — основной GTIN товара
    - `gtins` DocflowFlowLineGTIN[]: Части строки по объёмно-сортовому учёту по GTIN (ERP-2134): у товара с несколькими GTIN строка, отгруженная из партий разных GTIN, уходит в XML строкой на каждый GTIN с её количеством
      - `gtin` string, required: GTIN, 14 цифр; пусто — у товара GTIN нет
      - `qty` integer, required: Единиц под этим GTIN
      - `source` 'codes' | 'batch' | 'receipt_codes' | 'product', required: Откуда GTIN: codes — марки строки отгрузки; batch — задан партии; receipt_codes — марки прихода партии; product — у партии своего GTIN нет, основной GTIN товара
    - `checked_live` boolean, required: Статусы кодов только что спрошены у ГИС МТ; false — по последнему известному статусу
  - `required` integer, required: Сколько единиц всех строк ждут кода маркировки
  - `assigned` integer, required: Сколько кодов единиц подставлено во все строки
  - `packages` integer, required: Сколько кодов групповых упаковок подставлено
  - `not_in_circulation` integer, required: Сколько кодов не в обороте у продавца
  - `checked_live` boolean, required: Статусы хотя бы одной строки только что спрошены у ГИС МТ

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `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)
