Important: This is a draft IG for trial use. Click here to give feedback.

EN NL

HdBe-AdministrationAgreement

WARNING This page contains a draft CBB, as raw output from the zib export and automatic conversion to CBB. It requires thorough review and adaption to the Belgian realm. This CBB is merely added for informative use.

CBBDescriptionStatus
HdBe-AdministrationAgreement

An administration agreement is the use (or administering) instructions from the pharmacist to the patient (or their representative or administrator), whereby a medication agreement is structured at a concrete level.

Purpose

The goal of the administration agreement is to provide insight into the concrete instructions for administration/use of medication.

draft

id0..1string
extensionI0..*Extension
SupplierI0..1Reference(HdBe-HealthcareOrganization)
MedicineForAdministrationAgreementI1..1Reference(HdBe-PharmaceuticalProduct)
InstructionsForUse0..1HdBe-InstructionsForUse
AdministrationAgreementDateTime0..1dateTime
AgreementReason0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
StartDateTime0..1dateTime
EndDateTime0..1dateTime
DurationI0..1Quantity
MedicationAgreementI0..1Reference(HdBe-MedicationAgreement)
AdministrationAgreementStopType0..1CodeableConceptBinding
CanceledIndicator0..1boolean
AdministrationAgreementAdditionalInformation0..*CodeableConceptBinding
Comment0..1string

AdministrationAgreement0..*
AdministrationAgreement.SupplierReference(HdBe-HealthcareOrganization)0..1
AdministrationAgreement.MedicineForAdministrationAgreementReference(HdBe-PharmaceuticalProduct)1..1
AdministrationAgreement.InstructionsForUseHdBe-InstructionsForUse0..1
AdministrationAgreement.AdministrationAgreementDateTimedateTime0..1
AdministrationAgreement.AgreementReasonstring0..1
AdministrationAgreement.PeriodOfUseBackboneElement1..1
AdministrationAgreement.PeriodOfUse.StartDateTimedateTime0..1
AdministrationAgreement.PeriodOfUse.EndDateTimedateTime0..1
AdministrationAgreement.PeriodOfUse.DurationQuantity0..1
AdministrationAgreement.MedicationAgreementReference(HdBe-MedicationAgreement)0..1
AdministrationAgreement.AdministrationAgreementStopTypeCodeableConcept0..1
AdministrationAgreement.CanceledIndicatorboolean0..1
AdministrationAgreement.AdministrationAgreementAdditionalInformationCodeableConcept0..*
AdministrationAgreement.Commentstring0..1


