PATIENT ADMINISTRTAION (PA) Workgroup Development Draft

5.8 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.8.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.8.2 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Contract DomainResourceContract
... identifier Σ0..1IdentifierContract identifier
... issued Σ0..1dateTimeWhen this Contract was issued
... applies Σ0..1PeriodEffective time
... subject Σ0..*AnySubject of this Contract
... authority 0..*OrganizationAuthority under which this Contract has standing
... domain 0..*LocationDomain in which this Contract applies
... type Σ0..1CodeableConceptContract Tyoe
Contract Type Codes (Example)
... subType Σ0..*CodeableConceptContract Subtype
Contract Subtype Codes (Example)
... action 0..*CodeableConceptContract Action
Contract Action Codes (Example)
... actionReason 0..*CodeableConceptContract Action Reason
PurposeOfUse (Example)
... actor 0..*ElementContract Actor
.... entity 1..1Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | SupplyContract Actor Type
.... role 0..*CodeableConceptContract Actor Role
Contract Actor Role Codes (Example)
... valuedItem 0..*ElementContract Valued Item
.... entity[x] Contract Valued Item Type
..... entityCodeableConcept0..1CodeableConcept
..... entityReference0..1Any
.... identifier 0..1IdentifierContract Valued Item Identifier
.... effectiveTime 0..1dateTimeContract Valued Item Effective Tiem
.... quantity 0..1QuantityCount of Contract Valued Items
.... unitPrice 0..1MoneyContract Valued Item fee, charge, or cost
.... factor 0..1decimalContract Valued Item Price Scaling Factor
.... points 0..1decimalContract Valued Item Difficulty Scaling Factor
.... net 0..1MoneyTotal Contract Valued Item Value
... signer 0..*ElementContract Signer
.... type 1..1CodingContract Signer Type
Signature Type Codes (Preferred)
.... party 1..1Organization | Patient | Practitioner | RelatedPersonContract Signatory Party
.... signature 1..1stringContract Documentation Signature
... term 0..*ElementContract Term List
.... identifier Σ0..1IdentifierContract Term identifier
.... issued Σ0..1dateTimeContract Term Issue Date Time
.... applies Σ0..1PeriodContract Term Effective Time
.... type 0..1CodeableConceptContract Term Type
Contract Term Type Codes (Example)
.... subType 0..1CodeableConceptContract Term Subtype
Contract Term Type Codes (Example)
.... subject 0..1AnySubject of this Contract Term
.... action 0..*CodeableConceptContract Term Action
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptContract Term Action Reason
PurposeOfUse (Example)
.... actor 0..*ElementContract Term Actor List
..... entity 1..1Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | SupplyContract Term Actor
..... role 0..*CodeableConceptContract Term Actor Role
Contract Actor Role Codes (Example)
.... text 0..1stringHuman readable Contract term text
.... valuedItem 0..*ElementContract Term Valued Item
..... entity[x] Contract Term Valued Item Type
...... entityCodeableConcept0..1CodeableConcept
...... entityReference0..1Any
..... identifier 0..1IdentifierContract Term Valued Item Identifier
..... effectiveTime 0..1dateTimeContract Term Valued Item Effective Tiem
..... quantity 0..1QuantityContract Term Valued Item Count
..... unitPrice 0..1MoneyContract Term Valued Item fee, charge, or cost
..... factor 0..1decimalContract Term Valued Item Price Scaling Factor
..... points 0..1decimalContract Term Valued Item Difficulty Scaling Factor
..... net 0..1MoneyTotal Contract Term Valued Item Value
.... group 0..*see termNested Contract Term Group
... binding[x] Binding Contract
.... bindingAttachment0..1Attachment
.... bindingReference0..1Composition | DocumentReference | QuestionnaireAnswers
... friendly 0..*ElementContract Friendly Language
.... content[x] Easily comprehended representation of this Contract
..... contentAttachment1..1Attachment
..... contentReference1..1Composition | DocumentReference | QuestionnaireAnswers
... legal 0..*ElementContract Legal Language
.... content[x] Contract Legal Text
..... contentAttachment1..1Attachment
..... contentReference1..1Composition | DocumentReference | QuestionnaireAnswers
... rule 0..*ElementComputable Contract Language
.... content[x] Computable Contract Rules
..... contentAttachment1..1Attachment
..... contentReference1..1DocumentReference

