Blogg fra februar, 2020

Ved nedlasting av filer fra status APIet er det vanskelig å differensiere de forskjellige filene fordi "Filbeskrivelse" ikke beskriver filtypen godt nok. Her er et eksempel fra en distribusjon av en kontrollerklæring:

{
      "Distribusjonstype": "Kontrollerklæring",
      "ReferanseSluttbrukersystem": "ec8e27a7-2404-4bea-b135-47cb02c1723a",
      "Status": "receiptSent",
      "ReferanseIdSendt": "28587954",
      "Sendt": "2020-02-11T11:26:30.023",
      "ReferanseIdSignert": "AR6140027",
      "Signert": "2020-02-11T11:27:43.66",
      "ReferanseIdKvittering": "8525699",
      "SendtKvittering": "2020-02-11T11:28:01.69",
      "Filnedlastinger": [
        {
          "Filbeskrivelse": "Kontrollerklæring",
          "FilURL": "https://test-admbygg.dibk.no/api/download/2bc96397-fbe1-4d07-b899-e155b278bb8f/Kontrollerklaering.xml",
          "Mimetype": "application/xml"
        },
        {
          "Filbeskrivelse": "Kontrollerklæring",
          "FilURL": "https://test-admbygg.dibk.no/api/download/2bc96397-fbe1-4d07-b899-e155b278bb8f/Kontrollerklaering.pdf",
          "Mimetype": "application/pdf"
        },
        {
          "Filbeskrivelse": "Kontrollerklæring",
          "FilURL": "https://test-admbygg.dibk.no/api/download/2bc96397-fbe1-4d07-b899-e155b278bb8f/Vedlegg1.Plan.pdf",
          "Mimetype": "application/pdf"
        }
      ],
      "ReferanseOpprinneligDistribusjonSluttbrukersystem": "687675fd-2e74-49b9-9581-dcf54d4bb995",
      "AltinnInnboksMeldingsreferanse": "8525696"
    }

"Filbeskrivelse" er "Kontrollerklæring" for hver filnedlasting i eksempelet.

Vi foreslår en endring der:

• Den maskinlesbare XMLen med skjema data blir "Filbeskrivelse": "Maskinlesbar":

• Den signerte PDFen blir "Filbeskrivelse": "Skjema"

• Alle andre filer blir beskrevet med vedleggsfiltypen fra Altinn

For skjemaet Kontrollerklæring er vedleggstypen PlanForUavhengigKontroll:

En tilsvarende distribusjon til den over blir da vist slik i status APIet:

{
      "Distribusjonstype": "Kontrollerklæring",
      "ReferanseSluttbrukersystem": "9d221bee-6f68-4eaa-bed7-e5c3835dd09b",
      "Status": "receiptSent",
      "ReferanseIdSendt": "28644652",
      "Sendt": "2020-02-19T15:53:12.77",
      "ReferanseIdSignert": "AR6159706",
      "Signert": "2020-02-19T15:53:47.873",
      "ReferanseIdKvittering": "8560695",
      "SendtKvittering": "2020-02-19T15:54:01.993",
      "Filnedlastinger": [
        {
          "Filbeskrivelse": "Maskinlesbar",
          "FilURL": "http://localhost:57262api/download/45a867fd-b77e-4b45-8763-92e5a1f9aafd/Kontrollerklaering.xml",
          "Mimetype": "application/xml"
        },
        {
          "Filbeskrivelse": "Skjema",
          "FilURL": "http://localhost:57262api/download/45a867fd-b77e-4b45-8763-92e5a1f9aafd/Kontrollerklaering.pdf",
          "Mimetype": "application/pdf"
        },
        {
          "Filbeskrivelse": "PlanForUavhengigKontroll",
          "FilURL": "http://localhost:57262api/download/45a867fd-b77e-4b45-8763-92e5a1f9aafd/Vedlegg1.planForKontroll.pdf",
          "Mimetype": "application/pdf"
        }
      ],
      "ReferanseOpprinneligDistribusjonSluttbrukersystem": "e56efca2-c052-4db6-ae7a-307c5c8d4299",
      "AltinnInnboksMeldingsreferanse": "8560692"
    }

Vi ønsker tilbakemeldinger på dette forslaget.
Vi vil også gjerne høre om hvor lang tid dette vil ta å implementere hos leverandørene, eller om man ønsker en versjon 2 av APIet der denne endringen blir med.
Vi har datagrunnlaget for å gjøre dette til en tilbakevirkende endring slik at kall mot gamle arkiv referanser leverer data på det nye formatet. Er dette ønskelig?

Kommentarer kan rapporteres inn til Service Desk.

Utviklingsnotater

Oppdatert 15.04.2020

• Endringene blir implementert i en ny versjon/URL av APIet slik at eksisterende implementasjoner forsetter å fungerer.

• Utvetydig identifisering av vedlegg: "Filbeskrivelse": "Vedlegg-PlanForUavhengigKontroll",

• Nåværende API blir som før, nytt API er “tilbakevirkende” slik filbeskrivelse på gamle AR nummer blir oppdatert der.

Andre forslag til Status API:

