description: Legally enforceable, formally recorded unilateral or bilateral directive i.e., a policy or agreement.
package_name: hl7.fhir.r5.core
derivation: specialization
name: Contract
type: Contract
elements:
  legallyBindingAttachment: {short: Binding Contract, type: Attachment, choiceOf: legallyBinding, index: 163}
  instantiatesCanonical:
    type: Reference
    short: Source Contract Definition
    refers: ['http://hl7.org/fhir/StructureDefinition/Contract']
    index: 5
  instantiatesUri: {type: uri, short: External Contract Definition, index: 6}
  legallyBindingReference:
    short: Binding Contract
    refers: ['http://hl7.org/fhir/StructureDefinition/Composition', 'http://hl7.org/fhir/StructureDefinition/Contract', 'http://hl7.org/fhir/StructureDefinition/DocumentReference', 'http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse']
    type: Reference
    choiceOf: legallyBinding
    index: 164
  site:
    type: Reference
    short: Specific Location
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    array: true
    index: 14
  relevantHistory:
    type: Reference
    short: Key event in Contract History
    refers: ['http://hl7.org/fhir/StructureDefinition/Provenance']
    array: true
    index: 141
  supportingInfo:
    type: Reference
    short: Extra Information
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    array: true
    index: 140
  applies: {short: Effective time, type: Period, isSummary: true, index: 9}
  name: {short: Computer friendly designation, type: string, isSummary: true, index: 15}
  authority:
    short: Authority under which this Contract has standing
    refers: ['http://hl7.org/fhir/StructureDefinition/Organization']
    type: Reference
    array: true
    index: 12
  rule:
    short: Computable Contract Language
    type: BackboneElement
    array: true
    index: 156
    elements:
      content:
        short: Computable Contract Rules
        choices: [contentAttachment, contentReference]
        index: 158
      contentAttachment: {short: Computable Contract Rules, type: Attachment, choiceOf: content, index: 159}
      contentReference:
        short: Computable Contract Rules
        refers: ['http://hl7.org/fhir/StructureDefinition/DocumentReference']
        type: Reference
        choiceOf: content
        index: 160
    required: [contentAttachment, contentReference, content]
  type:
    short: Legal instrument category
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-type'}
    isSummary: true
    index: 25
  legal:
    short: Contract Legal Language
    type: BackboneElement
    array: true
    index: 151
    elements:
      content:
        short: Contract Legal Text
        choices: [contentAttachment, contentReference]
        index: 153
      contentAttachment: {short: Contract Legal Text, type: Attachment, choiceOf: content, index: 154}
      contentReference:
        short: Contract Legal Text
        refers: ['http://hl7.org/fhir/StructureDefinition/Composition', 'http://hl7.org/fhir/StructureDefinition/DocumentReference', 'http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse']
        type: Reference
        choiceOf: content
        index: 155
    required: [contentAttachment, contentReference, content]
  contentDerivative:
    short: Content derived from the basal information
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-content-derivative'}
    index: 7
  topic:
    short: Focus of contract interest
    choices: [topicCodeableConcept, topicReference]
    index: 22
  topicCodeableConcept: {short: Focus of contract interest, type: CodeableConcept, choiceOf: topic, index: 23}
  legalState:
    short: Negotiation status
    type: CodeableConcept
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/contract-legalstate'}
    index: 4
  contentDefinition:
    type: BackboneElement
    short: Contract precursor content
    index: 27
    elements:
      type:
        type: CodeableConcept
        short: Content structure and use
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-definition-type'}
        index: 28
      subType:
        type: CodeableConcept
        short: Detailed Content Type Definition
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-definition-subtype'}
        index: 29
      publisher:
        type: Reference
        short: Publisher Entity
        refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole']
        index: 30
      publicationDate: {type: dateTime, short: When published, index: 31}
      publicationStatus:
        type: code
        short: amended | appended | cancelled | disputed | entered-in-error | executable +
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/contract-publicationstatus|4.5.0'}
        index: 32
      copyright: {type: markdown, short: Publication Ownership, index: 33}
    required: [type, publicationStatus]
  scope:
    type: CodeableConcept
    short: Range of Legal Concerns
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-scope'}
    index: 20
  title: {type: string, short: Human Friendly name, isSummary: true, index: 16}
  signer:
    short: Contract Signatory
    type: BackboneElement
    array: true
    index: 142
    elements:
      type:
        short: Contract Signatory Role
        type: Coding
        binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/contract-signer-type'}
        index: 143
      party:
        short: Contract Signatory Party
        refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        index: 144
      signature: {type: Signature, short: Contract Documentation Signature, array: true, min: 1, index: 145}
    required: [signature, type, party]
  author:
    type: Reference
    short: Source of Contract
    refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole']
    index: 19
  term:
    short: Contract Term List
    type: BackboneElement
    array: true
    index: 34
    elements:
      group:
        short: Nested Contract Term Group
        elementReference: ['http://hl7.org/fhir/StructureDefinition/Contract', elements, term]
        array: true
        index: 139
      applies: {short: Contract Term Effective Time, type: Period, isSummary: true, index: 37}
      offer:
        short: Context of the Contract term
        type: BackboneElement
        index: 50
        elements:
          party:
            type: BackboneElement
            short: Offer Recipient
            array: true
            index: 52
            elements:
              reference:
                type: Reference
                short: Referenced entity
                refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
                array: true
                min: 1
                index: 53
              role:
                type: CodeableConcept
                short: Participant engagement type
                binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-party-role'}
                index: 54
            required: [role, reference]
          linkId: {type: string, short: Pointer to text, array: true, index: 75}
          decisionMode:
            type: CodeableConcept
            short: How decision is conveyed
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-decision-mode'}
            array: true
            index: 58
          type:
            short: Contract Offer Type or Form
            type: CodeableConcept
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-term-type'}
            index: 56
          topic:
            short: Negotiable offer asset
            refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
            type: Reference
            isSummary: true
            index: 55
          securityLabelNumber: {type: unsignedInt, short: Offer restriction numbers, array: true, index: 76}
          answer:
            type: BackboneElement
            short: Response to offer text
            array: true
            index: 59
            elements:
              valueReference:
                short: The actual answer response
                refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
                type: Reference
                choiceOf: value
                index: 73
              valueUri: {type: uri, short: The actual answer response, choiceOf: value, index: 69}
              valueTime: {type: time, short: The actual answer response, choiceOf: value, index: 67}
              valueDecimal: {type: decimal, short: The actual answer response, choiceOf: value, index: 63}
              valueQuantity: {type: Quantity, short: The actual answer response, choiceOf: value, index: 72}
              value:
                short: The actual answer response
                choices: [valueBoolean, valueDecimal, valueInteger, valueDate, valueDateTime, valueTime, valueString, valueUri, valueAttachment, valueCoding, valueQuantity, valueReference]
                index: 61
              valueString: {type: string, short: The actual answer response, choiceOf: value, index: 68}
              valueBoolean: {type: boolean, short: The actual answer response, choiceOf: value, index: 62}
              valueDateTime: {type: dateTime, short: The actual answer response, choiceOf: value, index: 66}
              valueDate: {type: date, short: The actual answer response, choiceOf: value, index: 65}
              valueCoding: {type: Coding, short: The actual answer response, choiceOf: value, index: 71}
              valueInteger: {type: integer, short: The actual answer response, choiceOf: value, index: 64}
              valueAttachment: {type: Attachment, short: The actual answer response, choiceOf: value, index: 70}
            required: [valueCoding, valueUri, valueString, valueReference, valueDecimal, valueAttachment, valueDateTime, value, valueBoolean, valueDate, valueTime, valueQuantity, valueInteger]
          identifier: {type: Identifier, short: Offer business ID, array: true, index: 51}
          decision:
            short: Accepting party choice
            type: CodeableConcept
            binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActConsentDirective'}
            index: 57
          text: {type: string, short: Human readable offer text, index: 74}
      type:
        short: Contract Term Type or Form
        type: CodeableConcept
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-term-type'}
        index: 42
      topic:
        short: Term Concern
        choices: [topicCodeableConcept, topicReference]
        index: 39
      topicCodeableConcept: {type: CodeableConcept, short: Term Concern, choiceOf: topic, index: 40}
      topicReference:
        short: Term Concern
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        choiceOf: topic
        index: 41
      identifier: {short: Contract Term Number, type: Identifier, isSummary: true, index: 35}
      action:
        short: Entity being ascribed responsibility
        type: BackboneElement
        array: true
        index: 113
        elements:
          requesterLinkId: {type: string, short: Pointer to specific item, array: true, index: 130}
          performerType:
            type: CodeableConcept
            short: Kind of service performer
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/participation-role-type'}
            array: true
            index: 131
          linkId: {type: string, short: Pointer to specific item, array: true, index: 120}
          performerRole:
            type: CodeableConcept
            short: Competency of the performer
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/security-role-type'}
            index: 132
          reasonLinkId: {type: string, short: Pointer to specific item, array: true, index: 136}
          type:
            short: Type or form of the action
            type: CodeableConcept
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-action'}
            index: 115
          occurrenceTiming: {type: Timing, short: When action happens, choiceOf: occurrence, index: 128}
          note: {type: Annotation, short: Comments about the action, array: true, index: 137}
          reason:
            type: CodeableReference
            short: Why is action (not) needed?
            binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-PurposeOfUse'}
            array: true
            index: 135
          requester:
            type: Reference
            short: Who asked for action
            refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
            array: true
            index: 129
          securityLabelNumber: {type: unsignedInt, short: Action restriction numbers, array: true, index: 138}
          occurrencePeriod: {type: Period, short: When action happens, choiceOf: occurrence, index: 127}
          status:
            type: CodeableConcept
            short: State of the action
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-actionstatus'}
            index: 121
          doNotPerform: {isModifier: true, short: True if the term prohibits the  action, type: boolean, isModifierReason: 'If true this element negates the specified action. For Example, instead of a dictate to perform an action, it is a dictate not to perform the action.', index: 114}
          context:
            type: Reference
            short: Episode associated with action
            refers: ['http://hl7.org/fhir/StructureDefinition/Encounter', 'http://hl7.org/fhir/StructureDefinition/EpisodeOfCare']
            index: 122
          intent:
            short: Purpose for the Contract Term Action
            type: CodeableConcept
            binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-PurposeOfUse'}
            index: 119
          performerLinkId: {type: string, short: Pointer to specific item, array: true, index: 134}
          occurrenceDateTime: {type: dateTime, short: When action happens, choiceOf: occurrence, index: 126}
          subject:
            type: BackboneElement
            short: Entity of the action
            array: true
            index: 116
            elements:
              reference:
                type: Reference
                short: Entity of the action
                refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
                array: true
                min: 1
                index: 117
              role:
                short: Role type of the agent
                type: CodeableConcept
                binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-actorrole'}
                index: 118
            required: [reference]
          occurrence:
            short: When action happens
            choices: [occurrenceDateTime, occurrencePeriod, occurrenceTiming]
            index: 125
          performer:
            type: Reference
            short: Actor that wil execute (or not) the action
            refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', 'http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Location', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson', 'http://hl7.org/fhir/StructureDefinition/Substance']
            index: 133
          contextLinkId: {type: string, short: Pointer to specific item, array: true, index: 123}
        required: [status, intent, type]
      issued: {short: Contract Term Issue Date Time, type: dateTime, isSummary: true, index: 36}
      subType:
        short: Contract Term Type specific classification
        type: CodeableConcept
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-term-subtype'}
        index: 43
      securityLabel:
        short: Protection for the Term
        type: BackboneElement
        array: true
        index: 45
        elements:
          number: {type: unsignedInt, short: Link to Security Labels, array: true, index: 46}
          classification:
            type: Coding
            short: Confidentiality Protection
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-security-classification'}
            index: 47
          category:
            type: Coding
            short: Applicable Policy
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-security-category'}
            array: true
            index: 48
          control:
            type: Coding
            short: Handling Instructions
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-security-control'}
            array: true
            index: 49
        required: [classification]
      asset:
        short: Contract Term Asset List
        type: BackboneElement
        array: true
        index: 77
        elements:
          periodType:
            short: Asset availability types
            type: CodeableConcept
            array: true
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/asset-availability'}
            index: 88
          usePeriod: {type: Period, short: Time period, array: true, index: 90}
          linkId: {type: string, short: Pointer to asset text, array: true, index: 92}
          relationship:
            short: Kinship of the asset
            type: Coding
            binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/consent-content-class'}
            index: 82
          type:
            type: CodeableConcept
            short: Asset category
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-assettype'}
            array: true
            index: 79
          scope:
            type: CodeableConcept
            short: Range of asset
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-assetscope'}
            index: 78
          securityLabelNumber: {type: unsignedInt, short: Asset restriction numbers, array: true, index: 94}
          typeReference:
            type: Reference
            short: Associated entities
            refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
            array: true
            index: 80
          condition: {type: string, short: Quality desctiption of asset, index: 87}
          answer:
            short: Response to assets
            elementReference: ['http://hl7.org/fhir/StructureDefinition/Contract', elements, term, elements, offer, elements, answer]
            array: true
            index: 93
          context:
            type: BackboneElement
            short: Circumstance of the asset
            array: true
            index: 83
            elements:
              reference:
                type: Reference
                short: Creator,custodian or owner
                refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
                index: 84
              code:
                type: CodeableConcept
                short: Codeable asset context
                binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-assetcontext'}
                array: true
                index: 85
              text: {type: string, short: Context description, index: 86}
          period: {type: Period, short: Time period of the asset, array: true, index: 89}
          valuedItem:
            short: Contract Valued Item List
            type: BackboneElement
            array: true
            index: 95
            elements:
              linkId: {type: string, short: Pointer to specific item, array: true, index: 111}
              payment: {type: string, short: Terms of valuation, index: 107}
              recipient:
                type: Reference
                short: Who will receive payment
                refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
                index: 110
              net: {type: Money, short: Total Contract Valued Item Value, index: 106}
              points: {type: decimal, short: Contract Valued Item Difficulty Scaling Factor, index: 105}
              responsible:
                type: Reference
                short: Who will make payment
                refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
                index: 109
              securityLabelNumber: {type: unsignedInt, short: Security Labels that define affected terms, array: true, index: 112}
              factor: {type: decimal, short: Contract Valued Item Price Scaling Factor, index: 104}
              paymentDate: {type: dateTime, short: When payment is due, index: 108}
              entityCodeableConcept: {short: Contract Valued Item Type, type: CodeableConcept, choiceOf: entity, index: 98}
              identifier: {type: Identifier, short: Contract Valued Item Number, index: 100}
              effectiveTime: {type: dateTime, short: Contract Valued Item Effective Tiem, index: 101}
              quantity: {type: Quantity, short: Count of Contract Valued Items, index: 102}
              entity:
                short: Contract Valued Item Type
                choices: [entityCodeableConcept, entityReference]
                index: 97
              unitPrice: {type: Money, short: 'Contract Valued Item fee, charge, or cost', index: 103}
              entityReference:
                short: Contract Valued Item Type
                refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
                type: Reference
                choiceOf: entity
                index: 99
          subtype:
            type: CodeableConcept
            short: Asset sub-category
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-assetsubtype'}
            array: true
            index: 81
          text: {type: string, short: Asset clause or question text, index: 91}
      text: {type: string, short: Term Statement, isSummary: true, index: 44}
    required: [offer]
  friendly:
    short: Contract Friendly Language
    type: BackboneElement
    array: true
    index: 146
    elements:
      content:
        short: Easily comprehended representation of this Contract
        choices: [contentAttachment, contentReference]
        index: 148
      contentAttachment: {short: Easily comprehended representation of this Contract, type: Attachment, choiceOf: content, index: 149}
      contentReference:
        short: Easily comprehended representation of this Contract
        refers: ['http://hl7.org/fhir/StructureDefinition/Composition', 'http://hl7.org/fhir/StructureDefinition/DocumentReference', 'http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse']
        type: Reference
        choiceOf: content
        index: 150
    required: [contentAttachment, contentReference, content]
  alias: {type: string, short: Acronym or short name, array: true, index: 18}
  status:
    isModifier: true
    short: amended | appended | cancelled | disputed | entered-in-error | executable +
    type: code
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/contract-status|4.5.0'}
    isModifierReason: This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    isSummary: true
    index: 3
  subtitle: {type: string, short: Subordinate Friendly name, index: 17}
  topicReference:
    short: Focus of contract interest
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    choiceOf: topic
    index: 24
  url: {short: Basal definition, type: uri, index: 1}
  identifier: {short: Contract number, type: Identifier, array: true, isSummary: true, index: 0}
  expirationType:
    type: CodeableConcept
    short: Contract cessation cause
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-expiration-type'}
    index: 10
  issued: {short: When this Contract was issued, type: dateTime, isSummary: true, index: 8}
  domain:
    short: A sphere of control governed by an authoritative jurisdiction, organization, or person
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    array: true
    index: 13
  subType:
    short: Subtype within the context of type
    type: CodeableConcept
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/contract-subtype'}
    isSummary: true
    index: 26
  version: {short: Business edition, type: string, isSummary: true, index: 2}
  subject:
    short: Contract Target Entity
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    isSummary: true
    index: 11
  legallyBinding:
    short: Binding Contract
    choices: [legallyBindingAttachment, legallyBindingReference]
    index: 162
package_version: 4.5.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Contract
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.5.0