Обмен с системой Меркурий через Web + Ветис.API для любых конфигураций (универсальная конфигурация Хамелеон Меркурий)

!01_06_2024 Очередной "сюрприз" от Меркурианцев: чтобы получить данные к рабочему API, необходимо получить сначала данные к тестовому API и создать несколько документов без ошибок. (Напоминаем, что у нас есть чудо кнопка которая по одному клику прогрузит тестовый контур любым количеством накладных(транзакций) и Вам не придется тратить на это значительное время)

!Новости от 20_05_2024 С 01.07.2024 из подгруппы 0406 (Сыры и творог) документами оформляются для групп: 0406 20, 0406 30, 0406 40 и 0406 90 — это все сыры, за исключением молодых сыров и творога, которые находятся в 0406 10, для них сертификация начнётся 01.11.2024.

!Новости от 19_05_2024 Добавлено видеобзора возможностей ХамелеонМеркурий+обучение работы с системой Меркурий, для специалистов и профи смотрим с момента 1ч17мин30 сек, если понравится можно ознакомиться с подробностями.

ВИДЕОБЗОР ХамелеонМеркурий:

!Новости от 25.01.2024 В связи с сообщением Россельхознадзора http://www.fsvps.ru/fsvps/news/29173.html о переходе на 4й справочника подконтрольных товаров с 1 февраля, сообщаем, что наше ПО изначально при производстве использует 4й уровень и никаких дополнительных действий предпринимать не нужно.

!Новости от 18.10.2024  Разработка ХамелеонМеркурий признана лучшей коммерческой разработкой. Спасибо Всем кто помогал в создании, каждый кусочек текста, принтскин, или даже просто совместное обсуждение отдельных вопросов — сделали наш продукт более востребованным, масштабируемым и интересным.

!Новости от 01.06.18:

Для тех кто уже самостоятельно интегрировал и использует наше решение — цена при подключении новых ИНН(клиентов) всего 5.000.

Для тех кто еще думает покупать или нет — можно заняться получением доступов к API это бесплатно. Получение доступа к тестовому контуру: https://t2-aplms.vetrf.ru/pub. Получение доступа к рабочему контуру: https://aplms.vetrf.ru/pub.

!!!Новости от 09.06.18 В связи с сообщением Россельхознадзора http://www.fsvps.ru/fsvps/news/26881.html просьба для тех кто откладывал до последнего переход на API — переключить систему в режим API 2.0/2.1, а режим работы через WEB использовать только для демо или тестового контура.

!Новости от 18.04.18 добавлено рандомно-автоматическое создание и отправка транзакций на отгрузку в тестовом API в пару кликов мышкой(для ускорения получения данных от Меркурианцев к рабочему АПИ). Вам не потребуется тратить время на тестовый контур.

!Новости от 18.03.2024 учтены изменения системы Меркурий версии 6.5.4 от 14 марта 2024г. (отправлены покупателям)

!Новости от 14.03.2024 учтены изменения системы Меркурий версии 6.5.3 от 14 марта 2024г. (отправлены покупателям)

!Новости от 13.03.2024 В веб интерфейсе произошли изменения( версия 6.5.2 ) всем покупателям обновления отправлены.

!Новости от 28.02.2024 Согласно 28 пунктов Подсистема_обработки_заявок_в_Ветис.API(Операции версии 2.*)  реализовано(через понятные для большинства программистов XML-запросы/ответы) с проверкой по XSD схемам и с сохранением XML внутри ИБ для последующего анализа(часть пунктов объединили):

Получение/создание организаций/контрагентов(ХС)(14)  +  авто-подстановка/заполнение данных по ИНН

Создание/изменение/получение предприятий/площадок(15)

Создание/удаление связи с площадкой(17)

Создание номенклатуры/продукции производителя в справочнике(18)

Получение остатков(актуального списка записей журнала)(12), с автоматической сверкой остатков на соответствующем регистре ИБ

Отправка производства(1) с проверкой по XSD схеме

