HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Mô hình logic: Phiếu xuất hàng CSDL Dược — Logical Model - Ánh xạ

Draft tại thời điểm 2026-07-31

Ánh xạ cho vnPharmacyStockOutLm mô hình logic.

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVN Core FHIR mappingdoco
.. vnPharmacyStockOutLm
... transactionDate
VNCoreMedicationDispense.whenHandedOver (sale-retail) | SupplyDelivery.occurrenceDateTime (nghiệp vụ khác)
FHIR dateTime bắt buộc có offset khi có giờ — adapter gắn +07:00 khi chuyển đổi.
... reason
sale-retail → MedicationDispense; còn lại → SupplyDelivery.type + ngữ cảnh nghiệp vụ
recall: đối chiếu quy trình thu hồi TT 30/2025/TT-BYT (cơ sở ngừng bán, trả hàng, báo cáo kết quả thu hồi về Cục QLD trong 03 ngày). destroy: xuất hủy — với thuốc kiểm soát đặc biệt đối chiếu TT 18/2026/TT-BYT.
... sourceStoreId
SupplyDelivery.supplier.resolve().identifier.value (chi nhánh xuất)
... targetStoreId
SupplyDelivery.destination.resolve().identifier.value
... targetWarehouseId
SupplyDelivery.destination.resolve().identifier.value (Location kho nhập)
... supplierId
SupplyDelivery.destination hoặc receiver (bên nhận hàng trả) — adapter quyết định theo ngữ cảnh
... referenceNumber
VNCoreMedicationDispense.identifier.value (sale-retail) | SupplyDelivery.identifier.value
... practiceLicenseCode
Organization.identifier.value (GCN đủ điều kiện kinh doanh dược — chưa có NamingSystem VN Core; ghi nhận gap)
... note
VNCoreMedicationDispense.note.text (sale-retail) | — (SupplyDelivery không có note)
... item
  • MedicationDispense (mỗi dòng một lần cấp phát
  • sale-retail) | SupplyDelivery.suppliedItem (mỗi dòng một SupplyDelivery)
.... @id
.... extension
.... modifierExtension
.... drugId
VNCoreMedicationDispense.medicationCodeableConcept.coding.code (hệ mã GPLH) | VNCoreMedicationDispense.extension[registrationNumber].valueString | SupplyDelivery.suppliedItem.itemReference.resolve().code
.... unitId
VNCoreMedicationDispense.quantity.code | SupplyDelivery.suppliedItem.quantity.code
.... quantity
VNCoreMedicationDispense.quantity.value | SupplyDelivery.suppliedItem.quantity.value
.... batchNo
Medication.batch.lotNumber (khi dùng Medication resource)
VNCoreMedicationDispense ràng buộc medication[x] only CodeableConcept nên KHÔNG mang được số lô trong resource cấp phát — số lô lấy từ hệ thống kho của phần mềm (gap đã ghi nhận trong bảng ánh xạ wiki; phương án dài hạn: nới profile cho medicationReference hoặc extension lô).
.... packagingSpecifications
— (tham khảo MedicationKnowledge.packaging)
.... expiryDate
Medication.batch.expirationDate (khi dùng Medication resource; cùng gap với batch_no ở nhánh sale-retail)
.... manufacturerId
VNCoreMedication.manufacturer.resolve().identifier.value
.... manufacturerName
VNCoreMedication.manufacturer.display | Organization.name
.... manufacturerCountry
Organization.address.country
.... gtin
//www.gs1.org/gtin) | VNCoreMedication.code.coding
.... price
Invoice.lineItem.priceComponent | VNCoreClaim.item.unitPrice (bối cảnh BHYT) — không có carrier trên MedicationDispense/SupplyDelivery
... transactionId
MedicationDispense.identifier | SupplyDelivery.identifier (system của TTYQG — bổ sung sau tiếp nhận)
... processingStatus
  • — (trạng thái tiếp nhận của CSDL Dược
  • KHÔNG phải MedicationDispense.status; giữ ở tầng adapter)

doco Documentation for this format