Beskriv affärshändelsen innan du väljer ett API
En B2B-kassa kan omfatta överenskomna priser, inköpsorder, attestgränser och betalningsvillkor. Börja med ett arbetsflöde och namnge de inblandade systemen. Till exempel: en godkänd köpare lägger en order, ekonomisystemet registrerar den, och lagret returnerar leveransstatus till kundportalen.
Den här artikeln beskriver ett planeringsexempel, inte ett slutfört kundprojekt. Samma förberedelse gäller för integrationer av CRM, betalning och bokning: identifiera händelsen, den auktoritativa datan och vad en lyckad överlämning innebär.
Förbered en integrationsbrief
- System och åtkomst: namnge plattformen, kontoplanen, API-versionen, dokumentationen och sandlådan. Bekräfta att de avsedda ändpunkterna och behörigheterna är tillgängliga.
- Dataägarskap: bestäm vilket system som äger kundidentitet, pris, lager, orderstatus och betalningstillstånd. Tillhandahåll representativa poster med personuppgifter borttagna.
- Mappning: definiera delade identifierare, obligatoriska fält, valuta, momshantering och tidszoner. Dokumentera vad en omatchad produkt eller kund ska leda till.
- Undantag: inkludera annullering, delleverans, misslyckad betalning, ett ändrat pris och ett otillgängligt nedströmssystem.
- Drift: bestäm vem som granskar fel, kan spela upp en överföring på nytt och godkänner en korrigering.
Utgå från att aviseringar kan upprepas eller anlända sent
Webhook-bearbetning behöver en tydlig policy för omförsök och dubbletthantering. Som ett konkret plattformsexempel dokumenterar Stripe signaturverifiering, dubbletthändelser och asynkron hantering i sin webhook-guide. En betalningsavisering ska autentiseras och bearbetas enligt leverantörens avtal. Andra plattformar har sina egna regler för leverans och omförsök; verifiera dem individuellt.
Acceptansexempel: skicka in en sandlådeorder, leverera dess händelse två gånger, och inaktivera sedan tillfälligt det mottagande systemet. Verifiera att ordern skapas en gång, att den misslyckade överföringen är synlig och att uppspelning kan återställa den. Kontrollera även att en kund inte kan se ett annat företags prissättning eller order.
Enas om vad den första releasen innehåller
Ett realistiskt första omfång kan stödja en ordertyp, ett lager och en definierad uppsättning tillstånd. Separera historisk datamigrering, leverantörsintroduktion och ovanliga prissättningsregler om de behöver ytterligare utredning. Enas om vad som inledningsvis är manuellt och hur teamet ska mäta om integrationen minskar arbetet.
Överlämningen bör inkludera fältmappningar, installationsanvisningar, övervakning, en uppspelningsrutin och namngivet ägarskap för plattformsuppgraderingar. Underhållsvillkoren beror på systemen och det överenskomna uppdraget. Utforska API-utveckling och integration, arbetsflödesautomatisering och e-handelsutveckling.
