...
A patientId may be provided when registering a new patient in WMDA Search & Match. Upon registration, a wmdaId will be assigned and returned. The wmdaId itself is guaranteed to be globally unique, though it cannot guarantee that the same patient is not identified with another wmdaIdregistered by multiple organisations using the same patientId or with different patientId's within the same organisation. The wmdaId must be used to identify the patient in all calls to the Search, Match & Connect (SMC) service after the initial patient registration.
...
| Identifier | Description |
|---|
| patientId | - Provided by the local registry system.
- Should be worldwide unique.
- Should follow the construct of hub code + local patient id.
- The hub code should be usually are the two-character ISO country code of the registry (e.g. DE for Germany)
- In the case of multiple registries in one country, a replacement code will be assigned.
- Should be provided as a user-friendly (displayable) id for use on screens and on documentation.
|
| wmdaId | - Generated by the central (SMC) system.
- Must be globally unique.
- Must be used for all system-to-system patient identification after the initial patient registration.
- Should be displayed on screens and on documentation.
|
3.2 - Create Patient
The CreatePatientRequest createPatient endpoint is used to submit a patient to the Search & Match Service. This call returns a wmdaId for the patient.
| Send |
|---|
| CreatePatientcreatePatient |
| Expand |
|---|
| | Field | Details |
|---|
| patientId | string
maxLength: 17
nullable: true
example: XY1234POrganisation unique identifier for patient. Cannot be set unless "legalTerms" is set to "true". Do not use real names here. | | hla* | {...} | | idm | {...} | | dateOfBirth | string($date)
nullable: true
maxLength: 10
example: 1961-05-27 | | diagnosis | {...} | | diseasePhase | string
nullable: true Enum:
Array [ 48 ] | | ethnicity | string
nullable: true Enum:
Array [ 21 ] | | poolCountryCode | string
maxLength: 2
pattern: ^[A-Z]{2}
nullable: true
example: NLISO 3166-1 alpha-2 Country Code (capitalized) | | transplantCentreId | string
maxLength: 10
nullable: true
example: TC X | | abo | string
nullable: true Enum:
Array [ 4 ] | | rhesus | string
nullable: true Enum:
Array [ 2 ] | | weight | integer
nullable: true
minimum: 1
maximum: 999
example: 76 | | sex | string
nullable: true Enum:
Array [ 2 ] | | legalTerms | boolean
nullable: true
default: false
example: trueIf not set to true, then patientId will not be stored. |
|
| Expand |
|---|
| | Field | Details |
|---|
| wmdaId | integer
example: 123456
nullable: false |
|
|
3.3 - Update Patient
The UpdatePatientRequest updatePatient endpoint is used to update a patient with the Search & Match Service.
| Send |
|---|
| UpdatePatientupdatePatient |
| Expand |
|---|
| | Field | Details |
|---|
| patientId | string
maxLength: 17
nullable: true
example: XY1234POrganisation unique identifier for patient. Cannot be set unless "legalTerms" is set to "true". Do not use real names here. A patient ID can only be updated when it was not set before. | | hla* | {...} | | idm | {...} | | dateOfBirth | string($date)
nullable: true
maxLength: 10
example: 1961-05-27 | | diagnosis | {...} | | diseasePhase | string
nullable: true Enum:
Array [ 48 ] | | ethnicity | string
nullable: true Enum:
Array [ 21 ] | | poolCountryCode | string
maxLength: 2
pattern: ^[A-Z]{2}
nullable: true
example: NLISO 3166-1 alpha-2 Country Code (capitalized) | | transplantCentreId | string
maxLength: 10
nullable: true
example: TC X | | abo | string
nullable: true Enum:
Array [ 4 ] | | rhesus | string
nullable: true Enum:
Array [ 2 ] | | weight | integer
nullable: true
minimum: 1
maximum: 999
example: 76 | | sex | string
nullable: true Enum:
Array [ 2 ] | | legalTerms | boolean
nullable: true
default: false
example: trueIf not set to true, then patientId will not be stored. | | wmdaId* | integer
example: 123456
nullable: false |
|
|
3.4 - Update Patient Status
The UpdatePatientStatusRequest updatePatientStatus endpoint is used to update a patient's search status with the Search & Match Service. Allowable statuses status values are SUS, PRE, ACT and STP. A new patient is defaulted to the new (NEW) state. Under the NEW state, searches must be requested explicitly. When doing so, the patient is moved to the PRE state. Under the ACT state, searches will be kept up to date automatically. SUS will stop automatic updates to searches, but results will remain for 42 days. STP will terminate the search and delete all search results.
Image Removed
Image Added
| Send |
|---|
| UpdatePatientStatus |
| Expand |
|---|
| | Field | Details |
|---|
| wmdaId* | integer
example: 123456
nullable: false | | newStatus* | string
maxLength: 3
nullable: false Enum:
Array [ 4 ] | | changeReason | string
maxLength: 3
nullable: trueReason why the change was made. Mandatory when changing to "STP" Enum:
Array [ 21 ] |
|
| Expand |
|---|
| | Field | Details |
|---|
| wmdaId* | integer
example: 123456
nullable: false | | newStatus* | string
maxLength: 3
nullable: false Enum:
Array [ 4 ] | | changeReason | string
maxLength: 3
nullable: trueReason why the change was made. Mandatory when changing to "STP" Enum:
Array [ 21 ] |
|
|
...
...