--- type: "resource" title: "Contract" resource: "Contract" --- # Contract ## Introduction ## Scope and Usage This resource allows for the instantiation of various types of legally enforceable agreements or policies as shareable, consumable, and executable artifacts as well as precursory content upon which instances may be based or derivative artifacts supporting management of their basal instance. The resource is general enough to encode broad range of legal artifacts such as: - A Contract instance, which may undergo legal state transitions during its formation. - Templates for or agreed upon instances of rules, obligations, and prohibitions. - An organizational or jurisdictional policy, for example, for establishing rules of conduct or obligations necessary to achieve societal goods. Or it may encode a contract instance, which may be accepted by one party in exchange of considerations offered by another party. - A derivative of a contract instance for purposes of workflow management of the agreement, e.g., for retrieval or indication of agreed upon terms, such as entities allowed to exchange governed assets. Contracts are promises or understandings that are enforceable by law in case of any violation or breech by any involved party or organization. A Contract instance may be a unilateral mandate such as a policy, or a unilateral, bilateral, or multilateral agreement, which impacts the influence of the parties over the terms of the agreement, and the burdens and risks incurred. Contract Resource may be typed to support multiple types of domain policies and contractual agreements, and specializations of those types. A Contract instance must include at least one term with an offer, which obligates the offerer to or not to do, perform, or effectuate some action in exchange for some consideration in return from the offeree, e.g., another obligatory action or non-action, or an asset. The Contract action element follows the Request Pattern to describe the proposal, plan, or order to effectuate the obligatory service or activity specified in a term’s offer. The Contract action may reference and specify the roles for one or more target entities, the requesters, and performers. By following the Request Pattern, the Contract provides the criteria needed to assess whether the contract obligations have been enforced, for example, in the case of a privacy policy, by an access control system. The Contract asset element supports detailed description of the consideration being exchanged in a Contract instance or the satisfaction of a policy imperative such as the obligation to render aid as required by local law. The Contract valuedItem element supports detailed description of the monetary worth of a Contract asset being marketed, the price of products being sold, or the property taxes required under a jurisdictional tax law. A Contract may be used as a content derivative, which contains the minimal content derived from the basal information source at a specific stage in its lifecycle, which is needed for management and communications about the basal information source. For example, the metadata used to register a Contract’s characteristics and retrieval address in a federated registry/repository exchange ecosystem. In addition to other uses of derivatives, the Contract Resource may function simply as the computable representation of the executed contract, which may be the attached to the Contract Resource as the 'legally binding' scanned paper contract attachment or referenced location, or as the 'friendly' electronic form such as an html page or a QuestionnaireResponse. By using the Contract linkID elements, which are associated with key Contract elements, a Contract Resource may be automatically populated with the values expressed in a related QuestionnaireResponse. Note that the Contract Resource may be considered the legally binding contract only if it is intended to be the sole 'executed' encoding of this contract, and includes the legally binding signatures. I.e., even if the Contract Resource is populated based on content in a hard-copy contract or an electronic contract form intended to collect both the content and the signature of relevant parties to the contract, if contracting parties have agreed or acknowledged that the Contract Resource conveys the binding and enforceable legal contract and that it is fully traceable to the forms used to collect its content, meeting the legal concept of being within the 'four corners of a contract', i.e., that the meaning of the contract, will, or deed is represented solely by this instance of the Contract Resource. This usage could be implemented with digital ledger technology to form a 'smart contract' to the extent that an instance supports elements critical to computable algorithms intended to achieve some output. Where the Consent resource applies, the Consent resource should be used. Where a Contract exists for a consent directive then if a Consent for this also exists the Consent shall reference the Contract. ## Boundaries and Relationships - Contracts are used to record in machine processible form a legal agreement between parties ## Background and Context Implementers should be familiar with legal concepts, [Ricardian Contracts](http://iang.org/papers/ricardian_contract.html) and have a general knowledge of recording agreements. ### Legal State Machine This Resource supports tracking of the progress of a Contract instance during its lifecycle as a 'legal instrument' from inception as a draft, possibly based on a definitional contract template to negotiations and the various permutation on term elements that may occur, on to execution. Then it follows the Contract as enforceable obligations, which may be breached, disputed, or modified, until the Contract reaches renewal, termination, or revocation. This is flow is orthogonal to the Contract.status, which tracks the progress of the documentation of the Contract whether it is definitional, a derivative, or an instance. The legal state value set specifies the characteristics of these states based on legal definitions. ![Legal State Machine](legal_state_machine_final.png) ## StructureDefinition ### Elements (Simplified) - **[Contract](/contract-definitions#Contract)** [0..*]: - Legal Agreement - **[Contract.identifier](/contract-definitions#Contract.identifier)** [0..*]: [Identifier](/Identifier) Contract number - **[Contract.url](/contract-definitions#Contract.url)** [0..1]: [uri](/uri) Basal definition - **[Contract.version](/contract-definitions#Contract.version)** [0..1]: [string](/string) Business edition - **[Contract.status](/contract-definitions#Contract.status)** [0..1]: [code](/code) required:[contract-status](/valueset-contract-status) amended | appended | cancelled | disputed | entered-in-error | executable + - **[Contract.legalState](/contract-definitions#Contract.legalState)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[contract-legalstate](/valueset-contract-legalstate) Negotiation status - **[Contract.instantiatesCanonical](/contract-definitions#Contract.instantiatesCanonical)** [0..1]: Reference([Contract](/Contract)) Source Contract Definition - **[Contract.instantiatesUri](/contract-definitions#Contract.instantiatesUri)** [0..1]: [uri](/uri) External Contract Definition - **[Contract.contentDerivative](/contract-definitions#Contract.contentDerivative)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-content-derivative](/valueset-contract-content-derivative) Content derived from the basal information - **[Contract.issued](/contract-definitions#Contract.issued)** [0..1]: [dateTime](/dateTime) When this Contract was issued - **[Contract.applies](/contract-definitions#Contract.applies)** [0..1]: [Period](/Period) Effective time - **[Contract.expirationType](/contract-definitions#Contract.expirationType)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-expiration-type](/valueset-contract-expiration-type) Contract cessation cause - **[Contract.subject](/contract-definitions#Contract.subject)** [0..*]: Reference([Resource](/Resource)) Contract Target Entity - **[Contract.authority](/contract-definitions#Contract.authority)** [0..*]: Reference([Organization](/Organization)) Authority under which this Contract has standing - **[Contract.domain](/contract-definitions#Contract.domain)** [0..*]: Reference([Location](/Location)) A sphere of control governed by an authoritative jurisdiction, organization, or person - **[Contract.site](/contract-definitions#Contract.site)** [0..*]: Reference([Location](/Location)) Specific Location - **[Contract.name](/contract-definitions#Contract.name)** [0..1]: [string](/string) Computer friendly designation - **[Contract.title](/contract-definitions#Contract.title)** [0..1]: [string](/string) Human Friendly name - **[Contract.subtitle](/contract-definitions#Contract.subtitle)** [0..1]: [string](/string) Subordinate Friendly name - **[Contract.alias](/contract-definitions#Contract.alias)** [0..*]: [string](/string) Acronym or short name - **[Contract.author](/contract-definitions#Contract.author)** [0..1]: [Reference(Patient](/Reference(Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [Organization](/Organization), [RelatedPerson)](/RelatedPerson)) Source of Contract - **[Contract.scope](/contract-definitions#Contract.scope)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-scope](/valueset-contract-scope) Range of Legal Concerns - **[Contract.topic[x]](/contract-definitions#Contract.topic%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Resource](/Resource)) Focus of contract interest - **[Contract.type](/contract-definitions#Contract.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-type](/valueset-contract-type) Legal instrument category - **[Contract.subType](/contract-definitions#Contract.subType)** [0..*]: [CodeableConcept](/CodeableConcept) example:[contract-subtype](/valueset-contract-subtype) Subtype within the context of type - **[Contract.contentDefinition](/contract-definitions#Contract.contentDefinition)** [0..1]: [BackboneElement](/BackboneElement) Contract precursor content - **[Contract.contentDefinition.type](/contract-definitions#Contract.contentDefinition.type)** [1..1]: [CodeableConcept](/CodeableConcept) example:[contract-definition-type](/valueset-contract-definition-type) Content structure and use - **[Contract.contentDefinition.subType](/contract-definitions#Contract.contentDefinition.subType)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-definition-subtype](/valueset-contract-definition-subtype) Detailed Content Type Definition - **[Contract.contentDefinition.publisher](/contract-definitions#Contract.contentDefinition.publisher)** [0..1]: [Reference(Practitioner](/Reference(Practitioner), [PractitionerRole](/PractitionerRole), [Organization)](/Organization)) Publisher Entity - **[Contract.contentDefinition.publicationDate](/contract-definitions#Contract.contentDefinition.publicationDate)** [0..1]: [dateTime](/dateTime) When published - **[Contract.contentDefinition.publicationStatus](/contract-definitions#Contract.contentDefinition.publicationStatus)** [1..1]: [code](/code) required:[contract-publicationstatus](/valueset-contract-publicationstatus) amended | appended | cancelled | disputed | entered-in-error | executable + - **[Contract.contentDefinition.copyright](/contract-definitions#Contract.contentDefinition.copyright)** [0..1]: [markdown](/markdown) Publication Ownership - **[Contract.term](/contract-definitions#Contract.term)** [0..*]: [BackboneElement](/BackboneElement) Contract Term List - **[Contract.term.identifier](/contract-definitions#Contract.term.identifier)** [0..1]: [Identifier](/Identifier) Contract Term Number - **[Contract.term.issued](/contract-definitions#Contract.term.issued)** [0..1]: [dateTime](/dateTime) Contract Term Issue Date Time - **[Contract.term.applies](/contract-definitions#Contract.term.applies)** [0..1]: [Period](/Period) Contract Term Effective Time - **[Contract.term.topic[x]](/contract-definitions#Contract.term.topic%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Resource](/Resource)) Term Concern - **[Contract.term.type](/contract-definitions#Contract.term.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-term-type](/valueset-contract-term-type) Contract Term Type or Form - **[Contract.term.subType](/contract-definitions#Contract.term.subType)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-term-subtype](/valueset-contract-term-subtype) Contract Term Type specific classification - **[Contract.term.text](/contract-definitions#Contract.term.text)** [0..1]: [markdown](/markdown) Term Statement - **[Contract.term.securityLabel](/contract-definitions#Contract.term.securityLabel)** [0..*]: [BackboneElement](/BackboneElement) Protection for the Term - **[Contract.term.securityLabel.number](/contract-definitions#Contract.term.securityLabel.number)** [0..*]: [unsignedInt](/unsignedInt) Link to Security Labels - **[Contract.term.securityLabel.classification](/contract-definitions#Contract.term.securityLabel.classification)** [1..1]: [Coding](/Coding) example:[contract-security-classification](/valueset-contract-security-classification) Confidentiality Protection - **[Contract.term.securityLabel.category](/contract-definitions#Contract.term.securityLabel.category)** [0..*]: [Coding](/Coding) example:[contract-security-category](/valueset-contract-security-category) Applicable Policy - **[Contract.term.securityLabel.control](/contract-definitions#Contract.term.securityLabel.control)** [0..*]: [Coding](/Coding) example:[contract-security-control](/valueset-contract-security-control) Handling Instructions - **[Contract.term.offer](/contract-definitions#Contract.term.offer)** [1..1]: [BackboneElement](/BackboneElement) Context of the Contract term - **[Contract.term.offer.identifier](/contract-definitions#Contract.term.offer.identifier)** [0..*]: [Identifier](/Identifier) Offer business ID - **[Contract.term.offer.party](/contract-definitions#Contract.term.offer.party)** [0..*]: [BackboneElement](/BackboneElement) Offer Recipient - **[Contract.term.offer.party.reference](/contract-definitions#Contract.term.offer.party.reference)** [1..*]: [Reference(Patient](/Reference(Patient), [RelatedPerson](/RelatedPerson), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [Device](/Device), [Group](/Group), [Organization)](/Organization)) Referenced entity - **[Contract.term.offer.party.role](/contract-definitions#Contract.term.offer.party.role)** [1..1]: [CodeableConcept](/CodeableConcept) example:[contract-party-role](/valueset-contract-party-role) Participant engagement type - **[Contract.term.offer.topic](/contract-definitions#Contract.term.offer.topic)** [0..1]: Reference([Resource](/Resource)) Negotiable offer asset - **[Contract.term.offer.type](/contract-definitions#Contract.term.offer.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-term-type](/valueset-contract-term-type) Contract Offer Type or Form - **[Contract.term.offer.decision](/contract-definitions#Contract.term.offer.decision)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[v3-ActConsentDirective](/valueset-v3-ActConsentDirective) Accepting party choice - **[Contract.term.offer.decisionMode](/contract-definitions#Contract.term.offer.decisionMode)** [0..*]: [CodeableConcept](/CodeableConcept) example:[contract-decision-mode](/valueset-contract-decision-mode) How decision is conveyed - **[Contract.term.offer.answer](/contract-definitions#Contract.term.offer.answer)** [0..*]: [BackboneElement](/BackboneElement) Response to offer text - **[Contract.term.offer.answer.value[x]](/contract-definitions#Contract.term.offer.answer.value%5Bx%5D)** [1..1]: [boolean](/boolean), [decimal](/decimal), [integer](/integer), [date](/date), [dateTime](/dateTime), [time](/time), [string](/string), [uri](/uri), [Attachment](/Attachment), [Coding](/Coding), [Quantity](/Quantity), Reference([Resource](/Resource)) The actual answer response - **[Contract.term.offer.text](/contract-definitions#Contract.term.offer.text)** [0..1]: [string](/string) Human readable offer text - **[Contract.term.offer.linkId](/contract-definitions#Contract.term.offer.linkId)** [0..*]: [string](/string) Pointer to text - **[Contract.term.offer.securityLabelNumber](/contract-definitions#Contract.term.offer.securityLabelNumber)** [0..*]: [unsignedInt](/unsignedInt) Offer restriction numbers - **[Contract.term.asset](/contract-definitions#Contract.term.asset)** [0..*]: [BackboneElement](/BackboneElement) Contract Term Asset List - **[Contract.term.asset.scope](/contract-definitions#Contract.term.asset.scope)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-assetscope](/valueset-contract-assetscope) Range of asset - **[Contract.term.asset.type](/contract-definitions#Contract.term.asset.type)** [0..*]: [CodeableConcept](/CodeableConcept) example:[contract-assettype](/valueset-contract-assettype) Asset category - **[Contract.term.asset.typeReference](/contract-definitions#Contract.term.asset.typeReference)** [0..*]: Reference([Resource](/Resource)) Associated entities - **[Contract.term.asset.subtype](/contract-definitions#Contract.term.asset.subtype)** [0..*]: [CodeableConcept](/CodeableConcept) example:[contract-assetsubtype](/valueset-contract-assetsubtype) Asset sub-category - **[Contract.term.asset.relationship](/contract-definitions#Contract.term.asset.relationship)** [0..1]: [Coding](/Coding) extensible:[consent-content-class](/valueset-consent-content-class) Kinship of the asset - **[Contract.term.asset.context](/contract-definitions#Contract.term.asset.context)** [0..*]: [BackboneElement](/BackboneElement) Circumstance of the asset - **[Contract.term.asset.context.reference](/contract-definitions#Contract.term.asset.context.reference)** [0..1]: Reference([Resource](/Resource)) Creator,custodian or owner - **[Contract.term.asset.context.code](/contract-definitions#Contract.term.asset.context.code)** [0..*]: [CodeableConcept](/CodeableConcept) example:[contract-assetcontext](/valueset-contract-assetcontext) Codeable asset context - **[Contract.term.asset.context.text](/contract-definitions#Contract.term.asset.context.text)** [0..1]: [string](/string) Context description - **[Contract.term.asset.condition](/contract-definitions#Contract.term.asset.condition)** [0..1]: [string](/string) Quality desctiption of asset - **[Contract.term.asset.periodType](/contract-definitions#Contract.term.asset.periodType)** [0..*]: [CodeableConcept](/CodeableConcept) example:[asset-availability](/valueset-asset-availability) Asset availability types - **[Contract.term.asset.period](/contract-definitions#Contract.term.asset.period)** [0..*]: [Period](/Period) Time period of the asset - **[Contract.term.asset.usePeriod](/contract-definitions#Contract.term.asset.usePeriod)** [0..*]: [Period](/Period) Time period - **[Contract.term.asset.text](/contract-definitions#Contract.term.asset.text)** [0..1]: [string](/string) Asset clause or question text - **[Contract.term.asset.linkId](/contract-definitions#Contract.term.asset.linkId)** [0..*]: [string](/string) Pointer to asset text - **[Contract.term.asset.answer](/contract-definitions#Contract.term.asset.answer)** [0..*]: - Response to assets - **[Contract.term.asset.securityLabelNumber](/contract-definitions#Contract.term.asset.securityLabelNumber)** [0..*]: [unsignedInt](/unsignedInt) Asset restriction numbers - **[Contract.term.asset.valuedItem](/contract-definitions#Contract.term.asset.valuedItem)** [0..*]: [BackboneElement](/BackboneElement) Contract Valued Item List - **[Contract.term.asset.valuedItem.entity[x]](/contract-definitions#Contract.term.asset.valuedItem.entity%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Resource](/Resource)) Contract Valued Item Type - **[Contract.term.asset.valuedItem.identifier](/contract-definitions#Contract.term.asset.valuedItem.identifier)** [0..1]: [Identifier](/Identifier) Contract Valued Item Number - **[Contract.term.asset.valuedItem.effectiveTime](/contract-definitions#Contract.term.asset.valuedItem.effectiveTime)** [0..1]: [dateTime](/dateTime) Contract Valued Item Effective Tiem - **[Contract.term.asset.valuedItem.quantity](/contract-definitions#Contract.term.asset.valuedItem.quantity)** [0..1]: [Quantity](/Quantity)([SimpleQuantity](/SimpleQuantity)) Count of Contract Valued Items - **[Contract.term.asset.valuedItem.unitPrice](/contract-definitions#Contract.term.asset.valuedItem.unitPrice)** [0..1]: [Money](/Money) Contract Valued Item fee, charge, or cost - **[Contract.term.asset.valuedItem.factor](/contract-definitions#Contract.term.asset.valuedItem.factor)** [0..1]: [decimal](/decimal) Contract Valued Item Price Scaling Factor - **[Contract.term.asset.valuedItem.points](/contract-definitions#Contract.term.asset.valuedItem.points)** [0..1]: [decimal](/decimal) Contract Valued Item Difficulty Scaling Factor - **[Contract.term.asset.valuedItem.net](/contract-definitions#Contract.term.asset.valuedItem.net)** [0..1]: [Money](/Money) Total Contract Valued Item Value - **[Contract.term.asset.valuedItem.payment](/contract-definitions#Contract.term.asset.valuedItem.payment)** [0..1]: [string](/string) Terms of valuation - **[Contract.term.asset.valuedItem.paymentDate](/contract-definitions#Contract.term.asset.valuedItem.paymentDate)** [0..1]: [dateTime](/dateTime) When payment is due - **[Contract.term.asset.valuedItem.responsible](/contract-definitions#Contract.term.asset.valuedItem.responsible)** [0..1]: [Reference(Organization](/Reference(Organization), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [RelatedPerson)](/RelatedPerson)) Who will make payment - **[Contract.term.asset.valuedItem.recipient](/contract-definitions#Contract.term.asset.valuedItem.recipient)** [0..1]: [Reference(Organization](/Reference(Organization), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [RelatedPerson)](/RelatedPerson)) Who will receive payment - **[Contract.term.asset.valuedItem.linkId](/contract-definitions#Contract.term.asset.valuedItem.linkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.asset.valuedItem.securityLabelNumber](/contract-definitions#Contract.term.asset.valuedItem.securityLabelNumber)** [0..*]: [unsignedInt](/unsignedInt) Security Labels that define affected terms - **[Contract.term.action](/contract-definitions#Contract.term.action)** [0..*]: [BackboneElement](/BackboneElement) Entity being ascribed responsibility - **[Contract.term.action.doNotPerform](/contract-definitions#Contract.term.action.doNotPerform)** [0..1]: [boolean](/boolean) True if the term prohibits the action - **[Contract.term.action.type](/contract-definitions#Contract.term.action.type)** [1..1]: [CodeableConcept](/CodeableConcept) example:[contract-action](/valueset-contract-action) Type or form of the action - **[Contract.term.action.subject](/contract-definitions#Contract.term.action.subject)** [0..*]: [BackboneElement](/BackboneElement) Entity of the action - **[Contract.term.action.subject.reference](/contract-definitions#Contract.term.action.subject.reference)** [1..*]: [Reference(Patient](/Reference(Patient), [RelatedPerson](/RelatedPerson), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [Device](/Device), [Group](/Group), [Organization)](/Organization)) Entity of the action - **[Contract.term.action.subject.role](/contract-definitions#Contract.term.action.subject.role)** [0..1]: [CodeableConcept](/CodeableConcept) example:[contract-actorrole](/valueset-contract-actorrole) Role type of the agent - **[Contract.term.action.intent](/contract-definitions#Contract.term.action.intent)** [1..1]: [CodeableConcept](/CodeableConcept) example:[v3-PurposeOfUse](/valueset-v3-PurposeOfUse) Purpose for the Contract Term Action - **[Contract.term.action.linkId](/contract-definitions#Contract.term.action.linkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.action.status](/contract-definitions#Contract.term.action.status)** [1..1]: [CodeableConcept](/CodeableConcept) example:[contract-actionstatus](/valueset-contract-actionstatus) State of the action - **[Contract.term.action.context](/contract-definitions#Contract.term.action.context)** [0..1]: [Reference(Encounter](/Reference(Encounter), [EpisodeOfCare)](/EpisodeOfCare)) Episode associated with action - **[Contract.term.action.contextLinkId](/contract-definitions#Contract.term.action.contextLinkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.action.occurrence[x]](/contract-definitions#Contract.term.action.occurrence%5Bx%5D)** [0..1]: [dateTime](/dateTime), [Period](/Period), [Timing](/Timing) When action happens - **[Contract.term.action.requester](/contract-definitions#Contract.term.action.requester)** [0..*]: [Reference(Patient](/Reference(Patient), [RelatedPerson](/RelatedPerson), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [Device](/Device), [Group](/Group), [Organization)](/Organization)) Who asked for action - **[Contract.term.action.requesterLinkId](/contract-definitions#Contract.term.action.requesterLinkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.action.performerType](/contract-definitions#Contract.term.action.performerType)** [0..*]: [CodeableConcept](/CodeableConcept) example:[participation-role-type](/valueset-participation-role-type) Kind of service performer - **[Contract.term.action.performerRole](/contract-definitions#Contract.term.action.performerRole)** [0..1]: [CodeableConcept](/CodeableConcept) example:[security-role-type-example](/valueset-security-role-type-example) Competency of the performer - **[Contract.term.action.performer](/contract-definitions#Contract.term.action.performer)** [0..1]: [Reference(RelatedPerson](/Reference(RelatedPerson), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [CareTeam](/CareTeam), [Device](/Device), [Substance](/Substance), [Organization](/Organization), [Location)](/Location)) Actor that wil execute (or not) the action - **[Contract.term.action.performerLinkId](/contract-definitions#Contract.term.action.performerLinkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.action.reason](/contract-definitions#Contract.term.action.reason)** [0..*]: [CodeableReference](/CodeableReference) example:[v3-PurposeOfUse](/valueset-v3-PurposeOfUse) Why is action (not) needed? - **[Contract.term.action.reasonLinkId](/contract-definitions#Contract.term.action.reasonLinkId)** [0..*]: [string](/string) Pointer to specific item - **[Contract.term.action.note](/contract-definitions#Contract.term.action.note)** [0..*]: [Annotation](/Annotation) Comments about the action - **[Contract.term.action.securityLabelNumber](/contract-definitions#Contract.term.action.securityLabelNumber)** [0..*]: [unsignedInt](/unsignedInt) Action restriction numbers - **[Contract.term.group](/contract-definitions#Contract.term.group)** [0..*]: - Nested Contract Term Group - **[Contract.supportingInfo](/contract-definitions#Contract.supportingInfo)** [0..*]: Reference([Resource](/Resource)) Extra Information - **[Contract.relevantHistory](/contract-definitions#Contract.relevantHistory)** [0..*]: Reference([Provenance](/Provenance)) Key event in Contract History - **[Contract.signer](/contract-definitions#Contract.signer)** [0..*]: [BackboneElement](/BackboneElement) Contract Signatory - **[Contract.signer.type](/contract-definitions#Contract.signer.type)** [1..1]: [Coding](/Coding) preferred:[contract-signer-type](/valueset-contract-signer-type) Contract Signatory Role - **[Contract.signer.party](/contract-definitions#Contract.signer.party)** [1..1]: [Reference(Organization](/Reference(Organization), [Patient](/Patient), [Practitioner](/Practitioner), [PractitionerRole](/PractitionerRole), [RelatedPerson)](/RelatedPerson)) Contract Signatory Party - **[Contract.signer.signature](/contract-definitions#Contract.signer.signature)** [1..*]: [Signature](/Signature) Contract Documentation Signature - **[Contract.friendly](/contract-definitions#Contract.friendly)** [0..*]: [BackboneElement](/BackboneElement) Contract Friendly Language - **[Contract.friendly.content[x]](/contract-definitions#Contract.friendly.content%5Bx%5D)** [1..1]: [Attachment](/Attachment), [Reference(Composition](/Reference(Composition), [DocumentReference](/DocumentReference), [QuestionnaireResponse)](/QuestionnaireResponse)) Easily comprehended representation of this Contract - **[Contract.legal](/contract-definitions#Contract.legal)** [0..*]: [BackboneElement](/BackboneElement) Contract Legal Language - **[Contract.legal.content[x]](/contract-definitions#Contract.legal.content%5Bx%5D)** [1..1]: [Attachment](/Attachment), [Reference(Composition](/Reference(Composition), [DocumentReference](/DocumentReference), [QuestionnaireResponse)](/QuestionnaireResponse)) Contract Legal Text - **[Contract.rule](/contract-definitions#Contract.rule)** [0..*]: [BackboneElement](/BackboneElement) Computable Contract Language - **[Contract.rule.content[x]](/contract-definitions#Contract.rule.content%5Bx%5D)** [1..1]: [Attachment](/Attachment), Reference([DocumentReference](/DocumentReference)) Computable Contract Rules - **[Contract.legallyBinding[x]](/contract-definitions#Contract.legallyBinding%5Bx%5D)** [0..1]: [Attachment](/Attachment), [Reference(Composition](/Reference(Composition), [DocumentReference](/DocumentReference), [QuestionnaireResponse](/QuestionnaireResponse), [Contract)](/Contract)) Binding Contract ## Mappings - [Contract Mappings](/contract-mappings) — 97 mapping entries ## Resource Packs ### list-Contract-packs.xml ```xml ``` ## Search Parameters - [authority](/contract-search#authority) — **reference** — The authority of the contract — `Contract.authority` - [domain](/contract-search#domain) — **reference** — The domain of the contract — `Contract.domain` - [identifier](/contract-search#identifier) — **token** — The identity of the contract — `Contract.identifier` - [instantiates](/contract-search#instantiates) — **uri** — A source definition of the contract — `Contract.instantiatesUri` - [issued](/contract-search#issued) — **date** — The date/time the contract was issued — `Contract.issued` - [patient](/contract-search#patient) — **reference** — The identity of the subject of the contract (if a patient) — `Contract.subject.where(resolve() is Patient)` - [signer](/contract-search#signer) — **reference** — Contract Signatory Party — `Contract.signer.party` - [status](/contract-search#status) — **token** — The status of the contract — `Contract.status` - [subject](/contract-search#subject) — **reference** — The identity of the subject of the contract — `Contract.subject` - [url](/contract-search#url) — **uri** — The basal contract definition — `Contract.url` [Full Search Parameters](/contract-search) ## Examples - [C-123](/contract-example-C-123) — contract-example — General Contract Example - [C-2121](/contract-example-C-2121) — contract-example-42cfr-part2 — 42 CFR Part 2 Consent Directive - [contract-example](/contract-example-contract-example) — contract-example - [contract-example-42cfr-part2](/contract-example-contract-example-42cfr-part2) — contract-example-42cfr-part2 - [contract-example-ins-policy](/contract-example-contract-example-ins-policy) — contract-example-ins-policy - [contract-examples-header](/contract-example-contract-examples-header) — contract-examples-header - [INS-101](/contract-example-INS-101) — contract-example-ins-policy — Health Insurance Policy - [pcd-example-notAuthor](/contract-example-pcd-example-notAuthor) — pcd-example-notAuthor — ConsentDirective Example - [pcd-example-notLabs](/contract-example-pcd-example-notLabs) — pcd-example-notLabs — ConsentDirective Example - [pcd-example-notOrg](/contract-example-pcd-example-notOrg) — pcd-example-notOrg — ConsentDirective Example - [pcd-example-notThem](/contract-example-pcd-example-notThem) — pcd-example-notThem — ConsentDirective Example - [pcd-example-notThis](/contract-example-pcd-example-notThis) — pcd-example-notThis — ConsentDirective Example [Full Examples](/contract-examples) ## Mapping Exceptions ### contract-event-mapping-exceptions.xml ### Divergent Elements - **Event.identifier** → **Contract.identifier** - shortUnmatched | reason=Unknown | pattern=Business identifier for contract | resource=Contract number - definitionUnmatched | reason=Unknown | pattern=Business identifiers assigned to this contract by the performer and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server. | resource=Unique identifier for this Contract or a derivative that references a Source Contract. - commentsUnmatched | reason=Unknown | pattern=Note: This is a business identifier, not a resource identifier (see [discussion](resource.html#identifiers)). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number. - requirementsUnmatched | reason=Unknown | pattern=Allows identification of the contract as it is known by various participating systems and in a way that remains consistent across servers. | resource=This is the business identifier of the contract content conveyed. It may be a derivative of the legally binding contract, in which case, the identifier of the basal contract is contained in the Contract.binding referenced Contract. - **Event.identifier** → **Contract.term.identifier** - shortUnmatched | reason=Unknown | pattern=Business identifier for contract | resource=Contract Term Number - definitionUnmatched | reason=Unknown | pattern=Business identifiers assigned to this contract by the performer and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server. | resource=Unique identifier for this particular Contract Provision. - commentsUnmatched | reason=Unknown | pattern=Note: This is a business identifier, not a resource identifier (see [discussion](resource.html#identifiers)). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number. - requirementsUnmatched | reason=Unknown | pattern=Allows identification of the contract as it is known by various participating systems and in a way that remains consistent across servers. - **Event.status** → **Contract.status** - shortUnmatched | reason=Unknown | pattern=preparation | in-progress | not-done | suspended | aborted | completed | entered-in-error | unknown | resource=amended | appended | cancelled | disputed | entered-in-error | executable + - definitionUnmatched | reason=Unknown | pattern=The current state of the contract. | resource=The status of the resource instance. - commentsUnmatched | reason=Unknown | pattern=A nominal state-transition diagram can be found in the (Event pattern documentation Unknown does not represent "other" - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is. | resource=This element is labeled as a modifier because the status contains codes that mark the contract as not currently valid or active. - **Event.code** → **Contract.type** - shortUnmatched | reason=Unknown | pattern=What service was done | resource=Legal instrument category - definitionUnmatched | reason=Unknown | pattern=A code that identifies the specific service or action that was or is being performed. | resource=A high-level category for the legal instrument, whether constructed as a Contract definition, derivative, or instance in any legal state. Provides additional information about its content within the context of the Contract's scope to distinguish the kinds of systems that would be interested in the contract. - **Event.code** → **Contract.term.type** - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=What service was done | resource=Contract Term Type or Form - definitionUnmatched | reason=Unknown | pattern=A code that identifies the specific service or action that was or is being performed. | resource=A legal clause or condition contained within a contract that requires one or both parties to perform a particular requirement by some specified time or prevents one or both parties from performing a particular requirement by some specified time. - **Event.subject** → **Contract.subject** - missingTypes | reason=Unknown | pattern=Reference(Patient, Group) - extraTypes | reason=Unknown - shortUnmatched | reason=Unknown | pattern=Individual service was done for/to | resource=Contract Target Entity - definitionUnmatched | reason=Unknown | pattern=The individual or set of individuals the action is being or was performed on. | resource=The target entity impacted by or of interest to parties to the agreement. - requirementsUnmatched | reason=Unknown | pattern=Links the contract to the Patient context. May also affect access control. | resource=The Contract.subject is an entity that has some role with respect to the Contract.topic and Contract.topic.term, which is of focal interest to the parties to the contract and likely impacted in a significant way by the Contract.action/Contract.action.reason and the Contract.term.action/Contract.action.reason. In many cases, the Contract.subject is a Contract.signer if the subject is an adult; has a legal interest in the contract; and incompetent to participate in the contract agreement. - **Event.occurrence[x]** → **Contract.applies** - missingTypes | reason=Unknown | pattern=dateTime, Timing - shortUnmatched | reason=Unknown | pattern=When contract occurred/is occurring | resource=Effective time - definitionUnmatched | reason=Unknown | pattern=The date, period or timing when the contract did occur or is occurring. | resource=Relevant time or time-period when this Contract is applicable. - commentsUnmatched | reason=Unknown | pattern=This indicates when the activity actually occurred or is occurring, not when it was asked/requested/ordered to occur. For the latter, look at the occurence element of the Request this {{event}} is "basedOn". The status code allows differentiation of whether the timing reflects a historic event or an ongoing event. Ongoing events should not include an upper bound in the Period or Timing.bounds. . - **Event.occurrence[x]** → **Contract.term.applies** - missingTypes | reason=Unknown | pattern=dateTime, Timing - shortUnmatched | reason=Unknown | pattern=When contract occurred/is occurring | resource=Contract Term Effective Time - definitionUnmatched | reason=Unknown | pattern=The date, period or timing when the contract did occur or is occurring. | resource=Relevant time or time-period when this Contract Provision is applicable. - commentsUnmatched | reason=Unknown | pattern=This indicates when the activity actually occurred or is occurring, not when it was asked/requested/ordered to occur. For the latter, look at the occurence element of the Request this {{event}} is "basedOn". The status code allows differentiation of whether the timing reflects a historic event or an ongoing event. Ongoing events should not include an upper bound in the Period or Timing.bounds. . - **Event.recorded** → **Contract.issued** - shortUnmatched | reason=Unknown | pattern=When contract was first captured in the subject's record | resource=When this Contract was issued - definitionUnmatched | reason=Unknown | pattern=The date the occurrence of the contract was first captured in the record - potentially significantly after the occurrence of the event. | resource=When this Contract was issued. - commentsUnmatched | reason=Unknown | pattern=The recorded date indicates the date when the data was placed in the record maintained by the performing practitioner, or the date of disclosure by Patient or RelatedPerson, not a date of record transfer. If the record is transferred from one system to another (in paper or electronic form), it does not create a distinct recorded date. In most cases, performing practitioners will record on the same date the event occurred, but sometimes there are delays. If information is being relayed second-hand, the recorded date indicates when the system is first made aware of the data. The recorded date is NOT intended to be the same as a database.createdTimestamp - that would be captured as part of resource.meta or possibly Provenance. It is possible for the same event to be disclosed to different systems at different times. E.g. a patient might tell two different clinicians about a historical event at different visits. If the disclosure is from the patient rather than record transfer from clinician A to B, the recorded date would be the date each respective clinician put the data in their record. If the data flowed from clinician A to B, the recorded date would remain the recorded date as initially set in clinician A's system. - **Event.recorded** → **Contract.term.issued** - shortUnmatched | reason=Unknown | pattern=When contract was first captured in the subject's record | resource=Contract Term Issue Date Time - definitionUnmatched | reason=Unknown | pattern=The date the occurrence of the contract was first captured in the record - potentially significantly after the occurrence of the event. | resource=When this Contract Provision was issued. - commentsUnmatched | reason=Unknown | pattern=The recorded date indicates the date when the data was placed in the record maintained by the performing practitioner, or the date of disclosure by Patient or RelatedPerson, not a date of record transfer. If the record is transferred from one system to another (in paper or electronic form), it does not create a distinct recorded date. In most cases, performing practitioners will record on the same date the event occurred, but sometimes there are delays. If information is being relayed second-hand, the recorded date indicates when the system is first made aware of the data. The recorded date is NOT intended to be the same as a database.createdTimestamp - that would be captured as part of resource.meta or possibly Provenance. It is possible for the same event to be disclosed to different systems at different times. E.g. a patient might tell two different clinicians about a historical event at different visits. If the disclosure is from the patient rather than record transfer from clinician A to B, the recorded date would be the date each respective clinician put the data in their record. If the data flowed from clinician A to B, the recorded date would remain the recorded date as initially set in clinician A's system. - **Event.performer** → **Contract.term.action.type** - extraTypes | reason=Unknown - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Who performed contract and what they did | resource=Type or form of the action - definitionUnmatched | reason=Unknown | pattern=Indicates who or what performed the contract and how they were involved. | resource=Activity or service obligation to be done or not done, performed or not performed, effectuated or not by this Contract term. - **Event.performer.actor** → **Contract.signer.party** - missingTypes | reason=Unknown | pattern=Reference(CareTeam, Device) - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Who performed contract | resource=Contract Signatory Party - definitionUnmatched | reason=Unknown | pattern=Indicates who or what performed the contract. | resource=Party which is a signator to this Contract. - **Event.reason** → **Contract.term.action.intent** - missingTypes | reason=Unknown | pattern=CodeableReference(Condition, Observation, DiagnosticReport, DocumentReference) - extraTypes | reason=Unknown - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Why was contract performed? | resource=Purpose for the Contract Term Action - definitionUnmatched | reason=Unknown | pattern=Describes why the contract occurred in coded or textual form or Indicates another resource whose existence justifies this contract. | resource=Reason or purpose for the action stipulated by this Contract Provision. - commentsUnmatched | reason=Unknown | pattern=Textual reasons can be captured using reasonCode.text. ### Unmapped Elements - **Event.partOf** — Unknown - **Event.reported** — Unknown - **Event.relevantHistory** — Unknown - **Event.location** — Unknown - **Event.statusReason** — Unknown - **Event.performer.function** — Unknown - **Event.note** — Unknown - **Event.category** — Unknown - **Event.encounter** — Unknown - **Event.product** — Unknown - **Event.basedOn** — Unknown - **Event.researchStudy** — Unknown ### contract-fivews-mapping-exceptions.xml ### Divergent Elements - **FiveWs.what[x]** → **Contract.subType** - **FiveWs.what[x]** → **Contract.term** - **FiveWs.what[x]** → **Contract.term.group** - **FiveWs.what[x]** → **Contract.friendly** - **FiveWs.what[x]** → **Contract.legal** - **FiveWs.what[x]** → **Contract.rule** ### Unmapped Elements - **FiveWs.cause** — Unknown - **FiveWs.version** — Unknown - **FiveWs.witness** — Unknown - **FiveWs.class** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.identifier** — Unknown - **FiveWs.source** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.subject** — Unknown ### contract-request-mapping-exceptions.xml ### Divergent Elements - **Request.identifier** → **Contract.identifier** - shortUnmatched | reason=Unknown | pattern=Business Identifier for contract | resource=Contract number - definitionUnmatched | reason=Unknown | pattern=Business identifiers assigned to this contract by the author and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server. | resource=Unique identifier for this Contract or a derivative that references a Source Contract. - commentsUnmatched | reason=Unknown | pattern=The identifier.type element is used to distinguish between the identifiers assigned by the requester/placer and the performer/filler. Note: This is a business identifier, not a resource identifier (see [discussion](resource.html#identifiers)). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number. - requirementsUnmatched | reason=Unknown | pattern=Allows identification of the contract as it is known by various participating systems and in a way that remains consistent across servers. | resource=This is the business identifier of the contract content conveyed. It may be a derivative of the legally binding contract, in which case, the identifier of the basal contract is contained in the Contract.binding referenced Contract. - **Request.identifier** → **Contract.term.identifier** - shortUnmatched | reason=Unknown | pattern=Business Identifier for contract | resource=Contract Term Number - definitionUnmatched | reason=Unknown | pattern=Business identifiers assigned to this contract by the author and/or other systems. These identifiers remain constant as the resource is updated and propagates from server to server. | resource=Unique identifier for this particular Contract Provision. - commentsUnmatched | reason=Unknown | pattern=The identifier.type element is used to distinguish between the identifiers assigned by the requester/placer and the performer/filler. Note: This is a business identifier, not a resource identifier (see [discussion](resource.html#identifiers)). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number. - requirementsUnmatched | reason=Unknown | pattern=Allows identification of the contract as it is known by various participating systems and in a way that remains consistent across servers. - **Request.status** → **Contract.status** - shortUnmatched | reason=Unknown | pattern=draft | active | on-hold | revoked | completed | entered-in-error | unknown | resource=amended | appended | cancelled | disputed | entered-in-error | executable + - definitionUnmatched | reason=Unknown | pattern=The current state of the contract. | resource=The status of the resource instance. - commentsUnmatched | reason=Unknown | pattern=The status is generally fully in the control of the requester - they determine whether the order is draft or active and, after it has been activated, completed, cancelled or suspended. States relating to the activities of the performer are reflected on either the corresponding]](s) or using the]] resource. A nominal state-transition diagram can be found in the] documentation Unknown does not represent "other" - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is. A status of 'active' when doNotPerform is true means that the request to not perform is currently in force. A status of completed for a "doNotPerform" request indicates that the period of non-performance is now satisfied and the request no longer holds. | resource=This element is labeled as a modifier because the status contains codes that mark the contract as not currently valid or active. - **Request.code** → **Contract.type** - shortUnmatched | reason=Unknown | pattern=Service requested/ordered | resource=Legal instrument category - definitionUnmatched | reason=Unknown | pattern=A code that identifies the specific service or action being asked to be done (or not done). | resource=A high-level category for the legal instrument, whether constructed as a Contract definition, derivative, or instance in any legal state. Provides additional information about its content within the context of the Contract's scope to distinguish the kinds of systems that would be interested in the contract. - **Request.code** → **Contract.term.type** - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Service requested/ordered | resource=Contract Term Type or Form - definitionUnmatched | reason=Unknown | pattern=A code that identifies the specific service or action being asked to be done (or not done). | resource=A legal clause or condition contained within a contract that requires one or both parties to perform a particular requirement by some specified time or prevents one or both parties from performing a particular requirement by some specified time. - **Request.subject** → **Contract.subject** - extraTypes | reason=Unknown - shortUnmatched | reason=Unknown | pattern=Individual the service is ordered/prohibited for | resource=Contract Target Entity - definitionUnmatched | reason=Unknown | pattern=The individual or set of individuals the action is to be performed/not performed on or for. | resource=The target entity impacted by or of interest to parties to the agreement. - requirementsUnmatched | reason=Unknown | pattern=Links the request to the Patient context. | resource=The Contract.subject is an entity that has some role with respect to the Contract.topic and Contract.topic.term, which is of focal interest to the parties to the contract and likely impacted in a significant way by the Contract.action/Contract.action.reason and the Contract.term.action/Contract.action.reason. In many cases, the Contract.subject is a Contract.signer if the subject is an adult; has a legal interest in the contract; and incompetent to participate in the contract agreement. - **Request.authoredOn** → **Contract.issued** - shortUnmatched | reason=Unknown | pattern=When request was created/transitioned to active | resource=When this Contract was issued - definitionUnmatched | reason=Unknown | pattern=For draft contracts, indicates the date of initial creation. For requests with other statuses, indicates the date of activation. | resource=When this Contract was issued. - **Request.authoredOn** → **Contract.term.issued** - shortUnmatched | reason=Unknown | pattern=When request was created/transitioned to active | resource=Contract Term Issue Date Time - definitionUnmatched | reason=Unknown | pattern=For draft contracts, indicates the date of initial creation. For requests with other statuses, indicates the date of activation. | resource=When this Contract Provision was issued. - **Request.requester** → **Contract.signer.party** - extraTypes | reason=Unknown - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Who/what is requesting service | resource=Contract Signatory Party - definitionUnmatched | reason=Unknown | pattern=Who initiated the {{request}} and has responsibility for its activation. | resource=Party which is a signator to this Contract. - **Request.performer** → **Contract.term.action.type** - missingTypes | reason=Unknown | pattern=Reference(Practitioner,PractitionerRole,Organization,CareTeam,HealthcareService,Patient,Device,RelatedPerson) - extraTypes | reason=Unknown - summary | reason=Unknown | pattern=true - shortUnmatched | reason=Unknown | pattern=Specific desired (non)performer | resource=Type or form of the action - definitionUnmatched | reason=Unknown | pattern=Indicates who or what is being asked to perform (or not perform) the {{request}}. | resource=Activity or service obligation to be done or not done, performed or not performed, effectuated or not by this Contract term. ### Unmapped Elements - **Request.occurrence** — Unknown - **Request** — Unknown - **Request.reported** — Unknown