Indholdsfortegnelse:
Beskrivelse
ReservePersonId kan benyttes hvis man ønsker at danne en liste af reserverede X-eCPR-numre til brug i offline-scenarier. Skal et eller flere X-eCPR-numre anvendes til umiddelbart brug for personer, der allerede er kendt ved oprettelsen anvendes i stedet CreatePerson. Når et X-eCPR-nummer på denne liste er taget i brug skal servicen UpdatePerson anvendes til at supplere med personinformation, id’er m.v.
I requestet angives en eller flere List-strukturer, som angiver hvilke typer eCPR, der ønskes dannet. I en list-struktur kan angives en række parametre til beregning og administration af de reserverede X-eCPR-numre.
Der returneres et antal lister med X-eCPR-numre svarende til forespørgslen.
Bemærk at elementet Modified indeholder ReservedUntil, der angiver at X-eCPR-numrene er reserveret frem til dette tidspunkt. Hvis numrene tages i anvendelse, skal personregistreringerne opdateres inden den angivne dato, ellers bliver numrene slettet fra Nationalt eCPR, og kan i teorien blive brugt til nye personregistreringer i andre organisationer.
Parameter | Beskrivelse | |
---|---|---|
OID | Angiver hvilken type Identifier der ønskes oprettet. OBS! Skal være X-eCPR. | Obligatorisk |
Number | Angiver hvor mange X-eCPR-numre der ønskes returneret. Max antal er 100 pr. kald og 100 pr. organisation pr. dag. Angives elementet ikke returneres 1 X-eCPR-nummer. | Optionelt |
Gender | Angiver til hvilket køn der ønskes X-eCPR-numre. Angives elementet ikke, returneres så vidt muligt lige mange til hvert køn. | Optionelt |
ForDate | Angiver hvorvidt X-eCPR-numrene skal afspejle en bestemt dato i de første 6 cifre. Angives elementet ikke, vælger servicen tilfældigt datoer mellem dags dato og frem til udløbsdatoen (ReservedUntil). | Optionelt |
ReservedUntil | Angiver fra hvilken dato X-eCPR-numrene ikke længere er reserverede. Er servicen eCPR - UpdatePerson ikke kaldt inden denne dato, for at opdatere et X-eCPR med stamdata, slettes denne personregistrering inkl. X-eCPR-nummer, og X-eCPR-nummeret kan principielt anvendes senere til en anden personregistrering. Servicen garanterer ikke at personregistreringen slettes præcist på dette tidspunkt, men det forventes at ske inden for et døgn efter. For at sikre, at der undgås unødigt mange reserverede personregistreringer, som aldrig kommer i brug, og som dermed vil medføre at anvendeligheden af Nationalt eCPR forringes, kan ReservedUntil højst være 2 år frem i tiden. Angives ReservedUntil ikke vælges tidspunktet for kaldet + 48 timer. | Optionelt |
Modified | Angiver hvilken organisation X-eCPR-numrene reserveres til. Det registreres også hvem der har foretaget handlingen (By), men det er den angivne organisation der har reserveret numrene, og som kan opdatere eller frigive dem på et senere tidspunkt. | Obligatorisk |
Forespørgsel
Request-eksempel (simplificeret):
<ReservePersonIdRequest> <List> <OID>1.2.208.176.1.6.1.1</OID> <Number>2</Number> <Gender>male</Gender> <ForDate>2018-05-08</ForDate> <ReservedUntil>2018-09-15T00:00:00+02:00</ReservedUntil> </List> <List> <OID>1.2.208.176.1.6.1.1</OID> <Number>3</Number> <Gender>female</Gender> <ForDate>2018-05-08</ForDate> <ReservedUntil>2018-09-15T00:00:00+02:00</ReservedUntil> </List> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> </Modified> </ReservePersonIdRequest>
Svar
Response-eksempel (simplificeret):
<ReservePersonIdResponse> <List> <Person> <Identifier> <PID>a2280f64-138b-4e62-b5b7-84497c74e9ff</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187WO3</Value> <Validity>16</Validity> </Identifier> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>95d5b22a-c070-4295-bd77-28e1ae0c7610</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>male</Value> </Gender> </Person> <Person> <Identifier> <PID>2737a84c-2106-4c1d-86ad-94059eabc55c</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187VX5</Value> <Validity>16</Validity> </Identifier> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>585b65fa-acf5-4396-b3de-aaafc57b1eeb</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>male</Value> </Gender> </Person> </List> <List> <Person> <Identifier> <PID>32d9f1ce-62f6-4626-982a-aa8dbcb332d7</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187HX0</Value> <Validity>16</Validity> </Identifier> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>79df2bdb-c86a-43d1-957f-a7c476592435</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> <Person> <Identifier> <PID>9b23d786-6551-4e8a-b50b-ed0444aed39d</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187SY0</Value> <Validity>16</Validity> </Identifier> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>5451486b-036b-43d5-8334-3caf422261d6</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> <Person> <Identifier> <PID>7131fcaf-beb9-423c-ab84-e8118d9b7277</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187XC0</Value> <Validity>16</Validity> </Identifier> <Modified> <By> <Person> <AuthorisationIdentifier>AB01C</AuthorisationIdentifier> <Name>Jens Jensen</Name> <PersonIdentifier>1234567890</PersonIdentifier> </Person> <Role>Læge</Role> <Organisation> <Name>Andeby hospital</Name> <Type>Hospital</Type> <Identifier> <Identifier>1234123412</Identifier> <Source>SOR</Source> </Identifier> </Organisation> </By> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>687429ed-6945-40ce-bbe9-e501cffbbf30</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> </List> </ReservePersonIdResponse>
Ændringslog
1.0 | 2023-11-08 | Indhold publiceret | SDS |