Quincefin ↔ OpenCart & Horoshop

Quincefin ↔ Shops Sync — це інтеграційне проміжне ПЗ (middleware) між QUINCEFIN (облік / склад) та онлайн-магазинами:

OpenCart 2.3
Horoshop

QUINCEFIN є основною системою для обліку залишків і цін. Middleware знаходиться між системами: він отримує події, зчитує повні дані про товари та замовлення і передає зміни в інтернет-магазини (а також отримує замовлення назад у QUINCEFIN).

Система потрібна тому, що:

Webhook-и QUINCEFIN передають лише id і timestamp — необхідно підтвердити їх отримання, повторно отримати актуальні дані та розподілити їх між магазинами.

API-ключі обмежені за IP-адресами; магазини мають обмеження на кількість запитів.

OpenCart 2.3 не має вбудованого API для роботи із залишками та цінами.
Один сервіс із фіксованою IP-адресою, чергою та зіставленням товарів/замовлень забезпечує узгодженість усіх даних.

Що робить система

QUINCEFIN → магазини

Залишки та роздрібні ціни синхронізуються з OpenCart (і, за бажанням, каталогом Horoshop). Webhook-и товарів об'єднуються, тому серія швидких змін перетворюється на один запит на оновлення. Щонічна повторна синхронізація (reconcile) виявляє дані, які могли бути пропущені через webhook-и.

Магазини → QUINCEFIN

Нові та оновлені замовлення кожні 5 хвилин завантажуються в QUINCEFIN як документи продажу (`OC-…` для OpenCart, `HS-…` для Horoshop), із даними клієнта в коментарі, застосованими до позицій знижками та фіксованою назвою роздрібного партнера.

Сторінки статусу оператора (`/status`, журнали замовлень, live probes) показують стан каналів, останні запуски та зіставлені замовлення без використання адміністративної панелі магазину.

Плагін OpenCart: Dimoks Sync

Dimoks Sync — це невелике розширення для OpenCart 2.3 (тип: Feed), встановлене безпосередньо в інтернет-магазині OpenCart.

Це повноцінний модуль, доступний в адміністративній панелі (Extensions → Feeds → Dimoks Sync), а не просто набір окремих файлів. Він надає JSON API, захищений токеном, до якого звертається middleware.

Налаштування адміністратора

Увімкнення / вимкнення інтеграції
Sync token (має відповідати `OPENCART_TOKEN` на middleware-сервісі)
Поле ключа товару: `model` або `sku` (артикул / article, який використовується для зіставлення з QUINCEFIN)
Підказка endpoint для URL ping-запиту

Що надає API модуля

Ping — перевірка доступності та версії
Products — читання та оновлення кількості, ціни й статусу за ключем артикула
Orders — отримання списку замовлень, змінених після певної часової позначки (для імпорту в QUINCEFIN)
Optional order status push back to OpenCart — за потреби передача статусу замовлення назад в OpenCart

Без цього модуля OpenCart 2.3 неможливо керувати залишками та цінами з QUINCEFIN.

Коротко в одному реченні

Middleware забезпечує синхронізацію залишків і цін QUINCEFIN з OpenCart (через плагін Dimoks Sync) та Horoshop, а також передає замовлення з інтернет-магазинів у QUINCEFIN як документи `OC-…` / `HS-…`.