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.
meta.versionId The version number of the patient. This version number is incremented by Akinox system outside of changes done trought this API.
meta.lastUpdated The last updated date of the patient
identifier.type PCI : Identifier type of the Patient is a fixed value. (i.e. PCI, Patient Composed Identifier)
identifier.value PCI : 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.
identifier.type JHN : Identifier type for the Patient is a fixed value. (i.e. JHN, Jurisdictional health number)
identifier.value JHN: The Provincial Health Insurance Number of the patient Website: https://www.ramq.gouv.qc.ca/en/citizens/health-insurance
identifier.period.end The expiration date of the Health Insurance Number card of the patient
name.family The last name of the patient
name.given The first name of the patient Only the first element of the given property is considered
telecom phone : The phone of the patient
telecom email: The email of the patient
gender The gender of the patient.
birthDate Birthdate of the patient.
address.extension ext-address-quebec-msss-rts : The patient's territorial service area code, calculatted from his postal code (Réseaux territoriaux de services de santé et de services sociaux (RTS).
address.extension.code.display The patient's RTS human readable display.
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