Tec.Delivery коннектор

Автоматическая синхронизация остатков, цен и каталога из REGOS в Tec.Delivery. Платная интеграция, подключается в кабинете REGOS за несколько минут.

Что нужно перед началом

Шаг 1. Получите токен Tec.Delivery

В админ-панели Tec.Delivery:

  1. Откройте раздел Merchant.
  2. Выберите нужного мерчанта.
  3. Перейдите в Settings.
  4. Скопируйте значение поля Token.

Там же токен можно перевыпустить. После перевыпуска старый токен перестаёт работать — не забудьте вставить новый в настройки интеграции, иначе синхронизация остановится с ошибкой авторизации.

Шаг 2. Подключите интеграцию в REGOS

  1. Найдите «Tec.Delivery коннектор» в каталоге интеграций REGOS и нажмите «Подключить».
  2. Заполните настройки:
    НастройкаЧто указать
    Токен Tec.Delivery Токен из шага 1. Обязательно.
    Склад Один склад, остатки которого выгружаются. Обязательно.
    Вид цены Один вид цены, который выгружается. Обязательно.
    Исключить группы товаров Необязательно. Группы, которые не должны попадать в Tec.Delivery. Подробнее — ниже.
  3. Сохраните. Синхронизация начнётся со следующего изменения в REGOS.
Пока токен, склад и вид цены не заполнены все три, коннектор принимает события, но ничего не отправляет. На вкладке «Статистика» это показано отдельным предупреждением — если оно есть, проверьте настройки.

Шаг 3. Проверьте, что всё работает

  1. Измените цену или остаток любого товара на выбранном складе.
  2. Откройте вкладку «Статистика» — счётчик обработанных событий увеличится.
  3. Проверьте товар в Tec.Delivery: цена и остаток должны совпасть с REGOS.

Обычная задержка — несколько секунд. Если товаров в каталоге много и изменений сразу тоже много, очередь разбирается последовательно и задержка вырастает.

Как это работает

REGOS присылает коннектору событие при каждом изменении товара, группы товаров, цены или количества — включая проведение и отмену проведения документов (приход, продажа, возврат, перемещение, переоценка, закрытый чек).

Получив событие, коннектор не применяет разницу, а заново запрашивает у REGOS текущее состояние затронутых товаров на выбранном складе и виде цены и отправляет в Tec.Delivery абсолютные значения. Поэтому отмена проведения, возврат или сторно чека обрабатываются так же надёжно, как обычная продажа: пересчёт всегда идёт от актуальных данных REGOS.

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

Что именно попадает в Tec.Delivery

REGOSTec.Delivery
Товарexternal_id = item + код товара REGOS
Группа товаровКатегория: is_category: true, external_id = код группы
Родительская группаexternal_parent_id (для товаров и для категорий)
Наименование, описаниеname, description
Цена выбранного вида ценыprice
Остаток на выбранном складеstore_balance

Отрицательный остаток (пересорт или ещё не проведённая корректировка) отправляется как 0 — отрицательное количество в витрине смысла не имеет. Цена передаётся как есть и не корректируется: молча переписывать сумму хуже, чем показать её и дать заметить ошибку в учёте.

Категория всегда создаётся раньше товара, который в неё входит, поэтому дерево каталога в Tec.Delivery повторяет структуру групп REGOS. Товары и группы верхнего уровня передаются без родителя.

Исключение групп товаров

Настройка «Исключить группы товаров» убирает из выгрузки всю ветку: выбранную группу, все её подгруппы на любую глубину и все товары внутри них.

Полная синхронизация каталога

Обычно ничего запускать вручную не нужно: коннектор реагирует на события. Полная синхронизация нужна в трёх случаях — сразу после подключения, после смены склада или вида цены, и после изменения списка исключённых групп.

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

Оплата

Подписка оплачивается через Payme на вкладке «Тариф» — помесячно или на год со скидкой. После окончания оплаченного периода действует льготный период, затем синхронизация останавливается. Интерфейс при этом остаётся доступным, чтобы можно было оплатить и продолжить.

События, пришедшие во время остановки, не накапливаются и не досылаются задним числом. Восстановление происходит само: следующее изменение любого товара отправляет его актуальное состояние. Чтобы обновить весь каталог сразу, запустите полную синхронизацию.

Если что-то не синхронизируется

  1. Проверьте настройки. Токен, склад и вид цены должны быть заполнены все три.
  2. Проверьте склад и вид цены. Товар без остатка на выбранном складе или без цены выбранного вида выгружается с нулевыми значениями — это не ошибка, а другой склад или другой прайс.
  3. Проверьте исключённые группы. Товар мог попасть в исключённую ветку через родительскую группу.
  4. Проверьте оплату. На вкладке «Тариф» видно, активна ли подписка.
  5. Проверьте токен. После перевыпуска токена в Tec.Delivery его нужно заново вставить в настройки интеграции.
  6. Посмотрите «Статистику». Там показаны очередь, обработанные события за 24 часа, ошибки и время последней синхронизации.