• Legge inn ID/versjon for datamodell informasjon for å hjelpe velge datamodell ved de-serialisering (aktuelt både for hovedskjema og nedlastbare svarskjema slik som ansvarsretter og nabovarsel svar).

• Etablere en overordnet ID for alle innsendinger som hører til samme byggesak (muligens ID tildelt fra FtB gjennom nytt API)

• Utvide status på distribusjon til å ha en default null verdi

Sikkerhet:

• Vi ser på om vi kan bruke Maskinporten på våre APIer (litt lenger sikt)

• Vi tenker at vi kommer til å kreve Basic Authentication også ved nedlastning av filer

Fra 27. januar (kl. 00:00) har PDF-ene for ramme- og ettrinnssøknad hatt en feil som gjør at informasjon om dispensasjon kan bli skjult, selv om informasjonen er fylt ut i XML-en.

Feilen er rettet og produksjonssatt for rammesøknad 07.02.20 kl. 15:07 og for ettrinnssøknad 07.02.20 kl. 15:45.

Dersom søknaden feilaktig mangler informasjon om dispensasjon, vil søkeren få mangelbrev fra kommunen. Vi anbefaler leverandører å kontakte søkere og be dem ettersende kommunen eventuell informasjon om dispensasjon, dersom de er rammet av feilen.

Feilen oppstod som følge av en rettelse på ettrinnssøknad, rammesøknad og søknad om tiltak uten ansvarsrett, hvor bolken for dispensasjon skal skjules dersom den er tom. Søknad om tiltak uten ansvarsrett er ikke rammet av feilen.

Vi opplever problemer med Altinn sitt rest API både på TT02 og prod. Det tar veldig lang tid med POST kall til api/<orgnr>/messages. Timeout forekommer.

Vi har åpnet sak med Altinn og de har fått deres leverandør inn for å jobbe med problemet.

Altinn oppgraderte TT02 til ny versjon 05.02.2020 men det har ikke vært driftsoppdateringer på prod.

Vi oppdaterer saken når vi vet noe mer.

10:00, 06.02.2020: Saken er eskalert med Altinn.

11:06, 06.02.2020: Saken jobbes med som en “alvorlig feil“ av Altinn sin leverandør.

14:35, 06.02.2020: Altinn sier at saken er løst, vi får fremdeles timeout på TT02.

16:02, 06.02.2020: Vi har rapportert tilbake til Altinn at REST APIet fremdeles ikke fungerer.

16:51, 06.02.2020: Altinn rapporterer at REST timeout har noe med mapper funksjonalitet å gjøre. Dette er funksjonalitet for å tillate API kall mellom Altinn og eksterne tjenester. Vi har brukt noen av disse mot GeoNorge kodelister og vi jobber med å ta disse ut siden dette blir dekket i pre-validering. Skjema uten GEoNorge mapper ser ut til å fungerer bedre i TT02. Vi bestiller nye Altinn prodsettinger omløpende.

19:35, 06.02.2020: Vi har bestilt prodsettinger av noen skjemaer hvor vi har fjernet kall mot GeoNorge-kodelisster. Altinn vakttelefon har bedt sin driftsleverandør om å prodsette i løpet av kvelden. Vi håper dette vil bedre problemet, men det løser ikke rotårsaken.

20:37, 06.02.2020: Vi har fått bekreftet at følgende skjemaer er prodsatt på nytt:

• Rammesøknad

• Distribusjon av nabovarsel + Nabovarsel

• Distribusjon av ansvarsrett + Ansvarsrett

Vi jobber videre i morgen tidlig med å oppdatere og prodsette resterende skjemaer. I tillegg har Altinn gjenåpna saken og behandler den fremdeles som en “alvorlig feil”.

8:47, 07.02.2020: Noen av tjenestene ser ut til å fungerer bedre nå. Vi ser at Distribusjon av Ansvarsrett går igjennom, men den oppretter ikke de distribuerte ansvarsrettene hos mottaker (ansvarlig foretak). Vi jobber med denne saken nå.

9:19, 07.02.2020: Vi har slått av behandling av Distribusjon av Ansvarsrett i prod. Disse innsendingenen vil ligg i kø til vi får opprettet preutfylte ansvarsretter igjen. Vi tror vi har en fiks ved å bruke en intern Altinn kodeliste istedet for GeoNorge liste gjennom mapper. Tester dette i TT02 nå.

10:11, 07.02.2020: Vi har gjort noen endringer i distribuert versjon av ansvarsrett skjemaet så vi ikke støter på nåværende problemer med mapper i Altinn. Venter på prod setting av skjemaet. Når dette er på plass skrur vi på behandling av Distribusjon av ansvarsrett igjen. Følg bloggen for oppdateringer. Vi ser gjennom alle andre innsendingstjenester for å luke ut mapper avhengigheter.

10:48, 07.02.20: Ettrinnssøknad og søknad om tiltak uten ansvarsrett er prodsatt på nytt. Vi observerer at noen rammesøknader og ettrinnssøknader begynner å kjøre vellykket gjennom systemet.

11:15, 07.02.2020: Vi har startet opp tjenesten for Distribusjon av ansvarsretter igjen og ser ikke noe problemer så langt.