Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

SendRetrieve
addressRequest
Expand
titleRequest...
Field

Details

organisationId*

string
nullable: false

maxLength: 10
minLength: 3

Organisation unique identifier for the institution.

  1. Unique reference to an institution
  2. Allows local address management if needed (e.g. for other use cases) by receiving registry and backward compatibility to existing EMDIS implementations. 
  • Provided by the local registry system.  
  • Should be worldwide unique.
    • Should follow the construct of hub code + local address id. 
      • The hub code usually are the two-character ISO country code of the registry (e.g. NL for Netherlands)  
      • 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.
line1*

string
nullable: false

maxLength: 60

Address line 1

line2

string
nullable: true

maxLength: 60

Address line 2

line3

string
nullable: true

maxLength: 60

Address line 3

postalCode*

string
nullable: false

maxLength: 10

city*

string
nullable: false

maxLength: 40

country*

string
nullable: false

minLength: 2

maxLength: 2

2 character ISO country code ( ISO 3166-1 alpha-2)
type*

string
nullable: false

minLength: 3

maxLength: 3

HUB = EMDIS Hub
DON = Donor centre
TRA = Transplant centre
HAR = Harvesting centre
LAB = Typing laboratory
FIN = Financial institution
CBB = Cord Blood Bank

contactPerson

string
nullable: true

maxLength: 40

Contact person. Required if type = LAB.

phone*

string
nullable: false

maxLength: 20

fax

string
nullable: true

maxLength: 20

email

string
nullable: true

maxLength: 60

receivingRegistry*string
maximum: 9999

minimum: 0

maxLength: 4

minLength: 4

example: 1234

4 digit ION of the receiving registry

Expand
titleResponse...
FieldDetails
wmdaResponseEmbedded WMDA Response Block
Expand
titleRequest...
limitinteger
default: 100

shouldPeekboolean
default: false

Set to true if you want messages to remain available after retrieval

Expand
titleResponse...
FieldDetails
originalMessage{...}
metaInformationEmbedded Meta Block

Consider to use address block structure according to HL7-FHIR standard with extensions (https://hapifhir.io/hapi-fhir/apidocs/hapi-fhir-structures-r4/org/hl7/fhir/r4/model/Address.html), e.g.

...

Suggested format

...

Suggested field

...

Description

...

Mapping to NEW_ADD

...

StringType

...

City

...

The name of the city, town, suburb, village or other community or delivery center.

...

City Req 40

...

StringType

...

country

...

Country - a nation as commonly understood or generally accepted.

...

Country Req 2

...

StringType

...

District

...

The name of the administrative area (county).

...

Address Line 2 ADDR_2 Opt 40

...

List <StringType>

...

line

...

This component contains the house number, apartment number, street name, street direction, and P.O.

...

Address Line 3 ADDR_3 Opt 40

...

Period

...

period

...

The time period when the address was/is in use.

...

new - Opt

...

StringType

...

postalCode

...

A postal code designating a region defined by the postal service.

...

ZIP code ZIP Req 10

...

StringType

...

state

...

Sub-unit of a country with limited sovereignty in a federally organized country.

...

new - Opt

...

StringType

...

text

...

Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts.

...

Address Line 1 to Address Line 3, City, Country, Zip code - Opt

...

Enumeration <Address.AddressType>

...

type

...

Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses. Most addresses are both.). This is the underlying object with id, value, and extensions. The accessor "getType" gives direct access to the value.

...

new - Req

...

Enumeration <Address.AddressUse>

...

use

...

The purpose of this address.

...

Institution Type INST_TYPE Req 3

...

StringType

...

contact person

...

The name of the contact person.

...

Contact person PERSON Opt 40

...

StringType

...

phone

...

The value is a telephone number used for voice calls.

...

Phone Number PHONE Req 20

...

StringType

...

fax

...

The value is a fax machine.

...

Fax Number FAX Opt 20

...

StringType

...

email

...

The value is an email address.

...

Email address EMAIL Opt 60

...

StringType

...

ID

...

Organisation unique identifier for the institution.

  1. Unique reference to an institution
  2. Allows local address management if needed (e.g. for other use cases) by receiving registry and backward compatibility to existing EMDIS implementations. 
  • Provided by the local registry system.  
  • Should be worldwide unique.
    • Should follow the construct of hub code + local address id. 
      • The hub code usually are the two-character ISO country code of the registry (e.g. NL for Netherlands)  
      • 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.

Not needed anymore, as the full address will be sent embedded in every request.

...

INST_ID Req 10

...

Obsolete. S&M provides accreditation on the match list.

...

Accreditation Opt 5


6.1.3 Embedded Patient Block

...