---
title: "Получить коды заказа с номерами и состоянием"
method: GET
path: "/api/v1/marking/orders/{id}/codes"
tags: ["Marking orders"]
---

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

`GET /api/v1/marking/orders/{id}/codes`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marking/orders/{id}/codes`
- 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`)

Коды заказа СУЗ в реестре кабинета: по каждому GTIN — счётчики «получено, напечатано, нанесено, в обороте, испорчено», страница кодов с порядковым номером в заказе и состоянием (получен, напечатан, наносится, нанесён, вводится, в обороте, испорчен), последние печати с диапазонами номеров и отчёты о нанесении. Состояние выводится из журнала печати, отчётов о нанесении и документов ввода — отдельного поля нет. Полного кода с криптохвостом в ответе нет.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `gtin` string
- `state` 'received' | 'printed' | 'applying' | 'applied' | 'introducing' | 'introduced' | 'spoiled': Получен, напечатан, наносится, нанесён, вводится в оборот, в обороте, испорчен
- `from` integer
- `to` integer
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Коды заказа

- MarkingOrderCodes
  - `order` MarkingCodeOrder, required
    - `id` string, uuid, required
    - `oms_order_id` string, required
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `product_group` string, required
    - `release_method` string, required
    - `cis_type` string, required
    - `origin` 'akeda' | 'oms', required
    - `status` string, required: orderStatus СУЗ как есть
    - `status_text` string, required: Статус словами на языке запроса с причиной отказа
    - `status_reason` string, required
    - `created_at` string, date-time, required
    - `oms_created_at` string, date-time, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `last_synced_at` string, date-time, nullable, required
    - `created_by` integer, nullable, required
    - `items` MarkingCodeOrderItem[], nullable, required
      - `gtin` string, required
      - `product_id` string, uuid, nullable, required
      - `product_name` string, required
      - `quantity` integer, required
      - `received` integer, required
      - `template_id` integer, nullable, required
      - `buffer_status` string, required: Статус буфера СУЗ как есть
      - `left_in_buffer` integer, nullable, required
      - `available_codes` integer, nullable, required
      - `total_passed` integer, nullable, required
      - `rejection_reason` string, required
      - `expires_at` string, date-time, nullable, required
    - `quantity` integer, required
    - `received` integer, required
  - `application_mode` 'report' | 'auto', required: Как наносятся коды группы заказа
  - `gtins` MarkingOrderGtinSummary[], required
    - `gtin` string, required
    - `product_id` string, uuid, nullable, required
    - `product_name` string, required
    - `quantity` integer, required: Заказано
    - `received` integer, required: Получено в реестр
    - `printed` integer, required: Напечатано хотя бы раз
    - `applying` integer, required: В отчёте о нанесении в обработке
    - `applied` integer, required: Нанесено, включая введённые в оборот
    - `introducing` integer, required: В отправленном документе ввода
    - `introduced` integer, required: В обороте
    - `spoiled` integer, required: Испорчено
    - `unprinted` integer, required: Получено и ещё не напечатано, не нанесено и не испорчено
    - `applicable` integer, required: Можно отметить нанесёнными
    - `introducible` integer, required: Нанесено, но ещё не вводится и не в обороте
  - `items` MarkingOrderCode[], required
    - `id` string, uuid, required
    - `gtin` string, required
    - `seq` integer, nullable, required: Порядковый номер кода в заказе по GTIN
    - `identity` string, required: Код без криптохвоста
    - `state` 'received' | 'printed' | 'applying' | 'applied' | 'introducing' | 'introduced' | 'spoiled', required: Получен, напечатан, наносится, нанесён, вводится в оборот, в обороте, испорчен
    - `printed` integer, required: Этикеток напечатано без тестовых
    - `duplicates` integer, required: Из них дубликатов
    - `application_id` string, uuid, nullable, required: Живой отчёт о нанесении кода
    - `spoiled_note` string, required: Пояснение к испорченному коду
    - `spoiled_at` string, date-time, nullable, required
  - `total` integer, required: Кодов по отбору
  - `print_jobs` MarkingOrderPrintJob[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `created_by` integer, nullable, required
    - `reason` 'first' | 'duplicate' | 'test', required
    - `template` string, required
    - `copies` integer, required
    - `note` string, required
    - `ranges` MarkingSeqRange[], required: Диапазоны номеров напечатанных кодов по GTIN
      - `gtin` string, required
      - `from` integer, required: Наименьший номер кода в заказе по GTIN
      - `to` integer, required: Наибольший номер кода в заказе по GTIN
      - `count` integer, required: Сколько кодов
  - `applications` MarkingApplication[], required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `order_id` string, uuid, nullable, required
    - `product_group` string, required
    - `mode` 'report' | 'auto', required: Отчёт в СУЗ с подписью или отметка у групп, где отчёт СУЗ формирует сама
    - `status` 'draft' | 'sent' | 'accepted' | 'rejected', required: Черновик, отправлен, принят (коды нанесены), отклонён (коды освобождены)
    - `oms_report_id` string, required: reportId СУЗ
    - `oms_status` string, required: reportStatus СУЗ последней проверки как есть
    - `error_text` string, required: Отказ словами СУЗ или причина неотправки
    - `attributes` object, required: Атрибуты отчёта группы как в теле
    - `codes_count` integer, required
    - `ranges` MarkingSeqRange[], required
      - `gtin` string, required
      - `from` integer, required: Наименьший номер кода в заказе по GTIN
      - `to` integer, required: Наибольший номер кода в заказе по GTIN
      - `count` integer, required: Сколько кодов
    - `created_by` integer, nullable, required
    - `created_at` string, date-time, required
    - `send_attempted_at` string, date-time, nullable, required
    - `sent_at` string, date-time, nullable, required
    - `checked_at` string, date-time, nullable, required

## Other responses

- `400`: Идентификатор, состояние или номера не распознаны
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Заказ не найден или недоступен

---

[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)