Отправка транзакций перевозки(2) со сменой владельца(реализация) с проверкой по XSD схеме

Получение(3),(8) новых/непогашенных входящих ВСД с последующим объединением во входящие транзакции(в поступления в виде строк табличной части) для более удобной последующей обработки/сверки с приходными накладными. При изменении фактического количества-возвратные ВСД отправляются автоматически. При необходимости ошибочные ВСД можно аннулировать(16)

Проверка возможности осуществления перевозки партии в рамках регионализации(21)

Инвентаризация(4), ввод начальных остатков.

Внесение сведений о ветеринарных мероприятиях(20)

Получение списка записей журнала, созданныхизмененных за период(13)

Регистрация и привязка пользователей к ХС(22)

Удаление связи пользователей с ХС(24)

Получение списка доступных прав пользователей(28)

Проверить работу в боевом контуре, используя данные для  WEB подключения, можно отправив черновики и сверив отправленные данные с данными получившимися в браузере), для подключения через API сначала необходимо протестировать все на тестовом контуре+копия ИБ(примерно 100-200 документов) и только убедившись, что все получилось — переходить на работу в боевом контуре.

!Новости от 09.02.2024 Проверка подключения через API. Добавлена регионализация .
Добавлено создание площадок через API. Возможность сохранения пароля пользователя Меркурий вне информационной базы(пример: на флешке локального ПК). Автоматическое переопределение истории записи партии журнала остатков при резервировании с учетом последующих отгрузок.

!Новости от 08.01.2024 В ознакомительную версию добавлена возможность запросов как через веб, так и возможность отправки запросов через API 2.0, как резервный канал на случай сбоев по одному из контуров системы Меркурий.

!Новости от 25.12.2024 Добавлена возможность работы с импортным товаром. Добавлена часть возможностей из Меркурий.ГВЭ. Учтено глобальное изменение целей для транзакций в demo-контуре.

!Новости от 15.12.2024 Добавлена возможность работы через прокси, или через тонкий клиент(при наличии доступа на сервере на сайт Меркурий)

!Новости от 12.12.2024 Добавлена возможность работы с системой Меркурий через прокси.

!Новости от  11.12.2024 Просмотр доступных прав(разрешенных действий) пользователя в системе Меркурий(готовы реализовать и другие Ваши имеющие ценность "пожелалки"). Возможность создать/присоединить предприятие + описание для удаления предприятий. Отчеты по движениям партий.

!Новости: от 03.12.2024 Решение работает на 8.3.6 и выше, а также поддерживает режим совместимости до 8.2.16

!Новости: от 01.12.2024 Разработка попала в топ самых популярных на Инфостарте

!Новости: от 30.11.2024 Включено в инструкцию описание работы без необходимости внедрения партионного учета для оптовиков, при этом сохраняется возможность контроля за сроками годности, а также сохраняется возможность при отгрузке со склада отдать туже партию что и по системе Меркурий. Добавлена возможность резервирования товара. Оптимизирована логика автономной работы при заметных нарушениях связи с сайтом Меркурий. Доступен к скачиванию файл только для ознакомления от 30.11.2024 с открытым кодом.

!Новости: от 25.11.2024 Самые интересные картинки и описание возможностей добавлены внизу публикации.

!Новости: от 24.11.2024 учтены зависания сайта Меркурий, теперь транзакции можно подготавливать в "черновом" варианте и как только связь с сайтом восстановится в минимальный промежуток времени отправлять большое количество подготовленных документов.

