Skill leseintegrasjoner fra integrasjoner som bokfører
Gi lesejobber og skrivejobber egne akseptansekrav slik at et rapportbehov ikke får utilsiktet bokføringsvirkning.
En integrasjon som leser hovedbok, har en annen økonomisk virkning enn en integrasjon som oppretter bilag. Å omtale begge som «API-kobling» skjuler forskjellen. Beskriv hvilken tilstand integrasjonen får endre, ikke bare hvilke data den bruker.
Syntetisk oppgavefordeling
En lokal test har tre oppgaver som arbeider med samme fakturagrunnlag på 12 000 kroner.
| Oppgave | Handling | Økonomisk virkning |
|---|---|---|
| Rapport | Leser eksisterende faktura | Ingen ny registrering |
| Utkast | Lager forslag fra grunnlaget | Må avklares før endelig dokument |
| Registrering | Oppretter ferdig dokument | Ny dokumentert økonomisk hendelse |
Et utkast og en utstedt faktura kan ikke telles som samme sluttstatus. Dersom kontrollen bare teller «opprettede objekter», kan den melde en leveranse ferdig mens fakturaen fortsatt venter på godkjenning.
Fastsett grenser for hver jobb
En lesejobb bør ha eget tilgangsmateriale hvis leverandørens modell tillater det. En skrivejobb trenger dessuten regler for identitet, gjentakelse, validering og håndtering av ukjent resultat. Periodestenging eller sletting bør ikke inkluderes bare fordi integrasjonen allerede har skriveadgang.
HTTP-spesifikasjonen skiller mellom sikre og idempotente metoder. Dette er protokollbegreper. Den konkrete økonomiske virkningen må fortsatt forklares av leverandørens operasjonsbeskrivelse og prøves med avtalt grunnlag.
Beskriv også indirekte effekter. Opprettelse av et objekt kan starte utsending, betaling eller en senere automatisk jobb. Et kontrollert dokumentutkast må undersøkes som utkast; navnet «opprett» beviser verken at det blir bokført eller at det er uten videre virkning.
Akseptanse med negative prøver
- Bekreft at rapporttilgangen kan hente det nødvendige grunnlaget.
- Prøv at samme tilgang ikke kan opprette dokumenter.
- Kontroller at skrivejobben stopper på ukjente selskaper og ugyldige referanser.
- Prøv gjentatt sending og avbrutt respons.
- Avstem kildens godkjente hendelser mot mottakerens sluttstatus.
Velg en leseintegrasjon når oppgaven bare er analyse eller kontroll. Velg en skriveintegrasjon når arbeidsflyten faktisk krever endring og ansvar for godkjenning er fordelt. Unngå å gi rapportverktøy større tilgang for å spare én avklaring.
Ved vurdering av ReAI bør et behov for å hente data skilles tydelig fra et behov for å lage dokumenter. Be om dokumentasjon på den konkrete operasjonens resultat og nødvendige rettigheter.
En nedlastet fil kan også brukes som grunnlag for en senere skrivejobb. Dokumenter derfor videre behandling etter leseuttrekket. Lesetilgangens begrensning løser ikke risikoen ved en annen prosess som senere registrerer samme grunnlag uten ny kontroll.
Se idempotens og tilgangsbegrensning før en automatisert skrivejobb godkjennes.