General considerations:

• A

  register_

  patient

  message

  registration embedded block will be sent together with

  all requests

  each request. This

  message

  block contains both wmdaId and patientId of the patient.

/post_api_v1_PatientRegistration3 - Patient Administration#3PatientAdministration-3.8-RegisterPatient

• Provision of the donor ID in every request must be changed.

...

In order to couple messages to the same request, e.g. VT request (SMP_REQ) and its results (SMP_RES) all messages following a request will must have a referenceCode as part of the message.

The message ID (correlationGUID) of the request message (ETTYP_REQ, IDM_REQ, VTSMP_REQ, RESRSV_REQ, etc...) will be used as 'referenceCode' for the rest of the request related message flow.

...

The following messages are linked to the donor updates:

1. SampleResponseRequest (SMP_RES)
2. InfectiosDiseaseMarkerResultRequest InfectiousDiseaseMarkerResultRequest (IDM_RES)
3. TypingResponseRequest (TYP_RES)
4. NoResultRequest (NO_RES)
5. ReservationResultRequest (RSV_RES)

These donor updates are for the recieving receiving registry (patient registry) only and will not be updated in the central HUB. So the sending registry is responsible to send and a DIFF upload to the S&M system in parallel to keep information in sync.

5.0 - DONOR_CB message

It was agreed that we must implement DONOR_CB message API to preserve the original EMDIS logic. 

S&M APIs have the DONOR_CB message split into Details of the meta block see in 

https://apispecs.wmda.info/?urls.primaryName=Search%20%26%20Match#/searches/retrieveFullReportDonors

...

In the future another message for ADCUs may come to play.

Proposal: change the Semantics by requesting an "updated donor" message instead of DONOR_CB.

...

for ADCUs may come to play.

• Here is the comparison of the DONOR_CB and the API endpoints: EMDIS vs API.xlsx

...

The field ACC_DAYS is a binary field with position 1 corresponding to Monday and position 7 corresponding to Sunday. A set bit means acceptable day, an unset bit means not acceptable day. For example, 1110000 means acceptable days for reception are Monday, Tuesday and Wednesday, not acceptable days are Thursday, Friday, Saturday and Sunday. The default value is 1111100 (accept all working days).The address INST_SMP_SENT must not be a P.O. box, since couriers often need a signature upon delivery. Should be part of the addressBlock definition

The quantity for the first product is optional when requesting DNA from a cord blood unit. In all other requests, the quantity fields for any of the corresponding product fields are required if a product is requested.

...