Connectathon 11 Snapshot

This page is part of the FHIR Specification (v1.2.0: STU 3 Draft). 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

7.11 Resource Contract - Content

Financial Management Work GroupMaturity Level: 0Compartments: Not linked to any defined compartments

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

7.11.1 Scope and Usage

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

This resource is referenced by Coverage and EligibilityResponse

7.11.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..*Reference(Any)Subject of this Contract
... authority 0..*Reference(Organization)Authority under which this Contract has standing
... domain 0..*Reference(Location)Domain 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..*BackboneElementContract Actor
.... entity 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Actor Type
.... role 0..*CodeableConceptContract Actor Role
Contract Actor Role Codes (Example)
... valuedItem 0..*BackboneElementContract Valued Item
.... entity[x] 0..1Contract Valued Item Type
..... entityCodeableConceptCodeableConcept
..... entityReferenceReference(Any)
.... identifier 0..1IdentifierContract Valued Item Identifier
.... effectiveTime 0..1dateTimeContract Valued Item Effective Tiem
.... quantity 0..1SimpleQuantityCount 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..*BackboneElementContract Signer
.... type 1..1CodingContract Signer Type
Signature Type Codes (Preferred)
.... party 1..1Reference(Organization | Patient | Practitioner | RelatedPerson)Contract Signatory Party
.... signature 1..1stringContract Documentation Signature
... term 0..*BackboneElementContract 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..1Reference(Any)Subject of this Contract Term
.... action 0..*CodeableConceptContract Term Action
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptContract Term Action Reason
PurposeOfUse (Example)
.... actor 0..*BackboneElementContract Term Actor List
..... entity 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Term Actor
..... role 0..*CodeableConceptContract Term Actor Role
Contract Actor Role Codes (Example)
.... text 0..1stringHuman readable Contract term text
.... valuedItem 0..*BackboneElementContract Term Valued Item
..... entity[x] 0..1Contract Term Valued Item Type
...... entityCodeableConceptCodeableConcept
...... entityReferenceReference(Any)
..... identifier 0..1IdentifierContract Term Valued Item Identifier
..... effectiveTime 0..1dateTimeContract Term Valued Item Effective Tiem
..... quantity 0..1SimpleQuantityContract 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] 0..1Binding Contract
.... bindingAttachmentAttachment
.... bindingReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... friendly 0..*BackboneElementContract Friendly Language
.... content[x] 1..1Easily comprehended representation of this Contract
..... contentAttachmentAttachment
..... contentReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... legal 0..*BackboneElementContract Legal Language
.... content[x] 1..1Contract Legal Text
..... contentAttachmentAttachment
..... contentReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... rule 0..*BackboneElementComputable Contract Language
.... content[x] 1..1Computable Contract Rules
..... contentAttachmentAttachment
..... contentReferenceReference(DocumentReference)

doco Documentation for this format

UML Diagram

