Amazon SP-API integration til Business Central: Hvad sker der teknisk bag integrationen?
En Amazon-integration bliver ofte beskrevet meget enkelt:
“Vi forbinder Amazon med Business Central.”
Teknisk sker der væsentligt mere.
Amazon stiller sin Selling Partner API — SP-API — til rådighed som en REST-baseret API-platform til integration med Amazon selling partner-data. Amazon Developer Docs
Microsoft Dynamics 365 Business Central tilbyder samtidig standard REST API’er og mulighed for at udvikle egne API’er gennem AL. Microsoft Learn
Det er fundamentet.
Men en driftssikker integration kræver også arkitektur omkring det.
Orders API
Amazons Orders API bruges til at hente ordreinformation og kan danne grundlag for ordresynkronisering. Amazon Developer Docs
Integrationen skal derefter:
- hente relevante ordrer
- sikre, at samme ordre ikke behandles dobbelt
- mappe data
- validere SKU’er
- anvende Business Central-regler
- oprette de relevante ERP-data
Det er derfor integrationslaget, der omsætter Amazon-data til forretningslogik.
Listings Items API
Listings Items API giver adgang til at arbejde programmatisk med seller listings og oplysninger såsom salgsbetingelser, pris og inventory. Amazon Developer Docs
Det kan være relevant, hvis integrationen også skal arbejde med produkt- eller lagerdata.
Reports API
Reports API kan hente og administrere forskellige rapporttyper og bruges blandt andet til lager, ordrer, tax-data og returns. Amazon Developer Docs
Rapporter er især interessante, når virksomheden har brug for datamængder eller processer, der ikke kun handler om enkelte events.
Finances API
Finances API giver adgang til finansielle events for Amazonsælgerens forretning. Amazon Developer Docs
Det er relevant i forbindelse med:
- afstemning
- fees
- refunds
- økonomirapportering
Læs mere i [Afstemning af Amazon-salg i Business Central](/amazon-afstemning-business-central/).
Business Central på den anden side
Business Central har et sæt standard-API’er.
Hvis de relevante data ikke er eksponeret på den måde, integrationen kræver, kan der udvikles custom API pages i AL. Microsoft dokumenterer, at API page-typen er beregnet til versionerede REST web services og understøtter webhooks. Microsoft Learn
Det betyder, at integrationsprojektet nogle gange også indebærer arbejde i Business Central.
API-forbindelsen er kun én komponent
Et produktionsklart setup har typisk også behov for:
Queueing
Så midlertidige problemer ikke nødvendigvis stopper hele processen.
Retries
Så relevante fejl kan forsøges igen.
Logging
Så man kan se, hvad der faktisk skete.
Mapping
Så Amazon og Business Central forstår hinandens identifikatorer.
Validering
Så forkerte data ikke blindt bliver sendt videre.
Monitorering
Så fejl bliver opdaget.
Idempotency og dubletter
Hvis en proces fejler efter, at Business Central faktisk har oprettet ordren, må et retry ikke skabe en ordre nummer to.
Derfor er håndtering af unikke nøgler og processtatus en vigtig del af integrationsdesignet.
API-kald er én ting.
Pålidelig databehandling er noget andet.
API-versioner ændrer sig
Amazon vedligeholder både release notes og en deprecation schedule for SP-API. Amazon Developer Docs
Det er en vigtig pointe for virksomheder:
Integrationer er ikke engangsinstallationer.
De er software, der skal vedligeholdes.
Det vigtigste at tage med
En Amazon SP-API integration til Business Central er ikke kun:
API A kalder API B.
Den består af både:
Amazon API
Business Central API
mapping
forretningsregler
fejlhåndtering
monitorering
sikkerhed
vedligeholdelse
Det er kombinationen, der afgør, om integrationen fungerer stabilt efter go-live.
Har I en teknisk Amazon-integration, der skal passe til jeres Business Central-arkitektur?