---
title: "Проверить связь с СУЗ"
method: POST
path: "/api/v1/marking/connections/{company_id}/oms/ping"
tags: ["Marking connections"]
---

# Проверить связь с СУЗ

`POST /api/v1/marking/connections/{company_id}/oms/ping`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marking/connections/{company_id}/oms/ping`
- 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`)

Пробует СУЗ входом юрлица и сохраняет итог у подключения (`oms_last_ping_*`). Заказов и кодов не трогает. Без живого входа в СУЗ — 409 `marking.oms.unauthorized`: войти может только человек по УКЭП.

## Path parameters

- `company_id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Подключение с итогом проверки

- MarkingConnectionEnvelope
  - `connection` MarkingConnection, required: Подключение юрлица. Токенов True API и СУЗ здесь нет и не будет.
    - `company_id` string, uuid, required
    - `company_name` string, required
    - `company_inn` string, required
    - `connected` boolean, required
    - `contour` 'sandbox' | 'production'
    - `inn` string: ИНН входа
    - `has_token` boolean, required: Есть живой вход в ГИС МТ
    - `token_kind` 'jwt' | 'uuid'
    - `token_expires_at` string, date-time
    - `token_issued_at` string, date-time
    - `token_issued_by` integer
    - `certificate` MarkingCertificate
      - `thumbprint` string
      - `owner` string
      - `inn` string
      - `valid_to` string, date-time
    - `participant` object: Несекретные сведения об участнике из входа
    - `last_check_at` string, date-time
    - `last_check_status` '' | 'ok' | 'unauthorized' | 'rate_limited' | 'declined' | 'unavailable'
    - `last_check_message` string
    - `oms_id` string, required
    - `oms_connection` string, required
    - `oms_has_token` boolean, required: Есть живой вход в СУЗ
    - `oms_token_expires_at` string, date-time, nullable, required
    - `oms_token_issued_at` string, date-time, nullable, required
    - `oms_last_ping_at` string, date-time, nullable, required
    - `oms_last_ping_status` '' | 'ok' | 'unauthorized' | 'rate_limited' | 'declined' | 'unavailable', required
    - `oms_last_ping_message` string, required

## Other responses

- `400`: Идентификатор юрлица не распознан
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Юрлицо не подключено к ГИС МТ
- `409`: Вход юрлица в ГИС МТ или СУЗ истёк или не выполнен (`marking.gismt.unauthorized`, `marking.oms.unauthorized`), не заданы OMS ID и соединение (`marking.oms.not_configured`) или сохранённый вход не читается. Войти может только человек по УКЭП в браузере.
- `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/a99574d597cc?raw)