AdministrationAgreement
DefinitionRoot concept of the AdministrationAgreement information model. This root concept contains all data elements of the AdministrationAgreement information model.
Cardinality0...*
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
AdministrationAgreement.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
AdministrationAgreement.Supplier
DefinitionThe supplier (pharmacist) that entered the administration agreement.
Cardinality0...1
TypeReference(HdBe-HealthcareOrganization)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
AdministrationAgreement.MedicineForAdministrationAgreement
DefinitionMedicine in the AdministrationAgreement.
Cardinality1...1
TypeReference(HdBe-PharmaceuticalProduct)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
AdministrationAgreement.InstructionsForUse
DefinitionInstructions for administering the medication, e.g. dose and route of administration.
Cardinality0...1
TypeHdBe-InstructionsForUse
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.AdministrationAgreementDateTime
DefinitionThe time at which the agreement was made.
Cardinality0...1
TypedateTime
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.AgreementReason
DefinitionReason for this agreement. This will often be the same reason as the one for the medication agreement. This field has the option to - if applicable - enter a specific reason for the administration agreement. Examples include: substitution, transfer to GDS, patient request for different product, etc.
Cardinality0...1
Typestring
Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.PeriodOfUse
DefinitionStart date: This is the time at which the agreement was to take effect (or took effect or will take effect). This is the time at which the instructions for use in this agreement start. In the case of an agreement to discontinue use, this is the start date of the original administration agreement. The end date indicates from when the medication is to be discontinued. Duration: The intended duration of use. E.g. 5 days or 8 weeks. It is not allowed to indicate the duration in months, because different months have a variable duration in days. End date: The time at which the period of use ends (or ended or will end). In the case of an agreement to discontinue use, this is the time at which the medication is to be discontinued. To avoid confusion between 'to' and 'up to', the submission of time is always mandatory for the end date. With medication for an indefinite period only a start date is indicated.
Cardinality1...1
TypeBackboneElement
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.PeriodOfUse.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
AdministrationAgreement.PeriodOfUse.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
AdministrationAgreement.PeriodOfUse.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
SummaryTrue
Aliasextensions, user content, modifiers
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
AdministrationAgreement.PeriodOfUse.StartDateTime
DefinitionThe start date and time of the interval
Cardinality0...1
TypedateTime
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.PeriodOfUse.EndDateTime
DefinitionThe end date and time of the interval
Cardinality0...1
TypedateTime
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.PeriodOfUse.Duration
DefinitionThe duration of the interval in appropriate units of time (*e.g.* days or hours, etc.
Cardinality0...1
TypeQuantity
Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • qty-3: If a code for the unit is present, the system SHALL also be present
    code.empty() or system.exists()
Mappings
  • rim: n/a
  • v2: SN (see also Range) or CQ
  • rim: PQ, IVL<PQ>, MO, CO, depending on the values
AdministrationAgreement.MedicationAgreement
DefinitionRelationship to the medication agreement on which the administration agreement is based.
Cardinality0...1
TypeReference(HdBe-MedicationAgreement)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
AdministrationAgreement.AdministrationAgreementStopType
DefinitionStop type, the manner in which this medication is discontinued (temporary or definitive).
Cardinality0...1
TypeCodeableConcept
Binding

AdministrationAgreementStopType codes

AdministrationAgreementStopType (required)
Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
  • v2: CE/CNE/CWE
  • rim: CD
  • orim: fhir:CodeableConcept rdfs:subClassOf dt:CD
AdministrationAgreement.CanceledIndicator
DefinitionIn the event of an error correction, this indicator is to be put on for the incorrect agreement.
Cardinality0...1
Typeboolean
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
AdministrationAgreement.AdministrationAgreementAdditionalInformation
DefinitionAdditional information includes details on the structure of the agreement made. This element mainly contains information that until now has been structured with ZZ rules. The medication-related topics that are now supported by the ZZ rules are best supported with a system functionality. A process has been started for this by Z-index/KNMP. For now, the following list will be used. This list will be replaced by a thesaurus in the G standard at a later stage.
Cardinality0...*
TypeCodeableConcept
Binding

AdministrationAgreementAdditionalInformation codes

AdministrationAgreementAdditionalInformation (required)
Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
  • v2: CE/CNE/CWE
  • rim: CD
  • orim: fhir:CodeableConcept rdfs:subClassOf dt:CD
AdministrationAgreement.Comment
DefinitionComments on the administration agreement.
Cardinality0...1
Typestring
Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a

Example instances

[CBB name]
[Concept name ] [example value]

// example of NameInformation

## Example instances

| NameInformation      |                   |
|----------------------|-------------------|
| FirstNames | Johanna Petronella Maria   
| Initials | J.P.M. 
| GivenName | Jo 
| NameUsage | Geslachtsnaam partner gevolgd door eigen geslachtsnaam
| LastName.Prefix | van
| LastName.LastName | Putten
| LastNamePartner.PartnerPrefix | van der
| LastNamePartner.PartnerLastName | Giessen
| Titles |

zib [zib name + version](https://zibs.nl/wiki/[zib name + version(release)]) difference

Concept Category Description
[element.path] [category of change] [Description of change]([Reference to ticket/issue/zulip chat using MarkDown link])



Terminology Bindings

PathNameStrengthURL
AdministrationAgreementStopTypeAdministrationAgreementStopTyperequiredhttps://fhir.healthdata.be/ValueSet/AdministrationAgreementStopType
AdministrationAgreementAdditionalInformationAdministrationAgreementAdditionalInformationrequiredhttps://fhir.healthdata.be/ValueSet/AdministrationAgreementAdditionalInformation