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

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

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

Версия: Управление торговлей 10.3 (обычные формы)
Подключение УТ 10.3 — по согласованию с поддержкой. Управление торговлей 10.3 (платформа 8.3, обычные формы) устроено иначе, чем УТ 11: другие документы, регистры и справочники. Архив с установщиком и обработками теперь можно скачать прямо в панели управления (карточка витрины → кнопка «Комплект для УТ 10.3») — собирать вручную не нужно. Но параметры именно вашей базы — какой тип цен показывать на витрине, какие склады учитывать в остатках, на какого контрагента оформлять веб-заказы — мы согласуем вместе и впишем в файл настроек merkio.json. Эта страница описывает общий порядок; шаги, помеченные значком «Уточнит поддержка», выполняются вместе с нами.
Содержание
  1. Что понадобится
  2. Чем УТ 10.3 отличается от УТ 11
  3. Комплект от Меркио
  4. Установка
  5. Проверка результата
  6. Обратный обмен заказов
  7. Эксплуатация: пауза, отключение, смена токена
  8. Диагностика типовых проблем
  9. Поддержка
  10. Приложение: ручная установка

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

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

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

2 Чем УТ 10.3 отличается от УТ 11

Эти отличия учтены в комплекте обмена, который готовит Меркио. Приводим их, чтобы вы понимали, откуда обработка берёт данные в вашей базе, и могли проверить права / наличие нужных объектов.

ОбластьУТ 11УТ 10.3 (ваша база)
Документ заказаЗаказ клиентаЗаказ покупателя
КонтрагентыПартнёры + КонтрагентыПартнёров нет — Контрагенты напрямую
Остаткиресурс «В наличии»ресурс «Количество» (регистр остатков товаров)
Ценыдокумент «Установка цен номенклатуры»измерение «Тип цен», справочник «Типы цен номенклатуры»
Картинки товаровприсоединённые файлычасто в «Хранилище дополнительной информации»
Формыуправляемыеобычные (толстый клиент)
Уточнит поддержка
Какой именно тип цен показывать на витрине и какой склад/склады учитывать в остатках — эти два параметра мы согласуем при подключении и впишем в файл настроек merkio.json (поля price_type и warehouses; пока не согласовано — обработка использует типовые значения: тип цен «оптовая», остатки по всем складам).

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

Всё для подключения — один архив, который можно скачать прямо в панели управления (карточка витрины → кнопка «Комплект для УТ 10.3»). Комплект универсальный: одна сборка на всех клиентов версии УТ 10.3, пересборка под вашу базу не нужна — внутри уже лежит токен вашей витрины и установщик. Состав архива:

Токен приёма данных — секрет вашей витрины, уже вписан в файл merkio.json из архива. Вручную его никуда вводить не нужно. Тот же токен виден в панели управления (карточка витрины). Не публикуйте его.
Параметры базы — согласуются с поддержкой. Скачанный архив содержит рабочий merkio.json, но поля price_type/warehouses/order_customer в нём пустые, пока мы их не согласуем. Скачивание архива — не финальный шаг подключения: сообщите поддержке Меркио, и мы поможем вписать нужные значения под вашу базу.

4 Установка

Порядок такой же, как для УТ 11 — тот же установщик, отличается только состав обработок под вашу базу.

  1. Распакуйте архив в папку на сервере 1С:Предприятия. Рекомендуем E:\Merkio или C:\Merkio, но путь может быть любым — важно, чтобы все файлы лежали в одной папке.
  2. Убедитесь, что у пользователя 1С:Предприятия снята «Защита от опасных действий» (см. раздел 1).
  3. Запустите Установить.cmd от имени администратора: правая кнопка мыши по файлу → «Запуск от имени администратора».
  4. Мастер спросит путь к информационной базе 1С:Предприятия (папка файловой базы либо строка соединения серверной), имя пользователя 1С:Предприятия и пароль.
  5. Дальше установщик всё делает сам:
    • определяет и проверяет COM-коннектор V83.COMConnector;
    • подключается к базе и понятным языком сообщает, если пароль неверный или не снята «Защита от опасных действий»;
    • создаёт три задания планировщика — MerkioExport, MerkioWatchdog, MerkioOrders;
    • запускает первую выгрузку и дожидается ответа витрины.
  6. Когда всё прошло, установщик выводит OK — обмен настроен и уже работает.
Что такое эти три задания. MerkioExport — основной цикл выгрузки (при старте сервера, каждые ~15 секунд — изменения цен и остатков, каждые ~5 минут — полный каталог). MerkioWatchdog — сторож, поднимает цикл после сбоя или перезагрузки. MerkioOrders — раз в 5 минут переносит заказы с витрины в 1С:Предприятие. Все три работают в фоне; отдельно запускать их не нужно.
Повторный запуск Установить.cmd безопасен — им же переустанавливают обмен, меняют пароль или путь к базе (см. раздел 7).

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

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

  1. Установщик показал OK и не вывел ошибок — первая выгрузка ушла и витрина её приняла.
  2. Откройте вашу витрину (https://<ваш-id>.merkio.ru или ваш домен) — товары появятся через несколько минут после первого полного фида.
  3. В панели управления поле «Синхронизация» покажет свежее время, счётчик активных товаров начнёт расти.
Текущее состояние обмена видно в файле loop_ut103_result.txt в папке установки — строка OK i=0 202 [...] означает, что фид принят витриной (код 202). Подробнее — в разделе «Диагностика».

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

Заказы с витрины переносятся в 1С:Предприятие заданием MerkioOrders (раз в 5 минут). В УТ 10.3 создаётся документ «Заказ покупателя» (в УТ 11 — «Заказ клиента»): по образцу вашего документа, с ценой-снимком на момент оформления; реквизиты покупателя и доставки — в Комментарий; документ создаётся без проведения. Результат — в файле orders_ut103_result.txt в папке установки.

Уточнит поддержка
На какого контрагента оформлять веб-заказы (в УТ 10.3 нет Партнёров — используются Контрагенты) и документ-образец «Заказ покупателя» — согласуются при подключении и записываются в поле order_customer файла merkio.json (пусто — обработка использует фолбэк розничного покупателя, как в УТ 11).

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

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

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

Ход установки установщик записывает в файл install.log. Состояние обмена — в loop_ut103_result.txt (выгрузка) и orders_ut103_result.txt (заказы).

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

9 Поддержка

Подключение УТ 10.3 всегда проходит в связке с поддержкой Меркио — комплект вы скачиваете сами в панели управления, а мы согласуем параметры вашей базы (раздел 3) и помогаем с настройкой соединения и проверкой обмена. Приложите содержимое install.log, loop_ut103_result.txt / orders_ut103_result.txt при обращении.

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

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

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

Скопируйте файлы комплекта в рабочую папку (например E:\Merkio): обработки МеркиоВыгрузкаUT103.epf, МеркиоЗаказыUT103.epf, скрипты merkio_loop_ut103.ps1, merkio_watchdog_ut103.ps1, com_orders_ut103.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-коннектор

Если внешнее соединение не зарегистрировано, выполните от администратора (для платформы 8.3 — обычно 32-разрядный путь):

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

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

Имена и расписание — те же, что для УТ 11. Три задачи от системной учётной записи (командная строка от администратора; пути 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_ut103.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_ut103.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_ut103.ps1"

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

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

schtasks /Run /TN MerkioExport

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

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

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

Меркио · headless-витрина для 1С:Предприятие · Инструкция для УТ 10.3