---
title: "Отсканировать марку в короб"
method: POST
path: "/api/v1/marking/boxes/{id}/scan"
tags: ["Marking boxes"]
---

# Отсканировать марку в короб

`POST /api/v1/marking/boxes/{id}/scan`

## Request

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

Кладёт марку в собирающийся свой короб: код юрлица короба, той же товарной группы, не лежащий в другом коробе. Незнакомая марка заводится в реестре юрлица (полный код со скана — шифротекстом). SSCC закрытого своего короба кладёт короб целиком (паллета). Повтор — 409 `marking.boxes.code_in_this_box`, код в другом коробе — 409 с SSCC того короба в `box`. Агенту достаточно кода без криптохвоста.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- MarkingBoxScanInput
  - `raw` string, required: Скан марки или SSCC

## Response `200`

Вложение и карточка после скана

- MarkingBoxScanResult
  - `item` MarkingBoxItem, required
    - `code_id` string, uuid, required
    - `identity` string, required: Код без криптохвоста
    - `kind` string, required: UNIT, GROUP, SET, BUNDLE или BOX
    - `gtin` string, required
    - `product_id` string, uuid, required
    - `product_name` string, required
    - `printable` boolean, required: Есть полный код: этикетку можно перепечатать
    - `box_id` string, uuid, required
    - `added_at` string, date-time, required
  - `card` MarkingBoxCard, required
    - `box` MarkingBox, required
      - `id` string, uuid, required
      - `company_id` string, uuid, required
      - `company_name` string, required
      - `code_id` string, uuid, required
      - `sscc` string, required: 18 цифр SSCC без AI
      - `identity` string, required: КИТУ «00» + SSCC
      - `group` string, required: Товарная группа; у чужого короба без товара в кабинете — пусто
      - `origin` 'own' | 'gismt', required: own — собран здесь, gismt — снимок чужого из ГИС МТ
      - `status` 'assembling' | 'closed' | 'signing' | 'sent' | 'accepted' | 'rejected' | 'disbanding' | 'disbanded' | 'received', required
      - `units` integer, required: Вложений первого уровня
      - `printed` integer, required: Этикеток короба напечатано, без тестовых
      - `parent_sscc` string, required: SSCC паллеты, где лежит короб; пусто — нигде
      - `aggregation_document_id` string, uuid, required
      - `disaggregation_document_id` string, uuid, required
      - `error_text` string, required: Отказ ГИС МТ по отчёту агрегации
      - `created_at` string, date-time, required
      - `closed_at` string, date-time, nullable, required
      - `disbanded_at` string, date-time, nullable, required
    - `items` MarkingBoxItem[], nullable, required
      - `code_id` string, uuid, required
      - `identity` string, required: Код без криптохвоста
      - `kind` string, required: UNIT, GROUP, SET, BUNDLE или BOX
      - `gtin` string, required
      - `product_id` string, uuid, required
      - `product_name` string, required
      - `printable` boolean, required: Есть полный код: этикетку можно перепечатать
      - `box_id` string, uuid, required
      - `added_at` string, date-time, required
    - `products` MarkingBoxProduct[], nullable, required
      - `gtin` string, required
      - `product_id` string, uuid, required
      - `product_name` string, required
      - `boxes` boolean, required: Строка — вложенные короба, а не товар
      - `count` integer, required
    - `printable` integer, required: Вложений с полным кодом

## Other responses

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

---

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