Data Exchange For Quality Measures Implementation Guide: STU1 Ballot 1 (for FHIR 3.0.1)

This page is part of the Da Vinci Data Exchange for Quality Measures (DEQM) FHIR IG (v0.1.0: STU 1 Ballot 1) based on FHIR R3. The current version which supercedes this version is 3.1.0. For a full list of available versions, see the Directory of published versions

StructureDefinition-organization-deqm

source file: source/pages/_includes/organization-deqm-intro.md

The DEQM Organization Profile defines the constraints for representing the organization for which the practitioner was working when he performed the measure to which he is attesting.

Mandatory Data Elements and Terminology

The following data-elements are mandatory (i.e data MUST be present).

Each Organization must have:

  1. Either an NPI or EIN (TIN) identifier

Additional Profile specific implementation guidance:

None

Examples

Formal Views of Profile Content

Description of Profiles, Differentials, and Snapshots.

The official URL for this profile is: http://hl7.org/fhir/us/davinci-deqm/STU3/StructureDefinition/organization-deqm

Published on Tue Jun 19 00:00:00 AEST 2018 as a active by Da Vinci Project.

This profile builds on QICore-Organization


Summary

Mandatory: 4 elements
Must-Support: 7 elements
Fixed Value: 2 elements

Slices

This structure defines the following Slices:

  • The element Organization.identifier is sliced based on the value of value:system
  • The element Organization.identifier.system is sliced based on the value of value:@this
NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*
... identifier SIIdentifierSlice: Unordered, Open by value:system
dv-1: If present, `Identifier.type` SHALL be 'PRN' when `Identifier.system` = 'http://hl7.org/fhir/sid/us-npi' and 'TAX' when `Identifier.system` = 'http://hl7.org/fhir/us/davinci-deqm/STU3/sid/us-tin'.
... identifier S1..1Identifier
.... type S0..1CodeableConceptBinding: DEQM Organization Type Value Set (required)
.... system SuriSlice: Unordered, Open by value:@this
.... system S1..1uriNational Provider Identifier (NPI)
Fixed Value: http://hl7.org/fhir/sid/us-npi
.... system S1..1uriU.S. IRS Assigned Employer Identification Number EIN (TIN)
Fixed Value: urn:oid:2.16.840.1.113883.4.4
.... value S0..1string

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*US Core Organization Profile
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣIIdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
dv-1: If present, `Identifier.type` SHALL be 'PRN' when `Identifier.system` = 'http://hl7.org/fhir/sid/us-npi' and 'TAX' when `Identifier.system` = 'http://hl7.org/fhir/us/davinci-deqm/STU3/sid/us-tin'.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required)
.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible)
.... system SΣ1..1uriThe namespace for the identifier value
Example General': http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... value Σ0..1stringThe value that is unique
Example General': 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... identifier SΣI1..1IdentifierIdentifies this organization across multiple systems
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required)
.... type SΣ0..1CodeableConceptDescription of identifier
Binding: DEQM Organization Type Value Set (required)
.... system SΣuriThe namespace for the identifier value
Slice: Unordered, Open by value:@this
Example General': http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... system SΣ1..1uriNational Provider Identifier (NPI)
Fixed Value: http://hl7.org/fhir/sid/us-npi
.... system SΣ1..1uriU.S. IRS Assigned Employer Identification Number EIN (TIN)
Fixed Value: urn:oid:2.16.840.1.113883.4.4
.... value SΣ0..1stringThe value that is unique
Example General': 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... active ?!SΣ1..1booleanWhether the organization's record is still in active use
... type SΣ0..*CodeableConceptKind of organization
Binding: OrganizationType (example)
... name SΣI1..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom SI1..*ContactPointA contact detail for the organization
... address SI1..*AddressAn address for the organization
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codehome | work | temp | old - purpose of this address
Binding: AddressUse (required)
Example General': home
.... type Σ0..1codepostal | physical | both
Binding: AddressType (required)
Example General': both
.... text Σ0..1stringText representation of the address
Example General': 137 Nowhere Street, Erewhon 9132
.... line SΣ0..*stringStreet 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Σ0..1stringName of city, town etc.
Example General': Erewhon
.... district Σ0..1stringDistrict name (aka county)
Example General': Madison
.... state SΣ0..1stringSub-unit of country (abbreviations ok)
Binding: USPS Two Letter Alphabetic Codes (required)
.... postalCode SΣ0..1stringUS Zip Codes
Example General': 9132
.... country Σ0..1stringCountry (e.g. can be ISO 3166 2 or 3 letter code)
.... period Σ0..1PeriodTime period when address was/is in use
Example General': {"start":"2010-03-22T23:00:00+10:00","end":"2010-07-01T00:00:00+10:00"}
... partOf Σ0..1Reference(QICore-Organization)The organization of which this organization forms a part
... contact I0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint S0..*Reference(Endpoint)Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Summary

