...
| Datum | Version | Namn | Förändring |
|---|---|---|---|
| 2.0 | Nya svarskoder från och med version 4.3 | |
| 2.1 | Uppdaterat rubrik. | |
| 2.2 | Tagit bort felaktigt fält i felmeddelanden. | |
| 23.30 | Anpassad för extern publicering. |
...
Se även Best practice i regel 11, RIVTA "Best-practice för felhantering".
Gemensamt för alla interaktioner
Felmeddelanden
Enligt ws Basic Profile v1.1 returneras alla Soap faults med en HTTP 500 error status.
När en användare inte är behörig att anropa tjänsten returneras ett soap:Fault med följande felmeddelande;
Obehörigt anrop för system <systemHsaID>.
Läsande interaktioner
Samtliga läsande interaktioner returnerar en beskrivande text som svar när ett fel uppstår.
Soap svar:
| Kodblock | ||
|---|---|---|
| ||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Client</faultcode>
<faultstring>Beskrivande felmeddelande</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope> |
Felmeddelanden per läsande kontrakt
Vid kända fel returneras ett soap:Fault med faultcode soap:Client samt faultstring med beskrivande felmeddelande enligt följande tabell.
...
| Kodblock | ||
|---|---|---|
| ||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Internt systemfel</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope> |
Skrivande interaktioner
När en skrivande interaktion går fel på grund av ett okänt fel så returneras ett soap:Fault enligt föregående exempel.
...
Samtliga meddelanden från kända fel returneras i returtypen result.resultText.
Generella fel för alla skrivande interaktioner
Skulle ett anrop mot något av de uppdaterande kontrakten som tar emot en identitet få en felaktig identitet där root inte stämmer överens med formatet på extension returneras följande meddelande:
Personidentiteten är angiven på ogiltigt format.
...
När ett värde inte följer specifikationen för given typ:
Värdet för parameter use är inte giltigt. (Där use är ett enum för exempelvis kontaktuppgifter)
Eller mer utförligt med beskrivning av specifikationen:
contactInformation.period -> Minst en av parametrarna start och end måste ha ett värde i formatet YYYY-MM-DD.
LinkPersonIdentity
| Info | ||
|---|---|---|
| ||
Som stöd vid implementering av interaktioner kring identitetskopplingar har ett nationellt ramverk tagits fram utifrån rutinerna för uttag och hantering av reservidentiteter i ett antal olika antal landsting och regioner. Detta återfinns under Personuppgiftstjänstens sidor för Dokument: https://www.inera.se/personuppgiftstjansten/dokument. Även de filmer som visar tjänstens administrationsgränssnitt i FAQn kan vara till hjälp i arbetet. |
...
Koppla ett lokalt id till ett nationellt id:
Valideringsfel, koppling måste följa hierarkin LRID → NRID → SNR → PNR.
UnlinkPersonIdentity
| Info | ||
|---|---|---|
| ||
Som stöd vid implementering av interaktioner kring identitetskopplingar har ett nationellt ramverk tagits fram utifrån rutinerna för uttag och hantering av reservidentiteter i ett antal olika antal landsting och regioner. Detta återfinns under Personuppgiftstjänstens sidor för Dokument: https://www.inera.se/personuppgiftstjansten/dokument. Även de filmer som visar tjänstens administrationsgränssnitt i FAQn kan vara till hjälp i arbetet. |
...
Koppla isär en identitet med personnummer/samordningsnummer:
Valideringsfel, isärkoppling mellan personnummer och samordningsnummer är ej tillåtet.
UpdatePersonContactInformation
Meddelande vid försök att sätta optoutPaperNotification till sant när det inte finns en contactInformation som har digitalNotification satt till sant.
Det måste finnas en kontaktinformation som kan ta emot de digital aviseringarna.
...