Универсальная конфигурация МеркурийХамелеон для взаимодействия с системой Меркурий(тестовый=https://demo-mercury.vetrf.ru/hs+или тестовый=https://t2-mercury.vetrf.ru + рабочий контур=https://mercury.vetrf.ru/hs) может использоваться для интеграции в любую конфигурацию 1с версии ПРОФ и выше(достаточно снять галочку: свойства конфигурации и можно пользоваться всеми преимуществами из своей привычной учетной системы). Основное отличие от других решений полностью открытый код, работа через веб-интерфейс и API. Для удобства реализован общий интерфейс в виде обработки, схожей с интерфейсом Меркурий, но возможностей гораздо больше, т.к. при интеграции в Вашу учетную систему, можно на основании Ваших справочников и документов, создавать соответствующие документы и справочники в системе Меркурий и наоборот. Гашение ВСД, отказ и частичный отказ. Возможность групповой печати ветеринарных свидетельств.

Для работы с системой меркурий необходимо выполнение требований: http://www.fsvps.ru/fsvps-docs/ru/importExport/info/files/argus_user_requirements.pdf. При работе с ХамелеонМеркурий Удобно использовать уже существующую обычную инструкцию от системы Меркурий:

http://help.vetrf.ru/wiki/Подсистема_хозяйствующего_субъекта_(Меркурий.ХС)  или

http://help.vetrf.ru/wiki/Часто_задаваемые_вопросы_по_системе_Меркурий,

мы только расширяем интеграционные возможности в сторону объединения с Вашими учетными системами + уже привычный интерфейс+легко настраиваемые/добавляемые поля(пункт "все действия" изменить форму) + хранение копий данных(документов/справочников) на Ваших ПК и дальнейшая работа с ними.

В комплекте для скачивания идет пакет для самостоятельной интеграции в Вашу учетную систему на базе 1с 8.3.6 и выше или в режиме совместимости до 8.2.16(универсальная конфигурация "ХамелеонМеркурий"). Подходит для любых(не базовых) конфигураций(на управляемых и обычных формах).

Почему Хамелеон? В свойствах конфигурации ставите нужное управляемое приложение или использовать управляемые формы в обычном приложении и получаете, то что нужно. При интеграции в Вашу конфигурацию, все еще проще — просто снимите верхнюю галочку(свойства конфигурации)

Почему конфигурация а не внешняя обработка? У нас очень большой опыт интеграции аналогичной системы на ЕГАИС, из которой мы постарались взять самые лучшие наши наработки и только использование конфигурации позволяет гладко закрывать все проблемные участки по Вашим пожеланиям в функционале, что порой крайне проблематично, а порой и невозможно сделать во внешней обработке. При этом интеграция происходит также легко как и скачивание файла внешней обработки. Наше решение работает в любой конфигурации в отличии от файла внешней обработки, который обычно заточен только под одну конфигурацию(и очень редко внешние обработки совместимы больше чем с одной конфигурацией, но при этом сложность кода такой обработки возрастает в разы)

Если возникнут вопросы по интеграции, обращайтесь, поможем.

Основные возможности:

• Внесение лабораторных исследований и иммунизации в созданные партии или при производстве.
• Можно подключить к своей учетной записи другие ХС=ИНН(своих ключевых клиентов-розничные точки) и за них погашать ВСД, чтобы клиенты от Вас никуда не делись(требуется покупка использования на дополнительные ИНН)
• Поддерживается отправка маркировки, номеров партий и одновременно нескольких видов упаковок для каждой партии.
• Просмотр доступных прав(действий) пользователя в системе Меркурий.
• Запрос продукции и данных по ней по GUID. Редактирование данных продукции.
• Синхронизация остатков с Меркурий.
• Возможность объединить несколько документов отгрузки в одну большую транзакцию(маршрут), значительно экономит время на отправку, очень актуально если документов на отгрузку в сутки несколько тысяч.
• Отчеты по движениям в Меркурий.
• Возможность учитывать работу вет. врача(действия с транзакциями отправленными в ГВЭ) доступно в WEB, в API 2.0 можно оформлять только через логин вет.врача(по договоренности с вет. врачом). Меркурианцы обещали в будущем реализовать и в API возможность отправить в ГВЭ.
• Автоматическая подстановка полей в документах из значений по умолчанию для текущего пользователя(удобно для не больших компаний) 
• Инвентаризация(изменение/удаление количества в партиях). Создание партий через журнал продукции.
• Объединение записей журнала(у нас тоже работает, но не рекомендуем все подряд объединять-Ваши клиенты, такую продукцию могут не принять)
• Создание транзакций: производство/отгрузка/перемещение+можно создавать черновой вариант в Меркурии для сверки всех полей.
• Возможность автономной работы при неполадках на сайте Меркурий.(при невозможности выгрузить в Меркурий-продукцию можно резервировать и при появлении соединения с Меркурием-выгружать)
• Поддерживает работу в тестовом(https://demo-mercury.vetrf.ru/hs)+рабочем контуре(https://mercury.vetrf.ru/hs) и в тестовом=https://t2-mercury.vetrf.ru, а также работает через тестовый и рабочий API 2.0
• Поддерживает загрузку документов/печать Ветеринарных свидетельств.
• Гашение ВСД, отказ и частичный отказ.(для гашения всех — просто выделите список)
• Гашение ВСД принадлежащих одному поступлению из самой входящей транзакции+ колонка количество по факту.
• Удобный интерфейс в 1с схожий с интерфейсом в веб браузере системы Меркурий.
• Поддерживается одновременная работа нескольких пользователей по разным ХС или предприятиям.
• Возможность работы с несколькими ХС(требуется соответствующее число лицензий на использование)
• Автоматическое или ручное включение отбора в журналах по выбранному XC и других отборов под разные задачи.
• Автоматическое пере-подключение при разрыве соединения.
• Вывод сообщений от системы Меркурий и наших рекомендаций по реагированию на них.
• Добавлены подробные инструкции с картинками во все разделы(Help-окна и кнопки с "?")
• Подходит для самостоятельного обучения(даже для неподготовленных пользователей)
• Полностью открытый код.(Убедитесь сами, что Ваши данные не передаются третьим лицам)
• Мы первые, кто предложил решение для работы с системой Меркурий через Web+API.
• Считывание и запись, добавление, редактирование, удаление справочников и групп.
• Мы готовы адаптировать наше решение под Ваши задачи.
• Лицензирование идет на ХС в целом(а не на каждое предприятие)
• На нашем ПК можно по-тестировать самим полнофункциональную версию со всеми возможностями(доступно по предварительной записи)
• Для всех покупателей мы предлагаем бесплатную рассылку обновлений и другой полезной и интересной информации на весь 2024г.
• Еженедельно выкладываем новые версии, в которых возможности конфигурации заметно увеличиваются согласно Вашим пожеланиям.
• Решены все пункты взаимодействия с Меркурий. Не нашли что-то нужное для Вас? Просто спросите мы оперативно добавим или более подробно распишем ответы на часто-задаваемые вопросы в HELP-окнах.

Основные возможности работы вместе с нами(с использованием нашего продукта):

• Покупая для одного Вашего тестового ИНН=ХС, сможете обучить на работающем примере работе в Меркурий большое количество сотрудников компаний переходящих на работу с системой Меркурий.
• Оптовым покупателям от 10 ИНН предусмотрены значительные скидки.
• Компании которые хотят привязать к себе своих ключевых розничных клиентов смогут за них погашать ВСД. Подключив их к своей учетной записи.(Необходимо оплатить 5.000 за каждый подключенный ИНН)
• Появились другие предложения по сотрудничеству-обращайтесь мы готовы их обсудить.

Все купившие(пункт за 8тыс. руб.) могут воспользоваться бесплатной первоначальной консультацией в течение 30 дней, где мы поможем объединить данную конфигурацию с Вашей и расскажем про основные моменты использования, (для помощи Вам требуется программа TeamViewer), дальнейшая поддержка платная 1 т. руб в час. Для тех кто, самостоятельно во всем разобрался действует спец. цена(5тыс. руб.)

Обновления для ХамелеонМеркурий рассылаются на почту, если кому-то вдруг не приходят(ограничение Вашего почтового ящика), пишите-мы очень постараемся, чтобы Вы их начали получать, т. к. рассылка содержит интересную/важную информацию о системе Меркурий и во вложении всегда актуальное обновление(обновления все подряд можно не устанавливать, последнее обновление уже содержит в себе все предыдущие)

Введение

Перед началом использования рекомендуем воспользоваться ссылкой для проверки доступа через обычный браузер(например Mozilla Firefox, Internet Explorer и др.)  https://mercury.vetrf.ru/hs  или https://demo-mercury.vetrf.ru/hs или https://t2-mercury.vetrf.ru/hs затем убедившись, что данные верны, уже вводите их в программе. Данные для подключения через API(тестовый или рабочий) вводятся на соответствующей вкладке в пользователе.

далее нажимаете кнопочку(1) подключиться и Вы уже подключены к системе Меркурий. Для работы с интересующим ХС, выберите его из списка ниже(ENTER или кнопка "2").

При первом использовании сработает регламентное задание по заполнению справочников согласно данным системы Меркурий(на быстрых ПК это почти незаметно).

Первоначальное использование и работа с документами

Для работы с интересующими Вас документами перейдите на соответствующую вкладку. Для гашения ВСД просто кликните на странице авторизации по "колонке с числом" входящих ВСД по предприятию, после чего только непогашенные ВСД(вместе с входящими транзакциями/поступлениями) будут загружены в Вашу учетную систему и доступны для дальнейшей работы с ними(погашения/частичного погашения). Очень удобно погасить несколько ВСД сразу из входящей транзакции(поступления), представлено в виде табличной части по ВСД и если количество по факту отличается, то меняете только колонку: "количество по факту". Есть возможность считывать/обновлять данные по отправленным в ГВЭ транзакциям в систему Меркурий, уже с учетом работы вет. врача).

по кнопке "погасить" доступно:  Гашение ВСД, отказ и частичный отказ.

далее доступна кнопка "Печать ВСД" нажав на нее вы можете распечатать сокращенное или полное ВСД.

Достаточно любой программы на ПК для работы с PDF документами.

Далее кнопка "Погасить ВСД" она вызывает форму аналогичную форме с сайта Меркурий, заполнив ее и нажав кнопку "Сохранить" можно при необходимости произвести гашение/частичное гашение ВСД.

Далее самая интересная кнопка: "Открытие внешней обработки", вот здесь уже можно делать абсолютно все! В зависимости от Ваших задач просто добавляете одну или несколько внешних обработок с названиями соответствующими их функционалу, мы здесь просто перечислим несколько примеров использования, например выделив в списке нужное количество документов и нажав кнопку соответствующей внешней обработки, можно:

• распечатать вет. свидетельства для всех выделенных.
• распечатать любые другие формы документов.
• создать на основании документов/данных Меркурий, любые документы в Вашей учетной системе.
• а также на основании Ваших документов, создавать и обрабатывать документы в системе Меркурий.
• также на основании полученных данных можно запускать различные регламентные задания(функционал регламентных заданий у нас очень развит в других решениях и в ближайшее время планируется его перенос в ХамелеонМеркурий.

Примеры внешних обработок доступны бесплатно для пользователей коммерческих версий, в соответствии с их задачами. Основные плюсы от использования внешних обработок-это то что Вы сможете без дополнительных усилий обновлять и Вашу конфигурацию и устанавливать наши обновления сняв всего одну галочку(свойства конфигурации), а все "состыковки" будут во внешних подключаемых обработках.

Пример удобства использования при работе со справочником:

При создании номенклатуры (в системе Меркурий) нажмите кнопку добавить, если Вы при этом находитесь в группе, то группы заполнятся автоматически. Для начала ввода введите первые символы в ответ увидите несколько вариантов для выбора полученных от системы Меркурий, выберите нужный из них, элемент справочника автоматически запишется в Вашу базу, в дальнейшем можно выбирать уже созданные элементы из Вашей базы воспользовавшись кнопкой выбора "…"

После записи "продукции" продукция автоматически создастся и на сайте Меркурий, доступны кнопки копирования, удаления, редактирования. Все изменения также отразятся и на сайте Меркурий.

Пример удобства использования при работе с документом транзакция:

Рассмотрим более подробно удобство использования на примере универсального документа транзакции.

Ниже приведена картинка которая наглядно демонстрирует все этапы создания транзакции (смена владельца без перевозки-доступны и другие виды транзакций),

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

Согласно картинке выше, работает стандартный алгоритм с сайта Меркурий, но поскольку транзакции это "сердце" системы Меркурий, а сердце БЪЁТСЯ, а не стучит или постукивает, мы решили максимально повысить удобство использования транзакций, если на сайте после внесения большого количества продукции на отгрузку выяснилось, что одна машина сломалась и повезут на другой, то чтобы сменить номер автомобиля приходилось: !УДАЛЯТЬ! продукцию и получателей только после этого можно было сменить номер автомобиля, а затем заново вносить получателей и продукцию… в нашей оболочке: просто меняете номер автомобиля-все остальное программа сделает за Вас! Плюс ко всему могли случиться другие напасти: интернет мог отключиться, сайт разлогиниться, что приводило к множеству дополнительных действий для пользователя, у нас ничего лишнего делать не нужно, даже при недоступности сайта можно продолжать свою обычную деятельность(делать заявки на производство/отгрузку и сверять поступившие накладные), про автономную работу чуть ниже, а сейчас смотрим картинки насколько удобнее стало работать(вид журнала транзакций):

транзакция изнутри:

Добавлена возможность автономной работы при неполадках на сайте Меркурий, готовите "черновики" и как только связь восстановится сразу отправляете весь комплект документов. Также доступна кнопка "отправить черновик в Меркурий", т. е. можете все сверить сами с сайтом прежде чем нажать кнопку оформить.

Интеграция с Вашими учетными системами(сопоставление справочников и и документов)

Картинка ниже наглядно демонстрирует удобство сопоставления Ваших учетных данных и данных системы Меркурий:

Сопоставлять можно абсолютно все(сопоставляются объекты вне зависимости справочник это или документ)! Мы сделали универсальный механизм, можно даже вытаскивать(для удобства сопоставления) необходимые для работы пользователя реквизиты документов и справочников, как из Вашей учетной системы, так и из Меркурий.

Например рассмотрим сразу самый сложный случай ведения партионного учета по сериям(в Вашей учетной системе это справочник) , в системе Меркурий это журнал продукции(документ), но в целом это одно и тоже-это партия. Никаких сложностей, сопоставляем справочник с документом у нас и то и другое является объектом+ можно вытащить необходимые реквизиты(в отдельные колонки) помогающие нам сопоставлять, например срок годности. Ну а если ручками нет времени сопоставить, а параметры сопоставления известны, то подключаем внешнюю обработку которая сопоставит в автоматическом режиме, мы же только наблюдаем результат ее работы в таблице ниже и если что-то не нравится, то очищаем и грузим с новыми параметрами.

Публикация в данный момент дорабатывается, задавайте вопросы, ответы на самые интересные из них мы развернем в самой публикации.

Ограничения для коммерческого использования:

Для коммерческого использования просьба указывать ИНН=ХС при подписке на обновления(использование), т. к. 1 подписка=1 ИНН=1ХС.( Лицензирование идет на ХС в целом, а не на каждое предприятие)

Для коммерческого использования допускается внесение любых изменений, кроме вкладки с авторизацией и кода связанного с ней.

Остальные ограничения связаны только с количеством/наличием лицензий фирмы 1С.

При наличии в покупке пункта консультации — консультация может быть по любым вопросам связанным с системой Меркурий, а не только по использованию программы(время консультации до 3х часов, может разбиваться на несколько консультаций по 0,5часа или 1 час) консультация осуществляется по программе Таймвивер и одновременным пояснением всех действий по телефону(при дорогой связи-можем перезванивать Вам). Воспользоваться такой бесплатной консультацией(ями) можно в течении 30 дней с момента покупки.

Благодарности от наших покупателей: