Kom i gang med EDI 2.0 🇳🇴
EDI 2.0 er et API for sending, mottak, kvittering og statussjekk av helsefaglige meldinger som benytter vår egen meldingstjener. EDI 2.0 tilbys som en tjeneste for meldingsutveksling for aktører i helsesektoren.
Hvis du er en utvikler for et fagsystem (EPJ) som skal benytte EDI 2.0 for meldingsutveksling med andre aktører, har du kommet til riktig sted. Teknisk dokumentasjon for API-endepunktene finner du på siden om API-endepunkter.
Integrasjon med EDI 2.0 krever visse tekniske forutsetninger som står beskrevet på siden om forhåndskrav. Det kreves mindre for å integrere med testmiljøet enn produksjonsmiljøet. API-endepunktene kan prøves ut på Swagger-siden.
Avklaringer
Meldingstjeneren for EDI 2.0 håndterer valg av standard og protokoll for meldingsutvekslingen. Især benyttes EbXml-standarden (HIS 1037:2011) for sending over tradisjonell EDI med SMTP-protokoll når dette behøves. I en utveksling mellom to API-klienter bli meldingen umiddelbart tilgjengelig for nedlasting av mottaker(e).
Meldingstjeneren for EDI 2.0 er en meldingstjener (MSH), ikke et fagsystem. API-klientene må selv implementere forretningslogikk for å håndtere det kliniske innholdet av meldingene som utveksles med EDI 2.0. Et unntak er applikasjonskvittering (HIS 80415:2012), som EDI 2.0 tilbyr et eget endepunkt for å opprette og sende. Les mer om endepunktet på siden for sending av applikasjonskvittering.
EDI 2.0 forholder seg til standarden for tjenestebasert adressering (HIS 1153:2017) av meldinger, som vil si at brukerne av EDI 2.0 skal registreres i Adresseregisteret som kommunikasjonsparter av typen "tjeneste". Dette utdypes på siden om oppsett i Adresseregisteret.
EDI 2.0 benytter HelseID som autentiseringsmekanisme. API-kall trenger et gyldig token fra HelseID med et DPoP-bevis. Les mer om HelseID på siden om oppsett i HelseId.
EDI 2.0 finansieres gjennom medlemskap i Helsenettet. Les mer på siden om medlemskap.
Getting Started with EDI 2.0 🇬🇧
EDI 2.0 is an API for sending, receiving, acknowledging, and checking status of health‑care messages that uses our own message handler. EDI 2.0 is offered as a messaging service for actors in the health sector.
If you are a developer of a clinical application (EPJ) which wants to use EDI 2.0 for exchanging messages with other actors, then you are in the right place. Techincal documentation for the API endpoints is found on the API endpoints page.
Integration with EDI 2.0 requires technical prerequisites described on the prerequisites page. The requirements are less for the test environment than for production. The API endpoints can be tried out on the Swagger page.
Clarifications
The message handler for EDI 2.0 handles the choice of standard and protocol for the message exchange. In particular, it uses the EbXml standard (HIS 1037:2011) for sending over traditional EDI with the SMTP protocol when needed. For an exchange between two API clients, the message is immediately made available for download by the recipient(s).
The message handler for EDI 2.0 is a message handler (MSH), not a clinical application. API clients must implement their own business logic to handle the clinical content of the messages exchanged with EDI 2.0. An exception is the application receipt message (HIS 80415:2012), which EDI 2.0 offers to create and send via a dedicated endpoint. Read more about the endpoint on the application receipt endpoint page.
EDI 2.0 follows the standard for service‑based addressing ("tjenestebasert adressering", HIS 1153:2017) of messages, meaning that the clients of EDI 2.0 should registered in the Address Registry ("Adresseregisteret") as communication parties of type "tjeneste". This is explained further on the Address Registry setup page.
EDI 2.0 uses HelseID as the authentication mechanism. API calls require a valid HelseID token with a DPoP proof. Learn more about HelseID on the HelseID setup page.
EDI 2.0 is financed through membership in Helsenettet, where you have to be a member. Read more on the membership page.