Collegare il tuo negozio a un fornitore tramite API: stock, listini e immagini aggiornati

Importare una volta il catalogo di un fornitore è un lavoro di giorni. Tenerlo aggiornato è un lavoro che non finisce mai: cambiano i prezzi, si esaurisce lo stock, escono nuovi colori, si ritirano riferimenti. Se lo fai a mano, il tuo negozio è sempre in ritardo, e vendi ciò che non c'è più o a un prezzo che non è più quello.

Quando il fornitore offre un'API, il negozio può consultarla in modo continuo. Questo articolo tratta questa sincronizzazione permanente; se il tuo fornitore ti dà solo file CSV o XML, abbiamo un'altra guida dedicata a quel caso.

Cosa cambia con un'API rispetto a un file

• Dati in tempo reale: lo stock si consulta quando serve, non quando il fornitore genera il file.
• Richieste parziali: si può chiedere solo lo stock o solo i prezzi, senza scaricare l'intero catalogo.
• Dati ricchi: molti fornitori pubblicano nell'API cose che non stanno in un CSV: listini a fasce, tecniche di personalizzazione, immagini per colore, testi in più lingue.
• Più impegnativa: bisogna gestire autenticazione, limiti di richieste, errori di rete e cambi di versione dell'API.

Cosa sincronizzare e con quale frequenza

Ciò che non ha senso è scaricare tutto il catalogo ogni ora: carichi il server del fornitore, il tuo, e rischi di superare i suoi limiti.

Il prezzo di costo non è il prezzo di vendita

Il fornitore ti dà il suo listino; tu decidi il tuo prezzo. Il collegamento ha bisogno di regole chiare:

• Margine per categoria, marca o fascia di prezzo, non uno unico per tutto.
• Fasce per quantità: in settori come il tessile o l'articolo promozionale, il costo scende molto oltre un certo volume. Queste fasce devono diventare prezzi per quantità nel tuo negozio.
• Arrotondamenti che non lascino prezzi come 12,37 €.
• Prezzi da non toccare: se hai abbassato a mano un prodotto per una campagna, la sincronizzazione non dovrebbe sovrascriverlo senza avvisare.

Stock: il tuo e quello del fornitore

Se hai anche merce nel tuo magazzino, mescolare il tuo stock con quello del fornitore in un unico numero inganna il cliente: non è lo stesso «ce l'ho e parte oggi» e «lo ordino in fabbrica e ci mette una settimana». La cosa corretta è separarli e mostrare un tempo diverso a seconda di dove esce ogni unità. E decidere cosa fare quando si ordina più di quanto sommano i due: bloccare la vendita o chiedere di contattarti per un preventivo.

Combinazioni, lingue e immagini

• Colori e taglie devono diventare combinazioni di PrestaShop abbinate agli attributi che hai già, non nuovi attributi duplicati («Rosso», «rosso», «ROSSO»).
• Immagini per colore, associate alla loro combinazione.
• Testi in ogni lingua attiva del tuo negozio, se il fornitore li pubblica.
• Categorie: l'albero del fornitore non è il tuo. Bisogna abbinare le sue categorie alle tue.
• Caratteristiche (materiale, misure) come caratteristiche di PrestaShop, perché funzionino nei filtri.

Personalizzazione

Nell'articolo promozionale o nel tessile personalizzato, il prodotto non si vende da solo: si vende con una marcatura. Il fornitore pubblica tecniche, zone, numero di colori e costi (spesso con costi fissi di avviamento). Portare tutto questo nel negozio permette al cliente di scegliere la tecnica e vedere il prezzo finale calcolato, invece di chiedere un preventivo per tutto.

Errori frequenti

1. Sovrascrivere ciò che hai migliorato: testi SEO o foto proprie che la sincronizzazione sostituisce di nuovo con quelle del fornitore.
2. Non registrare ciò che cambia: senza cronologia, non sai perché un prezzo è salito.
3. Sincronizzare nelle ore di punta e rallentare il negozio.
4. Non avvisare quando l'API fallisce: la sincronizzazione si ferma e nessuno se ne accorge finché non si vende qualcosa di esaurito.
5. Credenziali nel codice: le chiavi dell'API vanno nella configurazione, mai in file che si copiano o si caricano su un repository.

Checklist

1. Hai chiaro quali dati fornisce l'API e con quali limiti.
2. Regole di prezzo per categoria e fasce per quantità.
3. Stock proprio e del fornitore separati, con tempi diversi.
4. I prodotti ritirati vengono disattivati, non cancellati.
5. Attributi e categorie abbinati ai tuoi.
6. Cronologia delle modifiche e avviso se la sincronizzazione fallisce.

Come risolverlo in PrestaShop

RKR Conector Makito è un esempio di questo tipo di collegamento: un pacchetto con un hub che confronta e scrive nel negozio, il connettore con l'API di Makito, un modulo facoltativo per i multipli di vendita e RKR Supplier Stock (facoltativo, PrestaShop 9). Porta le quattro fasce di listino del fornitore (per unità e da 500, 2.000 e 5.000 unità) trasformate in prezzo di vendita con le tue regole e in prezzi per quantità, i testi, i colori e le caratteristiche nelle sette lingue pubblicate da Makito, e permette al cliente di aggiungere al carrello il prodotto con la sua marcatura e il prezzo già calcolato. Con RKR Supplier Stock, il tuo stock e quello di Makito vengono salvati separatamente, per combinazione, con messaggi e tempi diversi per ogni caso, e per impostazione predefinita non si vende più di quanto sommano i due. Senza quel modulo, il connettore funziona su PrestaShop da 1.7.6 a 9.x. Per altri fornitori, i connettori su misura che accompagnano questo articolo seguono lo stesso approccio.