Doffin Notices API
Doffins kunngjørings-API brukes av tilknyttede systemer til innsending; det bør ikke forveksles med et fritt søke-API for alle Doffin-data.
Doffin Notices API er grensesnittet tredjepartssystemer bruker for å sende kunngjøringer til Doffin. Den viktigste avklaringen for en ny plattform er at et API for innsending ikke nødvendigvis er det samme som et åpent API for å lese og søke i alle publiserte kunngjøringer.
Innsending og gjenbruk er to ulike behov
Et KGV trenger en kontrollert publiseringskanal. Systemet oppretter en eForms-kunngjøring, sender den, følger status og håndterer feil eller senere endringer. Dette krever onboarding og teknisk tilgang etter Doffins gjeldende vilkår.
En leverandørtjeneste trenger derimot data for søk, varsling og analyse. I et svar publisert på DFØs Datalandsbyen i juni 2026 beskrev Doffin-teamet Notices API som et grensesnitt for tredjepartssystemer og eSendere som skal sende kunngjøringer til publisering, ikke som et generelt uttrekks-API per organisasjon. For datagjenbruk viste de blant annet til Doffins dataside og TEDs nedlastbare kunngjøringer.
Konsekvensen er viktig: ikke bygg et produktløfte om komplett Doffin-lesetilgang før datakilden, lisensen, feltene og oppdateringsfrekvensen er verifisert.
Integrasjonsmønster for innsending
Behandle hver kunngjøring som en versjonert ressurs:
| Felt | Hvorfor det trengs |
|---|---|
| Lokal ID | Kobler konkurransen til intern arbeidsflate |
| Ekstern ID | Kobler mot Doffin og senere publisert referanse |
| eForms-versjon | Sikrer riktig schema og valideringsregler |
| Payload-hash | Avdekker om innholdet er endret |
| Status | Viser siste bekreftede steg i livsløpet |
| Korrelasjons-ID | Binder sammen API-kall, logg og supporthendelse |
| Tidsstempler | Dokumenterer innsending, respons og publisering |
Lagre aldri bare siste status. Bevar hendelsesrekken slik at systemet kan forklare om en bruker endret data før eller etter en avvist innsending.
Lesetilgang for markedssøk
For kunngjøringer som publiseres på TED finnes et åpent TED Search API uten autentisering. Det kan brukes til søk og bulkuttak av publiserte TED-kunngjøringer. Det dekker ikke automatisk enhver norsk kunngjøring under EØS-terskelverdiene.
En norsk markedstjeneste kan derfor trenge flere kilder og tydelig dataproveniens. Vis hvor kunngjøringen kommer fra, når den sist ble hentet og lenke brukeren til den offisielle publiseringen. Ikke la beriket eller AI-generert informasjon erstatte bindende konkurransedokumenter.
Tilgang og hemmeligheter
API-nøkler eller abonnementnøkler skal lagres som hemmeligheter, roteres og avgrenses per miljø. Test og produksjon bør ha separate nøkler og endepunkter. Logg ikke hele nøkkelen eller andre autentiseringsdata.
Doffin-dokumentasjonen må avgjøre den faktiske autentiseringsmetoden. Ikke anta at Maskinporten gjelder bare fordi tjenesten er offentlig.
Før utviklingen starter
- Avklar om behovet er publisering, datagjenbruk eller begge deler.
- Få skriftlig bekreftet tilgangsmodell og testmiljø.
- Kartlegg eForms-versjoner og nasjonale valideringsregler.
- Definer statusmaskin, retry-regler og manuell feilbehandling.
- Test rettelse, avlysning og duplikatforsøk, ikke bare første kunngjøring.
- Lag overvåking som oppdager at lokal status avviker fra Doffin.
Les Doffin-integrasjon og eForms for utviklere .
Offisielle kilder
Se Doffins API-portal og DFØs avklaring om API for offentlige anskaffelser . Dokumentasjon og tilgang kan endres; verifiser alltid gjeldende API-kontrakt direkte med Doffin.