Hopp til innhold
Lukk

Få varsel ved oppdateringer av «Teknisk informasjon for SYSVAK»

Hvor ofte ønsker du å motta varsler fra fhi.no? (Gjelder alle dine varsler)
Ønsker du også varsler om:

E-postadressen du registrerer her vil kun bli brukt til å sende ut nyhetsvarsler du har bedt om. Du kan når som helst avslutte dine varsler og slette din e-post adresse ved å følge lenken i varslene du mottar.
Les mer om personvern på fhi.no

Du har meldt deg på nyhetsvarsel for:

  • Teknisk informasjon for SYSVAK

Oops, noe gikk galt...

... ta kontakt med nettredaksjon@fhi.no.

... last inn siden på nytt og prøv igjen.

Artikkel

Teknisk informasjon for SYSVAK

Publisert

Primært for leverandører av EPJ-løsninger og eventuelle andre personer som arbeider med tekniske sider rundt kommunikasjon med SYSVAK. Hensikten er å informere om nødvendige tekniske detaljer for å kunne utvikle og produksjonssette løsninger som skal samhandle elektronisk med SYSVAK.

Primært for leverandører av EPJ-løsninger og eventuelle andre personer som arbeider med tekniske sider rundt kommunikasjon med SYSVAK. Hensikten er å informere om nødvendige tekniske detaljer for å kunne utvikle og produksjonssette løsninger som skal samhandle elektronisk med SYSVAK.


Implementasjon av SYSVAK-meldinger

Meldingsbeskrivelse 

Test- og godkjenningsprosessen

Før en godkjenningsprosess kan startes, må eksempelmeldingen dere skal benytte, validere korrekt med bruk av https://samsvar.nhn.no/validering/xml

Andre spørsmål relatert til dok75 og gjennomføring av akseptansetesten rettes til SYSVAK@fhi.no 

Integrasjon med SYSVAK

SYSVAK har tre forskjellige miljøer: Produksjonsmiljø, stagingmiljø og testmiljø. All testing skal foregå mot testmiljø. Ved spesielle behov kan virksomheter kontakte FHI for å kunne utføre integrasjon mot SYSVAKs stagingmiljø.

For å kunne lage best mulige rapporter fra SYSVAK ber vi om  at registrerende helseenhet ønskes så finmasket som mulig, uavhengig av adressering.

Adressering av REQUEST-meldinger som sendes til FHI SYSVAK

Felles for alle miljøer er at meldinger som sendes inn fra dere, skal adresseres tjenestebasert, som for andre e-helse-meldinger med hodemelding.

https://ehelse.no/standarder/tjenestebasert-adressering-del-2-identifikatorer-ved-elektronisk-samhandling viser en detaljert oversikt over adressering i både ebXML konvolutten og i selve XML-fagmeldingen (tilsvarende request-meldinger).

For mere informasjon om meldingsutveksling generelt i helsesektoren, se NHN sin veileder på https://nhn.no/veileder-for-elektronisk-meldingsutveksling/

EDI-adresse dere sender fra må være samme edi-adresse som dere har oppført under kommunikasjonspart i AR og/eller Test-AR. Årsaken er at vår meldingstjener er korrekt synkronisert med AR/Test-AR og avvikende adressering vil feile.

  1. Adressering i ebXML konvolutt fra deres meldingstjener for alle miljø

Dette er likt for alle miljøer, og det er krav om å bruke HER-ID, ENH kan benyttes ved behov, men kun dersom det er et tillegg til HER-ID

  • Avsender: HER-ID for kommunikasjonspart (som i xml-meldingen)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))
  1. Adressering for REQUEST-melding (fagmelding/xml/payload/) til FHI

Prinsippene er like for alle miljøer, det er krav om å bruke HER-ID for både virksomhet og kommunikasjonspart – for både avsender og mottaker.

  • Avsender: HER-ID for virksomhet
  • Avsender: HER-ID for kommunikasjonspart
  • Mottaker: HER-ID 85217 (FHI)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

