Меркио ← Выбор версии 1С:Предприятия

Подключение 1С:Предприятие к витрине Меркио

Инструкция для специалиста 1С:Предприятия — как настроить обмен вашей учётной базы с интернет-витриной Меркио. Установка идёт одним мастером — вручную ничего собирать не нужно.

Версия: Управление торговлей 11 (УТ 11.4 / 11.5)

Содержание

Что понадобится
Комплект от Меркио
Установка
Проверка результата
Обратный обмен заказов
Эксплуатация: пауза, отключение, смена токена
Диагностика типовых проблем
Поддержка
Приложение: ручная установка

1 Что понадобится

Обмен работает без изменения конфигурации 1С:Предприятия: отдельная внешняя обработка читает данные из вашей базы и отправляет их на витрину по защищённому каналу. Всё запускается на том же Windows-сервере, где установлена платформа 1С:Предприятие.

СерверWindows Server, на котором работает ваша платформа 1С:Предприятие. Права локального администратора (установщик создаёт задачи планировщика).
Платформа 1С:Предприятие1С:Предприятие 8.3 или 8.5. Конфигурация — «Управление торговлей 11» (11.4 или 11.5).
COM-коннекторВнешнее соединение V85.COMConnector (для платформы 8.5) или V83.COMConnector (для 8.3). Обычно ставится вместе с платформой. Установщик проверит его наличие и при необходимости попробует зарегистрировать сам.
Пользователь 1С:ПредприятияОтдельная учётная запись с правами на чтение номенклатуры, цен, остатков и на создание заказов. У неё должна быть снята «Защита от опасных действий» (см. ниже).
ИнтернетИсходящий HTTPS (порт 443) с сервера на https://merkio.ru. Данные всегда идут на этот адрес — витрина определяется по вашему токену, а не по домену.

«Защита от опасных действий». У пользователя 1С:Предприятия, под которым идёт обмен, этот флаг нужно снять в Конфигураторе (Администрирование → Пользователи → карточка пользователя). Через режим «Предприятие» это не переключается. Без снятия обработка не сможет прочитать данные и запись файлов будет заблокирована «безопасным режимом» — установщик на этом шаге сообщит об ошибке понятным текстом.

2 Комплект от Меркио

Всё для подключения приходит одним архивом: скачайте его в панели управления (карточка витрины → кнопка «Скачать комплект 1С:Предприятия») или получите у поддержки Меркио. Внутри уже лежит токен вашей витрины и установщик — собирать что-либо самостоятельно не нужно. Состав архива:

Установить.cmdМастер установки. Запускается один раз, задаёт пару вопросов и сам делает всю настройку.
Удалить.cmdПолное отключение обмена (файлы остаются на диске).
Пауза.cmd / Возобновить.cmdВременно остановить и снова включить обмен — например, на время обслуживания базы.
merkio.jsonНастройки обмена с уже вписанным токеном вашей витрины.
МеркиоВыгрузка.epfВнешняя обработка выгрузки: читает номенклатуру / цены / остатки и отправляет на витрину.
МеркиоЗаказы.epfВнешняя обработка обратного обмена: забирает оформленные на сайте заказы и создаёт документы «Заказ клиента».
Скрипты обменаmerkio_loop.ps1, merkio_watchdog.ps1, com_orders.ps1 — цикл выгрузки, сторож и перенос заказов. Их использует установщик.
install.ps1, README.mdСлужебный движок установщика и краткая памятка.

Токен приёма данных. Это секрет вашей витрины. Он уже вписан в файл merkio.json из архива — вручную его никуда вводить не нужно. Тот же токен виден в панели управления (карточка витрины → «Токен приёма данных из 1С:Предприятия»). Не публикуйте его.

3 Установка

Распакуйте архив в папку на сервере 1С:Предприятия. Рекомендуем E:\Merkio или C:\Merkio, но путь может быть любым — важно, чтобы все файлы лежали в одной папке.
Убедитесь, что у пользователя 1С:Предприятия снята «Защита от опасных действий» (см. раздел 1).
Запустите Установить.cmd от имени администратора: правая кнопка мыши по файлу → «Запуск от имени администратора».
Мастер спросит три вещи:
- Путь к информационной базе 1С:Предприятия — папка файловой базы (например E:\1CBases\Trade) либо строка соединения для серверной базы (сервер и имя базы);
- Имя пользователя 1С:Предприятия (той самой учётной записи для обмена);
- Пароль этого пользователя.
Дальше установщик всё делает сам:
- проверяет и при необходимости регистрирует COM-коннектор;
- подключается к базе с вашими реквизитами и понятным языком сообщает, если пароль неверный или не снята «Защита от опасных действий»;
- создаёт три задания планировщика — MerkioExport, MerkioWatchdog, MerkioOrders;
- запускает первую выгрузку и дожидается ответа витрины.
Когда всё прошло, установщик выводит OK — обмен настроен и уже работает.

