R4 Ballot #1 (Mixed Normative/Trial use)

This page is part of the FHIR Specification (v3.3.0: R4 Ballot 2). 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

13.11 Resource Contract - Content

Financial Management Work GroupMaturity Level: 1 Trial Use Compartments: Not linked to any defined compartments

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

13.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 Consent, Coverage, EligibilityResponse and SupplyDelivery

13.11.2 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Contract TUDomainResourceLegal Agreement
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierContract number
... status ?!Σ0..1codeamended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
Contract Resource Status Codes (Required)
... contentDerivative 0..1CodeableConceptContent derived from the basal information
Contract Content Derivation Codes (Example)
... issued Σ0..1dateTimeWhen this Contract was issued
... applies Σ0..1PeriodEffective time
... subject Σ0..*Reference(Any)Contract Target Entity
... authority 0..*Reference(Organization)Authority under which this Contract has standing
... domain 0..*Reference(Location)A sphere of control governed by an authoritative jurisdiction, organization, or person
... type Σ0..1CodeableConceptType or form
Contract Type Codes (Example)
... subType Σ0..*CodeableConceptSubtype within the context of type
Contract Subtype Codes (Example)
... term 0..*BackboneElementContract Term List
.... identifier Σ0..1IdentifierContract Term Number
.... issued Σ0..1dateTimeContract Term Issue Date Time
.... applies Σ0..1PeriodContract Term Effective Time
.... type 0..1CodeableConceptContract Term Type or Form
Contract Term Type Codes (Example)
.... subType 0..1CodeableConceptContract Term Type specific classification
Contract Term Subtype Codes (Example)
.... offer 1..1BackboneElementContext of the Contract term
..... topic Σ0..1Reference(Any)Negotiable offer asset
..... type 0..1CodeableConceptContract Offer Type or Form
Contract Term Type Codes (Example)
..... decision 0..1CodeableConceptDecision by Grantor
ActConsentDirective (Extensible)
..... text 0..1stringHuman readable offer text
..... linkId 0..1stringPointer to text
.... asset 0..*BackboneElementContract Term Asset List
..... class 0..1CodingResource Type, Profile, or CDA etc.
Consent Content Class (Extensible)
..... code 0..1CodingCode in the content
Consent Content Codes (Example)
..... period 0..1PeriodTime period of the asset
..... dataPeriod 0..1PeriodTime period of the data for the asset
..... data 0..*BackboneElementData defined by this Asset
...... meaning 0..1codeinstance | related | dependents | authoredby
ContractDataMeaning (Required)
...... reference 0..1Reference(Any)The actual data reference
..... valuedItem 0..*BackboneElementContract Valued Item List
...... entity[x] 0..1Contract Valued Item Type
....... entityCodeableConceptCodeableConcept
....... entityReferenceReference(Any)
...... identifier 0..1IdentifierContract Valued Item Number
...... 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
..... securityLabel Σ0..*CodingSecurity Labels that define affected terms
All Security Labels (Extensible)
.... agent 0..*BackboneElementEntity being ascribed responsibility
..... actor 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Agent Type
..... role 0..*CodeableConceptRole type of the agent
Contract Actor Role Codes (Example)
.... action 0..*CodeableConceptContract Term Activity
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptPurpose for the Contract Term Action
PurposeOfUse (Example)
.... group 0..*see termNested Contract Term Group
... signer 0..*BackboneElementContract Signatory
.... type 1..1CodingContract Signatory Role
Contract Signer Type Codes (Preferred)
.... party 1..1Reference(Organization | Patient | Practitioner | RelatedPerson)Contract Signatory Party
.... signature 1..*SignatureContract Documentation Signature
... 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..1BackboneElementComputable Contract Language
.... content[x] 1..1Computable Contract Rules
..... contentAttachmentAttachment
..... contentReferenceReference(DocumentReference)
... legallyBinding[x] 0..1Binding Contract
.... legallyBindingAttachmentAttachment
.... legallyBindingReferenceReference(Composition | DocumentReference | QuestionnaireResponse | Contract)

doco Documentation for this format

UML Diagram (Legend)

Contract (DomainResource)Unique identifier for this Contract or a derivative that references a Source Contractidentifier : Identifier [0..*]The status of the resource instance (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the resource instance. (Strength=Required)Contract Resource Status ! »The minimal content derived from the basal information source at a specific stage in its lifecyclecontentDerivative : CodeableConcept [0..1] « This is an example set of Content Derivative type codes, which represent the minimal content derived from the basal information source. (Strength=Example)Contract Content Derivation ?? »When this Contract was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract is applicableapplies : Period [0..1]The target entity impacted by or of interest to parties to the agreementsubject : 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 ?? »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 ContractlegallyBinding[x] : Type [0..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse|Contract) »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 Subtype ?? »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?? »ContractOfferThe owner of an asset has the residual control rights over the asset: the right to decide all usages of the asset in any way not inconsistent with a prior contract, custom, or law (Hart, 1995, p. 30)topic : Reference [0..1] « Any »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 ?? »The type of decision made by a grantor with respect to an offer made by a granteedecision : CodeableConcept [0..1] « The type of decision made by a grantor with respect to an offer made by a grantee. (Strength=Extensible)ActConsentDirective+ »Human readable form of this Contract Offertext : string [0..1]The id of the clause or question text of the offer in the referenced questionnaire/responselinkId : string [0..1]ContractAssetCategorization of the type of assetclass : Coding [0..1] « The class (type) of information a consent rule covers (Strength=Extensible)Consent Content Class+ »Code in the contentcode : Coding [0..1] « If this code is found in an instance, then the exception applies (Strength=Example)Consent Content ?? »Time period of the assetperiod : Period [0..1]Time period of the data for the assetdataPeriod : Period [0..1]A set of security labels that define which terms are controlled by this conditionsecurityLabel : Coding [0..*] « Security Labels from the Healthcare Privacy and Security Classification System. (Strength=Extensible)All Security Labels+ »AssetDatainstance | related | dependents | authoredbymeaning : code [0..1] « How a resource reference is interpreted when evaluating contract offers (Strength=Required)ContractDataMeaning! »The actual data referencereference : Reference [0..1] « Any »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 : 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 : Money [0..1]AgentWho or what parties are assigned roles in this Contractactor : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role type of agent assigned roles in this Contractrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »SignatoryRole of this Contract signer, e.g. notary, granteetype : Coding [1..1] « List of parties who may be signing. (Strength=Preferred)Contract Signer Type ? »Party which is a signator to this Contractparty : Reference [1..1] « Organization|Patient|Practitioner| RelatedPerson »Legally binding Contract DSIG signature contents in Base64signature : Signature [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) »The matter of concern in the context of this provision of the agrementoffer[1..1]Data defined by this Assetdata[0..*]Contract Valued Item ListvaluedItem[0..*]Contract Term Asset Listasset[0..*]An actor taking a role in an activity for which it can be assigned some degree of responsibility for the activity taking placeagent[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..*]Parties with legal standing in the Contract, including the principal parties, the grantor(s) and grantee(s), which are any person or organization bound by the contract, and any ancillary parties, which facilitate the execution of the contract such as a notary or witnesssigner[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..1]

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..* Identifier Contract number --></identifier>
 <status value="[code]"/><!-- 0..1 amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated -->
 <contentDerivative><!-- 0..1 CodeableConcept Content derived from the basal information --></contentDerivative>
 <issued value="[dateTime]"/><!-- 0..1 When this Contract was issued -->
 <applies><!-- 0..1 Period Effective time --></applies>
 <subject><!-- 0..* Reference(Any) Contract Target Entity --></subject>
 <authority><!-- 0..* Reference(Organization) Authority under which this Contract has standing --></authority>
 <domain><!-- 0..* Reference(Location) A sphere of control governed by an authoritative jurisdiction, organization, or person --></domain>
 <type><!-- 0..1 CodeableConcept Type or form --></type>
 <subType><!-- 0..* CodeableConcept Subtype within the context of type --></subType>
 <term>  <!-- 0..* Contract Term List -->
  <identifier><!-- 0..1 Identifier Contract Term Number --></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 or Form --></type>
  <subType><!-- 0..1 CodeableConcept Contract Term Type specific classification --></subType>
  <offer>  <!-- 1..1 Context of the Contract term -->
   <topic><!-- 0..1 Reference(Any) Negotiable offer asset --></topic>
   <type><!-- 0..1 CodeableConcept Contract Offer Type or Form --></type>
   <decision><!-- 0..1 CodeableConcept Decision by Grantor --></decision>
   <text value="[string]"/><!-- 0..1 Human readable offer text -->
   <linkId value="[string]"/><!-- 0..1 Pointer to text -->
  </offer>
  <asset>  <!-- 0..* Contract Term Asset List -->
   <class><!-- 0..1 Coding Resource Type, Profile, or CDA etc. --></class>
   <code><!-- 0..1 Coding Code in the content --></code>
   <period><!-- 0..1 Period Time period of the asset --></period>
   <dataPeriod><!-- 0..1 Period Time period of the data for the asset --></dataPeriod>
   <data>  <!-- 0..* Data defined by this Asset -->
    <meaning value="[code]"/><!-- 0..1 instance | related | dependents | authoredby -->
    <reference><!-- 0..1 Reference(Any) The actual data reference --></reference>
   </data>
   <valuedItem>  <!-- 0..* Contract Valued Item List -->
    <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Valued Item Type --></entity[x]>
    <identifier><!-- 0..1 Identifier Contract Valued Item Number --></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 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>
   <securityLabel><!-- 0..* Coding Security Labels that define affected terms --></securityLabel>
  </asset>
  <agent>  <!-- 0..* Entity being ascribed responsibility -->
   <actor><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|Patient|
     Practitioner|RelatedPerson|Substance) Contract Agent Type --></actor>
   <role><!-- 0..* CodeableConcept Role type of the agent --></role>
  </agent>
  <action><!-- 0..* CodeableConcept Contract Term Activity --></action>
  <actionReason><!-- 0..* CodeableConcept Purpose for the Contract Term Action --></actionReason>
  <group><!-- 0..* Content as for Contract.term Nested Contract Term Group --></group>
 </term>
 <signer>  <!-- 0..* Contract Signatory -->
  <type><!-- 1..1 Coding Contract Signatory Role --></type>
  <party><!-- 1..1 Reference(Organization|Patient|Practitioner|RelatedPerson) Contract Signatory Party --></party>
  <signature><!-- 1..* Signature Contract Documentation Signature --></signature>
 </signer>
 <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..1 Computable Contract Language -->
  <content[x]><!-- 1..1 Attachment|Reference(DocumentReference) Computable Contract Rules --></content[x]>
 </rule>
 <legallyBinding[x]><!-- 0..1 Attachment|Reference(Composition|DocumentReference|
   QuestionnaireResponse|Contract) Binding Contract --></legallyBinding[x]>
</Contract>

JSON Template

{doco
  "resourceType" : "Contract",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Contract number
  "status" : "<code>", // amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
  "contentDerivative" : { CodeableConcept }, // Content derived from the basal information
  "issued" : "<dateTime>", // When this Contract was issued
  "applies" : { Period }, // Effective time
  "subject" : [{ Reference(Any) }], // Contract Target Entity
  "authority" : [{ Reference(Organization) }], // Authority under which this Contract has standing
  "domain" : [{ Reference(Location) }], // A sphere of control governed by an authoritative jurisdiction, organization, or person
  "type" : { CodeableConcept }, // Type or form
  "subType" : [{ CodeableConcept }], // Subtype within the context of type
  "term" : [{ // Contract Term List
    "identifier" : { Identifier }, // Contract Term Number
    "issued" : "<dateTime>", // Contract Term Issue Date Time
    "applies" : { Period }, // Contract Term Effective Time
    "type" : { CodeableConcept }, // Contract Term Type or Form
    "subType" : { CodeableConcept }, // Contract Term Type specific classification
    "offer" : { // R!  Context of the Contract term
      "topic" : { Reference(Any) }, // Negotiable offer asset
      "type" : { CodeableConcept }, // Contract Offer Type or Form
      "decision" : { CodeableConcept }, // Decision by Grantor
      "text" : "<string>", // Human readable offer text
      "linkId" : "<string>" // Pointer to text
    },
    "asset" : [{ // Contract Term Asset List
      "class" : { Coding }, // Resource Type, Profile, or CDA etc.
      "code" : { Coding }, // Code in the content
      "period" : { Period }, // Time period of the asset
      "dataPeriod" : { Period }, // Time period of the data for the asset
      "data" : [{ // Data defined by this Asset
        "meaning" : "<code>", // instance | related | dependents | authoredby
        "reference" : { Reference(Any) } // The actual data reference
      }],
      "valuedItem" : [{ // Contract Valued Item List
        // entity[x]: Contract Valued Item Type. One of these 2:
        "entityCodeableConcept" : { CodeableConcept },
        "entityReference" : { Reference(Any) },
        "identifier" : { Identifier }, // Contract Valued Item Number
        "effectiveTime" : "<dateTime>", // Contract Valued Item Effective Tiem
        "quantity" : { Quantity(SimpleQuantity) }, // 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
      }],
      "securityLabel" : [{ Coding }] // Security Labels that define affected terms
    }],
    "agent" : [{ // Entity being ascribed responsibility
      "actor" : { Reference(Contract|Device|Group|Location|Organization|Patient|
     Practitioner|RelatedPerson|Substance) }, // R!  Contract Agent Type
      "role" : [{ CodeableConcept }] // Role type of the agent
    }],
    "action" : [{ CodeableConcept }], // Contract Term Activity
    "actionReason" : [{ CodeableConcept }], // Purpose for the Contract Term Action
    "group" : [{ Content as for Contract.term }] // Nested Contract Term Group
  }],
  "signer" : [{ // Contract Signatory
    "type" : { Coding }, // R!  Contract Signatory Role
    "party" : { Reference(Organization|Patient|Practitioner|RelatedPerson) }, // R!  Contract Signatory Party
    "signature" : [{ Signature }] // R!  Contract Documentation Signature
  }],
  "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) }
  },
  // legallyBinding[x]: Binding Contract. One of these 2:
  "legallyBindingAttachment" : { Attachment }
  "legallyBindingReference" : { Reference(Composition|DocumentReference|
   QuestionnaireResponse|Contract) }
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Contract;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Contract.identifier [ Identifier ], ... ; # 0..* Contract number
  fhir:Contract.status [ code ]; # 0..1 amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
  fhir:Contract.contentDerivative [ CodeableConcept ]; # 0..1 Content derived from the basal information
  fhir:Contract.issued [ dateTime ]; # 0..1 When this Contract was issued
  fhir:Contract.applies [ Period ]; # 0..1 Effective time
  fhir:Contract.subject [ Reference(Any) ], ... ; # 0..* Contract Target Entity
  fhir:Contract.authority [ Reference(Organization) ], ... ; # 0..* Authority under which this Contract has standing
  fhir:Contract.domain [ Reference(Location) ], ... ; # 0..* A sphere of control governed by an authoritative jurisdiction, organization, or person
  fhir:Contract.type [ CodeableConcept ]; # 0..1 Type or form
  fhir:Contract.subType [ CodeableConcept ], ... ; # 0..* Subtype within the context of type
  fhir:Contract.term [ # 0..* Contract Term List
    fhir:Contract.term.identifier [ Identifier ]; # 0..1 Contract Term Number
    fhir:Contract.term.issued [ dateTime ]; # 0..1 Contract Term Issue Date Time
    fhir:Contract.term.applies [ Period ]; # 0..1 Contract Term Effective Time
    fhir:Contract.term.type [ CodeableConcept ]; # 0..1 Contract Term Type or Form
    fhir:Contract.term.subType [ CodeableConcept ]; # 0..1 Contract Term Type specific classification
    fhir:Contract.term.offer [ # 1..1 Context of the Contract term
      fhir:Contract.term.offer.topic [ Reference(Any) ]; # 0..1 Negotiable offer asset
      fhir:Contract.term.offer.type [ CodeableConcept ]; # 0..1 Contract Offer Type or Form
      fhir:Contract.term.offer.decision [ CodeableConcept ]; # 0..1 Decision by Grantor
      fhir:Contract.term.offer.text [ string ]; # 0..1 Human readable offer text
      fhir:Contract.term.offer.linkId [ string ]; # 0..1 Pointer to text
    ];
    fhir:Contract.term.asset [ # 0..* Contract Term Asset List
      fhir:Contract.term.asset.class [ Coding ]; # 0..1 Resource Type, Profile, or CDA etc.
      fhir:Contract.term.asset.code [ Coding ]; # 0..1 Code in the content
      fhir:Contract.term.asset.period [ Period ]; # 0..1 Time period of the asset
      fhir:Contract.term.asset.dataPeriod [ Period ]; # 0..1 Time period of the data for the asset
      fhir:Contract.term.asset.data [ # 0..* Data defined by this Asset
        fhir:Contract.term.asset.data.meaning [ code ]; # 0..1 instance | related | dependents | authoredby
        fhir:Contract.term.asset.data.reference [ Reference(Any) ]; # 0..1 The actual data reference
      ], ...;
      fhir:Contract.term.asset.valuedItem [ # 0..* Contract Valued Item List
        # Contract.term.asset.valuedItem.entity[x] : 0..1 Contract Valued Item Type. One of these 2
          fhir:Contract.term.asset.valuedItem.entityCodeableConcept [ CodeableConcept ]
          fhir:Contract.term.asset.valuedItem.entityReference [ Reference(Any) ]
        fhir:Contract.term.asset.valuedItem.identifier [ Identifier ]; # 0..1 Contract Valued Item Number
        fhir:Contract.term.asset.valuedItem.effectiveTime [ dateTime ]; # 0..1 Contract Valued Item Effective Tiem
        fhir:Contract.term.asset.valuedItem.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Count of Contract Valued Items
        fhir:Contract.term.asset.valuedItem.unitPrice [ Money ]; # 0..1 Contract Valued Item fee, charge, or cost
        fhir:Contract.term.asset.valuedItem.factor [ decimal ]; # 0..1 Contract Valued Item Price Scaling Factor
        fhir:Contract.term.asset.valuedItem.points [ decimal ]; # 0..1 Contract Valued Item Difficulty Scaling Factor
        fhir:Contract.term.asset.valuedItem.net [ Money ]; # 0..1 Total Contract Valued Item Value
      ], ...;
      fhir:Contract.term.asset.securityLabel [ Coding ], ... ; # 0..* Security Labels that define affected terms
    ], ...;
    fhir:Contract.term.agent [ # 0..* Entity being ascribed responsibility
      fhir:Contract.term.agent.actor [ Reference(Contract|Device|Group|Location|Organization|Patient|Practitioner|RelatedPerson|
  Substance) ]; # 1..1 Contract Agent Type
      fhir:Contract.term.agent.role [ CodeableConcept ], ... ; # 0..* Role type of the agent
    ], ...;
    fhir:Contract.term.action [ CodeableConcept ], ... ; # 0..* Contract Term Activity
    fhir:Contract.term.actionReason [ CodeableConcept ], ... ; # 0..* Purpose for the Contract Term Action
    fhir:Contract.term.group [ See Contract.term ], ... ; # 0..* Nested Contract Term Group
  ], ...;
  fhir:Contract.signer [ # 0..* Contract Signatory
    fhir:Contract.signer.type [ Coding ]; # 1..1 Contract Signatory Role
    fhir:Contract.signer.party [ Reference(Organization|Patient|Practitioner|RelatedPerson) ]; # 1..1 Contract Signatory Party
    fhir:Contract.signer.signature [ Signature ], ... ; # 1..* Contract Documentation Signature
  ], ...;
  fhir:Contract.friendly [ # 0..* Contract Friendly Language
    # Contract.friendly.content[x] : 1..1 Easily comprehended representation of this Contract. One of these 2
      fhir:Contract.friendly.contentAttachment [ Attachment ]
      fhir:Contract.friendly.contentReference [ Reference(Composition|DocumentReference|QuestionnaireResponse) ]
  ], ...;
  fhir:Contract.legal [ # 0..* Contract Legal Language
    # Contract.legal.content[x] : 1..1 Contract Legal Text. One of these 2
      fhir:Contract.legal.contentAttachment [ Attachment ]
      fhir:Contract.legal.contentReference [ Reference(Composition|DocumentReference|QuestionnaireResponse) ]
  ], ...;
  fhir:Contract.rule [ # 0..1 Computable Contract Language
    # Contract.rule.content[x] : 1..1 Computable Contract Rules. One of these 2
      fhir:Contract.rule.contentAttachment [ Attachment ]
      fhir:Contract.rule.contentReference [ Reference(DocumentReference) ]
  ];
  # Contract.legallyBinding[x] : 0..1 Binding Contract. One of these 2
    fhir:Contract.legallyBindingAttachment [ Attachment ]
    fhir:Contract.legallyBindingReference [ Reference(Composition|DocumentReference|QuestionnaireResponse|Contract) ]
]

Changes since R3

Contract
Contract.identifier
  • Max Cardinality changed from 1 to *
Contract.term.offer
  • Added Element
Contract.term.offer.topic
  • Added Element
Contract.term.offer.type
  • Added Element
Contract.term.offer.decision
  • Added Element
Contract.term.offer.text
  • Added Element
Contract.term.offer.linkId
  • Added Element
Contract.term.asset
  • Added Element
Contract.term.asset.class
  • Added Element
Contract.term.asset.code
  • Added Element
Contract.term.asset.period
  • Added Element
Contract.term.asset.dataPeriod
  • Added Element
Contract.term.asset.data
  • Added Element
Contract.term.asset.data.meaning
  • Added Element
Contract.term.asset.data.reference
  • Added Element
Contract.term.asset.valuedItem
  • Added Element
Contract.term.asset.valuedItem.entity[x]
  • Added Element
Contract.term.asset.valuedItem.identifier
  • Added Element
Contract.term.asset.valuedItem.effectiveTime
  • Added Element
Contract.term.asset.valuedItem.quantity
  • Added Element
Contract.term.asset.valuedItem.unitPrice
  • Added Element
Contract.term.asset.valuedItem.factor
  • Added Element
Contract.term.asset.valuedItem.points
  • Added Element
Contract.term.asset.valuedItem.net
  • Added Element
Contract.term.asset.securityLabel
  • Added Element
Contract.friendly.content[x]
  • Remove Reference(Composition|DocumentReference|QuestionnaireResponse), Add Reference(Composition|DocumentReference|QuestionnaireResponse)
Contract.legal.content[x]
  • Remove Reference(Composition|DocumentReference|QuestionnaireResponse), Add Reference(Composition|DocumentReference|QuestionnaireResponse)
Contract.rule
  • Max Cardinality changed from * to 1
Contract.rule.content[x]
  • Remove Reference(DocumentReference), Add Reference(DocumentReference)
Contract.legallyBinding[x]
  • Added Element
Contract.topic
  • deleted
Contract.action
  • deleted
Contract.actionReason
  • deleted
Contract.decisionType
  • deleted
Contract.securityLabel
  • deleted
Contract.agent
  • deleted
Contract.valuedItem
  • deleted
Contract.term.topic
  • deleted
Contract.term.securityLabel
  • deleted
Contract.term.text
  • deleted
Contract.term.valuedItem
  • deleted
Contract.binding[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.). Note: these have note yet been updated to be R3 to R4

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Contract TUDomainResourceLegal Agreement
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..*IdentifierContract number
... status ?!Σ0..1codeamended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
Contract Resource Status Codes (Required)
... contentDerivative 0..1CodeableConceptContent derived from the basal information
Contract Content Derivation Codes (Example)
... issued Σ0..1dateTimeWhen this Contract was issued
... applies Σ0..1PeriodEffective time
... subject Σ0..*Reference(Any)Contract Target Entity
... authority 0..*Reference(Organization)Authority under which this Contract has standing
... domain 0..*Reference(Location)A sphere of control governed by an authoritative jurisdiction, organization, or person
... type Σ0..1CodeableConceptType or form
Contract Type Codes (Example)
... subType Σ0..*CodeableConceptSubtype within the context of type
Contract Subtype Codes (Example)
... term 0..*BackboneElementContract Term List
.... identifier Σ0..1IdentifierContract Term Number
.... issued Σ0..1dateTimeContract Term Issue Date Time
.... applies Σ0..1PeriodContract Term Effective Time
.... type 0..1CodeableConceptContract Term Type or Form
Contract Term Type Codes (Example)
.... subType 0..1CodeableConceptContract Term Type specific classification
Contract Term Subtype Codes (Example)
.... offer 1..1BackboneElementContext of the Contract term
..... topic Σ0..1Reference(Any)Negotiable offer asset
..... type 0..1CodeableConceptContract Offer Type or Form
Contract Term Type Codes (Example)
..... decision 0..1CodeableConceptDecision by Grantor
ActConsentDirective (Extensible)
..... text 0..1stringHuman readable offer text
..... linkId 0..1stringPointer to text
.... asset 0..*BackboneElementContract Term Asset List
..... class 0..1CodingResource Type, Profile, or CDA etc.
Consent Content Class (Extensible)
..... code 0..1CodingCode in the content
Consent Content Codes (Example)
..... period 0..1PeriodTime period of the asset
..... dataPeriod 0..1PeriodTime period of the data for the asset
..... data 0..*BackboneElementData defined by this Asset
...... meaning 0..1codeinstance | related | dependents | authoredby
ContractDataMeaning (Required)
...... reference 0..1Reference(Any)The actual data reference
..... valuedItem 0..*BackboneElementContract Valued Item List
...... entity[x] 0..1Contract Valued Item Type
....... entityCodeableConceptCodeableConcept
....... entityReferenceReference(Any)
...... identifier 0..1IdentifierContract Valued Item Number
...... 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
..... securityLabel Σ0..*CodingSecurity Labels that define affected terms
All Security Labels (Extensible)
.... agent 0..*BackboneElementEntity being ascribed responsibility
..... actor 1..1Reference(Contract | Device | Group | Location | Organization | Patient | Practitioner | RelatedPerson | Substance)Contract Agent Type
..... role 0..*CodeableConceptRole type of the agent
Contract Actor Role Codes (Example)
.... action 0..*CodeableConceptContract Term Activity
Contract Action Codes (Example)
.... actionReason 0..*CodeableConceptPurpose for the Contract Term Action
PurposeOfUse (Example)
.... group 0..*see termNested Contract Term Group
... signer 0..*BackboneElementContract Signatory
.... type 1..1CodingContract Signatory Role
Contract Signer Type Codes (Preferred)
.... party 1..1Reference(Organization | Patient | Practitioner | RelatedPerson)Contract Signatory Party
.... signature 1..*SignatureContract Documentation Signature
... 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..1BackboneElementComputable Contract Language
.... content[x] 1..1Computable Contract Rules
..... contentAttachmentAttachment
..... contentReferenceReference(DocumentReference)
... legallyBinding[x] 0..1Binding Contract
.... legallyBindingAttachmentAttachment
.... legallyBindingReferenceReference(Composition | DocumentReference | QuestionnaireResponse | Contract)

doco Documentation for this format

UML Diagram (Legend)

Contract (DomainResource)Unique identifier for this Contract or a derivative that references a Source Contractidentifier : Identifier [0..*]The status of the resource instance (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the resource instance. (Strength=Required)Contract Resource Status ! »The minimal content derived from the basal information source at a specific stage in its lifecyclecontentDerivative : CodeableConcept [0..1] « This is an example set of Content Derivative type codes, which represent the minimal content derived from the basal information source. (Strength=Example)Contract Content Derivation ?? »When this Contract was issuedissued : dateTime [0..1]Relevant time or time-period when this Contract is applicableapplies : Period [0..1]The target entity impacted by or of interest to parties to the agreementsubject : 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 ?? »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 ContractlegallyBinding[x] : Type [0..1] « Attachment|Reference(Composition| DocumentReference|QuestionnaireResponse|Contract) »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 Subtype ?? »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?? »ContractOfferThe owner of an asset has the residual control rights over the asset: the right to decide all usages of the asset in any way not inconsistent with a prior contract, custom, or law (Hart, 1995, p. 30)topic : Reference [0..1] « Any »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 ?? »The type of decision made by a grantor with respect to an offer made by a granteedecision : CodeableConcept [0..1] « The type of decision made by a grantor with respect to an offer made by a grantee. (Strength=Extensible)ActConsentDirective+ »Human readable form of this Contract Offertext : string [0..1]The id of the clause or question text of the offer in the referenced questionnaire/responselinkId : string [0..1]ContractAssetCategorization of the type of assetclass : Coding [0..1] « The class (type) of information a consent rule covers (Strength=Extensible)Consent Content Class+ »Code in the contentcode : Coding [0..1] « If this code is found in an instance, then the exception applies (Strength=Example)Consent Content ?? »Time period of the assetperiod : Period [0..1]Time period of the data for the assetdataPeriod : Period [0..1]A set of security labels that define which terms are controlled by this conditionsecurityLabel : Coding [0..*] « Security Labels from the Healthcare Privacy and Security Classification System. (Strength=Extensible)All Security Labels+ »AssetDatainstance | related | dependents | authoredbymeaning : code [0..1] « How a resource reference is interpreted when evaluating contract offers (Strength=Required)ContractDataMeaning! »The actual data referencereference : Reference [0..1] « Any »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 : 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 : Money [0..1]AgentWho or what parties are assigned roles in this Contractactor : Reference [1..1] « Contract|Device|Group|Location| Organization|Patient|Practitioner|RelatedPerson|Substance »Role type of agent assigned roles in this Contractrole : CodeableConcept [0..*] « Detailed codes for the contract actor role. (Strength=Example)Contract Actor Role ?? »SignatoryRole of this Contract signer, e.g. notary, granteetype : Coding [1..1] « List of parties who may be signing. (Strength=Preferred)Contract Signer Type ? »Party which is a signator to this Contractparty : Reference [1..1] « Organization|Patient|Practitioner| RelatedPerson »Legally binding Contract DSIG signature contents in Base64signature : Signature [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) »The matter of concern in the context of this provision of the agrementoffer[1..1]Data defined by this Assetdata[0..*]Contract Valued Item ListvaluedItem[0..*]Contract Term Asset Listasset[0..*]An actor taking a role in an activity for which it can be assigned some degree of responsibility for the activity taking placeagent[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..*]Parties with legal standing in the Contract, including the principal parties, the grantor(s) and grantee(s), which are any person or organization bound by the contract, and any ancillary parties, which facilitate the execution of the contract such as a notary or witnesssigner[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..1]

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..* Identifier Contract number --></identifier>
 <status value="[code]"/><!-- 0..1 amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated -->
 <contentDerivative><!-- 0..1 CodeableConcept Content derived from the basal information --></contentDerivative>
 <issued value="[dateTime]"/><!-- 0..1 When this Contract was issued -->
 <applies><!-- 0..1 Period Effective time --></applies>
 <subject><!-- 0..* Reference(Any) Contract Target Entity --></subject>
 <authority><!-- 0..* Reference(Organization) Authority under which this Contract has standing --></authority>
 <domain><!-- 0..* Reference(Location) A sphere of control governed by an authoritative jurisdiction, organization, or person --></domain>
 <type><!-- 0..1 CodeableConcept Type or form --></type>
 <subType><!-- 0..* CodeableConcept Subtype within the context of type --></subType>
 <term>  <!-- 0..* Contract Term List -->
  <identifier><!-- 0..1 Identifier Contract Term Number --></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 or Form --></type>
  <subType><!-- 0..1 CodeableConcept Contract Term Type specific classification --></subType>
  <offer>  <!-- 1..1 Context of the Contract term -->
   <topic><!-- 0..1 Reference(Any) Negotiable offer asset --></topic>
   <type><!-- 0..1 CodeableConcept Contract Offer Type or Form --></type>
   <decision><!-- 0..1 CodeableConcept Decision by Grantor --></decision>
   <text value="[string]"/><!-- 0..1 Human readable offer text -->
   <linkId value="[string]"/><!-- 0..1 Pointer to text -->
  </offer>
  <asset>  <!-- 0..* Contract Term Asset List -->
   <class><!-- 0..1 Coding Resource Type, Profile, or CDA etc. --></class>
   <code><!-- 0..1 Coding Code in the content --></code>
   <period><!-- 0..1 Period Time period of the asset --></period>
   <dataPeriod><!-- 0..1 Period Time period of the data for the asset --></dataPeriod>
   <data>  <!-- 0..* Data defined by this Asset -->
    <meaning value="[code]"/><!-- 0..1 instance | related | dependents | authoredby -->
    <reference><!-- 0..1 Reference(Any) The actual data reference --></reference>
   </data>
   <valuedItem>  <!-- 0..* Contract Valued Item List -->
    <entity[x]><!-- 0..1 CodeableConcept|Reference(Any) Contract Valued Item Type --></entity[x]>
    <identifier><!-- 0..1 Identifier Contract Valued Item Number --></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 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>
   <securityLabel><!-- 0..* Coding Security Labels that define affected terms --></securityLabel>
  </asset>
  <agent>  <!-- 0..* Entity being ascribed responsibility -->
   <actor><!-- 1..1 Reference(Contract|Device|Group|Location|Organization|Patient|
     Practitioner|RelatedPerson|Substance) Contract Agent Type --></actor>
   <role><!-- 0..* CodeableConcept Role type of the agent --></role>
  </agent>
  <action><!-- 0..* CodeableConcept Contract Term Activity --></action>
  <actionReason><!-- 0..* CodeableConcept Purpose for the Contract Term Action --></actionReason>
  <group><!-- 0..* Content as for Contract.term Nested Contract Term Group --></group>
 </term>
 <signer>  <!-- 0..* Contract Signatory -->
  <type><!-- 1..1 Coding Contract Signatory Role --></type>
  <party><!-- 1..1 Reference(Organization|Patient|Practitioner|RelatedPerson) Contract Signatory Party --></party>
  <signature><!-- 1..* Signature Contract Documentation Signature --></signature>
 </signer>
 <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..1 Computable Contract Language -->
  <content[x]><!-- 1..1 Attachment|Reference(DocumentReference) Computable Contract Rules --></content[x]>
 </rule>
 <legallyBinding[x]><!-- 0..1 Attachment|Reference(Composition|DocumentReference|
   QuestionnaireResponse|Contract) Binding Contract --></legallyBinding[x]>
</Contract>

JSON Template

{doco
  "resourceType" : "Contract",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Contract number
  "status" : "<code>", // amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
  "contentDerivative" : { CodeableConcept }, // Content derived from the basal information
  "issued" : "<dateTime>", // When this Contract was issued
  "applies" : { Period }, // Effective time
  "subject" : [{ Reference(Any) }], // Contract Target Entity
  "authority" : [{ Reference(Organization) }], // Authority under which this Contract has standing
  "domain" : [{ Reference(Location) }], // A sphere of control governed by an authoritative jurisdiction, organization, or person
  "type" : { CodeableConcept }, // Type or form
  "subType" : [{ CodeableConcept }], // Subtype within the context of type
  "term" : [{ // Contract Term List
    "identifier" : { Identifier }, // Contract Term Number
    "issued" : "<dateTime>", // Contract Term Issue Date Time
    "applies" : { Period }, // Contract Term Effective Time
    "type" : { CodeableConcept }, // Contract Term Type or Form
    "subType" : { CodeableConcept }, // Contract Term Type specific classification
    "offer" : { // R!  Context of the Contract term
      "topic" : { Reference(Any) }, // Negotiable offer asset
      "type" : { CodeableConcept }, // Contract Offer Type or Form
      "decision" : { CodeableConcept }, // Decision by Grantor
      "text" : "<string>", // Human readable offer text
      "linkId" : "<string>" // Pointer to text
    },
    "asset" : [{ // Contract Term Asset List
      "class" : { Coding }, // Resource Type, Profile, or CDA etc.
      "code" : { Coding }, // Code in the content
      "period" : { Period }, // Time period of the asset
      "dataPeriod" : { Period }, // Time period of the data for the asset
      "data" : [{ // Data defined by this Asset
        "meaning" : "<code>", // instance | related | dependents | authoredby
        "reference" : { Reference(Any) } // The actual data reference
      }],
      "valuedItem" : [{ // Contract Valued Item List
        // entity[x]: Contract Valued Item Type. One of these 2:
        "entityCodeableConcept" : { CodeableConcept },
        "entityReference" : { Reference(Any) },
        "identifier" : { Identifier }, // Contract Valued Item Number
        "effectiveTime" : "<dateTime>", // Contract Valued Item Effective Tiem
        "quantity" : { Quantity(SimpleQuantity) }, // 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
      }],
      "securityLabel" : [{ Coding }] // Security Labels that define affected terms
    }],
    "agent" : [{ // Entity being ascribed responsibility
      "actor" : { Reference(Contract|Device|Group|Location|Organization|Patient|
     Practitioner|RelatedPerson|Substance) }, // R!  Contract Agent Type
      "role" : [{ CodeableConcept }] // Role type of the agent
    }],
    "action" : [{ CodeableConcept }], // Contract Term Activity
    "actionReason" : [{ CodeableConcept }], // Purpose for the Contract Term Action
    "group" : [{ Content as for Contract.term }] // Nested Contract Term Group
  }],
  "signer" : [{ // Contract Signatory
    "type" : { Coding }, // R!  Contract Signatory Role
    "party" : { Reference(Organization|Patient|Practitioner|RelatedPerson) }, // R!  Contract Signatory Party
    "signature" : [{ Signature }] // R!  Contract Documentation Signature
  }],
  "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) }
  },
  // legallyBinding[x]: Binding Contract. One of these 2:
  "legallyBindingAttachment" : { Attachment }
  "legallyBindingReference" : { Reference(Composition|DocumentReference|
   QuestionnaireResponse|Contract) }
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Contract;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Contract.identifier [ Identifier ], ... ; # 0..* Contract number
  fhir:Contract.status [ code ]; # 0..1 amended | appended | cancelled | disputed | entered-in-error | executable | executed | negotiable | offered | policy | rejected | renewed | revoked | resolved | terminated
  fhir:Contract.contentDerivative [ CodeableConcept ]; # 0..1 Content derived from the basal information
  fhir:Contract.issued [ dateTime ]; # 0..1 When this Contract was issued
  fhir:Contract.applies [ Period ]; # 0..1 Effective time
  fhir:Contract.subject [ Reference(Any) ], ... ; # 0..* Contract Target Entity
  fhir:Contract.authority [ Reference(Organization) ], ... ; # 0..* Authority under which this Contract has standing
  fhir:Contract.domain [ Reference(Location) ], ... ; # 0..* A sphere of control governed by an authoritative jurisdiction, organization, or person
  fhir:Contract.type [ CodeableConcept ]; # 0..1 Type or form
  fhir:Contract.subType [ CodeableConcept ], ... ; # 0..* Subtype within the context of type
  fhir:Contract.term [ # 0..* Contract Term List
    fhir:Contract.term.identifier [ Identifier ]; # 0..1 Contract Term Number
    fhir:Contract.term.issued [ dateTime ]; # 0..1 Contract Term Issue Date Time
    fhir:Contract.term.applies [ Period ]; # 0..1 Contract Term Effective Time
    fhir:Contract.term.type [ CodeableConcept ]; # 0..1 Contract Term Type or Form
    fhir:Contract.term.subType [ CodeableConcept ]; # 0..1 Contract Term Type specific classification
    fhir:Contract.term.offer [ # 1..1 Context of the Contract term
      fhir:Contract.term.offer.topic [ Reference(Any) ]; # 0..1 Negotiable offer asset
      fhir:Contract.term.offer.type [ CodeableConcept ]; # 0..1 Contract Offer Type or Form
      fhir:Contract.term.offer.decision [ CodeableConcept ]; # 0..1 Decision by Grantor
      fhir:Contract.term.offer.text [ string ]; # 0..1 Human readable offer text
      fhir:Contract.term.offer.linkId [ string ]; # 0..1 Pointer to text
    ];
    fhir:Contract.term.asset [ # 0..* Contract Term Asset List
      fhir:Contract.term.asset.class [ Coding ]; # 0..1 Resource Type, Profile, or CDA etc.
      fhir:Contract.term.asset.code [ Coding ]; # 0..1 Code in the content
      fhir:Contract.term.asset.period [ Period ]; # 0..1 Time period of the asset
      fhir:Contract.term.asset.dataPeriod [ Period ]; # 0..1 Time period of the data for the asset
      fhir:Contract.term.asset.data [ # 0..* Data defined by this Asset
        fhir:Contract.term.asset.data.meaning [ code ]; # 0..1 instance | related | dependents | authoredby
        fhir:Contract.term.asset.data.reference [ Reference(Any) ]; # 0..1 The actual data reference
      ], ...;
      fhir:Contract.term.asset.valuedItem [ # 0..* Contract Valued Item List
        # Contract.term.asset.valuedItem.entity[x] : 0..1 Contract Valued Item Type. One of these 2
          fhir:Contract.term.asset.valuedItem.entityCodeableConcept [ CodeableConcept ]
          fhir:Contract.term.asset.valuedItem.entityReference [ Reference(Any) ]
        fhir:Contract.term.asset.valuedItem.identifier [ Identifier ]; # 0..1 Contract Valued Item Number
        fhir:Contract.term.asset.valuedItem.effectiveTime [ dateTime ]; # 0..1 Contract Valued Item Effective Tiem
        fhir:Contract.term.asset.valuedItem.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Count of Contract Valued Items
        fhir:Contract.term.asset.valuedItem.unitPrice [ Money ]; # 0..1 Contract Valued Item fee, charge, or cost
        fhir:Contract.term.asset.valuedItem.factor [ decimal ]; # 0..1 Contract Valued Item Price Scaling Factor
        fhir:Contract.term.asset.valuedItem.points [ decimal ]; # 0..1 Contract Valued Item Difficulty Scaling Factor
        fhir:Contract.term.asset.valuedItem.net [ Money ]; # 0..1 Total Contract Valued Item Value
      ], ...;
      fhir:Contract.term.asset.securityLabel [ Coding ], ... ; # 0..* Security Labels that define affected terms
    ], ...;
    fhir:Contract.term.agent [ # 0..* Entity being ascribed responsibility
      fhir:Contract.term.agent.actor [ Reference(Contract|Device|Group|Location|Organization|Patient|Practitioner|RelatedPerson|
  Substance) ]; # 1..1 Contract Agent Type
      fhir:Contract.term.agent.role [ CodeableConcept ], ... ; # 0..* Role type of the agent
    ], ...;
    fhir:Contract.term.action [ CodeableConcept ], ... ; # 0..* Contract Term Activity
    fhir:Contract.term.actionReason [ CodeableConcept ], ... ; # 0..* Purpose for the Contract Term Action
    fhir:Contract.term.group [ See Contract.term ], ... ; # 0..* Nested Contract Term Group
  ], ...;
  fhir:Contract.signer [ # 0..* Contract Signatory
    fhir:Contract.signer.type [ Coding ]; # 1..1 Contract Signatory Role
    fhir:Contract.signer.party [ Reference(Organization|Patient|Practitioner|RelatedPerson) ]; # 1..1 Contract Signatory Party
    fhir:Contract.signer.signature [ Signature ], ... ; # 1..* Contract Documentation Signature
  ], ...;
  fhir:Contract.friendly [ # 0..* Contract Friendly Language
    # Contract.friendly.content[x] : 1..1 Easily comprehended representation of this Contract. One of these 2
      fhir:Contract.friendly.contentAttachment [ Attachment ]
      fhir:Contract.friendly.contentReference [ Reference(Composition|DocumentReference|QuestionnaireResponse) ]
  ], ...;
  fhir:Contract.legal [ # 0..* Contract Legal Language
    # Contract.legal.content[x] : 1..1 Contract Legal Text. One of these 2
      fhir:Contract.legal.contentAttachment [ Attachment ]
      fhir:Contract.legal.contentReference [ Reference(Composition|DocumentReference|QuestionnaireResponse) ]
  ], ...;
  fhir:Contract.rule [ # 0..1 Computable Contract Language
    # Contract.rule.content[x] : 1..1 Computable Contract Rules. One of these 2
      fhir:Contract.rule.contentAttachment [ Attachment ]
      fhir:Contract.rule.contentReference [ Reference(DocumentReference) ]
  ];
  # Contract.legallyBinding[x] : 0..1 Binding Contract. One of these 2
    fhir:Contract.legallyBindingAttachment [ Attachment ]
    fhir:Contract.legallyBindingReference [ Reference(Composition|DocumentReference|QuestionnaireResponse|Contract) ]
]

Changes since DSTU2

Contract
Contract.identifier
  • Max Cardinality changed from 1 to *
Contract.term.offer
  • Added Element
Contract.term.offer.topic
  • Added Element
Contract.term.offer.type
  • Added Element
Contract.term.offer.decision
  • Added Element
Contract.term.offer.text
  • Added Element
Contract.term.offer.linkId
  • Added Element
Contract.term.asset
  • Added Element
Contract.term.asset.class
  • Added Element
Contract.term.asset.code
  • Added Element
Contract.term.asset.period
  • Added Element
Contract.term.asset.dataPeriod
  • Added Element
Contract.term.asset.data
  • Added Element
Contract.term.asset.data.meaning
  • Added Element
Contract.term.asset.data.reference
  • Added Element
Contract.term.asset.valuedItem
  • Added Element
Contract.term.asset.valuedItem.entity[x]
  • Added Element
Contract.term.asset.valuedItem.identifier
  • Added Element
Contract.term.asset.valuedItem.effectiveTime
  • Added Element
Contract.term.asset.valuedItem.quantity
  • Added Element
Contract.term.asset.valuedItem.unitPrice
  • Added Element
Contract.term.asset.valuedItem.factor
  • Added Element
Contract.term.asset.valuedItem.points
  • Added Element
