Følg asynkrone eksportjobber helt frem til ferdig fil
En akseptert eksportbestilling er ikke en ferdig leveranse. Jobbstatus og filinnhold må kontrolleres som egne steg.
Et API kan akseptere en eksportbestilling og lage filen senere. Klienten får da et foreløpig resultat mens behandlingen fortsetter. Bestillingen er ikke ferdig bare fordi første forespørsel blir akseptert. Integrasjonen trenger en dokumentert måte å følge jobben frem til leveranse eller avklart feil.
Syntetisk eksport med tre kontrollnivåer
En oppdiktet jobb J7 skal levere 120 dokumenter fra én avtalt periode. Statusnavnene er lokale illustrasjoner, ikke virkelige API-felter eller lovede funksjoner.
| Kontrollnivå | Observasjon i testen | Hva som fortsatt mangler |
|---|---|---|
| Bestilling | J7 er akseptert | Ingen fil er levert |
| Behandling | Jobben viser ferdig | Filen må hentes og undersøkes |
| Leveranse | Filen har 118 dokumenter | To forventede dokumenter er uavklart |
Selv med ferdig jobbstatus er leveranseavviket 120 − 118 = 2 dokumenter. En statuskontroll og en fullstendighetskontroll svarer på forskjellige spørsmål. Begge må inngå hvis oppgaven krever alle 120.
Følg den dokumenterte jobbmodellen
HTTP-status 202 beskriver akseptert behandling som ikke er fullført. Statusen alene garanterer ikke et vellykket sluttresultat. Leverandøren må beskrive eventuell jobbidentitet, statusressurs, varsling og hvordan filen blir tilgjengelig.
Bevar selskap, periodefilter og bestillingsreferanse før oppfølgingen starter. Ved et nettverksbrudd under bestilling kan jobben allerede være opprettet. Avklar gjenfinning eller dokumentert gjentakelsesregel før dere bestiller en ny eksport. To jobber med samme avgrensning er ikke nødvendigvis to forskjellige økonomiske leveranser.
Dersom statusen følges med oppslag, bruk leverandørens venteregler og en kontrollert frist. En foreløpig status skal ikke utløse et tett, ubegrenset oppslag. Ved fristbrudd bør jobben få synlig uavklart status med ansvarlig oppfølging.
Prøv også etter at jobben er ferdig
- Stans klienten og gjenoppta oppfølging av samme jobb.
- Prøv en jobb som avsluttes med dokumentert feil.
- Prøv at filtilgangen utløper før nedlasting.
- Kontroller nedlasting med feil selskaps- eller tilgangskontekst.
- Sammenlign dokumentantall og avtalte kontrollverdier i den hentede filen.
Godkjenn leveransen først når filen er mottatt, kan åpnes og dekker det avtalte omfanget. Hvis ny nedlasting lager en ny filutgave, må innhold og filidentitet avklares før den erstatter tidligere kontrollgrunnlag.
Ved samarbeid med Aiak kan eksportfrist og ansvar for manglende dokumenter inngå i leveranseavtalen. Den tekniske jobbmekanismen må bekreftes hos API-leverandøren; veiledningen påstår ingen generell asynkron eksportfunksjon i ReAI.