This page is part of the Consumer Real-time Pharmacy Benefit Check (v0.1.0: STU 1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions
SD.2 StructureDefinition-carin-rtpbc-patient
This profile constrains the Patient resource for carrying the limited patient information required in the consumer real-time pharmacy benefit check (RTPBC) process. In RTPBC, the sole purpose of patient information is to enable the responding payer/PBM to locate the patient’s insurance information. From there, pricing and coverage information is determined based on the patient’s member and coverage information maintained by the payer.
The function of the Patient resource in this exchange is limited to conveying identifying information needed for the responder to locate its own records related to the patient. This limited set of information consists of the patient’s…
- given and family name
- gender
- date of birth
- address
Must Support elements in this profile
Client and Responding systems
All of the elements identified above are marked Must Support though not all will be required in a given implementation (the address composite itself and each element within have a minimum cardinality of 0, to support differing patient lookup approaches).
The appropriate cardinality for address elements is to be determined by implementers.
SD.2.1 Formal Views of Profile Content
Description of Profiles, Differentials, and Snapshots.
The official URL for this profile is: http://hl7.org/fhir/us/carin/StructureDefinition/rtpbc-patient
Published on Sun Dec 08 05:00:00 UTC 2019 as a active by CARIN Alliance.
This profile builds on Patient
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Patient | 0..* | Patient | ||
name | S | 1..1 | HumanName | |
family | S | 1..1 | string | Patient family name |
given | S | 1..* | string | Patient given name(s) |
gender | S | 1..1 | code | Patient gender Binding: AdministrativeGender (required) |
birthDate | S | 1..1 | date | Patient birth date |
address | S | 0..1 | Address | Patient address |
line | S | 0..* | string | |
city | S | 0..1 | string | |
state | S | 0..1 | string | Binding: CARIN RTPBC Two Letter State and Province Code Value Set (extensible) |
postalCode | S | 0..1 | string | |
country | S | 0..1 | string | Binding: CARIN RTPBC Pharmacy Type Value Setf (extensible) |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Patient | I | 0..* | Patient | Information about an individual or animal receiving health care services |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | ΣI | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!ΣI | 0..1 | uri | A set of rules under which this content was created |
language | I | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!I | 0..* | Extension | Extensions that cannot be ignored |
identifier | ΣI | 0..* | Identifier | An identifier for this patient |
active | ?!ΣI | 0..1 | boolean | Whether this patient's record is in active use |
name | SΣI | 1..1 | HumanName | A name associated with the patient |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
use | ?!ΣI | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required) |
text | ΣI | 0..1 | string | Text representation of the full name |
family | SΣI | 1..1 | string | Patient family name |
given | SΣI | 1..* | string | Patient given name(s) This repeating element order: Given Names appear in the correct order for presenting the name |
prefix | ΣI | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name |
suffix | ΣI | 0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name |
period | ΣI | 0..1 | Period | Time period when name was/is in use |
telecom | ΣI | 0..* | ContactPoint | A contact detail for the individual |
gender | SΣI | 1..1 | code | Patient gender Binding: AdministrativeGender (required) |
birthDate | SΣI | 1..1 | date | Patient birth date |
deceased[x] | ?!ΣI | 0..1 | Indicates if the individual is deceased or not | |
deceasedBoolean | boolean | |||
deceasedDateTime | dateTime | |||
address | SΣI | 0..1 | Address | Patient address |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
use | ?!ΣI | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required) Example General: home |
type | ΣI | 0..1 | code | postal | physical | both Binding: AddressType (required) Example General: both |
text | ΣI | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132 |
line | SΣI | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street |
city | SΣI | 0..1 | string | Name of city, town etc. Example General: Erewhon |
district | ΣI | 0..1 | string | District name (aka county) Example General: Madison |
state | SΣI | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: CARIN RTPBC Two Letter State and Province Code Value Set (extensible) |
postalCode | SΣI | 0..1 | string | Postal code for area Example General: 9132 |
country | SΣI | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) Binding: CARIN RTPBC Pharmacy Type Value Setf (extensible) |
period | ΣI | 0..1 | Period | Time period when address was/is in use Example General: {"start":"2010-03-23T00:00:00+00:00","end":"2010-07-01T00:00:00+00:00"} |
maritalStatus | I | 0..1 | CodeableConcept | Marital (civil) status of a patient Binding: Marital Status Codes (extensible) |
multipleBirth[x] | I | 0..1 | Whether patient is part of a multiple birth | |
multipleBirthBoolean | boolean | |||
multipleBirthInteger | integer | |||
photo | I | 0..* | Attachment | Image of the patient |
contact | I | 0..* | BackboneElement | A contact party (e.g. guardian, partner, friend) for the patient pat-1: SHALL at least contain a contact's details or a reference to an organization |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
relationship | I | 0..* | CodeableConcept | The kind of relationship Binding: PatientContactRelationship (extensible) |
name | I | 0..1 | HumanName | A name associated with the contact person |
telecom | I | 0..* | ContactPoint | A contact detail for the person |
address | I | 0..1 | Address | Address for the contact person |
gender | I | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required) |
organization | I | 0..1 | Reference(Organization) | Organization that is associated with the contact |
period | I | 0..1 | Period | The period during which this contact person or organization is valid to be contacted relating to this patient |
communication | I | 0..* | BackboneElement | A language which may be used to communicate with the patient about his or her health |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
language | I | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
preferred | I | 0..1 | boolean | Language preference indicator |
generalPractitioner | I | 0..* | Reference(Organization | Practitioner | PractitionerRole) | Patient's nominated primary care provider |
managingOrganization | ΣI | 0..1 | Reference(Organization) | Organization that is the custodian of the patient record |
link | ?!ΣI | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
other | ΣI | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to |
type | ΣI | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required) |
Documentation for this format |
Differential View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Patient | 0..* | Patient | ||
name | S | 1..1 | HumanName | |
family | S | 1..1 | string | Patient family name |
given | S | 1..* | string | Patient given name(s) |
gender | S | 1..1 | code | Patient gender Binding: AdministrativeGender (required) |
birthDate | S | 1..1 | date | Patient birth date |
address | S | 0..1 | Address | Patient address |
line | S | 0..* | string | |
city | S | 0..1 | string | |
state | S | 0..1 | string | Binding: CARIN RTPBC Two Letter State and Province Code Value Set (extensible) |
postalCode | S | 0..1 | string | |
country | S | 0..1 | string | Binding: CARIN RTPBC Pharmacy Type Value Setf (extensible) |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Patient | I | 0..* | Patient | Information about an individual or animal receiving health care services |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | ΣI | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!ΣI | 0..1 | uri | A set of rules under which this content was created |
language | I | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!I | 0..* | Extension | Extensions that cannot be ignored |
identifier | ΣI | 0..* | Identifier | An identifier for this patient |
active | ?!ΣI | 0..1 | boolean | Whether this patient's record is in active use |
name | SΣI | 1..1 | HumanName | A name associated with the patient |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
use | ?!ΣI | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required) |
text | ΣI | 0..1 | string | Text representation of the full name |
family | SΣI | 1..1 | string | Patient family name |
given | SΣI | 1..* | string | Patient given name(s) This repeating element order: Given Names appear in the correct order for presenting the name |
prefix | ΣI | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name |
suffix | ΣI | 0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name |
period | ΣI | 0..1 | Period | Time period when name was/is in use |
telecom | ΣI | 0..* | ContactPoint | A contact detail for the individual |
gender | SΣI | 1..1 | code | Patient gender Binding: AdministrativeGender (required) |
birthDate | SΣI | 1..1 | date | Patient birth date |
deceased[x] | ?!ΣI | 0..1 | Indicates if the individual is deceased or not | |
deceasedBoolean | boolean | |||
deceasedDateTime | dateTime | |||
address | SΣI | 0..1 | Address | Patient address |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
use | ?!ΣI | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required) Example General: home |
type | ΣI | 0..1 | code | postal | physical | both Binding: AddressType (required) Example General: both |
text | ΣI | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132 |
line | SΣI | 0..* | string | Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street |
city | SΣI | 0..1 | string | Name of city, town etc. Example General: Erewhon |
district | ΣI | 0..1 | string | District name (aka county) Example General: Madison |
state | SΣI | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: CARIN RTPBC Two Letter State and Province Code Value Set (extensible) |
postalCode | SΣI | 0..1 | string | Postal code for area Example General: 9132 |
country | SΣI | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) Binding: CARIN RTPBC Pharmacy Type Value Setf (extensible) |
period | ΣI | 0..1 | Period | Time period when address was/is in use Example General: {"start":"2010-03-23T00:00:00+00:00","end":"2010-07-01T00:00:00+00:00"} |
maritalStatus | I | 0..1 | CodeableConcept | Marital (civil) status of a patient Binding: Marital Status Codes (extensible) |
multipleBirth[x] | I | 0..1 | Whether patient is part of a multiple birth | |
multipleBirthBoolean | boolean | |||
multipleBirthInteger | integer | |||
photo | I | 0..* | Attachment | Image of the patient |
contact | I | 0..* | BackboneElement | A contact party (e.g. guardian, partner, friend) for the patient pat-1: SHALL at least contain a contact's details or a reference to an organization |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
relationship | I | 0..* | CodeableConcept | The kind of relationship Binding: PatientContactRelationship (extensible) |
name | I | 0..1 | HumanName | A name associated with the contact person |
telecom | I | 0..* | ContactPoint | A contact detail for the person |
address | I | 0..1 | Address | Address for the contact person |
gender | I | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required) |
organization | I | 0..1 | Reference(Organization) | Organization that is associated with the contact |
period | I | 0..1 | Period | The period during which this contact person or organization is valid to be contacted relating to this patient |
communication | I | 0..* | BackboneElement | A language which may be used to communicate with the patient about his or her health |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
language | I | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
preferred | I | 0..1 | boolean | Language preference indicator |
generalPractitioner | I | 0..* | Reference(Organization | Practitioner | PractitionerRole) | Patient's nominated primary care provider |
managingOrganization | ΣI | 0..1 | Reference(Organization) | Organization that is the custodian of the patient record |
link | ?!ΣI | 0..* | BackboneElement | Link to another patient resource that concerns the same actual person |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
other | ΣI | 1..1 | Reference(Patient | RelatedPerson) | The other patient or related person resource that the link refers to |
type | ΣI | 1..1 | code | replaced-by | replaces | refer | seealso Binding: LinkType (required) |
Documentation for this format |
Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron