This page is part of the FHIR Specification (v0.0.82: DSTU 1). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.7 Resource Contract - Content

This resource maintained by the Financial Management Work Group

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

5.7.1 Scope and Usage

The Contract resource is the basal resource to convey information of all manner of contracts for financial (eg. Insurance policies), business arrangements (eg. supply contracts) and privacy and security (eg. consent directives). Todo

This resource is referenced by [Coverage]

5.7.2 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
. . Contract DomainResource Contract
. . . identifier Σ 0..1 Identifier Contract identifier
. . . issued Σ 0..1 dateTime When this Contract was issued
. . . applies Σ 0..1 Period Effective time
. . . subject Σ 0..* Any Subject of this Contract
. . . authority 0..* Organization Authority under which this Contract has standing
. . . domain 0..* Location Domain in which this Contract applies
. . . type Σ 0..1 CodeableConcept Contract Tyoe
ContractType ( Example )
. . . subType Σ 0..* CodeableConcept Contract Subtype
ContractSubtype ( Example )
. . . action 0..* CodeableConcept Contract Action
ContractAction ( Example )
. . . actionReason 0..* CodeableConcept Contract Action Reason
ContractActionReason ( Example )
. . . actor 0..* Element Contract Actor
. . . . entity 1..1 Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply Contract Actor Type
. . . . role 0..* CodeableConcept Contract Actor Role
ContractActorRole ( Example )
. . . valuedItem 0..* Element Contract Valued Item
. . . . entity[x] Contract Valued Item Type
. . . . . entityCodeableConcept 0..1 CodeableConcept
. . . . . entityReference 0..1 Any
. . . . identifier 0..1 Identifier Contract Valued Item Identifier
. . . . effectiveTime 0..1 dateTime Contract Valued Item Effective Tiem
. . . . quantity 0..1 Quantity Count of Contract Valued Items
. . . . unitPrice 0..1 Money Contract Valued Item fee, charge, or cost
. . . . factor 0..1 decimal Contract Valued Item Price Scaling Factor
. . . . points 0..1 decimal Contract Valued Item Difficulty Scaling Factor
. . . . net 0..1 Money Total Contract Valued Item Value
. . . signer 0..* Element Contract Signer
. . . . type 1..1 Coding Contract Signer Type
ContractSignerType ( Example )
. . . . party 1..1 Organization | Patient | Practitioner | RelatedPerson Contract Signatory Party
. . . . signature 1..1 string Contract Documentation Signature
. . . term 0..* Element Contract Term List
. . . . identifier Σ 0..1 Identifier Contract Term identifier
. . . . issued Σ 0..1 dateTime Contract Term Issue Date Time
. . . . applies Σ 0..1 Period Contract Term Effective Time
. . . . type 0..1 CodeableConcept Contract Term Type
ContractTermType ( Example )
. . . . subType 0..1 CodeableConcept Contract Term Subtype
ContractTermSubType ( Example )
. . . . subject 0..1 Any Subject of this Contract Term
. . . . action 0..* CodeableConcept Contract Term Action
ContractAction ( Example )
. . . . actionReason 0..* CodeableConcept Contract Term Action Reason
ContractActionReason ( Example )
. . . . actor 0..* Element Contract Term Actor List
. . . . . entity 1..1 Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply Contract Term Actor
. . . . . role 0..* CodeableConcept Contract Term Actor Role
ContractActorRole ( Example )
. . . . text 0..1 string Human readable Contract term text
. . . . valuedItem 0..* Element Contract Term Valued Item
. . . . . entity[x] Contract Term Valued Item Type
. . . . . . entityCodeableConcept 0..1 CodeableConcept
. . . . . . entityReference 0..1 Any
. . . . . identifier 0..1 Identifier Contract Term Valued Item Identifier
. . . . . effectiveTime 0..1 dateTime Contract Term Valued Item Effective Tiem
. . . . . quantity 0..1 Quantity Contract Term Valued Item Count
. . . . . unitPrice 0..1 Money Contract Term Valued Item fee, charge, or cost
. . . . . factor 0..1 decimal Contract Term Valued Item Price Scaling Factor
. . . . . points 0..1 decimal Contract Term Valued Item Difficulty Scaling Factor
. . . . . net 0..1 Money Total Contract Term Valued Item Value
. . . . group 0..* see term Nested Contract Term Group
. . . binding[x] Binding Contract
. . . . bindingAttachment 0..1 Attachment
. . . . bindingReference 0..1 Composition | DocumentReference | QuestionnaireAnswers
. . . friendly 0..* Element Contract Friendly Language
. . . . content[x] Easily comprehended representation of this Contract
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 Composition | DocumentReference | QuestionnaireAnswers
. . . legal 0..* Element Contract Legal Language
. . . . content[x] Contract Legal Text
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 Composition | DocumentReference | QuestionnaireAnswers
. . . rule 0..* Element Computable Contract Language
. . . . content[x] Computable Contract Rules
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 DocumentReference