Contract.term.asset.valuedItem.net
  • Added Element
Contract.term.asset.securityLabel
  • Added Element
Contract.friendly.content[x]
  • Remove Reference(Composition|DocumentReference|QuestionnaireResponse), Add Reference(Composition|DocumentReference|QuestionnaireResponse)
Contract.legal.content[x]
  • Remove Reference(Composition|DocumentReference|QuestionnaireResponse), Add Reference(Composition|DocumentReference|QuestionnaireResponse)
Contract.rule
  • Max Cardinality changed from * to 1
Contract.rule.content[x]
  • Remove Reference(DocumentReference), Add Reference(DocumentReference)
Contract.legallyBinding[x]
  • Added Element
Contract.topic
  • deleted
Contract.action
  • deleted
Contract.actionReason
  • deleted
Contract.decisionType
  • deleted
Contract.securityLabel
  • deleted
Contract.agent
  • deleted
Contract.valuedItem
  • deleted
Contract.term.topic
  • deleted
Contract.term.securityLabel
  • deleted
Contract.term.text
  • deleted
Contract.term.valuedItem
  • deleted
Contract.binding[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.). Note: these have note yet been updated to be R3 to R4

 

Alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

13.11.2.1 Terminology Bindings

PathDefinitionTypeReference
Contract.status A code specifying the state of the resource instance.RequiredContract Resource Status Codes
Contract.contentDerivative This is an example set of Content Derivative type codes, which represent the minimal content derived from the basal information source.ExampleContract Content Derivation Codes
Contract.type List of overall contract codes.ExampleContract Type Codes
Contract.subType Detailed codes within the above.ExampleContract Subtype Codes
Contract.term.type
Contract.term.offer.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 Subtype Codes
Contract.term.offer.decision The type of decision made by a grantor with respect to an offer made by a grantee.ExtensibleActConsentDirective
Contract.term.asset.class The class (type) of information a consent rule coversExtensibleConsent Content Class
Contract.term.asset.code If this code is found in an instance, then the exception appliesExampleConsent Content Codes
Contract.term.asset.data.meaning How a resource reference is interpreted when evaluating contract offersRequiredContractDataMeaning
Contract.term.asset.securityLabel Security Labels from the Healthcare Privacy and Security Classification System.ExtensibleAll Security Labels
Contract.term.agent.role Detailed codes for the contract actor role.ExampleContract Actor Role Codes
Contract.term.action Detailed codes for the contract action.ExampleContract Action Codes
Contract.term.actionReason Detailed codes for the contract action reason.ExamplePurposeOfUse
Contract.signer.type List of parties who may be signing.PreferredContract Signer Type Codes

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

NameTypeDescriptionExpressionIn Common
authorityreferenceThe authority of the contractContract.authority
(Organization)
domainreferenceThe domain of the contractContract.domain
(Location)
identifiertokenThe identity of the contractContract.identifier
issueddateThe date/time the contract was issuedContract.issued
patientreferenceThe identity of the subject of the contract (if a patient)Contract.subject
(Patient)
signerreferenceContract Signatory PartyContract.signer.party
(Practitioner, Organization, Patient, RelatedPerson)
statustokenThe status of the contractContract.status
subjectreferenceThe identity of the subject of the contractContract.subject
(Any)