Аннотация
В данном томе описываются принципы и особенности интеграции системы «Супермаг Плюс» с Государственной Информационной Системой «Меркурий».
Содержание
1 Введение
1.1 Наименование системы
1.2 Назначение документа
1.3 Сокращения
2 Принципы интеграции «Супермаг Плюс» с ГИС «Меркурий»
2.1 Законодательные требования по электронной сертификации.
2.2 Провайдеры ЭДО и программа-шлюз
2.3 Ключевые понятия ГИС «Меркурий»
3 Почтовый обмен с программой-шлюзом
4 Единицы измерения количества
5 Приёмка подконтрольной продукции. Гашение ВСД
5.1 Этапы процесса приёмки
5.2 Входящие ВСД
ПРИЛОЖЕНИЕ А. XSD- схема файла обмена с программой-шлюзом.
ПРИЛОЖЕНИЕ Б. УКАЗАТЕЛЬ РАЗДЕЛОВ СИСТЕМЫ и документов

Введение

Наименование системы

Полное наименование Системы – Государственная Информационная Система «Меркурий».
Сокращенное наименование Системы – ГИС «Меркурий».

Назначение документа

Настоящий документ предназначен для сотрудников «Сервис Плюс»: аналитиков, инженеров техподдержки. А также для системных администраторов, инженеров и аналитиков клиента.

Сокращения

Принципы интеграции «Супермаг Плюс» с ГИС «Меркурий»

Законодательные требования по электронной сертификации.

Законом РФ от 14.05.1993 N 4979-1 «О ветеринарии» вводится обязательная электронная сертификация движения и производства подконтрольных товаров (продукции). Сертификация делается в форме ветеринарных сопроводительных документов (ВСД). Оформление ветеринарных сопроводительных документов в электронной форме осуществляется с использованием федеральной государственной информационной системы в области ветеринарии ГИС «Меркурий».
Для облечения работы участников рынка с подконтрольной продукцией в ГИС «Меркурий» предусмотрена возможность её интеграции с учётными системами участников рынка. Использовать возможность интеграции является правом организации, а не её обязанностью.

Провайдеры ЭДО и программа-шлюз

Интеграция программы «Супермаг Плюс» с ГИС «Меркурий» возможна только с версии 1.036.
Интеграция системы «Супермаг Плюс» с ГИС «Меркурий» производится через программу-посредника (программу-шлюз). В качестве такой программы могут выступать продукты, предлагаемые провайдерами электронного документооборота (ЭДО). По существу, ВСД является электронным документом, оборотом которого и занимаются специализированные провайдеры.
Программа-шлюз выполняет следующие задачи:

1. Обеспечивает стыковку протокола обмена с ГИС «Меркурий» и протокола обмена с «Супермаг Плюс».
2. Обеспечивает вход в ГИС «Меркурий» вводом логина и пароля для лиц, имеющих доступ к ГИС «Меркурий».
3. Обеспечивает ввод ряда данных, связанных с ветеринарными показателями подконтрольной продукции.

В программе «Супермаг Плюс» реализован протокол обмена с программой-шлюзом. Этот протокол публичен и описан настоящей документации.
Пользователи программы «Супермаг Плюс» выбирают программу-шлюз и предоставляют провайдеру описание протокола обмена с «Супермаг Плюс». Провайдер ЭДО обеспечивает интеграцию по данному протоколу (Рисунок 1):

Рисунок 1 – Взаимодействие ГИС «Меркурий» с «Супермаг Плюс»

Ключевые понятия ГИС «Меркурий»

Субъектом наблюдения в ГИС «Меркурий» является так называемый «хозяйствующий субъект». Список ХС задаётся в ГИС «Меркурий». В системе «Супермаг Плюс» предварительно не производится прямого сопоставления ХС с местами хранения.
Объектом наблюдения (контроля) в ГИС «Меркурий» является партия товара (продукции). Партия определяется ВСД. Один ВСД – одна партия.
Именно партия (ВСД) сопоставляется с товарными строками приходной накладной в «Супермаг Плюс».
Поставка подконтрольного товара может включать несколько партий (ВСД). Поставщик оформляет товарно-транспортную накладную (ТТН) на несколько позиций и на эту ТТН оформляет несколько ВСД.
Для обработки поставки в «Супермаг Плюс» из программы-шлюза все ВСД по одной ТТН должны поступить пакетом в одном файле.

Почтовый обмен с программой-шлюзом

Обмен с программой-шлюзом ведётся с использованием почтового модуля системы «Супермаг Плюс». Для этой цели используется фильтр почтового модуля «Меркурий-обмен данными».
В Администраторе почтового модуля необходимо настроить обмен с программой-шлюзом. Указать каталоги обмена и выбрать в качестве фильтра опцию Меркурий-обмен данными (Рисунок 2):

Рисунок 2 – Фильтр почтового модуля «Меркурий-обмен данными»
Почтовый модуль из заданного каталога принимает пакеты ВСД, связанные с одной поставкой. По протоколу «Меркурия», одному наименованию продукции должен соответствовать один транспортный ветеринарный сопроводительный документ. Провайдеры должны обеспечить сборку всех ВСД по одной ТТН в один файл обмена. От программы шлюза должен приходить для одной поставки один файл, содержащий все транспортные ВСД, относящиеся к этой поставке.

Единицы измерения количества

В ГИС «Меркурий» используется такое понятие, как «базовая единица измерения». Таких единиц много не бывает. Как правило, в торговле требуются три или четыре типа единиц измерения: штучная единица, весовая единица, единица объёма, единица площади, единица длины. Для каждого типа единицы измерения необходимо выбрать одну, самую популярную. Остальные единицы измерения того же типа выражаются через неё.
Например, для весовой единицы измерения можно выбрать «килограмм». Все остальные единицы измерения веса (тонны, фунты, пуды и пр.) пересчитываются от килограмма с использованием коэффициента пересчёта.
В ГИС «Меркурий» базовая единица измерения задаётся тэгом commonUnitGuid. Коэффициент пересчёта – тэгом factor.
Перед началом работы требуется сопоставить базовые единицы измерения из ГИС «Меркурий» с соответствующими единицами единице измерения системы «Супермаг Плюс».
Для отображения количества в единицах измерения Торговой системы в справочнике единиц измерения (см. Том 1) необходимо заполнить новое поле Код ГИС Меркурий для базовых единиц измерения системы Меркурий (Рисунок 3). Производные единицы измерения Меркурия сопоставлять с единицами измерения Торговой системы не надо, эти сопоставления использоваться не будут.

Рисунок 3 – Код ГИС «Меркурий»
Для примера, описание единицы измерения в файле ВСД выглядит следующим образом:
<vd:volume>25.1</vd:volume>
<vd:unit>
<bs:uuid>0fd4780c-efd0-4f6d-bf10-f4ee7843ce2a</bs:uuid>
<argc:name>т</argc:name>
<argc:fullName>тонна</argc:fullName>
<argc:commonUnitGuid>ff1118b0-1045-485e-8c5d-d051df5c7616</argc:commonUnitGuid>
<argc:factor>1000</argc:factor>
</vd:unit>
Строки «0fd4780c-efd0-4f6d-bf10-f4ee7843ce2a» и «ff1118b0-1045-485e-8c5d-d051df5c7616» являются условным примером кодов единиц измерения системы «Меркурий». Истинные значения кодов следует брать из описания системы «Меркурий» или, при ее отсутствии, из примеров ВДС.
Код базовой единицы измерения записан в тэге «argc:commonUnitGuid».

Приёмка подконтрольной продукции. Гашение ВСД

Этапы процесса приёмки

Этап 1. Получение ВСД по конкретной поставке

Программа-шлюз пересылает в «Супермаг Плюс» перечень ВСД по конкретной поставке (по ТТН поставщика). Все ВСД, связанные с конкретной ТТН, принятые из программы-шлюза одним файлом, составляют исчерпывающий перечень ВСД по данной ТТН. Считается, что ни одна ВСД «не пропала» и «не потеряна». Принять ВСД по той же ТТН, но в другом файле, «Супермаг Плюс» не сможет. Все ВСД должны иметь соответствующий статус, чтобы по ним была возможна приёмка товара. После получения списка ВСД по ТТН пользователь ожидает прибытия товара по этой ТТН.

Этап 2. Приёмка товара по факту

При приёмке товара составляется приходная накладная. Далее, пользователь должен убедиться, что по подконтрольным товарам в этой накладной в системе имеется подходящий ВСД. Приходная накладная соотносится с ТТН. По строкам приходной накладной производится сопоставление с ВСД, входящими в ТТН. Выявляется расхождение в количестве.
Данные о факте принятого товара отправляются в программу-шлюз.
Программа-шлюз формирует данные для отправки в ГИС «Меркурий» и отправляет заявку на гашение ВСД. В зависимости от функционала программы-шлюза данная операция может выполняться роботом или человеком. Далее, от ГИС «меркурий» ожидается ответ о гашении ВСД.

Этап 3. Гашение ВСД, завершение приёмки

Программа-шлюз получает из ГИС «Меркурий» информацию о гашении ВСД и номер записи в складском журнале.
Данные о гашении передаются в «Супермаг Плюс».
Если все ВСД, связанные с приходной накладной погашены, то приходная накладная принимается полностью.

Входящие ВСД

Принятые почтовым модулем пакеты ВСД показываются в разделе Меркурий → Входящие ВСД (Рисунок 4):

Рисунок 4 – Раздел «Входящие ВСД»
Одному пакету соответствует одна строка в списке поставок (Рисунок 5):

Рисунок 5 – Строка в списке поставок, соответствующая пакету
Спецификация поставки состоит из перечня ВСД, относящихся к поставке (Рисунок 6):

Рисунок 6 – Спацификация ВСД к поставке
В строке спецификации в поле Объём показывается количество поставки так, как оно указано в ВСД. Наименование единицы измерения также берётся из ВСД и отображается в поле Ед. изм. объёма. Если в ВСД название единицы измерения указано не будет, то это поле также не будет заполнено.
Если в справочнике Торговой системы для базовых единиц измерения указаны коды ГИС «Меркурий» (см. Том 1), то в поле Количество строки спецификации будет показано количество поставки с пересчетом в единицу измерения Торговой системы ():


Рисунок 7 – Количество поставки с пересчетом в единицу измерения ТС
В разделе Входящий ВСД пакету ВСД можно поставить в соответствие приходную накладную со статусом Принят складом и произвести сопоставление строк накладной и ВСД из пакета ВСД. Сопоставление производится вручную.
В результате сопоставления в строке ВСД заполняется поле Фактический объем в единицах измерения ВСД (Рисунок 8):

Рисунок 8 – Фактический объем единицах измерения ВСД
По результатам сопоставления провайдеру отсылается акт приема с указанием разницы количества в приходной накладной и ВСД по каждому ВСД. Завершение работы по сопоставлению и отсылка акта выполняется нажатием кнопки Принять (Рисунок 9):

Рисунок 9 – Отсылка акта приема ВСД
Провайдер после обмена данными с системой «Меркурий» должен вернуть пакет со статусами гашения ВСД.
Статусы могут быть погашен или аннулирован (Рисунок 10):

