Integrationen virker. Ordrer flyder ind, lager opdateres, pakker sendes. Og så en dag opdager I, at 47 ordrer ikke er behandlet siden i går morges, og ingen vidste det. Det er integrationsfejlenes natur: de sker oftest usynligt, opdages sent og koster dyrt.
Her er de mest typiske fejl, hvad der forarsager dem, og hvad du gør ved det.
Hvad er integrationsfejl?
En integrationsfejl opstår, når to systemer ikke kan kommunikere som forventet. Det kan skyldes tekniske problemer (server nede, netvaerksfejl, timeout), datamassige problemer (forkert format, manglende felt) eller logiske problemer (mapping-fejl, duplikater, timing-konflikter).
Integrationsfejl har fire grundlæggende former:
- Stille fejl (silent failure): Systemet fejler, men rapporterer det ikke. Den farligste type, fordi den er usynlig.
- Haard fejl (hard fail): Systemet fejler og stopper. Ubehageligt, men lettere at opdage.
- Delvis synkronisering: Kun dele af dataen overføres korrekt. Systemet tror alt er OK.
- Timing-fejl: Data ankom i forkert rækkefolgel. Resulterer i "orphaned" data.
Hvad koster integrationsfejl reelt?
👉 SmartPack monitorerer alle integrationsforbindelser aktivt. Se SmartPacks integrationer
| Scenarie | Total årlig |
|---|---|
| BC client secret udloeber (2 dage downtime) | 40.000 kr. per episode |
| Stille fejl (47 ordrer, opdages efter 24 timer) | 64.002 kr. per episode |
| Webhook-tab uden retry (5% af ordrer) | 3.182.200 kr./aar |
| Leveringsmetode-mapping fejl (10% af ordrer) | 2.281.250 kr./aar |
Gennemgang af de mest typiske fejl
1. Webhook leveres ikke/ignoreres
Hvad sker: Shopify sender webhook-event, men dit WMS er utilgængeligt i det oejeblik (deployment, server-restart, netvaerksfejl). Eventet forsvinder.
årsag: Manglende retry-håndtering, timeout under deployment, ingen koe som buffer.
Losning: Brug en message queue (Azure Service Bus, RabbitMQ) som buffer. WMS behandler fra koen, ikke direkte fra webhook.
2. BC client secret udloeber
Hvad sker: Business Central-integrationen holder op med at virke, pludseligt, uden varsel. Ordrer synkroniseres ikke.
årsag: Business Central bruger OAuth2 med client secret der har maksimal levetid på 2 år. Det er den hyppigste årsag til BC-integrationsnedbrud. De fleste virksomheder sætter det op og glemmer det.
Losning: Saet kalenderreminder 30 og 60 dage foer udloeb. Dokumenter, hvem der har adgang til Azure App Registration. Overvej at rotere secret proaktivt hvert 18. maaned.
3. Leveringsmetode-mapping fejler
Hvad sker: Kunden vælger "GLS Pakkeshop" i Shopify-checkout. I WMS mappes det til forkert fragtprodukt. Pakken sendes med forkert service.
årsag: Shopify bruger interne nogler til leveringsmetoder. Fejl i mapping giver forkert fragtvalg eller mislykket fulfillment.
Losning: Gennemgå og test alle leveringsmetode-mappings i staging-miljo inden go-live.
4. Delvis synkronisering af ordrelinjer
Hvad sker: En ordre med 5 varelinjer importeres, men kun 4 linjer med. Den femte linje mangler fordi varen ikke findes i WMS-produktkatalog.
Losning: Implementer validering ved ordreimport. Ordrer med ukendte varenumre skal holdes i fejlkoe, ikke stiltiende delvis importeres.
5. Timing-fejl ved lageroprettelse
Hvad sker: En ny vare tilfoejes i Shopify og bestilles straks. Webhook for ordren ankommer til WMS inden varestamdata er synkroniseret. WMS kender ikke varen og fejler.
Losning: WMS skal kunne håndtere "ukendt vare" gracefully, ved at placere ordren i manuelt review-koe og hente varestamdata on-demand.
6. e-conomic Grant Token er trukket tilbage
Hvad sker: e-conomic-integration holder op med at virke. Ordrer hentes ikke, fakturakladder oprettes ikke.
årsag: e-conomic bruger Grant Token-autentificering. Hvis brugeren der oprettede token, er slettet i e-conomic (fx en fratraadt medarbejder), invalideres tokenet.
Losning: Brug en servicebruger/systembruger i e-conomic til integration, ikke en personlig bruger.
Det opdager de fleste for sent
- At BC client secret udloeber præcis 2 år efter oprettelse: Microsoft sender INGEN advarsel. Første tegn: kunder ringer og spoerger hvorfor ordren ikke er afsendt.
- At webhook-tab er usynlige: Shopify sender webhook, men dit system er nede i 12 sekunder under deployment. Webhook forsvinder. Ingen alarm. Ordren behandles aldrig.
- At e-conomic Grant Token invalideres når brugeren slettes: Den medarbejder der oprettede integrationen er stoppet for 6 maaneder siden. Fakturaer oprettes ikke længere. Bogholderiet opdager det ved maanedsafslutning.
Sådan gør du det rigtigt
- Implementer integration health dashboard: Vis, hvornår hver integration sidst koerte succesfuldt, antal behandlede events og eventuelle fejl.
- Alert ved ingen aktivitet: Hvis en integration ikke har modtaget events i 30 minutter i arbejdstiden, send alert. Fraværet af data er i sig selv et signal.
- Test alle fejlscenarier eksplicit: Unit test og integrationstests skal inkludere fejlscenarier: webhook med ugyldig signatur, ordre med ukendt varenummer, API-timeout, delvis payload.
SmartPack
SmartPack monitorerer alle integrationsforbindelser aktivt og viser status i administrationspanelet. Ved integrationsfejl logges detaljer med payload og fejlkode. Ordrer der fejler ved import, placeres i manuelt review, de forsvinder aldrig stille. SmartPack advarer om kommende token-udloeb (60 dage foer BC client secret udloeber) og har built-in retry-logik på alle webhook- og API-kald.