Что такое эти три задания. MerkioExport — основной цикл выгрузки (запускается при старте сервера, каждые ~15 секунд шлёт изменения цен и остатков, каждые ~5 минут — полный каталог). MerkioWatchdog — сторож, поднимает цикл после сбоя или перезагрузки. MerkioOrders — раз в 5 минут переносит заказы с витрины в 1С:Предприятие. Все три работают от системной учётной записи в фоне; отдельно запускать их не нужно.

Повторный запуск Установить.cmd безопасен — им же переустанавливают обмен, меняют пароль или путь к базе (см. раздел 6).

4 Проверка результата

Обычно достаточно вердикта установщика. Если хотите убедиться дополнительно:

Установщик показал OK и не вывел ошибок — первая выгрузка ушла и витрина её приняла.
Откройте вашу витрину (адрес вида https://<ваш-id>.merkio.ru или ваш домен) — через несколько минут после первого полного фида в каталоге появятся товары.
В панели управления (карточка витрины) поле «Синхронизация» покажет свежее время, а счётчик активных товаров начнёт расти.

Текущее состояние обмена всегда видно в файле loop_result.txt в папке установки — строка вида OK i=0 202 [...] означает, что фид ушёл и витрина приняла его (код 202). Подробнее — в разделе «Диагностика».

5 Обратный обмен заказов

Заказы, оформленные покупателями на витрине, автоматически переносятся в 1С:Предприятие заданием MerkioOrders (раз в 5 минут). Обработка МеркиоЗаказы.epf:

забирает новые заказы с витрины;
создаёт документ «Заказ клиента» (клонируя ваш документ-образец — наследуются организация, склад, статус); цена в заказе — снимок с момента оформления;
покупатель по умолчанию сопоставляется с «Розничным покупателем» (при совпадении телефона — с существующим партнёром);
реквизиты покупателя и доставки записываются в Комментарий документа.

Документ создаётся без проведения — менеджер проверяет и проводит его вручную.

Признак онлайн-оплаты. Если заказ оплачен на сайте (или оформлен возврат) уже после переноса в 1С:Предприятие, обработка идемпотентно дописывает в Комментарий метку [ОПЛАЧЕН ОНЛАЙН …] / [ВОЗВРАТ ОПЛАТЫ …]. Отдельная задача для этого не нужна — всё работает в рамках MerkioOrders.

Результат последнего запуска — в файле orders_result.txt в папке установки (строка OK ... или ERR ...).

Документ-образец «Заказ клиента» (проведённый, с нужными организацией / складом / статусом) должен существовать в базе — по нему создаются новые заказы. Если образца нет, сообщите в поддержку при онбординге.

6 Эксплуатация: пауза, отключение, смена токена

Обслуживание базыПеред обновлением конфигурации, тестированием и исправлением базы запустите Пауза.cmd — обмен остановится, чтобы не мешать монопольному доступу. После работ — Возобновить.cmd.
Полное отключениеУдалить.cmd убирает задания планировщика и останавливает обмен. Файлы комплекта остаются на диске — при желании обмен можно включить снова через Установить.cmd.
Переустановка / смена пароля или базыПросто запустите Установить.cmd заново и введите новые данные — это безопасно и заменяет прежнюю настройку.
Смена токена (ротация)Если токен витрины перевыпущен, скачайте свежий архив в панели управления (кнопка «Скачать комплект 1С:Предприятия» — новый токен уже внутри) и замените merkio.json в папке установки, либо просто впишите новое значение token в существующий файл. Ничего пересобирать и переустанавливать не нужно — обмен подхватит новый токен.

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

7 Диагностика типовых проблем

Ход установки установщик записывает в файл install.log в папке комплекта. Текущее состояние обмена — в loop_result.txt (выгрузка) и orders_result.txt (заказы). Ниже — что делать при типовых сообщениях.

Установщик: «неверное имя пользователя или пароль»	Проверьте имя пользователя 1С:Предприятия и пароль и запустите `Установить.cmd` заново. Убедитесь, что это учётная запись именно вашей рабочей базы.
Установщик: «установлен безопасный режим» / «Защита от опасных действий»	У пользователя 1С:Предприятия не снята «Защита от опасных действий». Снимите её в Конфигураторе (раздел 1) и запустите `Установить.cmd` ещё раз.
Установщик: «не найдена база 1С:Предприятия» / «неверный путь»	Указан неправильный путь к файловой базе или строка соединения серверной базы. Уточните путь (для файловой — папку с файлом `1Cv8.1CD`) и повторите установку.
Установщик: «COM-коннектор не зарегистрирован»	На сервере не установлен компонент внешнего соединения 1С:Предприятия. Установите платформу 1С:Предприятие полностью (с компонентой «COM-соединение») или обратитесь в поддержку Меркио — поможем зарегистрировать вручную.
Ошибка `ERR ... 401` в `loop_result.txt`	Токен неверный или отозван. Скачайте свежий комплект в панели управления (карточка витрины → «Скачать комплект 1С:Предприятия») и замените `merkio.json` в папке установки (раздел 6).
Товары не появляются, хотя `loop_result.txt` = `OK ... 202`	Фид принят, но полный каталог приходит раз в ~5 минут — подождите. Если долго пусто — проверьте в панели поле «Синхронизация» и обратитесь в поддержку.
Нет исходящего соединения на витрину	Проверьте, что с сервера открыт HTTPS (443) на `merkio.ru` (прокси / файрвол / антивирус не блокируют).

Если проблема не решается — приложите к обращению файлы install.log, loop_result.txt и orders_result.txt. По ним поддержка быстро определит причину.

8 Поддержка

Если шаг не проходит или в result-файлах постоянная ошибка — обратитесь в поддержку Меркио и приложите install.log, loop_result.txt, orders_result.txt. Мы поможем с настройкой соединения, перевыпуском комплекта и проверкой обмена.

Панель управленияКарточка вашей витрины: токен, поле «Синхронизация», счётчик товаров.
Проверка витриныВаш адрес витрины — каталог с товарами после первой выгрузки.

Приложение: ручная установка (для системных администраторов)

Обычно этот раздел не нужен — всё делает Установить.cmd. Он приведён на случай, когда установку нужно выполнить по шагам: например, при нестандартной конфигурации сервера или отладке.

1. Папка и файлы

Скопируйте файлы комплекта в рабочую папку (например E:\Merkio): обработки МеркиоВыгрузка.epf, МеркиоЗаказы.epf, скрипты merkio_loop.ps1, merkio_watchdog.ps1, com_orders.ps1 и конфиг merkio.json. Подпапку tmp для временных файлов COM скрипт создаёт сам.

Кодировка скриптов — UTF-8 с BOM. Файлы .ps1 должны остаться в кодировке UTF-8 со спецификацией (BOM). Если пересохранить их «обычным» блокнотом без BOM, PowerShell прочитает кириллицу как cp1251 и обмен сломается. Правьте в редакторе, сохраняющем BOM (PowerShell ISE или VS Code с «UTF-8 with BOM»).

2. COM-коннектор

Если внешнее соединение не зарегистрировано, выполните от администратора:

regsvr32 "C:\Program Files\1cv8\<версия>\bin\comcntr.dll"

3. Задачи планировщика

Три задачи от системной учётной записи. Откройте командную строку от администратора (пути E:\Merkio при необходимости замените на свои):

Near-realtime выгрузка (запуск при загрузке сервера):

schtasks /Create /TN MerkioExport /SC ONSTART /RU SYSTEM /RL HIGHEST /F ^
  /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File E:\Merkio\merkio_loop.ps1"

Сторож цикла (каждую минуту):

schtasks /Create /TN MerkioWatchdog /SC MINUTE /MO 1 /RU SYSTEM /RL HIGHEST /F ^
  /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File E:\Merkio\merkio_watchdog.ps1"

Обратный обмен заказов (каждые 5 минут):

schtasks /Create /TN MerkioOrders /SC MINUTE /MO 5 /RU SYSTEM /RL HIGHEST /F ^
  /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File E:\Merkio\com_orders.ps1"

4. Первый запуск и проверка

Задача MerkioExport стартует при загрузке сервера. Чтобы запустить сразу, не перезагружаясь:

schtasks /Run /TN MerkioExport

Через 20–30 секунд в loop_result.txt должна появиться строка OK i=0 202 [...] (код 202 — витрина приняла фид).

5. Пауза и замена обработок вручную

Остановить обмен: schtasks /Change /TN MerkioExport /DISABLE и schtasks /Change /TN MerkioWatchdog /DISABLE, затем завершить процесс цикла (при необходимости — процессы 1cv8). Возобновление: /ENABLE обеих задач + schtasks /Run /TN MerkioExport. При замене занятого .epf — сначала schtasks /End /TN MerkioExport и /DISABLE, затем замена, затем /ENABLE и /Run.