---
title: "Обновить коды юрлица из ЧЗ"
method: POST
path: "/api/v1/marking/codes/sync"
tags: ["Marking codes"]
---

# Обновить коды юрлица из ЧЗ

`POST /api/v1/marking/codes/sync`

## Request

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

«Обновить из ЧЗ»: загрузка списка кодов юрлица из ЧЗ (по каждой включённой товарной группе) в реестр Akeda в фоне. Новые коды добавляются (источник `gismt`, без полного кода — печатать их нельзя), известные получают свежий статус, владельца и родителя. Нужен действующий вход по УКЭП; сама загрузка ни при входе, ни по расписанию не стартует. Одна идущая загрузка на юрлицо; ход — в `GET /api/v1/marking/codes/sync`.

## Headers

- `X-Tenant` string, required

## Request body

- MarkingCodeSyncInput
  - `company_id` string, uuid, required

## Response `202`

Загрузка запущена

- MarkingCodeSyncStarted
  - `sync` MarkingCodeSync, required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `status` 'running' | 'done' | 'failed' | 'interrupted', required
    - `scanned` integer, required: Кодов просмотрено в ЧЗ
    - `added` integer, required: Новых кодов добавлено в реестр
    - `updated` integer, required: Известных кодов обновлено
    - `error` string: Почему загрузка остановилась
    - `started_by` integer
    - `started_at` string, date-time, required
    - `heartbeat_at` string, date-time, required
    - `finished_at` string, date-time

## Other responses

- `400`: Юрлицо не распознано или у него нет включённых групп
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Юрлицо не найдено или недоступно
- `409`: Загрузка этого юрлица уже идёт (`marking.codes.sync_running`)
- `502`: Нет действующего входа в ЧЗ или ЧЗ отказал

---

[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/a99574d597cc?raw)
