Kontroller at paginering henter hele regnskapsuttrekket

Et svar med 100 poster kan være en side i en større leveranse. Hvis integrasjonen behandler svaret som et komplett uttrekk, kan rapporten bli teknisk lesbar og økonomisk ufullstendig. Paginering må kontrolleres som en del av leveransen, ikke bare som en løkke i klientprogrammet.

Syntetisk uttrekk på 235 poster

Anta en avtalt sidestørrelse på 100 og et uforanderlig testsett. Beløpene nedenfor er kontrollsummer for hver side, uten valutablanding.

Første side alene mangler 135 poster og 137 000 kroner. To sider mangler fortsatt 35 poster. At siste svar er kortere, kan være et avslutningssignal i enkelte API-er, men andre bruker en eksplisitt lenke, markør eller indikator.

Følg leverandørens avslutningsregel

Stripes pagineringsdokumentasjon viser markørbasert uthenting. Det konkrete regnskapsgrensesnittet må undersøkes separat: sidetall, offset og markør er forskjellige kontrakter. Bruk aldri et oppdiktet parameter eller et kjent navn fra en annen leverandør uten å kontrollere dokumentasjonen.

Lagre markøren fra det faktisk mottatte svaret. En lokalt beregnet «neste ID» kan hoppe over objekter når nummerrekken har hull. Ved offset må dere undersøke om nye eller slettede poster forskyver de senere sidene mens uttrekket pågår.

Avtal derfor et stabilt skjæringstidspunkt eller en dokumentert øyeblikksvisning dersom dette er tilgjengelig. Uten slik støtte må dere håndtere gjentatte postnøkler og gjennomføre en etterkontroll for endringer rundt sidegrensene. En stabil sortering med entydig sekundærnøkkel er særlig viktig når flere poster har samme dato.

Godkjenning av hele leveransen

• Sammenlign antall unike nøkler med rått antall mottatte poster.
• Kontroller kontrollsummer innen samme selskap, periode og valuta.
• Prøv tom siste side og side med maksimal størrelse.
• Avbryt testen midtveis og kontroller at gjenopptakelse beholder filteret.
• Registrer manglende, gjentatte og endrede poster som separate avvik.

Uttrekket er klart når avslutningsregelen er nådd og kontrollene passerer. Det er ikke nok at alle HTTP-svar har status 200. Ved vurdering av ReAI bør omfang og uthentingsmåte avklares for den aktuelle ressursen; denne veiledningen lover ingen bestemt pagineringsmekanisme.

Bevar sidestørrelse og sorteringsregel i kjøringssporet. Dersom leverandøren endrer maksimal sidestørrelse, må klienten fortsatt følge avslutningssignalet. Antakelsen om at en kort side alltid er siste side bør aldri overstyre en dokumentert neste-markør.

Etter full uthenting følger avstemming mot regnskapet.