Oppdag endrede felter i regnskapsintegrasjonen
Overvåk feltbetydning, datatyper og statusverdier slik at en teknisk gyldig respons ikke gir feil regnskapsbehandling.
Et API kan legge til et felt uten problemer, men en endring fra tall til tekst kan stoppe importen. Mer skjult er endret betydning: «beløp» kan gå fra fakturatotal til restbeløp. Schema drift er endring i dataformen eller tolkningen som klienten bygger på.
Syntetisk feltkontroll
En lokal integrasjon bruker tre oppdiktede felt. Navnene er illustrasjoner og ikke dokumenterte produktfelter.
| Felt i testkontrakten | Godkjent betydning | Endring som skal fanges |
|---|---|---|
| Restbeløp | Ubetalt verdi i avtalt valuta | Fakturatotal leveres i stedet |
| Dokumentdato | Dato angitt på dokumentet | Tidsstempel leveres uten avtale |
| Kundereferanse | Stabil nøkkel fra kilden | Visningsnavn erstatter nøkkelen |
En faktura på 9 000 kroner med betaling på 4 000 har restbeløp 5 000. Hvis integrasjonen fortsatt leser 9 000 som åpen fordring, er differansen 4 000 kroner. En ren datatypekontroll vil ikke finne feilen når begge verdier er gyldige tall.
Skill tillatte tillegg fra brudd
Avtal hvordan ukjente felter håndteres. Det kan være fornuftig å ignorere et nytt, ubrukt opplysningsfelt, samtidig som manglende nøkler stopper behandlingen. Ukjente statusverdier bør vanligvis synliggjøres fordi de kan endre arbeidsflyten. Å tolke enhver ukjent status som «betalt» er en farlig standardverdi.
JSON-standarden beskriver dataformatet, mens OpenAPI kan beskrive feltkrav. Ingen av dem avgjør alene hva et restbeløp betyr i den konkrete leveransen.
Bevar et lite sett med godkjente, syntetiske eksempler. Sammenlign hver leveranse med kontraktens regler for obligatoriske felt, null, tom tekst, presisjon og kodeverdier. Unngå å lagre nye komplette kundesvar bare for å oppdage feltendringer.
Operativ reaksjon
- Registrer hvilken kontraktregel som brøt sammen.
- Sett berørte poster i en synlig avklaringsstatus.
- Fortsett bare med uavhengige poster som fortsatt er gyldige.
- Undersøk om endringen var varslet eller skyldes feil.
- Oppdater både kontrakt og test etter en faglig godkjenning.
Velg full stans når nøkler eller beløpsbetydning er usikker. Velg avgrenset behandling når feilen bare gjelder et valgfritt felt som ikke brukes i mottakerens økonomiske beslutning.
Mål også omfanget: hvor mange poster og hvilke tidsvinduer som er berørt. En enkelt ugyldig post og en endret feltbetydning for hele måneden krever forskjellige beslutninger. Avviksrapporten bør gjøre dette skillet synlig før noen starter en ny import.
Hendelsesloggen bør vise første berørte levering og omfanget av endringen. Da kan dere etterkontrollere de riktige periodene i stedet for å eksportere hele arkivet. Se API-kontrakttest for planlagte endringer og driftslogg.