Patient

References

Patient appears in ServiceRequest.subject references.

Snapshot

idΣ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileS Σ1..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ0..1uriFixed Value
versionΣ0..1string
codeS Σ1..1codeBindingFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemS Σ1..1uri
valueS Σ1..1string
periodS Σ I1..1Period
assignerΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ0..1uriFixed Value
versionΣ0..1string
codeS Σ1..1codeBindingFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemΣ0..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemS Σ1..1uriFixed Value
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
activeΣ ?!0..1boolean
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
textΣ0..1string
familyS Σ1..1string
givenS Σ1..1string
prefixΣ0..*string
suffixΣ0..*string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBindingFixed Value
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBindingFixed Value
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBindingFixed Value
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemΣ I1..1codeBindingFixed Value
valueΣ1..1string
useΣ ?!1..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
genderS Σ1..1codeBinding
birthDateS Σ1..1date
deceasedBooleanboolean
deceasedDateTimedateTime
id0..1string
extensionI1..1Extension(Coding)
useΣ ?!0..1codeBinding
typeΣ0..1codeBinding
textΣ0..1string
lineS Σ1..1string
cityS Σ1..1string
districtΣ0..1string
stateS Σ1..1string
postalCodeS Σ1..1string
countryS Σ1..1string
periodΣ I0..1Period
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
gender0..1codeBinding
organizationI0..1Reference(Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerI0..*Reference(Organization | Practitioner | PractitionerRole)
managingOrganizationS Σ I1..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherΣ I1..1Reference(Patient | RelatedPerson)
typeΣ1..1codeBinding

Click here for more information about the base FHIR Patient specification.

JSON structure

This is a template for the FHIR patient. See table below for values description.

{
    "resourceType": "Patient",
    "id": "{id}",
    "meta": {
        "versionId": "{versionId}",
        "lastUpdated": "{lastUpdated}",
        "profile":  [
            "http://fhir.akinox.com/r4b/StructureDefinition/Patient"
        ]
    },
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "code": "{identifierTypePci}"
                    }
                ]
            },
            "value": "{identifierValuePci}"
        },
        {
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                        "code": "{identifierTypeJhn}"
                    }
                ]
            },
            "system": "urn:oid:2.16.124.10.101.1.60.100",
            "value": "{identifierValueJhn}",
            "period": {
                "end": "{identifierExpirationDateJhn}"
            }
        }
    ],
    "active": true,
    "name":  [
        {
            "family": "{lastName}",
            "given":  [
                "{firstName}"
            ]
        }
    ],
    "telecom":  [
        {
            "system": "phone",
            "value": "{phone}"
        },
        {
            "system": "email",
            "value": "{email}"
        }
    ],
    "gender": "{gender}",
    "birthDate": "{birthDate}",
    "address":  [
        {
            "extension":  [
                {
                    "url": "http://akinox.com/fhir/StructureDefinition/ext-address-quebec-msss-rts",
                    "valueCoding": {
                        "coding":  [
                            {
                                "system": "http://akinox.com/fhir/ValueSet/address-quebec-msss-rts",
                                "code": "{rtsCode}",
                                "display": "{rtsDisplay}"
                            }
                        ]
                    }
                }
            ],
            "use": "home",
            "line":  [
                "{address}"
            ],
            "city": "{city}",
            "state": "{provinceCode}",
            "postalCode": "{postalCode}",
            "country": "{countryCode}"
        }
    ],
    "generalPractitioner": {
        "reference": "{generalPractitioner}"
    },
    "managingOrganization": {
        "reference": "{managingOrganization}"
    }
}

Description of the values

Property Description
{id} This is the logical identifier. It is a GUID.
{versionId} The version number of the patient. This version number is incremented by Akinox system outside of changes done trought this API.
{lastUpdatedDate} The last updated date of the patient
{identifierTypePci} Identifier type of the Patient is a fixed value. (i.e. PCI, Patient Composed Identifier)
{identifierValuePci} A concatenation of the Provincial Health Insurance Number of the patient Website: https://www.ramq.gouv.qc.ca/en/citizens/health-insurance, the last name, the first name, the gender and the birthdate. All separated by the semicolon character (';'). (e.g. SIMB12101881;Simpson;Bart;Male;2012-10-18). All element of the composed key must equal their corresponding attribute.
{identifierTypeJhn} Identifier type for the Patient is a fixed value. (i.e. JHN, Jurisdictional health number)
{identifierValueJhn} The Provincial Health Insurance Number of the patient Website: https://www.ramq.gouv.qc.ca/en/citizens/health-insurance
{identifierExpirationDate} The expiration date of the Health Insurance Number card of the patient
{lastName} The last name of the patient
{firstName} The first name of the patient Only the first element of the given property is considered
{phone} The phone of the patient
{email} The email of the patient
{gender} The gender of the patient.
{birthDate} Birthdate of the patient.
{rtsCode} The patient's territorial service area code, calculatted from his postal code (Réseaux territoriaux de services de santé et de services sociaux (RTS).
{rtsDisplay} The patient's RTS human readable display.
{address} The street number and name of the patient.
{city} The city name of the patient.
{provinceCode} The canadian province code of the patient.
{postalCode} The postal code of the patient.
{countryCode} The country code of the patient.
{generalPractitioner} The patient's assigned family doctor.
{managingOrganization} The organization managing the patient. This reference cannot be updated after entity creation

Notes on typical FHIR errors

  • See here for further information regarding the types of identifier.
  • If you remove the meta.profile, there will be an error on the FHIR validation.

Search Parameters

Name Description
identifier:of-type The :of-type modifier demands a search parameter with the format system|code|value, where the system and code refer to a Identifier.type.coding.system and .code, and match if any of the type codes match. All 3 parts must be present. In our case we have to two codes we can use either the PCI or the JHN. See FHIR documentation for more details on search parameter modifiers.

See search examples