UML Diagram

Contract ( DomainResource ) Unique identifier for this Contract identifier : Identifier 0..1 When this Contract was issued issued : dateTime 0..1 Relevant time or time-period when this Contract is applicable applies : Period 0..1 Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and services subject : Reference ( Any ) 0..* 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 authority : Reference ( Organization ) 0..* 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 domain : Reference ( Location ) 0..* 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 : CodeableConcept 0..1 « ( List of overall contract codes ContractType ) » 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 subType : CodeableConcept 0..* « ( Detailed codes within the above ContractSubtype ) » Action stipulated by this Contract action : CodeableConcept 0..* « ( Detailed codes for the contract action ContractAction ) » Reason for action stipulated by this Contract actionReason : CodeableConcept 0..* « ( Detailed codes for the contract action reason ContractActionReason ) » 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 binding[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 0..1 Actor Who or what actors are assigned roles in this Contract entity : Reference ( Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply ) 1..1 Role type of actors assigned roles in this Contract role : CodeableConcept 0..* « ( Detailed codes for the contract actor role ContractActorRole ) » ValuedItem Specific type of Contract Valued Item that may be priced entity[x] : CodeableConcept | Reference ( Any ) 0..1 Identifies a Contract Valued Item instance identifier : Identifier 0..1 Indicates the time during which this Contract ValuedItem information is effective effectiveTime : dateTime 0..1 Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instances quantity : Quantity 0..1 A Contract Valued Item unit valuation measure unitPrice : Money 0..1 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 factor : decimal 0..1 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 points : decimal 0..1 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 net : Money 0..1 Signatory Role of this Contract signer, e.g., notary, grantee type : Coding 1..1 « ( List of parties who may be signing ContractSignerType ) » Party which is a signator to this Contract party : Reference ( Organization | Patient | Practitioner | RelatedPerson ) 1..1 Legally binding Contract DSIG signature contents in Base64 signature : string 1..1 Term Unique identifier for this particular Contract Provision identifier : Identifier 0..1 When this Contract Provision was issued issued : dateTime 0..1 Relevant time or time-period when this Contract Provision is applicable applies : Period 0..1 Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g., life time maximum benefit type : CodeableConcept 0..1 « ( Detailed codes for the types of contract provisions ContractTermType ) » Subtype of this Contract Provision, e.g., life time maximum payment for a contract term for specific valued item, e.g., disability payment subType : CodeableConcept 0..1 « ( Detailed codes for the subtypes of contract provisions ContractTermSubType ) » Who or what this Contract Provision is about subject : Reference ( Any ) 0..1 Action stipulated by this Contract Provision action : CodeableConcept 0..* « ( Detailed codes for the contract action ContractAction ) » Reason or purpose for the action stipulated by this Contract Provision actionReason : CodeableConcept 0..* « ( Detailed codes for the contract action reason ContractActionReason ) » Human readable form of this Contract Provision text : string 0..1 TermActor The actor assigned a role in this Contract Provision entity : Reference ( Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply ) 1..1 Role played by the actor assigned this role in this Contract Provision role : CodeableConcept 0..* « ( Detailed codes for the contract actor role ContractActorRole ) » TermValuedItem Specific type of Contract Provision Valued Item that may be priced entity[x] : CodeableConcept | Reference ( Any ) 0..1 Identifies a Contract Provision Valued Item instance identifier : Identifier 0..1 Indicates the time during which this Contract Term ValuedItem information is effective effectiveTime : dateTime 0..1 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 quantity : Quantity 0..1 A Contract Provision Valued Item unit valuation measure unitPrice : Money 0..1 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 factor : decimal 0..1 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 points : decimal 0..1 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 net : Money 0..1 FriendlyLanguage Human readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandability content[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 1..1 LegalLanguage Contract legal text in human renderable form content[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 1..1 ComputableLanguage Computable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal) content[x] : Attachment | Reference ( DocumentReference ) 1..1 List of Contract actors actor 0..* Contract Valued Item List valuedItem 0..* Party signing this Contract signer 0..* List of actors participating in this Contract Provision actor 0..* Contract Provision Valued Item List valuedItem 0..* Nested group of Contract Provisions group 0..* One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groups term 0..* 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 friendly 0..* List of Legal expressions or representations of this Contract legal 0..* List of Computable Policy Rule Language Representations of this Contract rule 0..*

XML Template 

<Contract xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier Contract identifier --></identifier>
 <issued value="[dateTime]"/><!-- 0..1 When this Contract was issued -->
 <applies><!-- 0..1 Period Effective time --></applies>
 <subject><!-- 0..* Reference(Any) Subject of this Contract --></subject>
 <authority><!-- 0..* Reference(Organization) 
     Authority under which this Contract has standing --></authority>
 <domain><!-- 0..* Reference(Location) Domain in which this Contract applies --></domain>
 <type><!-- 0..1 CodeableConcept Contract Tyoe --></type>
 <subType><!-- 0..* CodeableConcept Contract Subtype --></subType>
 <action><!-- 0..* CodeableConcept Contract Action --></action>
 <actionReason><!-- 0..* CodeableConcept Contract Action Reason --></actionReason>
 <actor>  <!-- 0..* Contract Actor -->
  <entity><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|Patient|
    Practitioner|RelatedPerson|Substance|Supply) Contract Actor Type --></entity>
  <role><!-- 0..* CodeableConcept Contract  Actor Role --></role>
 </actor>
 <valuedItem>  <!-- 0..* Contract Valued Item -->
  <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Valued Item Type --></entity[x]>
  <identifier><!-- 0..1 Identifier Contract Valued Item Identifier --></identifier>
  <effectiveTime value="[dateTime]"/><!-- 0..1 Contract Valued Item Effective Tiem -->
  <quantity><!-- 0..1 Quantity Count of Contract Valued Items --></quantity>
  <unitPrice><!-- 0..1 Money Contract Valued Item fee, charge, or cost --></unitPrice>
  <factor value="[decimal]"/><!-- 0..1 Contract Valued Item Price Scaling Factor -->
  <points value="[decimal]"/><!-- 0..1 Contract Valued Item Difficulty Scaling Factor -->
  <net><!-- 0..1 Money Total Contract Valued Item Value --></net>
 </valuedItem>
 <signer>  <!-- 0..* Contract Signer -->
  <type><!-- 1..1 Coding Contract Signer Type --></type>
  <party><!-- 1..1 Reference(Organization|Patient|Practitioner|RelatedPerson) 
      Contract Signatory Party --></party>
  <signature value="[string]"/><!-- 1..1 Contract Documentation Signature -->
 </signer>
 <term>  <!-- 0..* Contract Term List -->
  <identifier><!-- 0..1 Identifier Contract Term identifier --></identifier>
  <issued value="[dateTime]"/><!-- 0..1 Contract Term Issue Date Time -->
  <applies><!-- 0..1 Period Contract Term Effective Time --></applies>
  <type><!-- 0..1 CodeableConcept Contract Term Type --></type>
  <subType><!-- 0..1 CodeableConcept Contract Term Subtype --></subType>
  <subject><!-- 0..1 Reference(Any) Subject of this Contract Term --></subject>
  <action><!-- 0..* CodeableConcept Contract Term Action --></action>
  <actionReason><!-- 0..* CodeableConcept Contract Term Action Reason --></actionReason>
  <actor>  <!-- 0..* Contract Term Actor List -->
   <entity><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|
     Patient|Practitioner|RelatedPerson|Substance|Supply) Contract Term Actor --></entity>
   <role><!-- 0..* CodeableConcept Contract Term Actor Role --></role>
  </actor>
  <text value="[string]"/><!-- 0..1 Human readable Contract term text -->
  <valuedItem>  <!-- 0..* Contract Term Valued Item -->
   <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Term Valued Item Type --></entity[x]>
   <identifier><!-- 0..1 Identifier Contract Term Valued Item Identifier --></identifier>
   <effectiveTime value="[dateTime]"/><!-- 0..1 Contract Term Valued Item Effective Tiem -->
   <quantity><!-- 0..1 Quantity Contract Term Valued Item Count --></quantity>
   <unitPrice><!-- 0..1 Money Contract Term Valued Item fee, charge, or cost --></unitPrice>
   <factor value="[decimal]"/><!-- 0..1 Contract Term Valued Item Price Scaling Factor -->
   <points value="[decimal]"/><!-- 0..1 Contract Term Valued Item Difficulty Scaling Factor -->
   <net><!-- 0..1 Money Total Contract Term Valued Item Value --></net>
  </valuedItem>
  <group><!-- 0..* Content as for Contract.term Nested Contract Term Group --></group>
 </term>
 <binding[x]><!-- 0..1 Attachment|Reference(Composition|DocumentReference|
   QuestionnaireAnswers) Binding Contract --></binding[x]>
 <friendly>  <!-- 0..* Contract Friendly Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireAnswers) Easily comprehended representation of this Contract --></content[x]>
 </friendly>
 <legal>  <!-- 0..* Contract Legal Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireAnswers) Contract Legal Text --></content[x]>
 </legal>
 <rule>  <!-- 0..* Computable Contract Language -->
  <content[x]><!-- 1..1 Attachment|Reference(DocumentReference) Computable Contract Rules --></content[x]>
 </rule>
</Contract>

JSON Template 

{doco
  "resourceType" : "Contract",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Contract identifier
  "issued" : "<dateTime>", // When this Contract was issued
  "applies" : { Period }, // Effective time
  "subject" : [{ Reference(Any) }], // Subject of this Contract
  "authority" : [{ Reference(Organization) }], // 
     Authority under which this Contract has standing
  "domain" : [{ Reference(Location) }], // Domain in which this Contract applies
  "type" : { CodeableConcept }, // Contract Tyoe
  "subType" : [{ CodeableConcept }], // Contract Subtype
  "action" : [{ CodeableConcept }], // Contract Action
  "actionReason" : [{ CodeableConcept }], // Contract Action Reason
  "actor" : [{ // Contract Actor
    "entity" : { Reference(Contract|Device|Group|Location|Organization|Patient|
    Practitioner|RelatedPerson|Substance|Supply) }, // R!  Contract Actor Type
    "role" : [{ CodeableConcept }] // Contract  Actor Role
  }],
  "valuedItem" : [{ // Contract Valued Item
    // entity[x]: Contract Valued Item Type. One of these 2:
    "entityCodeableConcept" : { CodeableConcept },
    "entityReference" : { Reference(Any) },
    "identifier" : { Identifier }, // Contract Valued Item Identifier
    "effectiveTime" : "<dateTime>", // Contract Valued Item Effective Tiem
    "quantity" : { Quantity }, // Count of Contract Valued Items
    "unitPrice" : { Money }, // Contract Valued Item fee, charge, or cost
    "factor" : <decimal>, // Contract Valued Item Price Scaling Factor
    "points" : <decimal>, // Contract Valued Item Difficulty Scaling Factor
    "net" : { Money } // Total Contract Valued Item Value
  }],
  "signer" : [{ // Contract Signer
    "type" : { Coding }, // R!  Contract Signer Type
    "party" : { Reference(Organization|Patient|Practitioner|RelatedPerson) }, // R!  
      Contract Signatory Party
    "signature" : "<string>" // R!  Contract Documentation Signature
  }],
  "term" : [{ // Contract Term List
    "identifier" : { Identifier }, // Contract Term identifier
    "issued" : "<dateTime>", // Contract Term Issue Date Time
    "applies" : { Period }, // Contract Term Effective Time
    "type" : { CodeableConcept }, // Contract Term Type
    "subType" : { CodeableConcept }, // Contract Term Subtype
    "subject" : { Reference(Any) }, // Subject of this Contract Term
    "action" : [{ CodeableConcept }], // Contract Term Action
    "actionReason" : [{ CodeableConcept }], // Contract Term Action Reason
    "actor" : [{ // Contract Term Actor List
      "entity" : { Reference(Contract|Device|Group|Location|Organization|
     Patient|Practitioner|RelatedPerson|Substance|Supply) }, // R!  Contract Term Actor
      "role" : [{ CodeableConcept }] // Contract Term Actor Role
    }],
    "text" : "<string>", // Human readable Contract term text
    "valuedItem" : [{ // Contract Term Valued Item
      // entity[x]: Contract Term Valued Item Type. One of these 2:
      "entityCodeableConcept" : { CodeableConcept },
      "entityReference" : { Reference(Any) },
      "identifier" : { Identifier }, // Contract Term Valued Item Identifier
      "effectiveTime" : "<dateTime>", // Contract Term Valued Item Effective Tiem
      "quantity" : { Quantity }, // Contract Term Valued Item Count
      "unitPrice" : { Money }, // Contract Term Valued Item fee, charge, or cost
      "factor" : <decimal>, // Contract Term Valued Item Price Scaling Factor
      "points" : <decimal>, // Contract Term Valued Item Difficulty Scaling Factor
      "net" : { Money } // Total Contract Term Valued Item Value
    }],
    "group" : [{ Content as for Contract.term }] // Nested Contract Term Group
  }],
  // binding[x]: Binding Contract. One of these 2:
  "bindingAttachment" : { Attachment },
  "bindingReference" : { Reference(Composition|DocumentReference|
   QuestionnaireAnswers) },
  "friendly" : [{ // Contract Friendly Language
    // content[x]: Easily comprehended representation of this Contract. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireAnswers) }
  }],
  "legal" : [{ // Contract Legal Language
    // content[x]: Contract Legal Text. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireAnswers) }
  }],
  "rule" : [{ // Computable Contract Language
    // content[x]: Computable Contract Rules. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(DocumentReference) }
  }]
}

Structure

Name Flags Card. Type Description & Constraints doco
. . Contract DomainResource Contract
. . . identifier Σ 0..1 Identifier Contract identifier
. . . issued Σ 0..1 dateTime When this Contract was issued
. . . applies Σ 0..1 Period Effective time
. . . subject Σ 0..* Any Subject of this Contract
. . . authority 0..* Organization Authority under which this Contract has standing
. . . domain 0..* Location Domain in which this Contract applies
. . . type Σ 0..1 CodeableConcept Contract Tyoe
ContractType ( Example )
. . . subType Σ 0..* CodeableConcept Contract Subtype
ContractSubtype ( Example )
. . . action 0..* CodeableConcept Contract Action
ContractAction ( Example )
. . . actionReason 0..* CodeableConcept Contract Action Reason
ContractActionReason ( Example )
. . . actor 0..* Element Contract Actor
. . . . entity 1..1 Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply Contract Actor Type
. . . . role 0..* CodeableConcept Contract Actor Role
ContractActorRole ( Example )
. . . valuedItem 0..* Element Contract Valued Item
. . . . entity[x] Contract Valued Item Type
. . . . . entityCodeableConcept 0..1 CodeableConcept
. . . . . entityReference 0..1 Any
. . . . identifier 0..1 Identifier Contract Valued Item Identifier
. . . . effectiveTime 0..1 dateTime Contract Valued Item Effective Tiem
. . . . quantity 0..1 Quantity Count of Contract Valued Items
. . . . unitPrice 0..1 Money Contract Valued Item fee, charge, or cost
. . . . factor 0..1 decimal Contract Valued Item Price Scaling Factor
. . . . points 0..1 decimal Contract Valued Item Difficulty Scaling Factor
. . . . net 0..1 Money Total Contract Valued Item Value
. . . signer 0..* Element Contract Signer
. . . . type 1..1 Coding Contract Signer Type
ContractSignerType ( Example )
. . . . party 1..1 Organization | Patient | Practitioner | RelatedPerson Contract Signatory Party
. . . . signature 1..1 string Contract Documentation Signature
. . . term 0..* Element Contract Term List
. . . . identifier Σ 0..1 Identifier Contract Term identifier
. . . . issued Σ 0..1 dateTime Contract Term Issue Date Time
. . . . applies Σ 0..1 Period Contract Term Effective Time
. . . . type 0..1 CodeableConcept Contract Term Type
ContractTermType ( Example )
. . . . subType 0..1 CodeableConcept Contract Term Subtype
ContractTermSubType ( Example )
. . . . subject 0..1 Any Subject of this Contract Term
. . . . action 0..* CodeableConcept Contract Term Action
ContractAction ( Example )
. . . . actionReason 0..* CodeableConcept Contract Term Action Reason
ContractActionReason ( Example )
. . . . actor 0..* Element Contract Term Actor List
. . . . . entity 1..1 Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply Contract Term Actor
. . . . . role 0..* CodeableConcept Contract Term Actor Role
ContractActorRole ( Example )
. . . . text 0..1 string Human readable Contract term text
. . . . valuedItem 0..* Element Contract Term Valued Item
. . . . . entity[x] Contract Term Valued Item Type
. . . . . . entityCodeableConcept 0..1 CodeableConcept
. . . . . . entityReference 0..1 Any
. . . . . identifier 0..1 Identifier Contract Term Valued Item Identifier
. . . . . effectiveTime 0..1 dateTime Contract Term Valued Item Effective Tiem
. . . . . quantity 0..1 Quantity Contract Term Valued Item Count
. . . . . unitPrice 0..1 Money Contract Term Valued Item fee, charge, or cost
. . . . . factor 0..1 decimal Contract Term Valued Item Price Scaling Factor
. . . . . points 0..1 decimal Contract Term Valued Item Difficulty Scaling Factor
. . . . . net 0..1 Money Total Contract Term Valued Item Value
. . . . group 0..* see term Nested Contract Term Group
. . . binding[x] Binding Contract
. . . . bindingAttachment 0..1 Attachment
. . . . bindingReference 0..1 Composition | DocumentReference | QuestionnaireAnswers
. . . friendly 0..* Element Contract Friendly Language
. . . . content[x] Easily comprehended representation of this Contract
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 Composition | DocumentReference | QuestionnaireAnswers
. . . legal 0..* Element Contract Legal Language
. . . . content[x] Contract Legal Text
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 Composition | DocumentReference | QuestionnaireAnswers
. . . rule 0..* Element Computable Contract Language
. . . . content[x] Computable Contract Rules
. . . . . contentAttachment 1..1 Attachment
. . . . . contentReference 1..1 DocumentReference