UML Diagram

Contract (DomainResource)Unique identifier for this Contractidentifier : Identifier 0..1When this Contract was issuedissued : dateTime 0..1Relevant time or time-period when this Contract is applicableapplies : Period 0..1Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and servicessubject : 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 policiesauthority : 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 resourcesdomain : 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, etctype : CodeableConcept 0..1 « (List of overall contract codesContract Type Codes) »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 consentsubType : CodeableConcept 0..* « (Detailed codes within the aboveContract Subtype Codes) »Action stipulated by this Contractaction : CodeableConcept 0..* « (Detailed codes for the contract actionContract Action Codes) »Reason for action stipulated by this ContractactionReason : CodeableConcept 0..* « (Detailed codes for the contract action reasonPurposeOfUse) »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 Contractbinding[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 0..1ActorWho or what actors are assigned roles in this Contractentity : Reference(Contract|Device|Group|Location| Organization|Patient|Practitioner| RelatedPerson|Substance|Supply) 1..1Role type of actors assigned roles in this Contractrole : CodeableConcept 0..* « (Detailed codes for the contract actor roleContract Actor Role Codes) »ValuedItemSpecific type of Contract Valued Item that may be pricedentity[x] : CodeableConcept|Reference(Any) 0..1Identifies a Contract Valued Item instanceidentifier : Identifier 0..1Indicates the time during which this Contract ValuedItem information is effectiveeffectiveTime : dateTime 0..1Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instancesquantity : Quantity 0..1A Contract Valued Item unit valuation measureunitPrice : Money 0..1A 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 amountfactor : decimal 0..1An 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 pointpoints : decimal 0..1Expresses 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 suppliednet : Money 0..1SignatoryRole of this Contract signer, e.g., notary, granteetype : Coding 1..1 « List of parties who may be signingSignature Type Codes+ »Party which is a signator to this Contractparty : Reference(Organization|Patient| Practitioner|RelatedPerson) 1..1Legally binding Contract DSIG signature contents in Base64signature : string 1..1TermUnique identifier for this particular Contract Provisionidentifier : Identifier 0..1When this Contract Provision was issuedissued : dateTime 0..1Relevant time or time-period when this Contract Provision is applicableapplies : Period 0..1Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g., life time maximum benefittype : CodeableConcept 0..1 « (Detailed codes for the types of contract provisionsContract Term Type Codes) »Subtype of this Contract Provision, e.g., life time maximum payment for a contract term for specific valued item, e.g., disability paymentsubType : CodeableConcept 0..1 « (Detailed codes for the subtypes of contract provisionsContract Term Type Codes) »Who or what this Contract Provision is aboutsubject : Reference(Any) 0..1Action stipulated by this Contract Provisionaction : CodeableConcept 0..* « (Detailed codes for the contract actionContract Action Codes) »Reason or purpose for the action stipulated by this Contract ProvisionactionReason : CodeableConcept 0..* « (Detailed codes for the contract action reasonPurposeOfUse) »Human readable form of this Contract Provisiontext : string 0..1TermActorThe actor assigned a role in this Contract Provisionentity : Reference(Contract|Device|Group|Location| Organization|Patient|Practitioner| RelatedPerson|Substance|Supply) 1..1Role played by the actor assigned this role in this Contract Provisionrole : CodeableConcept 0..* « (Detailed codes for the contract actor roleContract Actor Role Codes) »TermValuedItemSpecific type of Contract Provision Valued Item that may be pricedentity[x] : CodeableConcept|Reference(Any) 0..1Identifies a Contract Provision Valued Item instanceidentifier : Identifier 0..1Indicates the time during which this Contract Term ValuedItem information is effectiveeffectiveTime : dateTime 0..1Specifies the units by which the Contract Provision Valued Item is measured or counted, and quantifies the countable or measurable Contract Term Valued Item instancesquantity : Quantity 0..1A Contract Provision Valued Item unit valuation measureunitPrice : Money 0..1A 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 amountfactor : decimal 0..1An 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 pointpoints : decimal 0..1Expresses 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 suppliednet : Money 0..1FriendlyLanguageHuman readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandabilitycontent[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 1..1LegalLanguageContract legal text in human renderable formcontent[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 1..1ComputableLanguageComputable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal)content[x] : Attachment|Reference(DocumentReference) 1..1List of Contract actorsactor0..*Contract Valued Item ListvaluedItem0..*Party signing this Contractsigner0..*List of actors participating in this Contract Provisionactor0..*Contract Provision Valued Item ListvaluedItem0..*Nested group of Contract Provisionsgroup0..*One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groupsterm0..*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 agreementfriendly0..*List of Legal expressions or representations of this Contractlegal0..*List of Computable Policy Rule Language Representations of this Contractrule0..*

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Contract DomainResourceContract
... identifier Σ0..1IdentifierContract identifier
... issued Σ0..1dateTimeWhen this Contract was issued
... applies Σ0..1PeriodEffective time
... subject Σ0..*AnySubject of this Contract
... authority 0..*OrganizationAuthority under which this Contract has standing
... domain 0..*LocationDomain in which this Contract applies
... type Σ0..1CodeableConceptContract Tyoe
Contract Type Codes (Example)
... subType Σ0..*CodeableConceptContract Subtype
Contract Subtype Codes (Example)
... action 0..*CodeableConceptContract Action
Contract Action Codes (Example)
... actionReason 0..*CodeableConceptContract Action Reason
PurposeOfUse (Example)
... actor 0..*ElementContract Actor
.... entity 1..1Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | SupplyContract Actor Type
.... role 0..*CodeableConceptContract Actor Role
Contract Actor Role Codes (Example)
... valuedItem 0..*ElementContract Valued Item
.... entity[x] Contract Valued Item Type
..... entityCodeableConcept0..1CodeableConcept
..... entityReference0..1Any
.... identifier 0..1IdentifierContract Valued Item Identifier
.... effectiveTime 0..1dateTimeContract Valued Item Effective Tiem
.... quantity 0..1QuantityCount of Contract Valued Items
.... unitPrice 0..1MoneyContract Valued Item fee, charge, or cost
.... factor 0..1decimalContract Valued Item Price Scaling Factor
.... points 0..1decimalContract Valued Item Difficulty Scaling Factor
.... net 0..1MoneyTotal Contract Valued Item Value
... signer 0..*ElementContract Signer
.... type 1..1CodingContract Signer Type
Signature Type Codes (Preferred)
.... party 1..1Organization | Patient | Practitioner | RelatedPersonContract Signatory Party
.... signature 1..1stringContract Documentation Signature
... term 0..*ElementContract Term List
.... identifier Σ0..1IdentifierContract Term identifier
.... issued Σ0..1dateTimeContract Term Issue Date Time
.... applies Σ0..1PeriodContract Term Effective Time
.... type 0..1CodeableConceptContract Term Type
Contract Term Type Codes (Example)
.... subType 0..1CodeableConceptContract Term Subtype
Contract Term Type Codes (Example)
.... subject 0..1AnySubject of this Contract Term
.... action 0..*CodeableConceptContract Term Action
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptContract Term Action Reason
PurposeOfUse (Example)
.... actor 0..*ElementContract Term Actor List
..... entity 1..1Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance | SupplyContract Term Actor
..... role 0..*CodeableConceptContract Term Actor Role
Contract Actor Role Codes (Example)
.... text 0..1stringHuman readable Contract term text
.... valuedItem 0..*ElementContract Term Valued Item
..... entity[x] Contract Term Valued Item Type
...... entityCodeableConcept0..1CodeableConcept
...... entityReference0..1Any
..... identifier 0..1IdentifierContract Term Valued Item Identifier
..... effectiveTime 0..1dateTimeContract Term Valued Item Effective Tiem
..... quantity 0..1QuantityContract Term Valued Item Count
..... unitPrice 0..1MoneyContract Term Valued Item fee, charge, or cost
..... factor 0..1decimalContract Term Valued Item Price Scaling Factor
..... points 0..1decimalContract Term Valued Item Difficulty Scaling Factor
..... net 0..1MoneyTotal Contract Term Valued Item Value
.... group 0..*see termNested Contract Term Group
... binding[x] Binding Contract
.... bindingAttachment0..1Attachment
.... bindingReference0..1Composition | DocumentReference | QuestionnaireAnswers
... friendly 0..*ElementContract Friendly Language
.... content[x] Easily comprehended representation of this Contract
..... contentAttachment1..1Attachment
..... contentReference1..1Composition | DocumentReference | QuestionnaireAnswers
... legal 0..*ElementContract Legal Language
.... content[x] Contract Legal Text
..... contentAttachment1..1Attachment
..... contentReference1..1Composition | DocumentReference | QuestionnaireAnswers
... rule 0..*ElementComputable Contract Language
.... content[x] Computable Contract Rules
..... contentAttachment1..1Attachment
..... contentReference1..1DocumentReference

UML Diagram

Contract (DomainResource)Unique identifier for this Contractidentifier : Identifier 0..1When this Contract was issuedissued : dateTime 0..1Relevant time or time-period when this Contract is applicableapplies : Period 0..1Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and servicessubject : 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 policiesauthority : 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 resourcesdomain : 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, etctype : CodeableConcept 0..1 « (List of overall contract codesContract Type Codes) »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 consentsubType : CodeableConcept 0..* « (Detailed codes within the aboveContract Subtype Codes) »Action stipulated by this Contractaction : CodeableConcept 0..* « (Detailed codes for the contract actionContract Action Codes) »Reason for action stipulated by this ContractactionReason : CodeableConcept 0..* « (Detailed codes for the contract action reasonPurposeOfUse) »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 Contractbinding[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 0..1ActorWho or what actors are assigned roles in this Contractentity : Reference(Contract|Device|Group|Location| Organization|Patient|Practitioner| RelatedPerson|Substance|Supply) 1..1Role type of actors assigned roles in this Contractrole : CodeableConcept 0..* « (Detailed codes for the contract actor roleContract Actor Role Codes) »ValuedItemSpecific type of Contract Valued Item that may be pricedentity[x] : CodeableConcept|Reference(Any) 0..1Identifies a Contract Valued Item instanceidentifier : Identifier 0..1Indicates the time during which this Contract ValuedItem information is effectiveeffectiveTime : dateTime 0..1Specifies the units by which the Contract Valued Item is measured or counted, and quantifies the countable or measurable Contract Valued Item instancesquantity : Quantity 0..1A Contract Valued Item unit valuation measureunitPrice : Money 0..1A 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 amountfactor : decimal 0..1An 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 pointpoints : decimal 0..1Expresses 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 suppliednet : Money 0..1SignatoryRole of this Contract signer, e.g., notary, granteetype : Coding 1..1 « List of parties who may be signingSignature Type Codes+ »Party which is a signator to this Contractparty : Reference(Organization|Patient| Practitioner|RelatedPerson) 1..1Legally binding Contract DSIG signature contents in Base64signature : string 1..1TermUnique identifier for this particular Contract Provisionidentifier : Identifier 0..1When this Contract Provision was issuedissued : dateTime 0..1Relevant time or time-period when this Contract Provision is applicableapplies : Period 0..1Type of Contract Provision such as specific requirements, purposes for actions, obligations, prohibitions, e.g., life time maximum benefittype : CodeableConcept 0..1 « (Detailed codes for the types of contract provisionsContract Term Type Codes) »Subtype of this Contract Provision, e.g., life time maximum payment for a contract term for specific valued item, e.g., disability paymentsubType : CodeableConcept 0..1 « (Detailed codes for the subtypes of contract provisionsContract Term Type Codes) »Who or what this Contract Provision is aboutsubject : Reference(Any) 0..1Action stipulated by this Contract Provisionaction : CodeableConcept 0..* « (Detailed codes for the contract actionContract Action Codes) »Reason or purpose for the action stipulated by this Contract ProvisionactionReason : CodeableConcept 0..* « (Detailed codes for the contract action reasonPurposeOfUse) »Human readable form of this Contract Provisiontext : string 0..1TermActorThe actor assigned a role in this Contract Provisionentity : Reference(Contract|Device|Group|Location| Organization|Patient|Practitioner| RelatedPerson|Substance|Supply) 1..1Role played by the actor assigned this role in this Contract Provisionrole : CodeableConcept 0..* « (Detailed codes for the contract actor roleContract Actor Role Codes) »TermValuedItemSpecific type of Contract Provision Valued Item that may be pricedentity[x] : CodeableConcept|Reference(Any) 0..1Identifies a Contract Provision Valued Item instanceidentifier : Identifier 0..1Indicates the time during which this Contract Term ValuedItem information is effectiveeffectiveTime : dateTime 0..1Specifies the units by which the Contract Provision Valued Item is measured or counted, and quantifies the countable or measurable Contract Term Valued Item instancesquantity : Quantity 0..1A Contract Provision Valued Item unit valuation measureunitPrice : Money 0..1A 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 amountfactor : decimal 0..1An 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 pointpoints : decimal 0..1Expresses 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 suppliednet : Money 0..1FriendlyLanguageHuman readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandabilitycontent[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 1..1LegalLanguageContract legal text in human renderable formcontent[x] : Attachment|Reference(Composition| DocumentReference|QuestionnaireAnswers) 1..1ComputableLanguageComputable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal)content[x] : Attachment|Reference(DocumentReference) 1..1List of Contract actorsactor0..*Contract Valued Item ListvaluedItem0..*Party signing this Contractsigner0..*List of actors participating in this Contract Provisionactor0..*Contract Provision Valued Item ListvaluedItem0..*Nested group of Contract Provisionsgroup0..*One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groupsterm0..*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 agreementfriendly0..*List of Legal expressions or representations of this Contractlegal0..*List of Computable Policy Rule Language Representations of this Contractrule0..*

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)

5.8.2.1 Terminology Bindings

PathDefinitionTypeReference
Contract.type List of overall contract codesExamplehttp://hl7.org/fhir/vs/contract-type
Contract.subType Detailed codes within the aboveExamplehttp://hl7.org/fhir/vs/contract-subtype
Contract.action
Contract.term.action
Detailed codes for the contract actionExamplehttp://hl7.org/fhir/vs/contract-action
Contract.actionReason
Contract.term.actionReason
Detailed codes for the contract action reasonExamplehttp://hl7.org/fhir/v3/vs/PurposeOfUse
Contract.actor.role
Contract.term.actor.role
Detailed codes for the contract actor roleExamplehttp://hl7.org/fhir/vs/contract-actorrole
Contract.signer.type List of parties who may be signingPreferredhttp://hl7.org/fhir/vs/contract-signer-type
Contract.term.type Detailed codes for the types of contract provisionsExamplehttp://hl7.org/fhir/vs/contract-term-type
Contract.term.subType Detailed codes for the subtypes of contract provisionsExamplehttp://hl7.org/fhir/vs/contract-term-subtype

5.8.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.

NameTypeDescriptionPaths
actorreferenceContract Actor TypeContract.actor.entity
(Practitioner, Group, Organization, Device, Supply, Patient, Substance, Contract, RelatedPerson, Location)
identifiertokenThe identity of the contractContract.identifier
patientreferenceThe identity of the target of the contract (if a patient)Contract.subject
(Patient)
signerreferenceContract Signatory PartyContract.signer.party
(Practitioner, Organization, Patient, RelatedPerson)
subjectreferenceThe identity of the target of the contractContract.subject
(Patient)