Se andre variasjoner under for hhv PROD-, STAGE- og TESTMILJØ

 

PROD miljø

Meldinger i produksjonsmiljøet sendes KUN i Helsenettet, og Adresseregister skal benyttes, se https://register.nhn.no/Ar/Tjeneste/Index/138619 for EDI-adresse, virksomhetssertifikat etc.

For avsenderinformasjon, se over.

Produksjonsmiljø ebXML konvolutt

  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

Produksjonsmiljø fagmelding

  • Mottaker: HER-ID 85217 (FHI)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

 

TEST miljø i Helsenettet

Meldinger i testmiljøet som sendes i Helsenettet, skal benytte informasjon fra TEST- Adresseregister https://register-web.test.nhn.no/Ar/Tjeneste/Index/138619 (som er tilgjengelig på både internett og i Helsenettet) for EDI-adresse, virksomhetssertifikat etc.

For avsenderinformasjon, se over.

Testmiljø i Helsenettet -  ebXML konvolutt

  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

Testmiljø i Helsenettet - fagmelding

  • Mottaker: HER-ID 85217 (FHI)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

 

TEST miljø på internett

Dette er en avvikende løsning for EPJ leverandører som IKKE kan teste sine meldinger i Helsenettet, men kun over internett.

Før denne kan benyttes, må dere be om dette for å få meldingstjener til å avvike fra adresseregister på edi-adresse. Ta kontakt med NHN (se beskrivelse "NHN Kundesenter" under)) og be om eget test-oppsett på FHI meldingstjener for SYSVAK-testing over internett.

Meldinger i testmiljøet som sendes over internett, skal benytte informasjon om deres virksomhet, sertifikat, kommunikasjonspart og internett-mailadresse fra  TEST- Adresseregister https://register-web.test.nhn.no/Ar.

For avsenderinformasjon, se over.

Testmiljø over internett - ebXML konvolutt

  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))
  • test-fhi-mottak@fhi.no

Testmiljø over internett - fagmelding

  • Mottaker: HER-ID 85217 (FHI)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

 

STAGE miljø

Ved spesielle behov kan virksomheter kontakte FHI for å kunne utføre integrasjon mot SYSVAK sitt staging miljø, se kontaktinfo nederst.

Meldinger i staging miljøet som sendes over Helsenettet i Test, skal benytte informasjon om deres virksomhet, sertifikat, kommunikasjonspart og internett-mailadresse fra  TEST- Adresseregister https://register-web.test.nhn.no/Ar.

 

For avsenderinformasjon, se over.

Stagingmiljø ebXML konvolutt

  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))
  • staging-fhi-sysvak@edi.nhn.no

Stagingmiljø fagmelding

  • Mottaker: HER-ID 85217 (FHI)
  • Mottaker: HER-ID 138619 (Nasjonalt vaksinasjonsregister (SYSVAK))

Testmiljøet bruker testpersoner fra SYSVAK sin testfamilie (se under).

Krav til sikkerhet

  1. Integrasjon mot staging- og produksjonsmiljøet er reservert kommunikasjonspartnere som har lovlig rett og behov for tilgang.
  2. Integrasjon mot staging- og produksjonsmiljøet krever at kommunikasjonspartnere oppfyller krav til Norm for informasjonssikkerhet i helsesektoren.

Testfamilie

SYSVAK har en fiktiv testfamilie som brukes i SYSVAK sitt testmiljø.
Les om bruk av testfamilien.

Kontakt  for å få tilgang til testfamilien.

SYSVAK kodeverk

Det er viktig at kodeverk som er avsluttet og tatt ut av produksjon, ikke benyttes på nye vaksinasjonsmeldinger. Bruk av ugyldige kodeverdier medfører at vaksineinformasjon IKKE blir registrert hos FHI, eventuelle avvik vil bli returnert i egen responsmelding.

Eksport av SYSVAK data

Detaljert beskrivelse av eksportformatet  Dok 33 - SYSVAK Eksportformat.

Eksempler

Feilsituasjoner

  • Feil avsender av fagmelding

Vi opplever til tider at avsendere ikke mottar responsmeldinger fra FHI, og i de aller fleste tilfeller skyldes dette at innsendt fagmelding er adressert fra virksomheten/kommunen (uten edi-adresse), noe som medfører at vi IKKE har noe sted å returnere responsmeldingen. Meldinger til SYSVAK skal ALLTID sendes fra en kommunikasjonspart/tjeneste (HER-ID) i adresseregisteret og IKKE fra virksomheten, se flere detaljer under.

  • Tilgangsnivå/rollestyring

Har dere mottatt kvitteringsmelding, men ikke Responsmelding/AppRec? Kan det være rollestyring og tilganger til tjenester i eget EPJ systemet ?

 En transportkvittering (ACK) returneres fra FHI meldingstjener direkte fra informasjon i konvoluttmeldingens HER-ID og adresseinformasjon registrert i AR på denne.

  • En Responsmelding/AppRec er en fagmelding og bruker adresseinformasjon fra selve fagmeldingen som er generert fra deres eget EPJ.
  • FHI lager automatisk Responsmelding med adressering tilbake til HER-ID oppført i deres opprinnelige fagmelding, og benytter EDI-adresse registrert i Adresseregisteret.

Hvis manglende responsmelding er sporadisk, kan det være lurt å sjekke om helsepersonell (EPJ brukere) som sender fra en gitt kommunikasjonspart/tjeneste, har de rollene de skal ha i EPJ-systemet.

Dette på bakgrunn av informasjon om at manglende tilgangsnivå til en tjeneste, kan føre til at HER-id i fagmeldingen blir sendt fra kommunen på toppnivå (nivå 1 i AR – uten registrert edi-adresse) og ikke tjenesten (nivå 2).

Meldinger til FHI skal ALLTID sendes fra kommunikasjonspart/tjeneste.

  • Oppdatert sertifikatinformasjon i adresseregisteret?

Alle endringer dere gjør i Adresseregisteret relatert til egne sertifikater, edi-adresser eller kommunikasjonsparter, skal oppdateres automatisk i meldingstjeneren hos FHI, dvs varsling om endringer er ikke nødvendig.

Hvis dere allikevel skulle motta negativ kvitteringsmelding eller automatisk meldingsrespons uteblir, ber vi dere ta kontakt med kundesenter hos NHN direkte.

NHN Kundesenter

Det er viktig at dere beskriver følgende før innmelding til kundesenter@nhn.no

Emnefelt i mail: "Meldingstjener FHI" + kort problembeskrivelse

  1. Beskriv problemet konkret. og hvilken meldingsstandard sendes inn.
  2. Har dere mottatt transportkvittering (ACK) og/eller Responsmelding/ (AppRec) positiv eller negativ? Hva er eventuell feiltekst?
  3. Hva mener dere er forventet løsning? Hva mangler ?
  4. Hvilket miljø ønskes det bistand på (prod-/stage-/testmiljø)?
  5. Hvis testmiljø – tester dere over internett eller i helsenettet?
  6. Validerer XML korrekt på https://samsvar.nhn.no/validering/xml - og spesielt på adressering fra dere og til tjeneste hos FHI ? Eventuelt hva er avviket ?
  7. Hvilken kommunikasjonspart sender dere FRA (HER-ID nivå 2 og navn), hentet fra selve fagmeldingen/request-meldingen dere har sendt
  8. Hvilken kommunikasjonspart sender dere TIL (HER-ID nivå 2 og navn), hentet fra selve fagmeldingen/request-meldingen dere har sendt
  9. Hva er avsenders og mottakers edi-adresse – og er det den samme som er oppført i Adresseregister eller test-adresseregister?

Kontakt for ytterligere informasjon

 

  • E-post:

 

 

Teknisk informasjon for SYSVAK-nett

Her finner du teknisk informasjon for bedrifter med brukere som skal bruke SYSVAK-nett for registrering av vaksinasjoner.

 

Historikk

17.11.2020: Oppdatert med teknisk informasjon om SYSVAK-nett.

Innhold på denne siden