# Журнал ВСД и гашение документов

**Раздел:** **ВетИС** (vetis.md)

В журнале ВетИС можно получать входящие ветеринарные сопроводительные документы (ВСД), просматривать сведения о поступившей продукции и подтверждать её получение. Обмен выполняется с государственной системой «Меркурий» через ВетИС.API.

## Подключение к ВетИС
Для работы с ветеринарными документами откройте **«Интеграции → Меркурий (ВетИС)»**.

Обмен выполняется для склада, выбранного в шапке Меркурий-ИИ. Перед началом убедитесь, что выбран нужный склад.

Если интеграция ещё не настроена, раскройте блок **«Ключи склада»**.

В нём указываются:

- **Контур** — тестовый или рабочий («Прод»).
- **API Login** — логин доступа к ВетИС.API.
- **API Password** — пароль API. Если пароль уже сохранён, пустое поле при повторном сохранении не изменяет его.
- **APIKey** — ключ доступа.
- **IssuerID (ХС)** — идентификатор хозяйствующего субъекта.
- **GUID площадки** — идентификатор предприятия в системе «Цербер».
- **Логин уполномоченного** — пользователь, от имени которого выполняется гашение. Если поле пустое, используется API Login.

После заполнения нажмите **«Сохранить ключи»**.

**Важно:** обычный логин от сайта хозяйствующего субъекта не заменяет реквизиты ВетИС.API. При первоначальном подключении рекомендуется сначала проверить работу на тестовом контуре.

Как получить необходимые реквизиты, описано в инструкции **«Доступ к ВетИС.API»** (vetis-access.md).

Если программа сообщает об отсутствии таблиц ВетИС, необходимо обновить структуру базы данных (скрипт 00200). Следуйте сообщению программы или обратитесь в техническую поддержку.

## Получение и гашение ВСД
Под блоком настроек находится журнал входящих ветеринарных документов.

### Получить входящие ВСД
1. Убедитесь, что для выбранного склада сохранены ключи ВетИС.API.
2. Нажмите **«Обновить»**.
3. Дождитесь завершения обмена с ВетИС.
4. Проверьте появившиеся документы в таблице.

При обновлении Меркурий запрашивает входящие непогашенные ВСД со статусом `CONFIRMED`.

### Погасить ВСД
Гашение подтверждает получение продукции по ветеринарному сопроводительному документу.

1. Найдите нужный ВСД в таблице.
2. Проверьте отправителя, продукцию и количество.
3. Убедитесь, что фактически полученный товар соответствует документу.
4. Отметьте строку документа.
5. Нажмите **«Погасить»**.
6. Проверьте результат обработки документа.

Кнопка **«Погасить»** становится доступной после выбора строки.

**Внимание:** сейчас Меркурий поддерживает только полное гашение ВСД без расхождений. Если количество или состав фактически поступившей продукции отличается от документа, не используйте эту команду для подтверждения полной приёмки.

### Фильтр по статусу
Для отбора документов используйте поле **«Статус»**:

- **Все** — показать все документы, имеющиеся в журнале.
- **Непогашенные** — документы со статусом `CONFIRMED`.
- **Погашенные** — документы со статусом `UTILIZED`.

## Таблица документов
В журнале отображаются входящие ВСД и результаты их обработки.

Таблица содержит следующие колонки:

- **Отметка** — выбор документа для выполнения операции.
- **Номер** — номер ветеринарного сопроводительного документа.
- **Дата** — дата документа.
- **Отправитель** — организация, отправившая продукцию.
- **Продукция** — наименование товара, указанного в ВСД.
- **Объём** — количество продукции по документу.
- **Статус** — текущее состояние ВСД.
- **Ошибка** — сообщение об ошибке или отказе со стороны шлюза ВетИС.

### Если таблица пустая
При отсутствии документов программа показывает сообщение:

*«Справок нет. Сохраните ключи и нажмите „Обновить“.»*

Проверьте, что выбран правильный склад, сохранены ключи подключения и выполнено обновление журнала.

Если после обновления документов нет, возможно, для выбранной площадки отсутствуют входящие непогашенные ВСД.

## Статусы ВСД
Статус показывает текущее состояние ветеринарного документа.

- **CONFIRMED — Непогашен.**
      Входящий документ подтверждён в системе ВетИС и ожидает гашения получателем.
- **UTILIZED — Погашен.**
      Гашение документа выполнено.
- **REJECTED — Отклонён.**
      Шлюз ВетИС отказал в выполнении операции. Причину можно посмотреть в колонке **«Ошибка»**.

Если при гашении возникла ошибка, ознакомьтесь с её текстом. Не отправляйте повторную операцию, пока не выясните, была ли предыдущая обработана успешно.

## Ограничения текущей версии
На данный момент интеграция предназначена для получения входящих ВСД и их полного гашения без расхождений.

Следующие возможности пока не реализованы в этом разделе:

- **Частичное гашение** — подтверждение приёмки с расхождениями по количеству.
- **Создание прихода по ВСД** — автоматическое оформление поступления товаров в учёте Меркурий-ИИ на основании ветеринарного документа.
- **Исходящие ВСД на производство** — оформление производственных ветеринарных документов.

Гашение ВСД в государственной системе не создаёт автоматически приход товара в складском учёте Меркурия. При необходимости поступление следует оформить отдельно.