Descrivi l'evento di business prima di scegliere un'API
Un checkout B2B può coinvolgere prezzi concordati, ordini d'acquisto, limiti di approvazione e termini di pagamento. Inizia con un singolo workflow e nomina i sistemi coinvolti. Per esempio: un acquirente approvato effettua un ordine, il sistema finanziario lo registra e il magazzino restituisce lo stato di evasione al portale clienti.
Questo articolo descrive un esempio di pianificazione, non un progetto cliente completato. La stessa preparazione si applica alle integrazioni CRM, di pagamento e di prenotazione: identifica l'evento, i dati autorevoli e cosa significa un passaggio di consegne riuscito.
Prepara un brief di integrazione
- Sistemi e accessi: nomina la piattaforma, il piano dell'account, la versione dell'API, la documentazione e il sandbox. Conferma che gli endpoint e i permessi previsti siano disponibili.
- Proprietà dei dati: decidi quale sistema possiede l'identità del cliente, il prezzo, le scorte, lo stato dell'ordine e lo stato del pagamento. Fornisci record rappresentativi con i dati personali rimossi.
- Mappatura: definisci gli identificatori condivisi, i campi obbligatori, la valuta, la gestione delle imposte e i fusi orari. Registra cosa dovrebbe accadere con un prodotto o cliente non abbinato.
- Eccezioni: includi cancellazione, evasione parziale, pagamento fallito, un prezzo modificato e un sistema a valle non disponibile.
- Operazioni: decidi chi esamina i fallimenti, può rieseguire un trasferimento e approva una correzione.
Presupponi che le notifiche possano ripetersi o arrivare in ritardo
L'elaborazione dei webhook necessita di una chiara policy di retry e di gestione dei duplicati. Come esempio concreto di una piattaforma, Stripe documenta la verifica della firma, gli eventi duplicati e la gestione asincrona nella sua guida ai webhook. Una notifica di pagamento dovrebbe essere autenticata ed elaborata secondo il contratto del provider. Altre piattaforme hanno le proprie regole di consegna e retry; verificale singolarmente.
Esempio di accettazione: invia un ordine in sandbox, consegna il suo evento due volte, poi disabilita temporaneamente il sistema ricevente. Verifica che l'ordine venga creato una sola volta, che il trasferimento fallito sia visibile e che la riesecuzione possa recuperarlo. Verifica inoltre che un cliente non possa visualizzare i prezzi o gli ordini di un'altra azienda.
Concorda cosa include la prima release
Uno scope iniziale realistico potrebbe supportare un tipo di ordine, un magazzino e un insieme definito di stati. Separa la migrazione dei dati storici, l'onboarding dei fornitori e le regole di prezzo insolite se necessitano di ulteriori approfondimenti. Concorda cosa è manuale inizialmente e come il team misurerà se l'integrazione riduce il lavoro.
Il passaggio di consegne dovrebbe includere le mappature dei campi, le istruzioni di configurazione, il monitoraggio, una procedura di riesecuzione e la proprietà nominata degli aggiornamenti della piattaforma. I termini di manutenzione dipendono dai sistemi e dall'ingaggio concordato. Esplora sviluppo e integrazione di API, automazione del flusso di lavoro e sviluppo ecommerce.
