Hvis du har utfordringer med integrasjoner eller validering av XML-meldinger, her finnes hjelp.

• Teknisk bistand fra utviklere i leveranseteamet på Slack-kanal
  • EXT-UTV-Pasientensprøvesvar
  • https://norskhelsenett.slack.com/archives/C04JCDPSH55
• For tekniske spørsmål relatert til PTS-API og FoRe-API, benytt 
  • EXT-UTV-PTS
  • https://norskhelsenett.slack.com/archives/C05B56VGEK1
• For tekniske spørsmål om HelseID, benytt 
  • EXT-HELSEID
  • https://norskhelsenett.slack.com/archives/CJW3CQHJB
• For teknisk spørsmål ogsyntetiske testpersoner
  • EXT-SYNTPOP
  • https://norskhelsenett.slack.com/archives/C05BGTW5P6V

For virksomheter som IKKE har Slack, må vi invitere dere inn, send oss da en mail med navn, virksomhet, formål og mailadresse, så inviterer vi dere inn. Det samme gjelder ved andre henvendelser, send en mail til provesvar@nhn.no  - så hjelper vi deg så fort vi finner ledige ressurser.

• For andre henvendelser, ta kontakt med NHN Kundesenter

For avklaring om innhold i meldingsstandard, ta kontakt med  Helsedirektoratet

• Send mail til meldingshjelp@helsedir.no

Etter 12.05.2025 (forhåpentligvis) endres formålet fra teknisk utprøving med kvalitetssikring i produksjon, til utprøving med formål helsehjelp.

Etter den datoen må all testing og kvalitetssikring skje i Test, med bruk av syntetisk testpasienter.

Under er svar på noen spørsmål om hva og hvordan rundt testmeldinger

I Pasientens prøvesvar i test vises alle prøvesvar som er sendt inn til Pasientens prøvesvar, hvor svarrapporten er i henhold til standard, og Id for test-pasient finnes i Persontjenesten i test (syntetisk testpasient) eller i en tidsbegrenset periode, fra "Testaktører".

Testmeldinger kan sendes til Pasientens prøvesvar, med oppføring av adresser og sertifikater i NHN Adresseregister i test;

• HER-ID 8139764 i AR-TEST og edi-adresseTEST-NILAR@testedi.nhn.no
• HER-ID 8139952 i AR-TEST og e-postadresse NILAR-INTERNETT@samsvar.nhn.no
• HER-ID 8140937 i AR-TEST og edi-adresse NILAR-TEST@edi.nhn.no

Hvis dere ikke har tilgang i Helsenettet, og benytter internett-mail, vil vi kunne motta testmeldinger sendt til HER-ID 8139952 (@samsvar.nhn.no) - men IKKE sende APPREC i retur. Vi anbefaler derfor bruk av @testedi.nhn.no i helsenettet.

Ta i bruk Testedi

For å kunne sende testmeldinger over TEST-EDI, krever det en bestilling til NHN Kundesenter, men det er fullt mulig å teste om det allerede er etablert en åpning i brannmur til test-EDI - i helsenettet.

Tilkoblingstest med TELNET til TEST-EDI i helsenettet:

• Telnet pop.testedi.nhn.no 110
  • Skal resultere i følgende svar; "+OK Dovecot ready" – QUIT
• Telnet smtp.testedi.nhn.no 25
  • Skal resultere i følgende svar; “220 smtp.testedi.nhn.no NHN EDI-server”

Ved godkjent tilkoblingstest, kan bestilling av testedi-konto sendes til NHN kundesenter.

Feilsøking ved manglende tilgang til TEST-EDI i helsenettet;

• Er det satt opp at subnettet 91.186.80.0/20 skal rutes mot Helsenettet?
• Er det åpnet for TESTEDI i deres brannmur?
• "Traceroute pop.testedi.nhn.no" vil kunne vise hvor trafikken stopper opp
• Ta kontakt med egne nettverksressurser for bistand lokalt
• Ta kontakt med kundesenter@nhn.no for videre feilsøking

Tjenestebasert adressering er en forutsetning for å kunne sende og motta Applikasjonskvittering fra Pasientens prøvesvar, og har vært et krav siden oppstart utprøving med formål kvalitetssikring, oktober 2022.

Det anbefales å benytte syntetiske testpasienter, og her kan dere selv reservere egne syntetiske pasienter - Syntpop

I løpet av 2025 er det forventet at PREG-TEST avsluttes, og flere tjenester har allerede sluttet å supportere dette, til fordel for Syntpop.

