---
title: "Найти марку и её историю"
method: GET
path: "/api/v1/marking/codes/trace"
tags: ["Marking codes"]
---

# Найти марку и её историю

`GET /api/v1/marking/codes/trace`

## Request

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

Карточка марки по скану или коду без криптохвоста: товар, юрлицо, склад, где она числится сейчас (регистр `marking_codes`), последний известный статус ЧЗ и складские документы, где она стояла, свежие сверху (направление: пришла, ушла, перемещение). Работает без связи с ЧЗ — только учёт Akeda.

## Query parameters

- `code` string, required

## Headers

- `X-Tenant` string, required

## Response `200`

Карточка марки

- MarkingCodeTrace
  - `code` MarkingCode, required: Строка реестра кодов. Полного кода с криптохвостом в ней нет никогда.
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `product_id` string, uuid
    - `product_name` string, required
    - `group` string, required: Ключ товарной группы
    - `kind` string, required: Вид кода (единица или агрегат)
    - `gtin` string, required
    - `serial` string, required
    - `identity` string, required: Код идентификации без криптохвоста
    - `has_crypto_tail` boolean, required: Сохранён ли полный код для печати
    - `source` 'order' | 'import' | 'upd' | 'scan' | 'aggregation' | 'gismt', required
    - `import_id` string, uuid
    - `order_id` string, uuid
    - `produced_at` string, date-time
    - `expires_at` string, date-time
    - `weight_g` integer: Вес в граммах из кода
    - `gismt_status` string, required: Последний известный статус ГИС МТ
    - `gismt_owner_inn` string, required
    - `gismt_checked_at` string, date-time
    - `printed` integer, required: Этикеток напечатано без тестовых
    - `duplicates` integer, required: Из них дубликатов
    - `created_at` string, date-time, required
    - `warehouse_id` string, uuid
  - `history` MarkingCodeTraceEntry[], required
    - `document_id` string, uuid, required
    - `type` string, required: Вид складского документа
    - `number` string, required
    - `date` string, date, required
    - `status` string, required: Состояние документа: draft, posted, cancelled
    - `direction` 'in' | 'out' | 'transfer' | '', required: Пришла, ушла или перемещение
    - `warehouse_id` string, uuid
    - `warehouse_to_id` string, uuid

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