Mandatory: 4 elements
Must-Support: 7 elements
Fixed Value: 2 elements

Slices

This structure defines the following Slices:

  • The element Organization.identifier is sliced based on the value of value:system
  • The element Organization.identifier.system is sliced based on the value of value:@this

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*
... identifier SIIdentifierSlice: Unordered, Open by value:system
dv-1: If present, `Identifier.type` SHALL be 'PRN' when `Identifier.system` = 'http://hl7.org/fhir/sid/us-npi' and 'TAX' when `Identifier.system` = 'http://hl7.org/fhir/us/davinci-deqm/STU3/sid/us-tin'.
... identifier S1..1Identifier
.... type S0..1CodeableConceptBinding: DEQM Organization Type Value Set (required)
.... system SuriSlice: Unordered, Open by value:@this
.... system S1..1uriNational Provider Identifier (NPI)
Fixed Value: http://hl7.org/fhir/sid/us-npi
.... system S1..1uriU.S. IRS Assigned Employer Identification Number EIN (TIN)
Fixed Value: urn:oid:2.16.840.1.113883.4.4
.... value S0..1string

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*US Core Organization Profile
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣIIdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
dv-1: If present, `Identifier.type` SHALL be 'PRN' when `Identifier.system` = 'http://hl7.org/fhir/sid/us-npi' and 'TAX' when `Identifier.system` = 'http://hl7.org/fhir/us/davinci-deqm/STU3/sid/us-tin'.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required)
.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible)
.... system SΣ1..1uriThe namespace for the identifier value
Example General': http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... value Σ0..1stringThe value that is unique
Example General': 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... identifier SΣI1..1IdentifierIdentifies this organization across multiple systems
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required)
.... type SΣ0..1CodeableConceptDescription of identifier
Binding: DEQM Organization Type Value Set (required)
.... system SΣuriThe namespace for the identifier value
Slice: Unordered, Open by value:@this
Example General': http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... system SΣ1..1uriNational Provider Identifier (NPI)
Fixed Value: http://hl7.org/fhir/sid/us-npi
.... system SΣ1..1uriU.S. IRS Assigned Employer Identification Number EIN (TIN)
Fixed Value: urn:oid:2.16.840.1.113883.4.4
.... value SΣ0..1stringThe value that is unique
Example General': 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... active ?!SΣ1..1booleanWhether the organization's record is still in active use
... type SΣ0..*CodeableConceptKind of organization
Binding: OrganizationType (example)
... name SΣI1..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom SI1..*ContactPointA contact detail for the organization
... address SI1..*AddressAn address for the organization
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ0..1codehome | work | temp | old - purpose of this address
Binding: AddressUse (required)
Example General': home
.... type Σ0..1codepostal | physical | both
Binding: AddressType (required)
Example General': both
.... text Σ0..1stringText representation of the address
Example General': 137 Nowhere Street, Erewhon 9132
.... line SΣ0..*stringStreet 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Σ0..1stringName of city, town etc.
Example General': Erewhon
.... district Σ0..1stringDistrict name (aka county)
Example General': Madison
.... state SΣ0..1stringSub-unit of country (abbreviations ok)
Binding: USPS Two Letter Alphabetic Codes (required)
.... postalCode SΣ0..1stringUS Zip Codes
Example General': 9132
.... country Σ0..1stringCountry (e.g. can be ISO 3166 2 or 3 letter code)
.... period Σ0..1PeriodTime period when address was/is in use
Example General': {"start":"2010-03-22T23:00:00+10:00","end":"2010-07-01T00:00:00+10:00"}
... partOf Σ0..1Reference(QICore-Organization)The organization of which this organization forms a part
... contact I0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint S0..*Reference(Endpoint)Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron


Quick Start

Below is an overview of the required set of RESTful FHIR interactions - for example, search and read operations - for this profile. See the Conformance requirements for a complete list of supported RESTful interactions for this IG.

source file: source/pages/_includes/organization-deqm-search.md

Use cases: