Quincefin ↔ OpenCart & Horoshop

Quincefin ↔ Shops Sync est un middleware d’intégration entre QUINCEFIN (comptabilité / gestion des stocks) et les boutiques en ligne :

• OpenCart 2.3
• Horoshop

QUINCEFIN est le système principal pour la gestion des stocks et des prix. Le middleware se situe entre les systèmes : il reçoit les événements, récupère les données complètes des produits et des commandes, puis transmet les modifications aux boutiques en ligne (et récupère également les commandes des boutiques vers QUINCEFIN).

Le système existe parce que :

• Les webhooks de QUINCEFIN envoient uniquement un id et un horodatage (timestamp) — il est donc nécessaire d’accuser réception, de récupérer à nouveau les données réelles et de les distribuer aux différentes boutiques.

Les clés API sont limitées par adresse IP ; les boutiques disposent de limites de requêtes.

• OpenCart 2.3 ne dispose pas d’une API intégrée pour gérer les stocks ou les prix.
• Un seul service avec une adresse IP fixe, une file d’attente et un système de correspondance des produits et des commandes permet de maintenir toutes les données synchronisées.

Fonctionnement du système

QUINCEFIN → boutiques

Les stocks et les prix de vente au détail sont synchronisés avec OpenCart (et, éventuellement, avec le catalogue Horoshop). Les webhooks des produits sont regroupés afin qu’une série de modifications effectuées rapidement soit transformée en une seule mise à jour. Une réconciliation nocturne détecte les éventuelles données que les webhooks auraient pu manquer.

### Boutiques → QUINCEFIN

Les nouvelles commandes et les commandes mises à jour sont récupérées toutes les 5 minutes dans QUINCEFIN sous forme de documents de vente (`OC-…` pour OpenCart, `HS-…` pour Horoshop), avec les informations du client dans le commentaire, les remises appliquées aux lignes et un nom fixe pour le partenaire de vente au détail.

Les pages de statut opérateur (`/status`, journaux des commandes, live probes) affichent l’état des canaux, les exécutions récentes et les commandes associées sans utiliser l’interface d’administration de la boutique.

Plugin OpenCart : Dimoks Sync

Dimoks Sync est une petite extension pour OpenCart 2.3 (type : Feed) installée sur la boutique OpenCart.

Il s’agit d’un véritable module visible dans le panneau d’administration (Extensions → Feeds → Dimoks Sync), et non simplement d’un ensemble de fichiers indépendants. Il fournit une API JSON protégée par un token, utilisée par le middleware.

Paramètres d’administration

• Activer / désactiver l’intégration
• Sync token (doit correspondre à `OPENCART_TOKEN` sur le service middleware)
• Champ clé du produit : `model` ou `sku` (référence / article utilisé pour faire correspondre le produit avec QUINCEFIN)
• Indication de l’endpoint pour l’URL de ping

Ce que fournit l’API du module

• Ping — vérification de l’état et de la version
• Products — lecture et mise à jour de la quantité, du prix et du statut à partir de la référence produit
• Orders — récupération de la liste des commandes modifiées depuis un horodatage donné (pour leur importation dans QUINCEFIN)
• Optional order status push back to OpenCart — envoi facultatif du statut de la commande vers OpenCart

Sans ce module, OpenCart 2.3 ne peut pas être piloté depuis QUINCEFIN pour mettre à jour les stocks et les prix.

En une phrase

Le middleware maintient synchronisés les stocks et les prix de QUINCEFIN avec OpenCart (via le plugin Dimoks Sync) et Horoshop, et importe également les commandes des boutiques en ligne dans QUINCEFIN sous forme de documents `OC-…` / `HS-…`.