UML Diagram

Contract ( DomainResource ) Unique identifier for this Contract identifier : Identifier 0..1 When this Contract was issued issued : dateTime 0..1 Relevant time or time-period when this Contract is applicable applies : Period 0..1 Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and services subject : Reference ( Any ) 0..* 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 authority : Reference ( Organization ) 0..* 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 domain : Reference ( Location ) 0..* 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 : CodeableConcept 0..1 « ( List of overall contract codes ContractType ) » 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 subType : CodeableConcept 0..* « ( Detailed codes within the above ContractSubtype ) » Action stipulated by this Contract action : CodeableConcept 0..* « ( Detailed codes for the contract action ContractAction ) » Reason for action stipulated by this Contract actionReason : CodeableConcept 0..* « ( Detailed codes for the contract action reason ContractActionReason ) » 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 binding[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 0..1 Actor Who or what actors are assigned roles in this Contract entity : Reference ( Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply ) 1..1 Role type of actors assigned roles in this Contract role : CodeableConcept 0..* « ( Detailed codes for the contract actor role ContractActorRole ) » ValuedItem Specific type of Contract Valued Item that may be priced entity[x] : CodeableConcept | Reference ( Any ) 0..1 Identifies a Contract Valued Item instance identifier : Identifier 0..1 Indicates the time during which this Contract ValuedItem information is effective effectiveTime : dateTime 0..1 Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instances quantity : Quantity 0..1 A Contract Valued Item unit valuation measure unitPrice : Money 0..1 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 factor : decimal 0..1 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 points : decimal 0..1 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 net : Money 0..1 Signatory Role of this Contract signer, e.g., notary, grantee type : Coding 1..1 « ( List of parties who may be signing ContractSignerType ) » Party which is a signator to this Contract party : Reference ( Organization | Patient | Practitioner | RelatedPerson ) 1..1 Legally binding Contract DSIG signature contents in Base64 signature : string 1..1 Term Unique identifier for this particular Contract Provision identifier : Identifier 0..1 When this Contract Provision was issued issued : dateTime 0..1 Relevant time or time-period when this Contract Provision is applicable applies : Period 0..1 Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g., life time maximum benefit type : CodeableConcept 0..1 « ( Detailed codes for the types of contract provisions ContractTermType ) » Subtype of this Contract Provision, e.g., life time maximum payment for a contract term for specific valued item, e.g., disability payment subType : CodeableConcept 0..1 « ( Detailed codes for the subtypes of contract provisions ContractTermSubType ) » Who or what this Contract Provision is about subject : Reference ( Any ) 0..1 Action stipulated by this Contract Provision action : CodeableConcept 0..* « ( Detailed codes for the contract action ContractAction ) » Reason or purpose for the action stipulated by this Contract Provision actionReason : CodeableConcept 0..* « ( Detailed codes for the contract action reason ContractActionReason ) » Human readable form of this Contract Provision text : string 0..1 TermActor The actor assigned a role in this Contract Provision entity : Reference ( Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | Supply ) 1..1 Role played by the actor assigned this role in this Contract Provision role : CodeableConcept 0..* « ( Detailed codes for the contract actor role ContractActorRole ) » TermValuedItem Specific type of Contract Provision Valued Item that may be priced entity[x] : CodeableConcept | Reference ( Any ) 0..1 Identifies a Contract Provision Valued Item instance identifier : Identifier 0..1 Indicates the time during which this Contract Term ValuedItem information is effective effectiveTime : dateTime 0..1 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 quantity : Quantity 0..1 A Contract Provision Valued Item unit valuation measure unitPrice : Money 0..1 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 factor : decimal 0..1 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 points : decimal 0..1 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 net : Money 0..1 FriendlyLanguage Human readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandability content[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 1..1 LegalLanguage Contract legal text in human renderable form content[x] : Attachment | Reference ( Composition | DocumentReference | QuestionnaireAnswers ) 1..1 ComputableLanguage Computable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal) content[x] : Attachment | Reference ( DocumentReference ) 1..1 List of Contract actors actor 0..* Contract Valued Item List valuedItem 0..* Party signing this Contract signer 0..* List of actors participating in this Contract Provision actor 0..* Contract Provision Valued Item List valuedItem 0..* Nested group of Contract Provisions group 0..* One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groups term 0..* 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 friendly 0..* List of Legal expressions or representations of this Contract legal 0..* List of Computable Policy Rule Language Representations of this Contract rule 0..*

XML Template 

<Contract xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier Contract identifier --></identifier>
 <issued value="[dateTime]"/><!-- 0..1 When this Contract was issued -->
 <applies><!-- 0..1 Period Effective time --></applies>
 <subject><!-- 0..* Reference(Any) Subject of this Contract --></subject>
 <authority><!-- 0..* Reference(Organization) 
     Authority under which this Contract has standing --></authority>
 <domain><!-- 0..* Reference(Location) Domain in which this Contract applies --></domain>
 <type><!-- 0..1 CodeableConcept Contract Tyoe --></type>
 <subType><!-- 0..* CodeableConcept Contract Subtype --></subType>
 <action><!-- 0..* CodeableConcept Contract Action --></action>
 <actionReason><!-- 0..* CodeableConcept Contract Action Reason --></actionReason>
 <actor>  <!-- 0..* Contract Actor -->
  <entity><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|Patient|
    Practitioner|RelatedPerson|Substance|Supply) Contract Actor Type --></entity>
  <role><!-- 0..* CodeableConcept Contract  Actor Role --></role>
 </actor>
 <valuedItem>  <!-- 0..* Contract Valued Item -->
  <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Valued Item Type --></entity[x]>
  <identifier><!-- 0..1 Identifier Contract Valued Item Identifier --></identifier>
  <effectiveTime value="[dateTime]"/><!-- 0..1 Contract Valued Item Effective Tiem -->
  <quantity><!-- 0..1 Quantity Count of Contract Valued Items --></quantity>
  <unitPrice><!-- 0..1 Money Contract Valued Item fee, charge, or cost --></unitPrice>
  <factor value="[decimal]"/><!-- 0..1 Contract Valued Item Price Scaling Factor -->
  <points value="[decimal]"/><!-- 0..1 Contract Valued Item Difficulty Scaling Factor -->
  <net><!-- 0..1 Money Total Contract Valued Item Value --></net>
 </valuedItem>
 <signer>  <!-- 0..* Contract Signer -->
  <type><!-- 1..1 Coding Contract Signer Type --></type>
  <party><!-- 1..1 Reference(Organization|Patient|Practitioner|RelatedPerson) 
      Contract Signatory Party --></party>
  <signature value="[string]"/><!-- 1..1 Contract Documentation Signature -->
 </signer>
 <term>  <!-- 0..* Contract Term List -->
  <identifier><!-- 0..1 Identifier Contract Term identifier --></identifier>
  <issued value="[dateTime]"/><!-- 0..1 Contract Term Issue Date Time -->
  <applies><!-- 0..1 Period Contract Term Effective Time --></applies>
  <type><!-- 0..1 CodeableConcept Contract Term Type --></type>
  <subType><!-- 0..1 CodeableConcept Contract Term Subtype --></subType>
  <subject><!-- 0..1 Reference(Any) Subject of this Contract Term --></subject>
  <action><!-- 0..* CodeableConcept Contract Term Action --></action>
  <actionReason><!-- 0..* CodeableConcept Contract Term Action Reason --></actionReason>
  <actor>  <!-- 0..* Contract Term Actor List -->
   <entity><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|
     Patient|Practitioner|RelatedPerson|Substance|Supply) Contract Term Actor --></entity>
   <role><!-- 0..* CodeableConcept Contract Term Actor Role --></role>
  </actor>
  <text value="[string]"/><!-- 0..1 Human readable Contract term text -->
  <valuedItem>  <!-- 0..* Contract Term Valued Item -->
   <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Term Valued Item Type --></entity[x]>
   <identifier><!-- 0..1 Identifier Contract Term Valued Item Identifier --></identifier>
   <effectiveTime value="[dateTime]"/><!-- 0..1 Contract Term Valued Item Effective Tiem -->
   <quantity><!-- 0..1 Quantity Contract Term Valued Item Count --></quantity>
   <unitPrice><!-- 0..1 Money Contract Term Valued Item fee, charge, or cost --></unitPrice>
   <factor value="[decimal]"/><!-- 0..1 Contract Term Valued Item Price Scaling Factor -->
   <points value="[decimal]"/><!-- 0..1 Contract Term Valued Item Difficulty Scaling Factor -->
   <net><!-- 0..1 Money Total Contract Term Valued Item Value --></net>
  </valuedItem>
  <group><!-- 0..* Content as for Contract.term Nested Contract Term Group --></group>
 </term>
 <binding[x]><!-- 0..1 Attachment|Reference(Composition|DocumentReference|
   QuestionnaireAnswers) Binding Contract --></binding[x]>
 <friendly>  <!-- 0..* Contract Friendly Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireAnswers) Easily comprehended representation of this Contract --></content[x]>
 </friendly>
 <legal>  <!-- 0..* Contract Legal Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireAnswers) Contract Legal Text --></content[x]>
 </legal>
 <rule>  <!-- 0..* Computable Contract Language -->
  <content[x]><!-- 1..1 Attachment|Reference(DocumentReference) Computable Contract Rules --></content[x]>
 </rule>
