Doffin-integrasjon for anskaffelsessystemer
Et norsk KGV må kunne opprette gyldige eForms-kunngjøringer og utveksle dem kontrollert med Doffin.
En Doffin-integrasjon gjør det mulig for et konkurransegjennomføringsverktøy å sende kunngjøringer til den nasjonale kunngjøringsdatabasen. Integrasjonen er mer enn en publiseringsknapp: den må oversette konkurransens data til riktig eForms-struktur, validere innholdet og følge kunngjøringen frem til publisert eller avvist status.
Dataflyten
For en norsk konkurranse er hovedløpet:
- Oppdragsgiveren registrerer strukturert informasjon i KGV.
- KGV bygger en kunngjøring i gjeldende eForms-format.
- Tekniske og forretningsmessige regler valideres før innsending.
- Kunngjøringen sendes gjennom Doffins grensesnitt.
- Doffin behandler og publiserer kunngjøringen.
- Kunngjøringer som skal til EØS-markedet formidles videre til TED.
- KGV henter status, publiseringsreferanser og eventuelle feil tilbake.
DFØ opplyser at Doffin er Norges eneste eSender til TED. Et norsk KGV skal derfor ikke bygge normalflyten som en direkte TED-publisering for norske kunngjøringer.
Hva integrasjonen må håndtere
Kunngjøringer har et livsløp. Det kan komme rettelser, endringer, avlysninger og kontraktskunngjøringer etter den første publiseringen. Systemet må bevare identifikatorer og forholdet mellom versjonene.
En robust løsning bør ha:
- feltvalidering mens brukeren arbeider
- full validering mot riktig eForms-versjon før innsending
- idempotent innsending slik at et nettverksavbrudd ikke skaper ukontrollerte duplikater
- statusmaskin for utkast, sendt, under behandling, publisert og feilet
- lesbare feilmeldinger som peker tilbake til riktig felt
- kø og kontrollert gjentakelse ved midlertidige feil
- logging av payload, tidspunkt, respons og brukerhandling
- avstemming som oppdager forskjell mellom lokal og ekstern status
Skill brukerfeil fra driftsfeil
Et obligatorisk felt som mangler skal tilbake til saksbehandleren. En midlertidig nettverksfeil kan prøves på nytt automatisk. En ukjent schemafeil bør stoppe flyten og varsle teknisk ansvarlig. Hvis alle feil behandles likt, får brukeren enten unødvendige stopp eller farlige automatiske gjentakelser.
Bygg derfor en feilmodell med kode, kategori, alvorlighet, anbefalt handling og korrelasjons-ID. Den samme ID-en bør følge hendelsen i KGV, integrasjonslaget og driftsloggen.
Er Maskinporten nødvendig?
Ikke legg til grunn at Doffin bruker Maskinporten. Doffins grensesnitt har egen teknisk dokumentasjon og onboarding. Maskinporten er en generell mekanisme for virksomhetsautentisering mot API-er som støtter den, ikke en universell innlogging til alle offentlige tjenester.
Hvis plattformen også integrerer med Altinn eller andre offentlige API-er, kan disse koblingene kreve Maskinporten eller Altinn systembruker . Hold legitimasjon, scopes og feilflyt separat per integrasjon.
Test før produksjon
Test minst opprettelse, endring, avlysning og kontraktskunngjøring. Test både gyldige og ugyldige data, timeout etter innsending og status som ikke oppdateres. Verifiser også at en ny eForms-versjon kan prøves i et testmiljø før produksjonssetting.
Les videre om Doffin Notices API , eForms og integrasjonsarkitektur .
Offisielle kilder
Se DFØs KGV-veiledning og Doffins API-portal . Grensesnitt og onboarding kan endres; kontroller alltid gjeldende spesifikasjon før utvikling.