DSTU2 STU 3 Ballot
This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is

This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . For a full list of available versions, see the Directory of published versions . Page versions: . Page versions: R5 R4B R4 R3 R2

7.11.5 13.11.5 Resource Contract - Detailed Descriptions Resource Contract - Detailed Descriptions Detailed Descriptions for the elements in the Contract resource.

Detailed Descriptions for the elements in the Contract resource.

© HL7.org 2011+. FHIR DSTU2 (v1.0.2-7202) generated on Sat, Oct 24, 2015 07:43+1100. Links: Search | Version History | Table of Contents | Compare to DSTU1
Contract
Definition

A formal agreement between parties regarding the conduct of business, exchange of information or other matters. A formal agreement between parties regarding the conduct of business, exchange of information or other matters.

Control 1..1
Contract.identifier
Definition

Unique identifier for this Contract. Unique identifier for this Contract.

Note This is a business identifer, not a resource identifier (see This is a business identifer, not a resource identifier (see discussion )
Control 0..1
Type Identifier
Summary true
Contract.issued
Definition

When this Contract was issued. When this Contract was issued.

Control 0..1
Type dateTime
Summary true
Contract.applies
Definition

Relevant time or time-period when this Contract is applicable. Relevant time or time-period when this Contract is applicable.

Control 0..1
Type Period
Summary true
Contract.subject
Definition

Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and services. The target entity impacted by or of interest to parties to the agreement.

Control 0..*
Type Reference ( Any )
Requirements

The Contract.subject is an entity that has some role with respect to the Contract.topic and Contract.topic.term, which is of focal interest to the parties to the contract and likely impacted in a significant way by the Contract.action/Contract.action.reason and the Contract.term.action/Contract.action.reason. In many cases, the Contract.subject is a Contract.signer if the subject is an adult; has a legal interest in the contract; and incompetent to participate in the contract agreement.

Alternate Names Patient
Summary true
Comments

The Contract.subject is an entity that has some role with respect to the Contract.topic and Contract.topic.term, which is of focal interest to the parties to the contract and likely impacted in a significant way by the Contract.action/Contract.action.reason and the Contract.term.action/Contract.action.reason. In many cases, the Contract.subject is a Contract.signer if the subject is an adult; has a legal interest in the contract; and incompetent to participate in the contract agreement.

Contract.topic
Definition

The matter of concern in the context of this agreement.

Control 0..*
Type Reference ( Any )
Requirements

In the context of a contract, the topic is the matter under consideration in regards to which specific rights, privileges, obligations, restrictions, and prohibitions are binding on any grantor and grantee parties upon the execution of the contract. Given the wide range of contract topics, implementers need to be cognizant of the business use case for which they are designing a FHIR Contract, and narrowly specify the topic being represented with respect to the Contract.type and any specializing Contract.subtype. The same topic, e.g., an asset such as a good or service, such as a real property, medical supply, insurance, information, a procedure or employment, or a manner of conduct, such adherence to a privacy, trust, or security policy, may be the topic of multiple types of contracts. One way to determine the Contract.topic is to answer the question: “What is the object of negotiation?” Answer: The Contract.topic, which may be described with more detail in the [0..*]Contract.valuedItem @ [0..1] Contract.valuedItem.entity[x] Definition: Specific type of Contract Valued Item that may be priced. CodeableConcept|Reference(Any) Contract.topic is “the what” that a grantor is exchanging with a grantee in return for some benefit. Contract.topic is “the what” to which any Contract.action is being applied for any stipulated Contract.action.reason. AContract.topic is “the what” governed by the execution of the contract to which any party’s rights, privileges, obligations, restrictions, and prohibitions apply.

Summary true
Comments

The Contract.topic may be an application for or offer of a policy or service (e.g., uri to a consent directive form or a health insurance policy), which becomes the Contract once accepted by both the grantor and grantee. The Contract Resource may function simply as the computable representation of the executed contract, which may be the attached to the Contract Resource as the “binding” or as the “friendly” electronic form. For example, a Contract Resource may be automatically populated with the values expressed in a related QuestionnaireResponse. However, the Contract Resource may be considered the legally binding contract if it is the only “executed” form of this contract, and includes the signatures as *The Contract Resource may function as the computable representation of an application or offer in a pre-executed Contract if the grantor has not entered any values. In this case, it is populated with values in a “legal” form of the application or offer or by the values in an associated Questionnaire. If the grantor has filled in the legal form or the associated Questionnaire Response, then these values are used to populate a pre-executed Contract Resource. If the Contract.topic is considered an application or offer, then the policy is often required to be attached as the “legal” basis for the application to ensure “informed consent” to the contract, and that any discrepancy between the application and the policy are interpreted against the policy. Implementers should check organizational and jurisdictional policies to determine the relationship among multiple representations of a contract pre- and post-execution.

Contract.authority
Definition

A formally or informally recognized grouping of people, principals, organizations, or jurisdictions formed for the purpose of achieving some form of collective action such as the promulgation, administration and enforcement of contracts and policies. A formally or informally recognized grouping of people, principals, organizations, or jurisdictions formed for the purpose of achieving some form of collective action such as the promulgation, administration and enforcement of contracts and policies.

Control 0..*
Type Reference ( Organization )
Contract.domain
Definition

Recognized governance framework or system operating with a circumscribed scope in accordance with specified principles, policies, processes or procedures for managing rights, actions, or behaviors of parties or principals relative to resources. Recognized governance framework or system operating with a circumscribed scope in accordance with specified principles, policies, processes or procedures for managing rights, actions, or behaviors of parties or principals relative to resources.

Control 0..*
Type Reference ( Location )
Alternate Names Alternate Names scope of governance jurisdiction scope of governance jurisdiction
Contract.type
Definition

Type of Contract such as an insurance policy, real estate contract, a will, power of attorny, Privacy or Security policy , trust framework agreement, etc. Type of Contract such as an insurance policy, real estate contract, a will, power of attorny, Privacy or Security policy , trust framework agreement, etc.

Control 0..1
Binding Contract Type Codes: List of overall contract codes. ( Contract Type Codes: List of overall contract codes. ( Example )
Type CodeableConcept
Summary true
Contract.subType
Definition

More specific type or specialization of an overarching or more general contract such as auto insurance, home owner insurance, prenupial agreement, Advanced-Directive, or privacy consent. More specific type or specialization of an overarching or more general contract such as auto insurance, home owner insurance, prenupial agreement, Advanced-Directive, or privacy consent.

Control 0..*
Binding Contract Subtype Codes: Detailed codes within the above. ( Contract Subtype Codes: Detailed codes within the above. ( Example )
Type CodeableConcept
Summary true
Contract.action
Definition

Action stipulated by this Contract. Action stipulated by this Contract.

Control 0..*
Binding Contract Action Codes: Detailed codes for the contract action. ( Contract Action Codes: Detailed codes for the contract action. ( Example )
Type CodeableConcept
Contract.actionReason
Definition

Reason for action stipulated by this Contract. Reason for action stipulated by this Contract.

Control 0..*
Binding PurposeOfUse: Detailed codes for the contract action reason. ( PurposeOfUse: Detailed codes for the contract action reason. ( Example )
Type CodeableConcept
Contract.actor Contract.agent
Definition

List of Contract actors. An actor taking a role in an activity for which it can be assigned some degree of responsibility for the activity taking place.

Control 0..*
Requirements

An agent can be a person, an organization, software, device, or other entities that may be ascribed responsibility.

Comments

Several agents may be associated (i.e. has some responsibility for an activity) with an activity and vice-versa. For example, in cases of actions initiated by one user for other users, or in events that involve more than one user, hardware device, software, or system process. However, only one user may be the initiator/requestor for the event.

Contract.actor.entity Contract.agent.actor
Definition

Who or what actors are assigned roles in this Contract. Who or what parties are assigned roles in this Contract.

Control 1..1
Type Reference ( Contract | | Device | | Group | | Location | | Organization | | Patient | | Practitioner | | RelatedPerson | | Substance )
Contract.actor.role Contract.agent.role
Definition

Role type of actors assigned roles in this Contract. Role type of agent assigned roles in this Contract.

Control 0..*
Binding Contract Actor Role Codes: Detailed codes for the contract actor role. ( Contract Actor Role Codes: Detailed codes for the contract actor role. ( Example )
Type CodeableConcept
Contract.valuedItem Contract.signer
Definition

Contract Valued Item List. Parties with legal standing in the Contract, including the principal parties, the grantor(s) and grantee(s), which are any person or organization bound by the contract, and any ancillary parties, which facilitate the execution of the contract such as a notary or witness.

Control 0..*
Requirements

The Contract.signer applies a signature to the Contract.binding referenced resource, which is the documentation that is the legal "source of truth". The Contract.signer may delegate, such as a legally recognized personal representative, or have a delegate assigned e.g., by a court of law, to actually sign the Contract, such as a trustee in the case of incompetence.

Comments

Signers who are principal parties to the contract are bound by the Contract.activity related to the Contract.topic, and the Contract.term(s), which either extend or restrict the overall action on the topic by, for example, stipulating specific policies or obligations constraining actions, action reason, or agents with respect to some or all of the topic. For example, specifying how policies or obligations shall constrain actions and action reasons permitted or denied on all or a subset of the Contract.topic (e.g., all or a portion of property being transferred by the contract), agents (e.g., who can resell, assign interests, or alter the property being transferred by the contract), actions, and action reasons; or with respect to Contract.terms, stipulating, extending, or limiting the Contract.period of applicability or valuation of items under consideration.

Contract.valuedItem.entity[x] Contract.signer.type
Definition

Specific type of Contract Valued Item that may be priced. Role of this Contract signer, e.g. notary, grantee.

Control 0..1 1..1
Type Binding CodeableConcept | Reference ( Any Contract Signer Type Codes: List of parties who may be signing. ( Preferred )
[x] Note Type See Choice of Data Types Coding for further information about how to use [x]
Contract.valuedItem.identifier Contract.signer.party
Definition

Identifies a Contract Valued Item instance. Note This is a business identifer, not a resource identifier (see discussion ) Party which is a signator to this Contract.

Control 0..1 1..1
Type Identifier Reference ( Organization | Patient | Practitioner | RelatedPerson )
Contract.valuedItem.effectiveTime Contract.signer.signature
Definition

Indicates the time during which this Contract ValuedItem information is effective. Legally binding Contract DSIG signature contents in Base64.

Control 0..1 1..*
Type dateTime Signature
Contract.valuedItem.quantity Contract.valuedItem
Definition

Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instances. Contract Valued Item List.

Control 0..1 Type SimpleQuantity 0..*
Contract.valuedItem.unitPrice Contract.valuedItem.entity[x]
Definition

A Contract Valued Item unit valuation measure. Specific type of Contract Valued Item that may be priced.

Control 0..1
Type Money CodeableConcept | Reference ( Any )
[x] Note See Choice of Data Types for further information about how to use [x]
Contract.valuedItem.factor Contract.valuedItem.identifier
Definition

A real number that represents a multiplier used in determining the overall value of the Contract Valued Item delivered. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount. Identifies a Contract Valued Item instance.

Note This is a business identifer, not a resource identifier (see discussion )
Control 0..1
Type decimal Identifier
Contract.valuedItem.points Contract.valuedItem.effectiveTime
Definition

An amount that expresses the weighting (based on difficulty, cost and/or resource intensiveness) associated with the Contract Valued Item delivered. The concept of Points allows for assignment of point values for a Contract Valued Item, such that a monetary amount can be assigned to each point. Indicates the time during which this Contract ValuedItem information is effective.

Control 0..1
Type decimal dateTime
Contract.valuedItem.net Contract.valuedItem.quantity
Definition

Expresses the product of the Contract Valued Item unitQuantity and the unitPriceAmt. For example, the formula: unit Quantity * unit Price (Cost per Point) * factor Number * points = net Amount. Quantity, factor and points are assumed to be 1 if not supplied. Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instances.

Control 0..1
Type Money SimpleQuantity
Contract.signer Contract.valuedItem.unitPrice
Definition

Party signing this Contract. A Contract Valued Item unit valuation measure.

Control 0..* 0..1
Type Money
Contract.signer.type Contract.valuedItem.factor
Definition

Role of this Contract signer, e.g. notary, grantee. A real number that represents a multiplier used in determining the overall value of the Contract Valued Item delivered. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount.

Control 1..1 Binding Signature Type Codes: List of parties who may be signing. ( Preferred ) 0..1
Type Coding decimal
Contract.signer.party Contract.valuedItem.points
Definition

Party which is a signator to this Contract. An amount that expresses the weighting (based on difficulty, cost and/or resource intensiveness) associated with the Contract Valued Item delivered. The concept of Points allows for assignment of point values for a Contract Valued Item, such that a monetary amount can be assigned to each point.

Control 1..1 0..1
Type Reference ( Organization | Patient | Practitioner | RelatedPerson decimal )
Contract.signer.signature Contract.valuedItem.net
Definition

Legally binding Contract DSIG signature contents in Base64. Expresses the product of the Contract Valued Item unitQuantity and the unitPriceAmt. For example, the formula: unit Quantity * unit Price (Cost per Point) * factor Number * points = net Amount. Quantity, factor and points are assumed to be 1 if not supplied.

Control 1..1 0..1
Type string Money
Contract.term
Definition

One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groups. One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groups.

Control 0..*
Contract.term.identifier
Definition

Unique identifier for this particular Contract Provision. Unique identifier for this particular Contract Provision.

Note This is a business identifer, not a resource identifier (see This is a business identifer, not a resource identifier (see discussion )
Control 0..1
Type Identifier
Summary true
Contract.term.issued
Definition

When this Contract Provision was issued. When this Contract Provision was issued.

Control 0..1
Type dateTime
Summary true
Contract.term.applies
Definition

Relevant time or time-period when this Contract Provision is applicable. Relevant time or time-period when this Contract Provision is applicable.

Control 0..1
Type Period
Summary true
Contract.term.type
Definition

Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g. life time maximum benefit. Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g. life time maximum benefit.

Control 0..1
Binding Contract Term Type Codes: Detailed codes for the types of contract provisions. ( Contract Term Type Codes: Detailed codes for the types of contract provisions. ( Example )
Type CodeableConcept
Contract.term.subType
Definition

Subtype of this Contract Provision, e.g. life time maximum payment for a contract term for specific valued item, e.g. disability payment. Subtype of this Contract Provision, e.g. life time maximum payment for a contract term for specific valued item, e.g. disability payment.

Control 0..1
Binding Contract Term Type Codes: Detailed codes for the subtypes of contract provisions. ( Contract Term Type Codes: Detailed codes for the subtypes of contract provisions. ( Example )
Type CodeableConcept
Contract.term.subject Contract.term.topic
Definition

Who or what this Contract Provision is about. The matter of concern in the context of this provision of the agrement.

Control 0..1 0..*
Type Reference ( Any )
Requirements

A contract term topic is typically about a portion of the contract topic which has additional or specialized rights, privileges, obligations, restrictions, and prohibitions that are binding on any grantor and grantee parties upon the execution of the contract. Contract.term.topic may be described in more detail in the [0..*] Contract.term.valuedItem @[0..1] Contract.term.valuedItem [x] Definition: Specific type of Contract Provision Valued Item that may be priced. CodeableConcept|Reference(Any) [See Contract.topic Requirements for further elaboration on this requirement.].

Summary true
Comments

The Contract.term.topic, as a Contract Resource subpart, is handled in the same manner as the Contract Resource as discussed above.

Contract.term.action
Definition

Action stipulated by this Contract Provision. Action stipulated by this Contract Provision.

Control 0..*
Binding Contract Action Codes: Detailed codes for the contract action. ( Contract Action Codes: Detailed codes for the contract action. ( Example )
Type CodeableConcept
Contract.term.actionReason
Definition

Reason or purpose for the action stipulated by this Contract Provision. Reason or purpose for the action stipulated by this Contract Provision.

Control 0..*
Binding PurposeOfUse: Detailed codes for the contract action reason. ( PurposeOfUse: Detailed codes for the contract action reason. ( Example )
Type CodeableConcept
Contract.term.actor Contract.term.agent
Definition

List of actors participating in this Contract Provision. An actor taking a role in an activity for which it can be assigned some degree of responsibility for the activity taking place.

Control 0..*
Requirements

An agent can be a person, an organization, software, device, or other entities that may be ascribed responsibility.

Comments

Several agents may be associated (i.e. has some responsibility for an activity) with an activity and vice-versa. For example, in cases of actions initiated by one user for other users, or in events that involve more than one user, hardware device, software, or system process. However, only one user may be the initiator/requestor for the event.

Contract.term.actor.entity Contract.term.agent.actor
Definition

The actor assigned a role in this Contract Provision. The agent assigned a role in this Contract Provision.

Control 1..1
Type Reference ( Contract | | Device | | Group | | Location | | Organization | | Patient | | Practitioner | | RelatedPerson | | Substance )
Contract.term.actor.role Contract.term.agent.role
Definition

Role played by the actor assigned this role in this Contract Provision. Role played by the agent assigned this role in the execution of this Contract Provision.

Control 0..*
Binding Contract Actor Role Codes: Detailed codes for the contract actor role. ( Contract Actor Role Codes: Detailed codes for the contract actor role. ( Example )
Type CodeableConcept
Contract.term.text
Definition

Human readable form of this Contract Provision. Human readable form of this Contract Provision.

Control 0..1
Type string
Contract.term.valuedItem
Definition

Contract Provision Valued Item List. Contract Provision Valued Item List.

Control 0..*
Contract.term.valuedItem.entity[x]
Definition

Specific type of Contract Provision Valued Item that may be priced. Specific type of Contract Provision Valued Item that may be priced.

Control 0..1
Type CodeableConcept | Reference ( Any )
[x] Note [x] Note See Choice of Data Types for further information about how to use [x] See Choice of Data Types for further information about how to use [x]
Contract.term.valuedItem.identifier
Definition

Identifies a Contract Provision Valued Item instance. Identifies a Contract Provision Valued Item instance.

Note This is a business identifer, not a resource identifier (see This is a business identifer, not a resource identifier (see discussion )
Control 0..1
Type Identifier
Contract.term.valuedItem.effectiveTime
Definition

Indicates the time during which this Contract Term ValuedItem information is effective. Indicates the time during which this Contract Term ValuedItem information is effective.

Control 0..1
Type dateTime
Contract.term.valuedItem.quantity
Definition

Specifies the units by which the Contract Provision Valued Item is measured or counted, and quantifies the countable or measurable Contract Term Valued Item instances. Specifies the units by which the Contract Provision Valued Item is measured or counted, and quantifies the countable or measurable Contract Term Valued Item instances.

Control 0..1
Type SimpleQuantity
Contract.term.valuedItem.unitPrice
Definition

A Contract Provision Valued Item unit valuation measure. A Contract Provision Valued Item unit valuation measure.

Control 0..1
Type Money
Contract.term.valuedItem.factor
Definition

A real number that represents a multiplier used in determining the overall value of the Contract Provision Valued Item delivered. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount. A real number that represents a multiplier used in determining the overall value of the Contract Provision Valued Item delivered. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount.

Control 0..1
Type decimal
Contract.term.valuedItem.points
Definition

An amount that expresses the weighting (based on difficulty, cost and/or resource intensiveness) associated with the Contract Provision Valued Item delivered. The concept of Points allows for assignment of point values for a Contract ProvisionValued Item, such that a monetary amount can be assigned to each point. An amount that expresses the weighting (based on difficulty, cost and/or resource intensiveness) associated with the Contract Provision Valued Item delivered. The concept of Points allows for assignment of point values for a Contract ProvisionValued Item, such that a monetary amount can be assigned to each point.

Control 0..1
Type decimal
Contract.term.valuedItem.net
Definition

Expresses the product of the Contract Provision Valued Item unitQuantity and the unitPriceAmt. For example, the formula: unit Quantity * unit Price (Cost per Point) * factor Number * points = net Amount. Quantity, factor and points are assumed to be 1 if not supplied. Expresses the product of the Contract Provision Valued Item unitQuantity and the unitPriceAmt. For example, the formula: unit Quantity * unit Price (Cost per Point) * factor Number * points = net Amount. Quantity, factor and points are assumed to be 1 if not supplied.

Control 0..1
Type Money
Contract.term.group
Definition

Nested group of Contract Provisions. Nested group of Contract Provisions.

Control 0..*
Type See Contract.term See Contract.term
Contract.binding[x]
Definition

Legally binding Contract: This is the signed and legally recognized representation of the Contract, which is considered the "source of truth" and which would be the basis for legal action related to enforcement of this Contract. Legally binding Contract: This is the signed and legally recognized representation of the Contract, which is considered the "source of truth" and which would be the basis for legal action related to enforcement of this Contract.

Control 0..1
Type Attachment | Reference ( Composition | | DocumentReference | | QuestionnaireResponse )
[x] Note [x] Note See Choice of Data Types for further information about how to use [x] See Choice of Data Types for further information about how to use [x]
Contract.friendly
Definition

The "patient friendly language" versionof the Contract in whole or in parts. "Patient friendly language" means the representation of the Contract and Contract Provisions in a manner that is readily accessible and understandable by a layperson in accordance with best practices for communication styles that ensure that those agreeing to or signing the Contract understand the roles, actions, obligations, responsibilities, and implication of the agreement. The "patient friendly language" versionof the Contract in whole or in parts. "Patient friendly language" means the representation of the Contract and Contract Provisions in a manner that is readily accessible and understandable by a layperson in accordance with best practices for communication styles that ensure that those agreeing to or signing the Contract understand the roles, actions, obligations, responsibilities, and implication of the agreement.

Control 0..*
Contract.friendly.content[x]
Definition

Human readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandability. Human readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandability.

Control 1..1
Type Attachment | Reference ( Composition | | DocumentReference | | QuestionnaireResponse )
[x] Note [x] Note See Choice of Data Types for further information about how to use [x] See Choice of Data Types for further information about how to use [x]
Contract.legal
Definition

List of Legal expressions or representations of this Contract. List of Legal expressions or representations of this Contract.

Control 0..*
Contract.legal.content[x]
Definition

Contract legal text in human renderable form. Contract legal text in human renderable form.

Control 1..1
Type Attachment | Reference ( Composition | | DocumentReference | | QuestionnaireResponse )
[x] Note [x] Note See Choice of Data Types for further information about how to use [x] See Choice of Data Types for further information about how to use [x]
Contract.rule
Definition

List of Computable Policy Rule Language Representations of this Contract. List of Computable Policy Rule Language Representations of this Contract.

Control 0..*
Contract.rule.content[x]
Definition

Computable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal). Computable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal).

Control 1..1
Type Attachment | Reference ( DocumentReference )
[x] Note [x] Note See Choice of Data Types for further information about how to use [x] See Choice of Data Types for further information about how to use [x]