Case study
Prim.io – app pubblica Shopify
Prim.io è una piattaforma ERP bulgara sviluppata e gestita da ANTIPODES OOD. Offre a rivenditori, grossisti e produttori un unico sistema per giacenze, magazzino, prezzi, documenti di vendita, logistica e registrazioni contabili.
Prim.io serve aziende che gestiscono giacenze reali in più magazzini e che hanno bisogno che i propri dati operativi - quantità, prezzi, spedizioni e documenti - restino accurati in un unico luogo autorevole. Man mano che un numero crescente dei loro clienti ha iniziato a vendere online, Prim.io aveva bisogno che il proprio ERP si collegasse in modo nativo alle piattaforme e-commerce, a partire da Shopify.
Il progetto
La sfida
I commercianti che gestivano l'attività in un ERP e la vetrina su Shopify mantenevano due sistemi scollegati. Gli ordini venivano reinseriti a mano nell'ERP, le giacenze divergevano fino a far vendere al negozio più merce di quanta ne avesse, le variazioni di prezzo andavano applicate due volte e i dati di spedizione stavano in un terzo posto ancora diverso. Ognuno di questi passaggi era manuale, lento e soggetto a errori.
Prim.io aveva bisogno di un'applicazione Shopify pubblica che facesse funzionare l'ERP e la vetrina come un unico sistema - abbastanza affidabile da girare senza presidio per molti commercianti contemporaneamente e abbastanza semplice da essere configurata dal titolare di un negozio senza uno sviluppatore.
La soluzione
Commissionata da Gloross e realizzata in collaborazione con loro, Prim.io ERP Integration è un'app Shopify pubblica integrata che mantiene il negozio Shopify di un commerciante e il suo account ERP Prim.io costantemente sincronizzati - in entrambe le direzioni.
L'app è completamente self-service: un percorso di onboarding guidato accompagna il commerciante nel collegamento dell'ERP, nella scelta delle impostazioni operative predefinite e nella mappatura tra i due sistemi di magazzini, listini, metodi di pagamento e corrieri. Da quel momento in poi, tutto funziona in background.
Funzionalità principali
- Sincronizzazione degli ordini in tempo reale - un ordine Shopify diventa una vendita nell'ERP in pochi secondi, con cliente, articoli, tipo di pagamento e metodo di consegna tradotti nei codici ERP del commerciante.
- Sincronizzazione delle giacenze - i livelli di stock si aggiornano ogni minuto, con invio istantaneo opzionale dall'ERP; più magazzini ERP vengono consolidati nelle sedi Shopify corrette.
- Sincronizzazione di prezzi e prodotti - listini, titoli, descrizioni, pesi, immagini e stato del prodotto passano dall'ERP a Shopify, con un controllo campo per campo su ciò che è di competenza dell'ERP.
- Logistica e corrieri - i metodi di spedizione Shopify vengono mappati sui codici di consegna dell'ERP, compresi la logistica di terze parti e gli uffici di ritiro dei corrieri, così il vettore e l'ufficio selezionato viaggiano insieme all'ordine.
- Tracciamento delle spedizioni - quando nell'ERP viene emessa una lettera di vettura, l'app crea l'evasione in Shopify con il numero di tracciamento e il cliente viene avvisato automaticamente.
- Aree di lavoro multi-negozio - i gruppi di commercianti possono collegare fino a dieci negozi sotto un'unica organizzazione.
- Piena visibilità operativa - log delle attività in linguaggio chiaro, una dashboard dell'attività di sincronizzazione e payload delle richieste ispezionabili per un supporto rapido.
Aspetti tecnici salienti
L'affidabilità era il requisito centrale: un'app pubblica elabora gli ordini reali di altre aziende e un ordine perso è una vendita persa. Gli eventi in ingresso vengono scritti su una coda persistente ed elaborati con ritentativi automatici e backoff esponenziale, così nulla va perso durante un guasto di rete o un rilascio. Le operazioni sull'intero catalogo usano l'API bulk operations di Shopify per spostare migliaia di prodotti in modo efficiente, mentre le sincronizzazioni incrementali inviano solo ciò che è effettivamente cambiato.
L'app si autentica con i session token di Shopify, conserva le credenziali lato server, verifica ogni webhook in entrata e implementa i webhook obbligatori sulla privacy di Shopify - compresa la cancellazione completa dei dati di un negozio alla disinstallazione. La fatturazione passa da Shopify con più livelli di abbonamento e l'intera interfaccia è localizzata in inglese, bulgaro e rumeno.
Risultato
I commercianti Prim.io possono ora vendere su Shopify senza mantenere a mano un secondo sistema. Gli ordini arrivano al magazzino automaticamente, le giacenze restano accurate su entrambi i lati e il tracciamento della spedizione raggiunge il cliente senza che nessuno copi un numero da uno schermo all'altro.
Tecnologie
.NET 8
C#
PostgreSQL
React
Node.js
Shopify GraphQL API
REST API
Webhooks
Nginx
Linux