</Contract>

JSON Template 

{doco
  "resourceType" : "Contract",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Contract identifier
  "issued" : "<dateTime>", // When this Contract was issued
  "applies" : { Period }, // Effective time
  "subject" : [{ Reference(Any) }], // Subject of this Contract
  "authority" : [{ Reference(Organization) }], // 
     Authority under which this Contract has standing
  "domain" : [{ Reference(Location) }], // Domain in which this Contract applies
  "type" : { CodeableConcept }, // Contract Tyoe
  "subType" : [{ CodeableConcept }], // Contract Subtype
  "action" : [{ CodeableConcept }], // Contract Action
  "actionReason" : [{ CodeableConcept }], // Contract Action Reason
  "actor" : [{ // Contract Actor
    "entity" : { Reference(Contract|Device|Group|Location|Organization|Patient|
    Practitioner|RelatedPerson|Substance|Supply) }, // R!  Contract Actor Type
    "role" : [{ CodeableConcept }] // Contract  Actor Role
  }],
  "valuedItem" : [{ // Contract Valued Item
    // entity[x]: Contract Valued Item Type. One of these 2:
    "entityCodeableConcept" : { CodeableConcept },
    "entityReference" : { Reference(Any) },
    "identifier" : { Identifier }, // Contract Valued Item Identifier
    "effectiveTime" : "<dateTime>", // Contract Valued Item Effective Tiem
    "quantity" : { Quantity }, // Count of Contract Valued Items
    "unitPrice" : { Money }, // Contract Valued Item fee, charge, or cost
    "factor" : <decimal>, // Contract Valued Item Price Scaling Factor
    "points" : <decimal>, // Contract Valued Item Difficulty Scaling Factor
    "net" : { Money } // Total Contract Valued Item Value
  }],
  "signer" : [{ // Contract Signer
    "type" : { Coding }, // R!  Contract Signer Type
    "party" : { Reference(Organization|Patient|Practitioner|RelatedPerson) }, // R!  
      Contract Signatory Party
    "signature" : "<string>" // R!  Contract Documentation Signature
  }],
  "term" : [{ // Contract Term List
    "identifier" : { Identifier }, // Contract Term identifier
    "issued" : "<dateTime>", // Contract Term Issue Date Time
    "applies" : { Period }, // Contract Term Effective Time
    "type" : { CodeableConcept }, // Contract Term Type
    "subType" : { CodeableConcept }, // Contract Term Subtype
    "subject" : { Reference(Any) }, // Subject of this Contract Term
    "action" : [{ CodeableConcept }], // Contract Term Action
    "actionReason" : [{ CodeableConcept }], // Contract Term Action Reason
    "actor" : [{ // Contract Term Actor List
      "entity" : { Reference(Contract|Device|Group|Location|Organization|
     Patient|Practitioner|RelatedPerson|Substance|Supply) }, // R!  Contract Term Actor
      "role" : [{ CodeableConcept }] // Contract Term Actor Role
    }],
    "text" : "<string>", // Human readable Contract term text
    "valuedItem" : [{ // Contract Term Valued Item
      // entity[x]: Contract Term Valued Item Type. One of these 2:
      "entityCodeableConcept" : { CodeableConcept },
      "entityReference" : { Reference(Any) },
      "identifier" : { Identifier }, // Contract Term Valued Item Identifier
      "effectiveTime" : "<dateTime>", // Contract Term Valued Item Effective Tiem
      "quantity" : { Quantity }, // Contract Term Valued Item Count
      "unitPrice" : { Money }, // Contract Term Valued Item fee, charge, or cost
      "factor" : <decimal>, // Contract Term Valued Item Price Scaling Factor
      "points" : <decimal>, // Contract Term Valued Item Difficulty Scaling Factor
      "net" : { Money } // Total Contract Term Valued Item Value
    }],
    "group" : [{ Content as for Contract.term }] // Nested Contract Term Group
  }],
  // binding[x]: Binding Contract. One of these 2:
  "bindingAttachment" : { Attachment },
  "bindingReference" : { Reference(Composition|DocumentReference|
   QuestionnaireAnswers) },
  "friendly" : [{ // Contract Friendly Language
    // content[x]: Easily comprehended representation of this Contract. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireAnswers) }
  }],
  "legal" : [{ // Contract Legal Language
    // content[x]: Contract Legal Text. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireAnswers) }
  }],
  "rule" : [{ // Computable Contract Language
    // content[x]: Computable Contract Rules. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(DocumentReference) }
  }]
}

 

Alternate definitions: Schema / Schematron , Resource Profile ( XML , JSON ), Questionnaire

5.7.2.1 Terminology Bindings

Path Definition Type Reference
Contract.type List of overall contract codes Example http://hl7.org/fhir/vs/contract-type
Contract.subType Detailed codes within the above Example http://hl7.org/fhir/vs/contract-subtype
Contract.action
Contract.term.action 		Detailed codes for the contract action Example http://hl7.org/fhir/vs/contract-action
Contract.actionReason
Contract.term.actionReason 		Detailed codes for the contract action reason Example http://hl7.org/fhir/vs/contract-actionreason
Contract.actor.role
Contract.term.actor.role 		Detailed codes for the contract actor role Example http://hl7.org/fhir/vs/contract-actorrole
Contract.signer.type List of parties who may be signing Example http://hl7.org/fhir/vs/contract-signer-type
Contract.term.type Detailed codes for the types of contract provisions Example http://hl7.org/fhir/vs/contract-term-type
Contract.term.subType Detailed codes for the subtypes of contract provisions Example http://hl7.org/fhir/vs/contract-term-subtype

5.7.3 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Paths
actor reference Contract Actor Type Contract.actor.entity
( Supply , Device , Patient , Organization , Location , Substance , Practitioner , Contract , Group , RelatedPerson )
identifier token The identity of the contract Contract.identifier
patient reference The identity of the target of the contract (if a patient) Contract.subject
( Patient )
signer reference Contract Signatory Party Contract.signer.party
( Patient , Organization , Practitioner , RelatedPerson )
subject reference The identity of the target of the contract Contract.subject
( Patient )