---
title: "Заказать коды маркировки в СУЗ"
method: POST
path: "/api/v1/marking/orders"
tags: ["Marking orders"]
---

# Заказать коды маркировки в СУЗ

`POST /api/v1/marking/orders`

## Request

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

Отправляет заказ в СУЗ: от 1 до 10 товаров с разными GTIN, от 1 до 150 000 кодов на товар. Заказ ТРАТИТ ДЕНЬГИ лицевого счёта «Честного знака», поэтому нужен узкий глагол `marking.gismt:send`, а агент исполняет его только после предпросмотра и явного согласия человека. Повтор после обрыва связи передаёт тот же заголовок `Idempotency-Key` — сервер вернёт прежний ответ и второго заказа не заведёт. Готовые коды забирает отдельное получение.

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- MarkingOrderInput
  - `company_id` string, uuid, required
  - `product_group` string, required
  - `release_method` 'PRODUCTION' | 'IMPORT' | 'REMAINS' | 'REMARK' | 'COMMISSION' | 'REAPPLY', required
  - `cis_type` '' | 'UNIT' | 'GROUP' | 'SET' | 'BUNDLE': Вид кода всех строк; пусто — UNIT
  - `contact_person` string
  - `signature` string: Откреплённая подпись УКЭП (CMS в base64) тела заказа из «Подготовить заказ»; СУЗ без неё заказ отклоняет
  - `items` object[], required
    - `gtin` string, required: GTIN из 14 цифр
    - `quantity` integer, required
    - `product_id` string, uuid
    - `template_id` integer: Шаблон кода СУЗ; 0 — по группе

## Response `200`

Заведённый заказ

- MarkingCodeOrderEnvelope
  - `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

## Other responses

- `400`: Строки, GTIN, количество, способ ввода, вид кода, шаблон или группа не приняты
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Юрлицо не подключено к ГИС МТ
- `409`: Вход в СУЗ истёк или не заданы OMS ID и соединение
- `422`: ГИС МТ или СУЗ отказали по существу (`marking.gismt.declined`, `marking.oms.declined`); `detail` передаёт отказ словами оператора.
- `429`: ГИС МТ или СУЗ просят подождать (`marking.gismt.rate_limited`, `marking.oms.rate_limited`). Повторите через минуту.
- `503`: ГИС МТ или СУЗ не отвечают (`marking.gismt.unavailable`, `marking.oms.unavailable`) либо на сервере не задан ключ шифрования входа (`marking.connection.encryption_key_required`).

---

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