Quincefin ↔ OpenCart & Horoshop
Quincefin ↔ Shops Sync è un middleware di integrazione tra QUINCEFIN (contabilità / gestione del magazzino) e i negozi online:
- OpenCart 2.3
- Horoshop
QUINCEFIN è il sistema principale per la gestione delle scorte e dei prezzi. Il middleware si trova tra i sistemi: riceve gli eventi, recupera i dati completi dei prodotti e degli ordini e trasferisce le modifiche ai negozi online (e recupera anche gli ordini dai negozi verso QUINCEFIN).
Il sistema è necessario perché:
- I webhook di QUINCEFIN inviano solo un id e un timestamp — è quindi necessario confermarne la ricezione, recuperare nuovamente i dati effettivi e distribuirli ai negozi.
Le chiavi API sono limitate a determinati indirizzi IP; i negozi hanno limiti sul numero di richieste.
- OpenCart 2.3 non dispone di un'API integrata per la gestione delle scorte o dei prezzi.
- Un unico servizio con un indirizzo IP fisso, una coda e un sistema di associazione di prodotti e ordini mantiene tutti i dati coerenti e sincronizzati.
Cosa fa il sistema
QUINCEFIN → negozi
Le scorte e i prezzi al dettaglio vengono sincronizzati con OpenCart (e, facoltativamente, con il catalogo Horoshop). I webhook dei prodotti vengono raggruppati, in modo che una serie di modifiche effettuate rapidamente venga trasformata in un unico aggiornamento. Una riconciliazione notturna rileva eventuali dati che i webhook potrebbero aver perso.
### Negozi → QUINCEFIN
Gli ordini nuovi e aggiornati vengono recuperati ogni 5 minuti in QUINCEFIN come documenti di vendita (`OC-…` per OpenCart, `HS-…` per Horoshop), con i dati del cliente inseriti nel commento, gli sconti applicati alle singole righe e un nome fisso per il partner al dettaglio.
Le pagine di stato dell'operatore (`/status`, registri degli ordini, live probes) mostrano lo stato dei canali, le esecuzioni recenti e gli ordini associati senza utilizzare il pannello di amministrazione del negozio.
Plugin OpenCart: Dimoks Sync
Dimoks Sync è una piccola estensione per OpenCart 2.3 (tipo: Feed) installata nel negozio OpenCart.
È un vero e proprio modulo visibile nel pannello di amministrazione (Extensions → Feeds → Dimoks Sync), non semplicemente un insieme di file indipendenti. Fornisce un'API JSON protetta da token utilizzata dal middleware.
Impostazioni dell'amministratore
- Abilitazione / disabilitazione dell'integrazione
- Sync token (deve corrispondere a `OPENCART_TOKEN` sul servizio middleware)
- Campo chiave del prodotto: `model` o `sku` (codice articolo / article utilizzato per associare il prodotto a QUINCEFIN)
- Indicazione dell'endpoint per l'URL di ping
Cosa fornisce l'API del modulo
- Ping — verifica dello stato e della versione
- Products — lettura e aggiornamento di quantità, prezzo e stato tramite il codice articolo
- Orders — recupero dell'elenco degli ordini modificati dopo un determinato timestamp (per l'importazione in QUINCEFIN)
- Optional order status push back to OpenCart — invio opzionale dello stato dell'ordine a OpenCart
Senza questo modulo, OpenCart 2.3 non può essere gestito da QUINCEFIN per aggiornare le scorte e i prezzi.
In una frase
Il middleware mantiene sincronizzati le scorte e i prezzi di QUINCEFIN con OpenCart (tramite il plugin Dimoks Sync) e Horoshop, e importa inoltre gli ordini dei negozi online in QUINCEFIN come documenti `OC-…` / `HS-…`.