Contract (DomainResource)Unique identifier for this Contractidentifier : Identifier [0..1]When this Contract was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract is applicableapplies : Period [0..1]Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and servicessubject : Reference [0..*] « Any »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 [0..*] « Organization »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 [0..*] « Location »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 codes. (Strength=Example)Contract Type ?? »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 above. (Strength=Example)Contract Subtype ?? »Action stipulated by this Contractaction : CodeableConcept [0..*] « Detailed codes for the contract action. (Strength=Example)Contract Action ?? »Reason for action stipulated by this ContractactionReason : CodeableConcept [0..*] « Detailed codes for the contract action reason. (Strength=Example)PurposeOfUse?? »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] : Type [0..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »ActorWho or what actors are assigned roles in this Contractentity : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role type of actors assigned roles in this Contractrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »ValuedItemSpecific type of Contract Valued Item that may be pricedentity[x] : Type [0..1] « CodeableConcept|Reference(Any) »Identifies a Contract Valued Item instanceidentifier : Identifier [0..1]Indicates the time during which this Contract ValuedItem information is effectiveeffectiveTime : 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 instancesquantity : Quantity(SimpleQuantity) [0..1]A Contract Valued Item unit valuation measureunitPrice : Quantity(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 amountfactor : 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 pointpoints : 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 suppliednet : Quantity(Money) [0..1]SignatoryRole of this Contract signer, e.g. notary, granteetype : Coding [1..1] « List of parties who may be signing. (Strength=Preferred)Signature Type ? »Party which is a signator to this Contractparty : Reference [1..1] « Organization|Patient|Practitioner| RelatedPerson »Legally binding Contract DSIG signature contents in Base64signature : string [1..1]TermUnique identifier for this particular Contract Provisionidentifier : Identifier [0..1]When this Contract Provision was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract Provision is applicableapplies : Period [0..1]Type 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 provisions. (Strength=Example)Contract Term Type ?? »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 provisions. (Strength=Example)Contract Term Type ?? »Who or what this Contract Provision is aboutsubject : Reference [0..1] « Any »Action stipulated by this Contract Provisionaction : CodeableConcept [0..*] « Detailed codes for the contract action. (Strength=Example)Contract Action ?? »Reason or purpose for the action stipulated by this Contract ProvisionactionReason : CodeableConcept [0..*] « Detailed codes for the contract action reason. (Strength=Example)PurposeOfUse?? »Human readable form of this Contract Provisiontext : string [0..1]TermActorThe actor assigned a role in this Contract Provisionentity : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role played by the actor assigned this role in this Contract Provisionrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »TermValuedItemSpecific type of Contract Provision Valued Item that may be pricedentity[x] : Type [0..1] « CodeableConcept|Reference(Any) »Identifies a Contract Provision Valued Item instanceidentifier : Identifier [0..1]Indicates the time during which this Contract Term ValuedItem information is effectiveeffectiveTime : 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 instancesquantity : Quantity(SimpleQuantity) [0..1]A Contract Provision Valued Item unit valuation measureunitPrice : Quantity(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 amountfactor : 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 pointpoints : 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 suppliednet : Quantity(Money) [0..1]FriendlyLanguageHuman readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandabilitycontent[x] : Type [1..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »LegalLanguageContract legal text in human renderable formcontent[x] : Type [1..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »ComputableLanguageComputable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal)content[x] : Type [1..1] « Attachment|Reference(DocumentReference) »List of Contract actorsactor[0..*]Contract Valued Item ListvaluedItem[0..*]Party signing this Contractsigner[0..*]List of actors participating in this Contract Provisionactor[0..*]Contract Provision Valued Item ListvaluedItem[0..*]Nested group of Contract Provisionsgroup[0..*]One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groupsterm[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 agreementfriendly[0..*]List of Legal expressions or representations of this Contractlegal[0..*]List of Computable Policy Rule Language Representations of this Contractrule[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) 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(SimpleQuantity) Count of Contract Valued Items --></quantity>
  <unitPrice><!-- 0..1 Quantity(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 Quantity(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) 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(SimpleQuantity) Contract Term Valued Item Count --></quantity>
   <unitPrice><!-- 0..1 Quantity(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 Quantity(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|
   QuestionnaireResponse) Binding Contract --></binding[x]>
 <friendly>  <!-- 0..* Contract Friendly Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireResponse) Easily comprehended representation of this Contract --></content[x]>
 </friendly>
 <legal>  <!-- 0..* Contract Legal Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireResponse) 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) }, // 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(SimpleQuantity) }, // Count of Contract Valued Items
    "unitPrice" : { Quantity(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" : { Quantity(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) }, // 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(SimpleQuantity) }, // Contract Term Valued Item Count
      "unitPrice" : { Quantity(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" : { Quantity(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|
   QuestionnaireResponse) },
  "friendly" : [{ // Contract Friendly Language
    // content[x]: Easily comprehended representation of this Contract. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireResponse) }
  }],
  "legal" : [{ // Contract Legal Language
    // content[x]: Contract Legal Text. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireResponse) }
  }],
  "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..*Reference(Any)Subject of this Contract
... authority 0..*Reference(Organization)Authority under which this Contract has standing
... domain 0..*Reference(Location)Domain 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..*BackboneElementContract Actor
.... entity 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Actor Type
.... role 0..*CodeableConceptContract Actor Role
Contract Actor Role Codes (Example)
... valuedItem 0..*BackboneElementContract Valued Item
.... entity[x] 0..1Contract Valued Item Type
..... entityCodeableConceptCodeableConcept
..... entityReferenceReference(Any)
.... identifier 0..1IdentifierContract Valued Item Identifier
.... effectiveTime 0..1dateTimeContract Valued Item Effective Tiem
.... quantity 0..1SimpleQuantityCount 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..*BackboneElementContract Signer
.... type 1..1CodingContract Signer Type
Signature Type Codes (Preferred)
.... party 1..1Reference(Organization | Patient | Practitioner | RelatedPerson)Contract Signatory Party
.... signature 1..1stringContract Documentation Signature
... term 0..*BackboneElementContract 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..1Reference(Any)Subject of this Contract Term
.... action 0..*CodeableConceptContract Term Action
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptContract Term Action Reason
PurposeOfUse (Example)
.... actor 0..*BackboneElementContract Term Actor List
..... entity 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Term Actor
..... role 0..*CodeableConceptContract Term Actor Role
Contract Actor Role Codes (Example)
.... text 0..1stringHuman readable Contract term text
.... valuedItem 0..*BackboneElementContract Term Valued Item
..... entity[x] 0..1Contract Term Valued Item Type
...... entityCodeableConceptCodeableConcept
...... entityReferenceReference(Any)
..... identifier 0..1IdentifierContract Term Valued Item Identifier
..... effectiveTime 0..1dateTimeContract Term Valued Item Effective Tiem
..... quantity 0..1SimpleQuantityContract 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] 0..1Binding Contract
.... bindingAttachmentAttachment
.... bindingReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... friendly 0..*BackboneElementContract Friendly Language
.... content[x] 1..1Easily comprehended representation of this Contract
..... contentAttachmentAttachment
..... contentReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... legal 0..*BackboneElementContract Legal Language
.... content[x] 1..1Contract Legal Text
..... contentAttachmentAttachment
..... contentReferenceReference(Composition | DocumentReference | QuestionnaireResponse)
... rule 0..*BackboneElementComputable Contract Language
.... content[x] 1..1Computable Contract Rules
..... contentAttachmentAttachment
..... contentReferenceReference(DocumentReference)

doco Documentation for this format

UML Diagram

Contract (DomainResource)Unique identifier for this Contractidentifier : Identifier [0..1]When this Contract was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract is applicableapplies : Period [0..1]Who and/or what this Contract is about: typically a Patient, Organization, or valued items such as goods and servicessubject : Reference [0..*] « Any »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 [0..*] « Organization »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 [0..*] « Location »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 codes. (Strength=Example)Contract Type ?? »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 above. (Strength=Example)Contract Subtype ?? »Action stipulated by this Contractaction : CodeableConcept [0..*] « Detailed codes for the contract action. (Strength=Example)Contract Action ?? »Reason for action stipulated by this ContractactionReason : CodeableConcept [0..*] « Detailed codes for the contract action reason. (Strength=Example)PurposeOfUse?? »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] : Type [0..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »ActorWho or what actors are assigned roles in this Contractentity : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role type of actors assigned roles in this Contractrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »ValuedItemSpecific type of Contract Valued Item that may be pricedentity[x] : Type [0..1] « CodeableConcept|Reference(Any) »Identifies a Contract Valued Item instanceidentifier : Identifier [0..1]Indicates the time during which this Contract ValuedItem information is effectiveeffectiveTime : 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 instancesquantity : Quantity(SimpleQuantity) [0..1]A Contract Valued Item unit valuation measureunitPrice : Quantity(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 amountfactor : 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 pointpoints : 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 suppliednet : Quantity(Money) [0..1]SignatoryRole of this Contract signer, e.g. notary, granteetype : Coding [1..1] « List of parties who may be signing. (Strength=Preferred)Signature Type ? »Party which is a signator to this Contractparty : Reference [1..1] « Organization|Patient|Practitioner| RelatedPerson »Legally binding Contract DSIG signature contents in Base64signature : string [1..1]TermUnique identifier for this particular Contract Provisionidentifier : Identifier [0..1]When this Contract Provision was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract Provision is applicableapplies : Period [0..1]Type 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 provisions. (Strength=Example)Contract Term Type ?? »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 provisions. (Strength=Example)Contract Term Type ?? »Who or what this Contract Provision is aboutsubject : Reference [0..1] « Any »Action stipulated by this Contract Provisionaction : CodeableConcept [0..*] « Detailed codes for the contract action. (Strength=Example)Contract Action ?? »Reason or purpose for the action stipulated by this Contract ProvisionactionReason : CodeableConcept [0..*] « Detailed codes for the contract action reason. (Strength=Example)PurposeOfUse?? »Human readable form of this Contract Provisiontext : string [0..1]TermActorThe actor assigned a role in this Contract Provisionentity : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role played by the actor assigned this role in this Contract Provisionrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »TermValuedItemSpecific type of Contract Provision Valued Item that may be pricedentity[x] : Type [0..1] « CodeableConcept|Reference(Any) »Identifies a Contract Provision Valued Item instanceidentifier : Identifier [0..1]Indicates the time during which this Contract Term ValuedItem information is effectiveeffectiveTime : 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 instancesquantity : Quantity(SimpleQuantity) [0..1]A Contract Provision Valued Item unit valuation measureunitPrice : Quantity(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 amountfactor : 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 pointpoints : 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 suppliednet : Quantity(Money) [0..1]FriendlyLanguageHuman readable rendering of this Contract in a format and representation intended to enhance comprehension and ensure understandabilitycontent[x] : Type [1..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »LegalLanguageContract legal text in human renderable formcontent[x] : Type [1..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse) »ComputableLanguageComputable Contract conveyed using a policy rule language (e.g. XACML, DKAL, SecPal)content[x] : Type [1..1] « Attachment|Reference(DocumentReference) »List of Contract actorsactor[0..*]Contract Valued Item ListvaluedItem[0..*]Party signing this Contractsigner[0..*]List of actors participating in this Contract Provisionactor[0..*]Contract Provision Valued Item ListvaluedItem[0..*]Nested group of Contract Provisionsgroup[0..*]One or more Contract Provisions, which may be related and conveyed as a group, and may contain nested groupsterm[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 agreementfriendly[0..*]List of Legal expressions or representations of this Contractlegal[0..*]List of Computable Policy Rule Language Representations of this Contractrule[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) 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(SimpleQuantity) Count of Contract Valued Items --></quantity>
  <unitPrice><!-- 0..1 Quantity(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 Quantity(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) 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(SimpleQuantity) Contract Term Valued Item Count --></quantity>
   <unitPrice><!-- 0..1 Quantity(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 Quantity(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|
   QuestionnaireResponse) Binding Contract --></binding[x]>
 <friendly>  <!-- 0..* Contract Friendly Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireResponse) Easily comprehended representation of this Contract --></content[x]>
 </friendly>
 <legal>  <!-- 0..* Contract Legal Language -->
  <content[x]><!-- 1..1 Attachment|Reference(Composition|DocumentReference|
    QuestionnaireResponse) 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) }, // 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(SimpleQuantity) }, // Count of Contract Valued Items
    "unitPrice" : { Quantity(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" : { Quantity(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) }, // 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(SimpleQuantity) }, // Contract Term Valued Item Count
      "unitPrice" : { Quantity(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" : { Quantity(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|
   QuestionnaireResponse) },
  "friendly" : [{ // Contract Friendly Language
    // content[x]: Easily comprehended representation of this Contract. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireResponse) }
  }],
  "legal" : [{ // Contract Legal Language
    // content[x]: Contract Legal Text. One of these 2:
    "contentAttachment" : { Attachment }
    "contentReference" : { Reference(Composition|DocumentReference|
    QuestionnaireResponse) }
  }],
  "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

7.11.2.1 Terminology Bindings

PathDefinitionTypeReference
Contract.type List of overall contract codes.ExampleContract Type Codes
Contract.subType Detailed codes within the above.ExampleContract Subtype Codes
Contract.action
Contract.term.action 		Detailed codes for the contract action.ExampleContract Action Codes
Contract.actionReason
Contract.term.actionReason 		Detailed codes for the contract action reason.ExamplePurposeOfUse
Contract.actor.role
Contract.term.actor.role 		Detailed codes for the contract actor role.ExampleContract Actor Role Codes
Contract.signer.type List of parties who may be signing.PreferredSignature Type Codes
Contract.term.type Detailed codes for the types of contract provisions.ExampleContract Term Type Codes
Contract.term.subType Detailed codes for the subtypes of contract provisions.ExampleContract Term Type Codes

7.11.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
(Device, Patient, Organization, Location, Substance, Practitioner, Contract, Group, RelatedPerson)
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
(Patient, Organization, Practitioner, RelatedPerson)
subjectreferenceThe identity of the target of the contractContract.subject
(Patient)