Feilmeldinger i FtB økosystemet
Noen leverandørløsninger opplever inn i mellom å få uventede feilmeldinger fra Fellestjenester BYGG. Som oftest skjer det i forbindelse med innsending gjennom Altinn og i tilknytning til pålogging via IDPorten.
På denne siden skal vi forsøke å holde en oversikt over oftest forekommende feilmeldinger, hva de betyr og hvordan de kan håndteres i leverandørløsningene; enten med skjerming av sluttbruker eller med veiledning til denne.
Vi kan ikke ha en komplett, oppdatert oversikt. Derfor vil vi også lenke videre til de relevante kildene slik at leverandørene selv kan undersøke sine konkrete tilfeller.
Fortrinnsvis baserer alle API-kall i FtB seg på REST og da vil feilmeldingene typisk være knyttet HTTP-request/-response.
Feilmeldinger fra Fellestjenester BYGG
Dette er typiske feilkoder fra fellestjenester bygg API. Dette er også mer detaljert beskrevet for hver enkelt tjeneste med Open API spesifikasjon https://admbygg.ft.dibk.no/swagger.
Statuskode | Beskrivelse |
---|---|
200 | Ok |
400 | BadRequest - ugyldig forespørsel |
401 | Unauthorized - mangler/feil autentiseringsinformasjon |
403 | Forbidden - ingen tilgang |
404 | NotFound - finner ikke innsending med gitt arkivreferanse i altinn |
500 | Error - intern feil |
For StatusAPI - status koder er det her nærmere beskrivelse av status for de enkelte elementene.
Feilmeldinger fra Altinn
Tabellen under angir de viktigste feilmeldingene fra Altinn.
Feilmelding | Forklaring |
---|---|
ERROR: Søker angitt i skjema er ikke samme som avsender(pålogget bruker) i Altinn. | Meldingen vises som Feil - datavalidering i loggen, men fanges ikke opp av prevalideringen. Den oppstår dersom pålogget bruker i Altinn ikke har rettigheter til å representere personen/foretaket som er angitt som søker i XML-en. |
Les mer på Altinn sine sider: https://altinn.github.io/docs/api/rest/kom-i-gang/
Nedetid og feilmeldinger fra KS FIKS
Ved nedetid i KS FIKS …
Ved nedetid i KS FIKS, følges følgende prosedyre:
Vi blir varslet om at vi ikke får levert innsendinger til FIKS
Vi slår av behandling av innsendringskøen fra Altinn slik at disse ikke fånyttes sendes til FIKS og får status “FEIL”
Det er fremdeles mulig å levere innsendinger til Altinn, men status på AR-referanse blir ikke tilgjengelig via FtB status API
Når KS er oppe igjen, behandler vi innsendingen i FtPB og returnerer status
Feilmeldinger fra KS FIKS
Tabellen under angir de viktigste feilmeldingene fra KS SvarUt.
Feilmelding | Forklaring |
---|---|
Forsendelse til SvarUt feilet: SvarUt request exception: Bad Request - Ugyldig innhold i forsendelse: Fant ikke organisasjon ´XXXXXXXXX´ i enhetsregisteret. | Sendinger til KS SvarUt blir avvist dersom organisasjonsnummeret til ansvarlig søker er ugyldig i Enhetsregisteret. Sendingen får status Feil. Organisasjonsnummeret må rettes og søknaden må sendes på nytt. |