Hvis dere allikevel ikke har fått på plass syntetiske pasienter, her er et knippe som vil kunne benyttes i store deler av 2025, men KAN bli slettet uten forvarsel;

Den enkleste form for XML-validering, er å laste opp syntetisk test XML til XML-validering, som en første validering på generelt nivå.

Dette er ikke en innholdsvalidering for om et labsvar er korrekt implementert, se da neste punkt, PPS innholdsvalidering.

I XML-validering, finnes muligheter for å finne generelle avvik  for en eller flere fagmeldinger, ved å laste opp eller dra/slipp syntetis test xml-melding. Det er ikke krav om innlogging og tjenesten er tilgjengelig fra internett.

"Innhold" viser overordnet status på validering,oversikt over hvilke feil som er avdekket, samt utlisting av egen XML

"Skjema" viser om det er feil i skjemavalidering, som vil returnere Negativ AppRec ved innsending til PPS.

"Visning" er en enkel xml-transformering (visningsfil), uavhengig av eventuelle feil i "Innhold", men er ikke en visning av hvordan hvordan/om KJ Portal viser prøvesvaret.

I og med at Pasientens prøvesvar skal håndere prøvesvar fra alle lab/rad i hele Norge, er det viktig at informasjon som sendes er i henhold til standard for svarrapportering. 

I tillegg til XML-validering, er det viktig å sikre at innholdet i svarrapporten tilfredsstiller detaljer som kreves for et lab-svar (inkludert RTG), og vi har derfor lagt inn validering av innhold, for å sikre at f.eks relasjoner mellom prøvemateriale og analyseresultater er entydig identifisert, at Id'er det referes til, faktisk finnes (og kun et sted) etc. 

Ved innsending at testmelding, vil eventuelle avvik returneres i Negativ AppRec, men i tillegg kan man benytte midlertidig PPS validerings-endepunkt, for å avdekke eventuelle avvik i en svarrapport, som ikke nødvendigvis avdekkes i XML-validering.

1. Installer f.eks. Postman https://www.postman.com/downloads/
2. Opprett en ny samling – new collection – new request
3. Endre default Request fra GET til POST
4. Legg inn POST https://backdoor.test.pps.nhn.no/dryrun/validate i Postman (å trykke på lenken vil feile)
5. Opprett/finn syntetisk testmelding, og åpne XML i Notisblokk eller Notepad++ (ikke web-browser eller andre viewere som endrer format)
6. Kopier hele XML-meldingen fra notisblokk - Ctrl+A og Ctrl+C
7. Gå til Postman Body og velg raw som format for tekstboksen
8. Klikk i tekstboksen, merk alt og lim inn - Ctrl+A og Ctrl+V
9. Trykk Send og du skal få opp et valideringsresultat
10. Les resultat fra OperationalOutcome – diagnostics

Når innholdsvalidering avdekker en feil eller mismatch, sendes feilmeldingen som en kode X99 "Annen feil" - med informasjon om avviket i OT. Teksten som legges med viser følgende;

• plassering i XML-svarrapporten hvor avviket finnes
• hvis det finnes flere forekomster av samme element, vises avviket med nummerering regnet fra øverst i XML-rapporten, eks [4]
• Deretter vises hvilket element som har avvik
• Selve feilmeldingen med referanse til manglende objekt, manglende Servtype pr undersøkelse, manglende påkrevd felt etc.

Her et eksempel på feiltekst X99 i Negativ AppRec;

Oppfølging av applikasjonskvitteringer;

• En Positiv APPREC betyr at selve svarraporten er validert OK, men er ikke en bekreftelse på lagring i Pasientens prøvesvar. Pasienten kan ha reservert seg mot lagring, ha hemmelig adresse etc. og slettet av denne- eller andre årsaker.
• En Negativ APPREC betyr at det er feil i svarrapporten, som må rettes opp og sendes på nytt, med ny unik meldingsid.

Manglende APPREC betyr at adresseinformasjon er utilstrekkelig i svarrapporten, eller inneholder annen HER-ID enn den som sendte svarrapporten;

"Når en fagmelding er adressert til en virksomhet og en kommunikasjonspart som ikke representerer virksomheten som mottar meldingen, skal ikke fagmeldingen besvares med applikasjonskvittering. Det samme gjelder hvis fagmeldingen er så mangelfullt adressert at det ikke kan tydes hvor meldingen kommer fra."

