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

I PPS 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-adresse TEST-NILAR@testedi.nhn.no

• HER-ID 8139952 i AR-TEST og edi-adresse NILAR-INTERNETT@samsvar.nhn.no

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;

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.