Рисунок 10 – Пакет со статусами гашения ВСД
Если статус ВСД Аннулирован, поставку следует отменить.
При приеме товара необходимо учитывать, что если разница количества в накладной и в ВСД составляет не более 5%, то такой ВСД будет погашен и информация об этом событии придет от провайдера. Если количество принятого товара будет меньше указанного на величину большую, чем 5%, то провайдер оформит возвратный ВСД и на принятое количество придет акт приема. Если принимаемое количество превышает заданное больше чем на 5%, партия принята не будет. Партия не может быть принята также, если для принимаемого товара отсутствует ВСД. При отсутствии ВСД на товар или его часть, количество, не подтвержденное ВСД, не может иметь движения, то есть не может приниматься, продаваться, возвращаться, списываться.

XSD- схема файла обмена с программой-шлюзом.

<?xml version = "1.0" encoding = "UTF-8"?>
<xs:schema targetNamespace="http://servplus.ru/software/supermag/mercury/exchange"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://servplus.ru/software/supermag/mercury/exchange"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:vetd="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
elementFormDefault="qualified" version="1.4">
<xs:import namespace="http://api.vetrf.ru/schema/cdm/base" schemaLocation="base_v1.4.xsd"/>
<xs:import namespace="http://api.vetrf.ru/schema/cdm/argus/common" schemaLocation="argus_common_v1.4.xsd"/>
<xs:import namespace="http://api.vetrf.ru/schema/cdm/mercury/vet-document" schemaLocation="veterinary_document_v1.4.xsd"/>
<xs:complexType name="AcceptedVetDocumnet">
<xs:annotation>
<xs:documentation>Идентификатор принятого ВСД и фактическое количество.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="vetDocumentId" type="bs:UUID" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Идентификатор принятого ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="acceptedVolume" type="bs:Decimal" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Фактический объём принятого товара.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AcceptAct">
<xs:annotation>
<xs:documentation>Акт приёма товара в магазин с фактически принятым количеством.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="actDate" type="xs:date" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>
Дата акта приёма товара.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="item" type="tns:AcceptedVetDocumnet" minOccurs="1" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Идентификатор принятого ВСД и фактическое количество.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="UtilizedVetDocumnet">
<xs:annotation>
<xs:documentation>Погашенный ВСД.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="vetDocumentId" type="bs:UUID" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Идентификатор погашенного ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="status" type="vetd:VetDocumentStatus" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Статус ВСД (Погашен).</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="utilizedBy" type="argc:User" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Инспектор, погасивший ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="utilizeDate" type="xs:dateTime" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Дата и время гашения ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="WithdrawnVetDocumnet">
<xs:annotation>
<xs:documentation>Аннулированный ВСД.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="vetDocumentId" type="bs:UUID" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Идентификатор принятого ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="status" type="vetd:VetDocumentStatus" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Статус ВСД (Аннулирован).</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="withdrawedBy" type="argc:User" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Инспектор, аннулировавший ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="withdrawDate" type="xs:dateTime" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Дата и время аннулирования ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="withdrawReason" type="vetd:WithdrawReason" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Причина аннулирования ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="UtilizeAct">
<xs:annotation>
<xs:documentation>Акт гашения / аннулирования ВСД.</xs:documentation>
</xs:annotation>
<xs:choice>
<xs:element name="utilize" type="tns:UtilizedVetDocumnet">
<xs:annotation>
<xs:documentation>Гашение ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="withdraw" type="tns:WithdrawnVetDocumnet">
<xs:annotation>
<xs:documentation>Аннулирование ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:complexType name="UtilizeActList">
<xs:annotation>
<xs:documentation>Тип, описывающий список актов гашения / аннулирования ВСД.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="item" type="tns:UtilizeAct" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:element name="consignment" type="vetd:ConsignmentDocumentList">
<xs:annotation>
<xs:documentation>Поступление товара в магазин.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="acceptAct" type="tns:AcceptAct">
<xs:annotation>
<xs:documentation>Акт приёма товара в магазин.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="utilizeActList" type="tns:UtilizeActList">
<xs:annotation>
<xs:documentation>Список актов гашения / аннулирования ВСД.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:schema>

УКАЗАТЕЛЬ РАЗДЕЛОВ СИСТЕМЫ и документов