---
title: "Получить ход загрузки кодов из ЧЗ"
method: GET
path: "/api/v1/marking/codes/sync"
tags: ["Marking codes"]
---

# Получить ход загрузки кодов из ЧЗ

`GET /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`)

Идущая или последняя загрузка кодов юрлица из ЧЗ (просмотрено, добавлено, обновлено, причина остановки) и время последнего полного обновления (`refreshed_at` — «Обновлено из ЧЗ: …» на экране). Загрузка, замолчавшая дольше двух минут, показывается прерванной.

## Query parameters

- `company` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Ход загрузки

- MarkingCodeSyncState
  - `current` 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
  - `refreshed_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)
