HL7 FHIR JP Core ImplementationGuide
1.1.1 - release
HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.1). See the Directory of published versions
項目 | 内容 |
定義URL | http://jpfhir.jp/fhir/core/StructureDefinition/JP_MedicationDispense_Injection |
Version | 1.1.1 |
Name | JP_MedicationDispense_Injection |
Title | JP Core MedicationDispense Injection Profile |
Status | Active ( 2022-10-24 ) |
Copyright | Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG |
このプロファイルはMedicationDispenseリソースに対して、注射薬剤処方調剤・払い出し記録のデータを送受信するための基礎となる制約と拡張を定めたものである。JP_MedicationDispenseBaseプロファイルからの派生プロファイルである。
本プロファイルは注射、注入を含む薬剤処方の調剤情報をMedicationDispenseリソースを使用して表現する。日本国内で規格を運用するためにExtensionの追加や用語集の追加・変更を行った。 以下、本プロファイルのMedicationDispenseリソースを「JP Core MedicationDispense Injectionリソース」と呼ぶ。
本プロファイルは、以下のようなユースケースを想定している。
本プロファイルの対象は注射、注入を含む一般的な薬剤処方の調剤情報を電子的に連携するためのメッセージを記述することである。
本プロファイルのMedicationDispenseリソースは薬剤の調剤情報に関するものであり、処方指示や実施記録は対象としない。それぞれ、MedicationRequest, MedicationAdministrationが対応するリソースである。
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from JP_MedicationDispenseBase
Summary
Mandatory: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MedicationDispense | 0..* | JP_MedicationDispenseBase | 指定された患者への注射薬剤の払い出し | |
medication[x] | 1..1 | Reference(Medication) | What medication was supplied 医薬品 Slice: Unordered, Open by type:$this | |
medicationReference | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | |
authorizingPrescription | 0..* | Reference(JP Core MedicationRequest Injection Profile) | Medication order that authorizes the dispense 調剤を正当化する元の処方オーダ | |
dosageInstruction | 0..* | JP_MedicationDosage_Injection | 薬の服用方法・服用した方法、または服用すべき方法 | |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationDispense | C | 0..* | JP_MedicationDispenseBase | 指定された患者への注射薬剤の払い出し | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
preparation | 0..* | CodeableConcept | 調剤結果 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDispense_Preparation Binding: JP Core Medication JHSP0002 Instruction For Dispense ValueSet (example) | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
Slices for identifier | 1..* | Identifier | 外部から参照されるID Slice: Unordered, Open by value:system | |||||
identifier:rpNumber | 1..1 | Identifier | 処方箋内部の剤グループとしてのRp番号 | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | Rp番号(剤グループ番号)についてのsystem値 Fixed Value: urn:oid:1.2.392.100495.20.3.81 | ||||
value | Σ | 1..1 | string | Rp番号(剤グループ番号) Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
identifier:requestIdentifier | 0..* | Identifier | 処方オーダに対するID(MedicationRequestからの継承) | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://jpfhir.jp/fhir/core/IdSystem/resourceInstance-identifier | ||||
value | Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
partOf | 0..* | Reference(JP Core Procedure Profile) | Event that dispense is part of 親イベントへの参照 | |||||
status | ?!Σ | 1..1 | code | preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | unknown 一連の調剤イベントの状態 Binding: MedicationDispense Status Codes (required): A coded concept specifying the state of the dispense event. | ||||
statusReason[x] | 0..1 | Why a dispense was not performed 調剤が実行されなかった理由 Binding: MedicationDispense Status Reason Codes (example): A code describing why a dispense was not performed. | ||||||
statusReasonCodeableConcept | CodeableConcept | |||||||
statusReasonReference | Reference(DetectedIssue) | |||||||
category | 0..1 | CodeableConcept | Type of medication dispense 調剤タイプ Binding: MedicationDispense Category Codes (preferred): A code describing where the dispensed medication is expected to be consumed or administered. | |||||
Slices for medication[x] | Σ | 1..1 | Reference(Medication) | What medication was supplied 医薬品 Slice: Unordered, Closed by type:$this | ||||
medication[x]:medicationReference | Σ | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | ||||
subject | Σ | 1..1 | Reference(JP Core Patient Profile) | Who received medication 投与対象患者 | ||||
context | 0..1 | Reference(JP Core Encounter Profile | EpisodeOfCare) | Encounter / Episode associated with event 調剤ベントに関連するEncounterやエピソード | |||||
supportingInformation | 0..* | Reference(Resource) | Information that supports the dispensing of the medication 薬の調剤をサポートする情報 | |||||
performer | 0..* | BackboneElement | Who performed event 調剤を実施した人 | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
function | 0..1 | CodeableConcept | Who performed the dispense and what they did Binding: MedicationDispense Performer Function Codes (example): A code describing the role an individual played in dispensing a medication. | |||||
actor | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Organization Profile | JP Core Patient Profile | Device | RelatedPerson) | Individual who was performing | |||||
location | 0..1 | Reference(JP Core Location Profile) | Where the dispense occurred 調剤実施場所 | |||||
authorizingPrescription | 0..* | Reference(JP Core MedicationRequest Injection Profile) | Medication order that authorizes the dispense 調剤を正当化する元の処方オーダ | |||||
type | 0..1 | CodeableConcept | 実行される調剤イベント Binding: ActPharmacySupplyType (example): Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. | |||||
quantity | C | 1..1 | JP_MedicationSimpleQuantity | Trial fill, partial fill, emergency fill, etc. 払い出される薬剤の量 | ||||
daysSupply | C | 0..1 | JP_MedicationSimpleQuantity | Amount of medication expressed as a timing amount タイミングとして表される投薬量 | ||||
whenPrepared | Σ | 0..1 | dateTime | When product was packaged and reviewed 調剤がパッケージ化され、レビューされた日時 | ||||
whenHandedOver | 1..1 | dateTime | Medication order that authorizes the dispense 払い出された日時 | |||||
destination | 0..1 | Reference(JP Core Location Profile) | Where the medication was sent 薬が送られた場所 | |||||
receiver | 0..* | Reference(JP Core Patient Profile | JP Core Practitioner Profile) | Who collected the medication 薬を受け取った人 | |||||
note | 0..* | Annotation | Information about the dispense 調剤に関する備考 | |||||
dosageInstruction | 0..* | JP_MedicationDosage_Injection | 薬の服用方法・服用した方法、または服用すべき方法 | |||||
substitution | 0..1 | BackboneElement | Whether a substitution was performed on the dispense 調剤で置換が実行されたかどうか | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
wasSubstituted | 1..1 | boolean | Whether a substitution was or was not performed on the dispense 調剤で置換が実行されたか、あるいはされていないかを'true'または'false'で表す | |||||
type | 0..1 | CodeableConcept | Code signifying whether a different drug was dispensed from what was prescribed 処方されたものとは異なる薬が調剤されたかどうかを示すコード Binding: ActSubstanceAdminSubstitutionCode (example): A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription. | |||||
reason | 0..* | CodeableConcept | Why was substitution made 置換が実施された理由 Binding: SubstanceAdminSubstitutionReason (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed. | |||||
responsibleParty | 0..* | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile) | Who is responsible for the substitution 置換責任者 | |||||
detectedIssue | 0..* | Reference(DetectedIssue) | Clinical issue with action アクションを伴う臨床的問題 | |||||
eventHistory | 0..* | Reference(Provenance) | A list of relevant lifecycle events 関連するライフサイクルイベントのリスト | |||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | ||||
MedicationDispense.language | preferred | CommonLanguages
| ||||
MedicationDispense.identifier:rpNumber.use | required | IdentifierUse | ||||
MedicationDispense.identifier:rpNumber.type | extensible | Identifier Type Codes | ||||
MedicationDispense.identifier:requestIdentifier.use | required | IdentifierUse | ||||
MedicationDispense.identifier:requestIdentifier.type | extensible | Identifier Type Codes | ||||
MedicationDispense.status | required | MedicationDispense Status Codes | ||||
MedicationDispense.statusReason[x] | example | MedicationDispense Status Reason Codes | ||||
MedicationDispense.category | preferred | MedicationDispense Category Codes | ||||
MedicationDispense.performer.function | example | MedicationDispense Performer Function Codes | ||||
MedicationDispense.type | example | ActPharmacySupplyType | ||||
MedicationDispense.substitution.type | example | ActSubstanceAdminSubstitutionCode | ||||
MedicationDispense.substitution.reason | example | SubstanceAdminSubstitutionReason |
Constraints
Id | Grade | Path(s) | Details | Requirements |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
qty-3 | error | MedicationDispense.quantity, MedicationDispense.daysSupply | If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
sqty-1 | error | MedicationDispense.quantity, MedicationDispense.daysSupply | The comparator is not used on a SimpleQuantity : comparator.empty() |
This structure is derived from JP_MedicationDispenseBase
Summary
Mandatory: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Differential View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MedicationDispense | 0..* | JP_MedicationDispenseBase | 指定された患者への注射薬剤の払い出し | |
medication[x] | 1..1 | Reference(Medication) | What medication was supplied 医薬品 Slice: Unordered, Open by type:$this | |
medicationReference | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | |
authorizingPrescription | 0..* | Reference(JP Core MedicationRequest Injection Profile) | Medication order that authorizes the dispense 調剤を正当化する元の処方オーダ | |
dosageInstruction | 0..* | JP_MedicationDosage_Injection | 薬の服用方法・服用した方法、または服用すべき方法 | |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationDispense | C | 0..* | JP_MedicationDispenseBase | 指定された患者への注射薬剤の払い出し | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
preparation | 0..* | CodeableConcept | 調剤結果 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDispense_Preparation Binding: JP Core Medication JHSP0002 Instruction For Dispense ValueSet (example) | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
Slices for identifier | 1..* | Identifier | 外部から参照されるID Slice: Unordered, Open by value:system | |||||
identifier:rpNumber | 1..1 | Identifier | 処方箋内部の剤グループとしてのRp番号 | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | Rp番号(剤グループ番号)についてのsystem値 Fixed Value: urn:oid:1.2.392.100495.20.3.81 | ||||
value | Σ | 1..1 | string | Rp番号(剤グループ番号) Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
identifier:requestIdentifier | 0..* | Identifier | 処方オーダに対するID(MedicationRequestからの継承) | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://jpfhir.jp/fhir/core/IdSystem/resourceInstance-identifier | ||||
value | Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||
partOf | 0..* | Reference(JP Core Procedure Profile) | Event that dispense is part of 親イベントへの参照 | |||||
status | ?!Σ | 1..1 | code | preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | unknown 一連の調剤イベントの状態 Binding: MedicationDispense Status Codes (required): A coded concept specifying the state of the dispense event. | ||||
statusReason[x] | 0..1 | Why a dispense was not performed 調剤が実行されなかった理由 Binding: MedicationDispense Status Reason Codes (example): A code describing why a dispense was not performed. | ||||||
statusReasonCodeableConcept | CodeableConcept | |||||||
statusReasonReference | Reference(DetectedIssue) | |||||||
category | 0..1 | CodeableConcept | Type of medication dispense 調剤タイプ Binding: MedicationDispense Category Codes (preferred): A code describing where the dispensed medication is expected to be consumed or administered. | |||||
Slices for medication[x] | Σ | 1..1 | Reference(Medication) | What medication was supplied 医薬品 Slice: Unordered, Closed by type:$this | ||||
medication[x]:medicationReference | Σ | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | ||||
subject | Σ | 1..1 | Reference(JP Core Patient Profile) | Who received medication 投与対象患者 | ||||
context | 0..1 | Reference(JP Core Encounter Profile | EpisodeOfCare) | Encounter / Episode associated with event 調剤ベントに関連するEncounterやエピソード | |||||
supportingInformation | 0..* | Reference(Resource) | Information that supports the dispensing of the medication 薬の調剤をサポートする情報 | |||||
performer | 0..* | BackboneElement | Who performed event 調剤を実施した人 | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
function | 0..1 | CodeableConcept | Who performed the dispense and what they did Binding: MedicationDispense Performer Function Codes (example): A code describing the role an individual played in dispensing a medication. | |||||
actor | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Organization Profile | JP Core Patient Profile | Device | RelatedPerson) | Individual who was performing | |||||
location | 0..1 | Reference(JP Core Location Profile) | Where the dispense occurred 調剤実施場所 | |||||
authorizingPrescription | 0..* | Reference(JP Core MedicationRequest Injection Profile) | Medication order that authorizes the dispense 調剤を正当化する元の処方オーダ | |||||
type | 0..1 | CodeableConcept | 実行される調剤イベント Binding: ActPharmacySupplyType (example): Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. | |||||
quantity | C | 1..1 | JP_MedicationSimpleQuantity | Trial fill, partial fill, emergency fill, etc. 払い出される薬剤の量 | ||||
daysSupply | C | 0..1 | JP_MedicationSimpleQuantity | Amount of medication expressed as a timing amount タイミングとして表される投薬量 | ||||
whenPrepared | Σ | 0..1 | dateTime | When product was packaged and reviewed 調剤がパッケージ化され、レビューされた日時 | ||||
whenHandedOver | 1..1 | dateTime | Medication order that authorizes the dispense 払い出された日時 | |||||
destination | 0..1 | Reference(JP Core Location Profile) | Where the medication was sent 薬が送られた場所 | |||||
receiver | 0..* | Reference(JP Core Patient Profile | JP Core Practitioner Profile) | Who collected the medication 薬を受け取った人 | |||||
note | 0..* | Annotation | Information about the dispense 調剤に関する備考 | |||||
dosageInstruction | 0..* | JP_MedicationDosage_Injection | 薬の服用方法・服用した方法、または服用すべき方法 | |||||
substitution | 0..1 | BackboneElement | Whether a substitution was performed on the dispense 調剤で置換が実行されたかどうか | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
wasSubstituted | 1..1 | boolean | Whether a substitution was or was not performed on the dispense 調剤で置換が実行されたか、あるいはされていないかを'true'または'false'で表す | |||||
type | 0..1 | CodeableConcept | Code signifying whether a different drug was dispensed from what was prescribed 処方されたものとは異なる薬が調剤されたかどうかを示すコード Binding: ActSubstanceAdminSubstitutionCode (example): A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription. | |||||
reason | 0..* | CodeableConcept | Why was substitution made 置換が実施された理由 Binding: SubstanceAdminSubstitutionReason (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed. | |||||
responsibleParty | 0..* | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile) | Who is responsible for the substitution 置換責任者 | |||||
detectedIssue | 0..* | Reference(DetectedIssue) | Clinical issue with action アクションを伴う臨床的問題 | |||||
eventHistory | 0..* | Reference(Provenance) | A list of relevant lifecycle events 関連するライフサイクルイベントのリスト | |||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | ||||
MedicationDispense.language | preferred | CommonLanguages
| ||||
MedicationDispense.identifier:rpNumber.use | required | IdentifierUse | ||||
MedicationDispense.identifier:rpNumber.type | extensible | Identifier Type Codes | ||||
MedicationDispense.identifier:requestIdentifier.use | required | IdentifierUse | ||||
MedicationDispense.identifier:requestIdentifier.type | extensible | Identifier Type Codes | ||||
MedicationDispense.status | required | MedicationDispense Status Codes | ||||
MedicationDispense.statusReason[x] | example | MedicationDispense Status Reason Codes | ||||
MedicationDispense.category | preferred | MedicationDispense Category Codes | ||||
MedicationDispense.performer.function | example | MedicationDispense Performer Function Codes | ||||
MedicationDispense.type | example | ActPharmacySupplyType | ||||
MedicationDispense.substitution.type | example | ActSubstanceAdminSubstitutionCode | ||||
MedicationDispense.substitution.reason | example | SubstanceAdminSubstitutionReason |
Constraints
Id | Grade | Path(s) | Details | Requirements |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
qty-3 | error | MedicationDispense.quantity, MedicationDispense.daysSupply | If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
sqty-1 | error | MedicationDispense.quantity, MedicationDispense.daysSupply | The comparator is not used on a SimpleQuantity : comparator.empty() |
Other representations of profile: CSV, Excel, Schematron
次のデータ項目は必須(データが存在しなければならない)である。
MedicationDispense リソースは、次の要素を持たなければならない。
MedicationDispense リソースに内包されるMedicationリソースでは、次の要素を持たなければならない。
JP Core MedicationDispense Injectionプロファイルで使用される拡張は次の通りである。
拡張 | 説明 | 定義 | 値型 |
---|---|---|---|
調剤結果 | 薬剤単位の調剤結果 | JP_MedicationDispense_Preparation | CodeableConcept |
RP内薬剤番号 | RP内の薬剤の連番を格納する拡張 《medicationReference配下》 |
JP_Medication_Ingredient_DrugNo | integer |
力価区分 | 投与量が製剤単位か成分単位かを格納する拡張 《medicationReference配下》 |
JP_Medication_IngredientStrength_StrengthType | CodeableConcept |
用法コメント | 用法コメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_DosageComment | CodeableConcept/String |
指示ライン | 指示ラインを格納する拡張 《dosageInstruction配下》 |
JP_MedicationDosage_Line | CodeableConcept |
ラインコメント | ラインコメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_LineComment | CodeableConcept/String |
投与装置 | 投与装置を格納する拡張 《dosageInstruction配下》 |
JP_MedicationDosage_Device | Reference (Device) |
投与経路コメント | 投与経路コメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_RouteComment | CodeableConcept/String |
投与部位詳細 | 投与部位詳細を格納するための拡張 《dosageInstruction配下》 |
bodySite(hl7.org) | Reference (BodyStructure) |
投与部位コメント | 投与部位コメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_SiteComment | CodeableConcept/String |
手技コメント | 手技コメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_MethodComment | CodeableConcept/String |
投与速度コメント | 投与速度コメントを格納するための拡張 《dosageInstruction配下》 |
JP_MedicationDosage_RateComment | CodeableConcept/String |
HL7 FHIRの基底規格では、薬剤コードをはじめとして、剤形などでSNOMED CTが使われているが、日本ではライセンスの問題もあり普及していない。代替としてJAHIS注射データ交換規約やSS-MIX2で使われている用語集を採用した。
HL7 ver 2系では用語集を識別するコーディングシステム名(以下、「CS名」)は文字列であったが、FHIRではURIを指定する必要があるため、それぞれにURIを割り当てた。以下に使用する用語集のCS名とURI表記を列記する。
分類 | CS名 | URI |
---|---|---|
医薬品 | HOT7 | urn:oid:1.2.392.200119.4.403.2 |
医薬品 | HOT9 | urn:oid:1.2.392.200119.4.403.1 |
医薬品 | HOT13 | urn:oid:1.2.392.200119.4.402.1 |
医薬品 | YJコード | urn:oid:1.2.392.100495.20.1.73 |
剤形 | MERIT-9(剤形) | http://jpfhir.jp/fhir/core/CodeSystem/JP_MedicationFormMERIT9_CS |
薬品単位 | MERIT-9(単位) | urn:oid:1.2.392.100495.20.2.101 |
力価区分 | 処方情報 HL7FHIR 記述仕様(力価区分) | urn:oid:1.2.392.100495.20.2.22 |
用法 | JAMI処方・注射オーダ標準用法規格(用法コード) | urn:oid:1.2.392.200250.2.2.20 |
頓用条件 | MERIT-9(頓用指示) | http://jpfhir.jp/fhir/core/CodeSystem/JP_MedicationAsNeededConditionMERIT9_CS |
投与部位 | JAMI処方・注射オーダ標準用法規格(部位コード) | urn:oid:1.2.392.200250.2.2.20.32 |
投与部位 | HL7 V2(HL7表0550) | http://terminology.hl7.org/CodeSystem/v2-0550 |
投与部位(修飾子) | HL7 V2(HL7表0495) | http://terminology.hl7.org/CodeSystem/v2-0495 |
投与装置 | HL7 V2(使用者定義表0164) | http://terminology.hl7.org/CodeSystem/v2-0164 |
投与方法 | JAMI処方・注射オーダ標準用法規格(基本用法区分) | urn:oid:1.2.392.200250.2.2.20.30 |
投与手技 | HL7 V2(使用者定義表0165) | http://terminology.hl7.org/CodeSystem/v2-0165 |
投与手技 | JAMI処方・注射オーダ標準用法規格(用法詳細区分) | urn:oid:1.2.392.200250.2.2.20.40 |
投与手技 | JAHIS注射データ交換規約Ver.2.1C(JHSI表0003) | http://jpfhir.jp/fhir/core/CodeSystem/JHSI0003 |
投与経路 | HL7 V2(使用者定義表0162) | http://terminology.hl7.org/CodeSystem/v2-0162 |
入外区分 | HL7 V2(HL7表0482) | http://terminology.hl7.org/CodeSystem/v2-0482 |
日本国内の電子カルテシステムでの注射オーダの運用に合わせ、以下の項目を追加した。
コンフォーマンス | パラメータ | 型 | 例 |
---|---|---|---|
SHALL | identifier | token | GET [base]/MedicationDispense?identifier=http://myhospital.com/fhir/medication|1234567890 |
SHOULD | patient | reference | GET [base]/MedicationDispense?patient=123456 |
SHOULD | patient,whenhandedover | reference,date | GET [base]/MedicationDispense?patient=123456&whenhandedover=eq2013-01-14 |
MAY | whenhandedover,whenprepared,context,code,performer | date,date,token,token,token | GET [base]/MedicationDispense?code=urn:oid:1.2.392.200119.4.403.1|105271807 |
次の検索パラメータは必須でサポートされなければならない。
identifier 検索パラメータを使用して、オーダIDなどの識別子によるMedicationRequestの検索をサポートしなければならない(SHALL)
GET [base]/MedicationDispense?identifier={system|}[code]
例:
GET [base]/MedicationDispense?identifier=http://myhospital.com/fhir/medication|1234567890
指定された識別子に一致するMedicationDispenseリソースを含むBundleを検索する。
次の検索パラメータをサポートすることが望ましい。
patient 検索パラメータを使用して、患者のリファレンス情報によるMedicationDispenseの検索をサポートすることが望ましい(SHOULD)
GET [base]/MedicationDispense?patient=[id]
GET [base]/MedicationDispense?patient=[url]
例:
GET [base]/MedicationDispense?patient=123456
リソースIDが123456の患者のMedicationDispenseリソースを含むBundleを検索する。
patient,whenhandedover 検索パラメータを使用して、患者のリファレンス情報と払い出し日によるMedicationDispenseの検索をサポートすることが望ましい(SHOULD)
GET [base]/MedicationDispense?patient=[id]&whenhandedover=[date]
GET [base]/MedicationDispense?patient=[url]&whenhandedover=[date]
例:
GET [base]/MedicationDispense?patient=123456&whenhandedover=eq2013-01-14
リソースIDが123456の患者の2013-01-14に払い出されたMedicationDispenseリソースを含むBundleを検索する。
追加検索パラメータは定義しない。
JP Core MedicationDispense Injection リソースに対して使用される操作は次の通りである。
$everything:[base]/MedicationDispense/[id]/$everything
この操作は、この操作が呼び出された特定のMedicationDispenseリソースに関連する全ての情報を返す。応答は “searchset” タイプのBundleリソースである。サーバは、少なくとも、識別されたMedicationDispenseコンパートメントに含まれる全てのリソースと、それらから参照されるすべてのリソースを返すことが望ましい。
この操作の公式なURLは以下である。
http://hl7.jp/fhir/OperationDefinition/MedicationDispense-everything
URL: [base]/MedicationDispense/[id]/$everything
本操作は、べき等な操作である。
名前 | 多重度 | 型 | 説明 |
---|---|---|---|
start | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。開始日が指定されていない場合、終了日以前のすべてのレコードが対象に含まれる。 |
end | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。終了日が指定されていない場合、開始日以降のすべてのレコードが対象に含まれる。 |
_since | 0..1 | instant | 指定された日時以降に更新されたリソースのみが応答に含まれる。 |
_type | 0..* | code | 応答に含むFHIRリソース型を、カンマ区切りで指定する。指定されない場合は、サーバは全てのリソース型を対象とする。 |
_count | 0..1 | integer | Bundleの1ページに含まれるリソース件数を指定。 |
名前 | 多重度 | 型 | 説明 |
---|---|---|---|
return | 1..1 | Bundle | バンドルのタイプは”searchset”である。この操作の結果は、リソースとして直接返される。 |
リクエスト:単一のMedicationDispenseに関連する全てのリソースを取得する。
GET [base]/MedicationDispense/1234567890/$everything
[some headers]
レスポンス:指定されたMedicationDispenseに関連する全てのリソースを返す。
HTTP/1.1 200 OK
[other headers]
{
"resourceType": "Bundle",
"id": "example",
"meta": {
"lastUpdated": "2014-08-18T01:43:33Z"
},
"type": "searchset",
"entry": [
{
"fullUrl": "http://example.org/fhir/MedicationDispense/1234567890",
"resource": {
"resourceType": "MedicationDispense",
・・・
},
}
]
}
ホリゾン注射液10mg1アンプルを左腕に静脈注射する処方例をFHIRで表現する場合のサンプルを示す。
MedicationDispenseは薬剤をCodeableConceptとして1つまでしか持つか、Medicationリソースのreferenceをもつことしかできない。したがって、複数の薬剤を同一のRp番号で表現する場合にはMedicationDispenseを繰り返すか、複数の薬剤をまとめたMedication Resourceのインスタンスを参照することとなる。ワーキンググループでの検討の結果、注射の場合は複数の薬剤をまとめたMedicationリソースのインスタンスをcontained属性に内包した上で参照することとした。
1オーダ内に複数のRpがある場合には、MedicationDispenseを繰り返し、identifier属性にオーダ番号、Rp番号をそれぞれ持つことでリソース間の関係性がわかるようにする。
1オーダ内にRpごとに複数の施用(投薬)を持つことができるシステムの場合は、今回の調剤に対する施用の情報をdosageInstruction要素で記述する。該当の施用の投与タイミングを dosageInstruction.timing で指定し、施用番号を dosageInstruction.sequenceで記述する。
投与薬剤と調剤量は、RP内の薬剤が1薬剤の場合も混注などで複数の薬剤を含む場合も、すべての薬剤を記述したMedicationリソースを contained 属性に内包し、それをMedicationRequest.medicationReference属性で参照するようにする。 Medicationリソースのingredient.itemCodeableConcept要素にCodeableConcept型で各薬剤の識別情報を記述し、ingredient.strength.numerator要素に1回あたりの含有量を記述する。薬剤を識別するコードはHOT7、HOT9、YJコード、⼀般処⽅名マスターを推奨するが、ローカルコードを使用してもよい。含有量の単位コードは MERIT-9を使用する。ingredient.strength.denominatorには固定値「1回」をMERIT-9を使用して指定する。 dosageInstruction.doseAndRate.doseQuantity要素には、情報が得られる場合には全体の容量をUCUM(“http://unitsofmeasure.org”)を使用してmL単位で指定する。
「ソリタ-T3号輸液500mL 1本」と「アドナ注(静脈用)50mg/10mL 1アンプル」計510mLを指示する場合のインスタンス例を示す。
"contained": [
{
"resourceType": "Medication",
"id": "jp-medicationrequest-injection-medication-example-2",
"meta": {
"profile": [
"http://jpfhir.jp/fhir/core/StructureDefinition/JP_Medication"
]
},
"status": "active",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"system": "urn:oid:1.2.392.200119.4.403.1",
"code": "107750602",
"display": "ソリタ-T3号輸液500mL"
}
]
},
"strength": {
"numerator": {
"value": 1,
"unit": "本",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "HON"
},
"denominator": {
"value": 1,
"unit": "回",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "TIME"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "urn:oid:1.2.392.200119.4.403.1",
"code": "108010001",
"display": "アドナ注(静脈用)50mg"
}
]
},
"strength": {
"numerator": {
"value": 1,
"unit": "アンプル",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "AMP"
},
"denominator": {
"value": 1,
"unit": "回",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "TIME"
}
}
}
]
}
],
...
"medicationReference": {
"reference": "#jp-medicationrequest-injection-medication-example-2"
},
調剤量に対する容量はquantity要素にSimpleQuantity型で記録する。単位コードはUCUM(“http://unitsofmeasure.org”)を使用する。
調剤量に対する容量が510mLになる場合のインスタンス例を以下に示す。
"quantity": {
"value": 510,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
用量は製剤量で記述することを基本とするが、必要に応じて原薬量指定も可能とする。この識別は、Medication.ingredient.strength要素に対して定義した拡張「JP_Medication_IngredientStrength_StrengthType」を使用する。この拡張を識別するURIとして、”http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Medication_IngredientStrength_StrengthType”を使用し、値はCodeableConcept型を使用して力価区分コードを指定することで行い、製剤量は「1」、原薬量は「2」とする。
投与量「1本」を製剤量で記録したインスタンス例を示す。
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "107750602",
"display": "ソリタ-T3号輸液500mL",
"system": "urn:oid:1.2.392.200119.4.403.1"
}
]
},
"strength": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Medication_IngredientStrength_StrengthType",
"valueCodeableConcept": {
"coding": [
{
"system": "urn:oid:1.2.392.100495.20.2.22",
"code": "1",
"display": "製剤量"
}
]
}
}
],
"numerator": {
"value": 1,
"unit": "本",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "HON"
},
"denominator": {
"value": 1,
"unit": "回",
"system": "urn:oid:1.2.392.100495.20.2.101",
"code": "TIME"
}
},
調剤時に行ったジェネリック医薬品などへの変更内容の記述は、substitution.wasSubstituted, substitution.type, substitution.reason を使用する。 変更の種類はデフォルトのコード表(”http://terminology.hl7.org/CodeSystem/v3-substanceAdminSubstitution”)を使用する。 変更の理由はデフォルトのコード表(”http://terminology.hl7.org/CodeSystem/v3-ActReason”)を使用するかフリーテキストで記述する。ローカルのコード表を使用してもよい。
ジェネリック医薬品への変更の場合のインスタンス例を以下に示す。
"substitution" : {
"wasSubstituted" : true,
"type" : {
"coding" : [
{
"code" : "G",
"system" : "http://terminology.hl7.org/CodeSystem/v3-substanceAdminSubstitution",
"display" : "generic composition"
}
]
},
"reason": [
{
"coding" : [
{
"code" : "RR",
"system" : "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"display" : "regulatory requirement"
}
]
}
]
}
調剤された薬剤が払い出された先は、destination要素にReference型でLocationリソースの参照情報を記述する。
"destination" : {
"reference" : "Location/12A"
}
調剤された薬剤が払い出された日時は、whenHandedOver要素にdateTime型で記述する。
薬剤が実際に調剤された日時は、whenPrepared要素にdateTime型で記述する。
調剤を実際に行った医療従事者は、performer.actor要素にReference型でPractitionerリソースの参照情報を記述する。役割に応じて複数の医療従事者を記述できる。
"performer" : [
{
"function" : {
"coding" : [
{
"code" : "packager",
"system" : "http://terminology.hl7.org/CodeSystem/medicationdispense-performer-function",
"display" : "Packager"
}
]
},
"actor" : {
"reference" : "Practitioner/01234567"
}
}
]
単一の薬剤に対する調剤結果は、MedicationDispenseに対して定義した拡張「JP_MedicationDispense_Preparation」を使用する。 この拡張は、CodeableConcept型を使用してテキストによる指示とコードによる指示のどちらかを記述することができる。 一つの薬剤に対して、複数の指示を記録する場合には、この拡張を、拡張単位で繰り返して記録する。 調剤結果で使用するコードは、特に推奨するものはない。
薬剤単位の調剤結果を表すインスタンス例を示す。
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDispense_Preparation",
"valueCodeableConcept": {
"text" : "5mLに溶解して2mL抜きとる"
}
}
],
調剤時に行った疑義照会の内容は、note要素にAnnotation型で記述する。
調剤時の特記事項(コメントなど)も、note要素にAnnotation型で記述する。
調剤の基となった薬剤処方の用法などの情報は、特に記述のない限り JP Core MedicationRequest Injection と同様の記述方法とする。該当する項目としては以下のものがある。