Quincefin ↔ OpenCart & Horoshop
Quincefin ↔ Shops Sync és un middleware d’integració entre QUINCEFIN (comptabilitat / inventari) i les botigues en línia:
- OpenCart 2.3
- Horoshop
QUINCEFIN és el sistema principal per gestionar l’estoc i els preus. El middleware se situa entre els sistemes: rep esdeveniments, obté les dades completes dels productes i les comandes i envia els canvis a les botigues en línia (i també recupera les comandes de les botigues cap a QUINCEFIN).
El sistema existeix perquè:
- Els webhooks de QUINCEFIN només envien un id i una marca de temps (timestamp): cal confirmar-ne la recepció, tornar a obtenir les dades reals i distribuir-les entre les botigues.
Les claus API estan restringides per adreça IP; les botigues tenen límits de sol·licituds.
- OpenCart 2.3 no disposa d’una API integrada per gestionar l’estoc o els preus.
- Un únic servei amb una IP fixa, una cua i un sistema de correspondència de productes/comandes manté totes les dades sincronitzades.
Què fa el sistema
QUINCEFIN → botigues
L’estoc i els preus de venda al detall se sincronitzen amb OpenCart (i, opcionalment, amb el catàleg de Horoshop). Els webhooks dels productes s’agrupen, de manera que una sèrie de canvis realitzats ràpidament es converteix en una única actualització. Una reconciliació nocturna detecta qualsevol dada que els webhooks hagin pogut ometre.
### Botigues → QUINCEFIN
Les comandes noves i actualitzades es descarreguen cada 5 minuts a QUINCEFIN com a documents de venda (`OC-…` per a OpenCart, `HS-…` per a Horoshop), amb les dades del client al comentari, els descomptes aplicats a les línies i un nom fix per al soci minorista.
Les pàgines d’estat de l’operador (`/status`, registres de comandes, live probes) mostren l’estat dels canals, les execucions recents i les comandes associades sense utilitzar el panell d’administració de la botiga.
Plugin d’OpenCart: Dimoks Sync
Dimoks Sync és una petita extensió per a OpenCart 2.3 (tipus: Feed) instal·lada a la botiga OpenCart.
És un mòdul complet i visible al panell d’administració (Extensions → Feeds → Dimoks Sync), no simplement un conjunt de fitxers independents. Proporciona una API JSON protegida mitjançant un token a la qual es connecta el middleware.
Configuració de l’administrador
- Activar / desactivar la integració
- Sync token (ha de coincidir amb `OPENCART_TOKEN` al servei middleware)
- Camp de clau del producte: `model` o `sku` (referència / article utilitzat per associar-lo amb QUINCEFIN)
- Indicació de l’endpoint per a l’URL de ping
Què proporciona l’API del mòdul
- Ping — comprovació de l’estat i de la versió
- Products — lectura i actualització de la quantitat, el preu i l’estat mitjançant la clau de referència
- Orders — obtenció de la llista de comandes modificades des d’una determinada marca de temps (per importar-les a QUINCEFIN)
- Optional order status push back to OpenCart — enviament opcional de l’estat de la comanda de tornada a OpenCart
Sense aquest mòdul, OpenCart 2.3 no es pot gestionar des de QUINCEFIN per actualitzar l’estoc i els preus.
En una sola frase
El middleware manté sincronitzats l’estoc i els preus de QUINCEFIN amb OpenCart (mitjançant el plugin Dimoks Sync) i Horoshop, i també importa les comandes de les botigues en línia a QUINCEFIN com a documents `OC-…` / `HS-…`.