Checklist per integrare un nuovo marketplace (pre go-live)

Integrare un nuovo marketplace non si esaurisce nel "collegare l'API". Prima del go-live ci sono molti punti che, se trascurati, generano errori di pubblicazione, overselling o problemi contabili. Questa checklist raccoglie i controlli essenziali.

1. Account e credenziali

• account venditore attivo e verificato;
• applicazione registrata e autorizzata (OAuth);
• refresh token conservato in sicurezza (es. Key Vault) e rinnovo testato;
• ambienti separati per test e produzione.

2. Policy e prerequisiti

• policy di pagamento, reso e spedizione configurate;
• tempi di gestione e condizioni commerciali definiti;
• requisiti normativi e fiscali del marketplace verificati.

3. Catalogo e mapping

• mapping delle categorie interne verso quelle del marketplace;
• attributi obbligatori coperti per le categorie usate;
• identificatori prodotto (GTIN/MPN) corretti e validati;
• immagini conformi ai requisiti del canale;
• varianti modellate correttamente.

4. Stock e prezzi

Controllo	Perché
Buffer di sicurezza	Prevenire l'overselling sui canali lenti
Listino per canale	Prezzi corretti per valuta e regole
Aggiornamenti incrementali	Propagazione rapida di stock e prezzi

5. Ordini e fulfillment

• import ordini idempotente (niente duplicati);
• mapping degli stati ordine verso ERP/magazzino;
• invio tracking testato, incluse spedizioni parziali;
• gestione di resi e rimborsi.

6. Finanze

• lettura di transazioni e payout;
• riconciliazione tra ordini, commissioni e accrediti;
• mapping verso conti/causali contabili.

7. Robustezza

• retry con backoff e gestione dei rate limit;
• code e dead-letter per i fallimenti;
• idempotenza su tutte le operazioni critiche.

8. Monitoraggio

• log strutturati con correlation ID;
• metriche di business (ordini, sync, disapprovazioni);
• alert azionabili (dead-letter, errori API, ordini mancanti);
• dashboard per la salute del flusso.

9. Test end-to-end

• pubblicazione di prodotti reali in sandbox o su un set ridotto;
• ciclo completo: pubblicazione → ordine → spedizione → payout;
• prova degli scenari di errore e dei retry.

Conclusione

Un go-live di successo non è fortuna: è il risultato di controlli sistematici su account, policy, catalogo, stock, ordini, finanze, robustezza e monitoraggio. Usare questa checklist prima di andare in produzione riduce drasticamente i problemi nelle prime settimane, quando costano di più.