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.10.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 - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

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

Draft tại thời điểm 2026-09-22

Ánh xạ cho vnPharmacyStockInLm 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
.. vnPharmacyStockInLm
... transactionDate
SupplyDelivery.occurrenceDateTime
Wire → FHIR: adapter gắn +07:00 trước khi tạo occurrenceDateTime. FHIR → wire: adapter quy đổi về giờ Hà Nội, render YYYY-MM-DDThh:mm:ss rồi bỏ offset; logical model luôn giữ đúng chuỗi trên dây.
... reason
SupplyDelivery.type (medication) + phân nhánh nghiệp vụ tầng adapter
R4 SupplyDelivery không có phần tử 'lý do nhập'; enum 6.4.1 quyết định nhánh nghiệp vụ (chọn supplier/destination), không map 1-1 vào một phần tử FHIR.
... supplierId
SupplyDelivery.supplier.resolve().identifier.value
... sourceWarehouseId
Location.identifier.value (kho xuất — mô hình đa kho cần Location riêng cho từng kho)
... targetStoreId
SupplyDelivery.destination.resolve().identifier.value
... targetWarehouseId
SupplyDelivery.destination.resolve().identifier.value (Location kho nhập)
... referenceNumber
SupplyDelivery.identifier.value (system nội bộ cơ sở; dùng chung cho các SupplyDelivery tách từ cùng một phiếu)
... practiceLicenseCode
Organization.identifier.value (GCN đủ điều kiện kinh doanh dược — chưa có NamingSystem VN Core; ghi nhận gap)
... note
— (R4 SupplyDelivery không có phần tử note/annotation; giữ ở tầng adapter)
... item
  • SupplyDelivery.suppliedItem (0..1 mỗi resource — mỗi dòng thuốc là một SupplyDelivery riêng
  • chung identifier phiếu)
.... @id
.... extension
.... modifierExtension
.... drugId
  • SupplyDelivery.suppliedItem.itemReference.resolve().code.coding.code (VNCoreMedication
  • hệ mã GPLH) | VNCoreMedication.identifier[drugRegistrationNumber].value
.... unitId
SupplyDelivery.suppliedItem.quantity.code (bộ mã đơn vị tính GET /master/units)
.... quantity
SupplyDelivery.suppliedItem.quantity.value
.... batchNo
SupplyDelivery.suppliedItem.itemReference.resolve().batch.lotNumber (VNCoreMedication)
Khi hiện diện, mỗi lô ánh xạ thành một instance Medication riêng (Medication.batch chỉ chứa 1 lô). Với dòng opening-balance quantity=0, adapter không được bịa Medication.batch để lấp trường vắng.
.... packagingSpecifications
— (tham khảo MedicationKnowledge.packaging; không có carrier trên VNCoreMedication R4)
.... expiryDate
SupplyDelivery.suppliedItem.itemReference.resolve().batch.expirationDate (VNCoreMedication)
Chỉ map khi wire có expiry_date. Với dòng opening-balance quantity=0, adapter giữ vắng và không tổng hợp một ngày hết hạn.
.... manufacturerId
VNCoreMedication.manufacturer.resolve().identifier.value
.... manufacturerName
VNCoreMedication.manufacturer.display | Organization.name
.... manufacturerCountry
Organization.address.country
.... gtin
//www.gs1.org/gtin)
.... price
— (SupplyDelivery không có phần tử giá; nếu cần biểu diễn dùng Invoice.lineItem.priceComponent)
... transactionId
SupplyDelivery.identifier (system của TTYQG — bổ sung sau khi hệ thống tiếp nhận)
... processingStatus
  • — (trạng thái tiếp nhận của CSDL Dược
  • KHÔNG phải SupplyDelivery.status; giữ ở tầng adapter)

doco Documentation for this format