---
title: "Обновить статус исходящего документа из ГИС МТ"
method: POST
path: "/api/v1/marking/gismt/outbox/{id}/refresh"
tags: ["Marking GIS MT documents"]
---

# Обновить статус исходящего документа из ГИС МТ

`POST /api/v1/marking/gismt/outbox/{id}/refresh`

## Request

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

Читает статус отправленного документа в ГИС МТ и сохраняет его: принят, отклонён с ошибками или ещё в обработке. Ничего не отправляет. Неотправленный черновик — 409 `marking.document.not_sent`.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Документ со статусом

- MarkingOutboxDocumentEnvelope
  - `document` MarkingOutboxDocument, required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `kind` 'withdrawal' | 'withdrawal_cancel' | 'return' | 'introduce' | 'introduce_remains' | 'introduce_import' | 'remark' | 'cancel_codes' | 'aggregation' | 'disaggregation' | 'sets_aggregation', required
    - `gismt_type` string, required
    - `product_group` string, required
    - `codes_count` integer, required
    - `status` 'draft' | 'sent' | 'accepted' | 'rejected' | 'cancelled', required
    - `gismt_doc_id` string, required
    - `gismt_status` string, required
    - `error_text` string, required
    - `params` MarkingDocumentParams, required: Параметры вида документа; незнакомое поле — отказ
      - `reason` string
      - `reason_other` string
      - `action_date` string
      - `buyer_inn` string
      - `product_cost` integer: Цена за единицу в копейках с НДС
      - `product_costs` object: Дистанционная продажа (DISTANCE): цена каждого кода в копейках с НДС, ключ — код (сводится к КИ без криптохвоста); код без своей цены берёт product_cost
      - `kpp` string
      - `fias_id` string
      - `primary_document_type` string
      - `primary_document_number` string
      - `primary_document_date` string
      - `primary_document_name` string
      - `withdrawal_document_id` string
      - `return_type` string
      - `paid` boolean
      - `production_date` string
      - `production_type` string
      - `tnved_code` string
      - `certificate_type` string
      - `certificate_number` string
      - `certificate_date` string
      - `declaration_number` string: Ввод импорта (introduce_import) — регистрационный номер ДТ «XXXXXXXX/ДДММГГ/XXXXXXX»
      - `declaration_date` string: Ввод импорта — дата регистрации ДТ, ГГГГ-ММ-ДД; совпадает с датой в номере
      - `previous_codes` object: Перемаркировка (remark): предыдущий код к новому — ключ новый код, значение предыдущий (оба сводятся к КИ без криптохвоста); у нового кода без предыдущего нужен tnved_code
      - `unit_serial_number` string: Формирование упаковки — код короба «00» + SSCC; формирование набора — код набора (КИН), скан или без криптохвоста
    - `created_at` string, date-time, required
    - `sent_at` string, date-time, nullable, required
    - `checked_at` string, date-time, nullable, required
    - `basis_type` string: Вид складского документа-основания
    - `basis_id` string, uuid

## Other responses

- `400`: Идентификатор не распознан
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Документ не найден или недоступен
- `409`: Документ ещё не отправлен, вход в ГИС МТ истёк
- `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/3c60ded179f2?raw)