I tillegg kan det være sendt en duplikat av tidligere sendt svarrapport, da sendes ingen APPREC.

Hvis du mottar en negativ AppRec med kode T99, er dette en "annen feil", hvor feilen/avviket beskrives i "OT" som en del av AppRec-meldingen.

• XML encoding is not UTF-8 (found encoding: 'ISO-8859-1'.

Dette betyr at svarrapporten ikke er deklarert som UTF8, som er et krav til løsningen.

Alle XML-melkdinger som sendes til pasientens prøvesvar skal inneholde en deklarering først i XML-meldingen, slik;

<?xml version="1.0" encoding="utf-8"?>

Se ytterligere beskrivelse her;

EPJ som har integrasjon med KJ Portal, vil også kunne benytte ny fane Prøvesvar i gammel innlogging, men kundene må bestille tjenesten  Pasientens prøvesvar for å kunne se innhold i tjenesten.

For infomasjon om hvordan kundene kan bestille tjenesten, se her

Når gammel innloggingsmetode i KJ Portal erstattes med krav til bruk av HelseID brukerpålogg, må EPJ som ikke allerede har etablert dette for f.eks Journaldokumenter, ha ny klientkonfigurasjon i HelseID Selvbetjening.

Se mere informasjon om Kjernejournal Portal her

Se mere informasjon om HelseID her

Når Pasientens prøvesvar endrer formål til utprøving med formål helsehjelp, vil pasienter som har fastleger med i utprøvingen, kunne se sine prøvesvar i Helsenorge.

De aller fleste prøvesvar vil bli gjort tilgjenglig uten noen utsettelse, mens Patologiske og Bildediagnostiske prøvesvar vil utsettes i 14 dager. I tillegg vil genetiske analyser utsettes i 90 dager.

Når PPS mottar en svarrapport sjekkes følgende;

• Er status på Svarrapporten ENDELIG eller TILLEGG?
• Finnes det PTS innstillinger satt for Svarrapporten?
• Finnes det PTS-innstillinger satt for Rekvisisjonen?
• Bergne automatisk utsatt innsyn etter fastsatte regler, 0, 14 eller 90 dager, som er forklart på nhn sine sider for Automatisk utsatt innsyn for innbyggere i Helsenorge.

Det er planlagt et statusendepunkt, hvor helsepersonell kan sjekke om det finnes nye prøvesvar i Nasjonal Kjernejournal, eller om innbygger har reservert seg mot å ha en Kjernejournal, eller Prøvesvar.

Statusendepunktet vil etableres tilsvarende som andre statusendepunkter med krav til maskin-maskin token eller HelseID brukerpålogging for autentisering, som f.eks. kristisk Info (men med annen respons)

Se eksempel på Statusendepunkt her

Endepunktet vil bli levert i løpet av 2026.

Ja, alle API'er som beskyttes av HelseID, har samme krav til dokumentasjon og kodegjennomgang fra Test til Prod.

Det er derfor viktig at alle leverandører som skal produksjonssette løsninger som har integrasjon med Prøvesvar-API, PTS-API, FoRe-API etc, følger Onboardingsguiden til HelseID, og følger overgangen til produksjonsmiljøet stegvis, som beskrevet for HelseID Selvbetjening.

Hvis dere har behov for bistand, oppgi alltid følgende for enklere å finne frem til riktig melding;

• Avsender av testmeldingen - både Dept og Inst
  • Navn og HER-ID
• Dato og klokkeslett når meldingen er sendt inn
• Meldingens-ID <MsgId>A7736D48-A03F-4AEC-94B6-0FE6CBAB5561</MsgId>
• Svarrappor-ID <ServProvId>2023a2c7-dc0c-4d17-a43a-97398f6d4004</ServProvId>
• Testpasient som er benyttet, med OffID og Navn
• Dato for når prøven er tatt/ undersøkelsen er gjennomført 
  • <CollectedDate>
• Om det er en NY, ENDRING eller KANSELLERING

Ved innsending av svarrapporter til Pasientens prøvesvar i produksjon, skal HER-ID 169762 benyttes, se Pasientens prøvesvar - Tjeneste - Adresseregisteret

Dette vil være Svarrapporter fra private og offentlige laboratorier og radiologivirksomheter, i tilleg til alle EPJ-system som sender pasientnære analyser til Pasientens prøvesvar.

Før innsending, skal dere ha sendt inn testmeldinger i Test, for å sikre at det retureneres positiv apprec, og at innsendt svarrapport er synlig i både KJ Portal og i Helsenorge.