{ "resourceType" : "StructureDefinition", "id" : "vnPharmacyStockOutLm", "language" : "vi", "text" : { "status" : "extensions", "div" : "

Generated Narrative: StructureDefinition vnPharmacyStockOutLm

\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
NameFlagsCard.TypeDescription & Constraints\"doco\"
\".\"\".\" vnPharmacyStockOutLm 0..*BasePhiếu xuất hàng CSDL Dược — Logical Model
\".\"\".\"\".\" transactionDate 1..1dateTimetransaction_date — Ngày/giờ xuất hàng (GMT+7 không ghi offset — mục 6.3.1)
\".\"\".\"\".\" reason 1..1codereason — Loại phiếu xuất/Lý do xuất (mục 6.4.2; tối đa 20 ký tự)
\".\"\".\"\".\" sourceStoreId 0..1stringsource_store_id — Mã chi nhánh xuất hàng (chuỗi nhà thuốc, reason=transfer-out)
\".\"\".\"\".\" sourceWarehouseId 0..1stringsource_warehouse_id — Mã kho xuất (reason=transfer-out)
\".\"\".\"\".\" targetStoreId 0..1stringtarget_store_id — Mã chi nhánh nhập hàng (reason=transfer-out)
\".\"\".\"\".\" targetWarehouseId 0..1stringtarget_warehouse_id — Mã kho nhập (reason=transfer-out)
\".\"\".\"\".\" supplierId 0..1stringsupplier_id — Mã định danh nhà cung cấp (reason=return — xuất trả nhà cung cấp)
\".\"\".\"\".\" referenceNumber 1..1stringreference_number — Số chứng từ xuất hàng
\".\"\".\"\".\" practiceLicenseCode 0..1stringpractice_license_code — Số GCN đủ điều kiện sản xuất/kinh doanh thuốc của chi nhánh (bổ sung ở v1.1; tài khoản cơ sở chính đẩy hộ thành viên chuỗi)
\".\"\".\"\".\" note 0..1stringnote — Ghi chú (tối đa 500 ký tự)
\".\"\".\"\".\" item 1..*BackboneElementitems[] — Danh sách thuốc trong phiếu xuất
\".\"\".\"\".\"\".\" drugId 1..1stringitems[].drug_id — Mã định danh thuốc (bắt buộc — validator trả lỗi khi để trống)
\".\"\".\"\".\"\".\" unitId 1..1stringitems[].unit_id — Mã đơn vị tính (bắt buộc — validator trả lỗi khi để trống)
\".\"\".\"\".\"\".\" quantity 1..1integeritems[].quantity — Số lượng
\".\"\".\"\".\"\".\" batchNo 1..1stringitems[].batch_no — Số lô sản xuất (tối đa 20 ký tự)
\".\"\".\"\".\"\".\" packagingSpecifications 0..1stringitems[].packaging_specifications — Quy cách đóng gói (bổ sung ở v1.1)
\".\"\".\"\".\"\".\" expiryDate 1..1dateitems[].expiry_date — Hạn sử dụng của lô
\".\"\".\"\".\"\".\" manufacturerId 0..1stringitems[].manufacturer.id — Mã nhà sản xuất
\".\"\".\"\".\"\".\" manufacturerName 0..1stringitems[].manufacturer.name — Tên nhà sản xuất (tối đa 200 ký tự)
\".\"\".\"\".\"\".\" manufacturerCountry 0..1stringitems[].manufacturer.country — Mã quốc gia sản xuất (ISO-3166)
\".\"\".\"\".\"\".\" gtin 0..1stringitems[].gtin — Mã GTIN theo cấp độ đóng gói
\".\"\".\"\".\"\".\" price 0..1decimalitems[].price — Đơn giá xuất (2 chữ số thập phân)
\".\"\".\"\".\" transactionId 0..1stringtransaction_id — Mã giao dịch do hệ thống cấp trong response
\".\"\".\"\".\" processingStatus 0..1codestatus — Trạng thái xử lý bất đồng bộ (mục 6.2: accepted | processing | completed | error | rejected)

\"doco\" Documentation for this format
" }, "extension" : [{ "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis", "valueCoding" : { "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs", "code" : "QD-232-TTYQG" } }, { "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis", "valueCoding" : { "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs", "code" : "TT-11-2025" } }], "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vnPharmacyStockOutLm", "identifier" : [{ "system" : "urn:ietf:rfc:3986", "value" : "urn:oid:2.25.161089673617632664299011809196868855799.42.165" }], "version" : "0.9.0", "name" : "VNPharmacyStockOutLM", "title" : "Phiếu xuất hàng CSDL Dược — Logical Model", "status" : "draft", "date" : "2026-07-31T01:48:42+07:00", "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative", "contact" : [{ "name" : "Omi HealthTech / VN Core FHIR Community Initiative", "telecom" : [{ "system" : "url", "value" : "https://hl7.org.vn" }, { "system" : "email", "value" : "info@hl7.org.vn" }] }, { "name" : "Omi HealthTech (OmiGroup)", "telecom" : [{ "system" : "url", "value" : "https://omihealthtech.vn" }, { "system" : "url", "value" : "https://omigroup.vn" }, { "system" : "email", "value" : "info@hl7.org.vn" }] }], "description" : "Logical model cho payload phiếu xuất hàng gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-out, API v1.1 mục 5.4.4). Bao trùm cả nghiệp vụ BÁN LẺ THUỐC (reason=sale-retail — v1.1 đã bỏ nhóm API hóa đơn /invoices của v1.0, bán lẻ chỉ còn liên thông qua stock-out): với bán lẻ theo đơn, đích FHIR chủ đạo là VNCoreMedicationDispense; với các nghiệp vụ kho khác là SupplyDelivery. reason=recall gắn trực tiếp quy trình thu hồi thuốc theo TT 30/2025/TT-BYT.", "jurisdiction" : [{ "coding" : [{ "system" : "urn:iso:std:iso:3166", "code" : "VN", "display" : "Viet Nam" }] }], "fhirVersion" : "4.0.1", "mapping" : [{ "identity" : "vn-fhir", "uri" : "http://fhir.hl7.org.vn/core/mapping/csdl-duoc-fhir", "name" : "VN Core FHIR mapping", "comment" : "Phân nhánh theo reason (mục 6.4.2): sale-retail → VNCoreMedicationDispense; sale-wholesale/transfer-out/return/recall/destroy → SupplyDelivery (mỗi dòng thuốc một SupplyDelivery, chung identifier phiếu — suppliedItem là 0..1)." }], "kind" : "logical", "abstract" : false, "type" : "http://fhir.hl7.org.vn/core/StructureDefinition/vnPharmacyStockOutLm", "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base", "derivation" : "specialization", "snapshot" : { "extension" : [{ "url" : "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version", "valueString" : "4.0.1" }], "element" : [{ "id" : "vnPharmacyStockOutLm", "path" : "vnPharmacyStockOutLm", "short" : "Phiếu xuất hàng CSDL Dược — Logical Model", "definition" : "Logical model cho payload phiếu xuất hàng gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-out, API v1.1 mục 5.4.4). Bao trùm cả nghiệp vụ BÁN LẺ THUỐC (reason=sale-retail — v1.1 đã bỏ nhóm API hóa đơn /invoices của v1.0, bán lẻ chỉ còn liên thông qua stock-out): với bán lẻ theo đơn, đích FHIR chủ đạo là VNCoreMedicationDispense; với các nghiệp vụ kho khác là SupplyDelivery. reason=recall gắn trực tiếp quy trình thu hồi thuốc theo TT 30/2025/TT-BYT.", "min" : 0, "max" : "*", "base" : { "path" : "Base", "min" : 0, "max" : "*" }, "isModifier" : false }, { "id" : "vnPharmacyStockOutLm.transactionDate", "path" : "vnPharmacyStockOutLm.transactionDate", "short" : "transaction_date — Ngày/giờ xuất hàng (GMT+7 không ghi offset — mục 6.3.1)", "definition" : "transaction_date — Ngày/giờ xuất hàng (GMT+7 không ghi offset — mục 6.3.1)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.transactionDate", "min" : 1, "max" : "1" }, "type" : [{ "code" : "dateTime" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.whenHandedOver (sale-retail) | SupplyDelivery.occurrenceDateTime (nghiệp vụ khác)", "comment" : "FHIR dateTime bắt buộc có offset khi có giờ — adapter gắn +07:00 khi chuyển đổi." }] }, { "id" : "vnPharmacyStockOutLm.reason", "path" : "vnPharmacyStockOutLm.reason", "short" : "reason — Loại phiếu xuất/Lý do xuất (mục 6.4.2; tối đa 20 ký tự)", "definition" : "reason — Loại phiếu xuất/Lý do xuất (mục 6.4.2; tối đa 20 ký tự)", "comment" : "Cơ sở bán lẻ: sale-retail | return | destroy | other. Cơ sở khác thêm: sale-wholesale | transfer-out | recall (xuất thu hồi theo công văn/khuyến cáo BYT). Giá trị return bắt buộc kèm supplier_id; transfer-out bắt buộc kèm cặp source_*/target_*.", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.reason", "min" : 1, "max" : "1" }, "type" : [{ "code" : "code" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Phân nhánh adapter: sale-retail → MedicationDispense; còn lại → SupplyDelivery.type + ngữ cảnh nghiệp vụ", "comment" : "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." }] }, { "id" : "vnPharmacyStockOutLm.sourceStoreId", "path" : "vnPharmacyStockOutLm.sourceStoreId", "short" : "source_store_id — Mã chi nhánh xuất hàng (chuỗi nhà thuốc, reason=transfer-out)", "definition" : "source_store_id — Mã chi nhánh xuất hàng (chuỗi nhà thuốc, reason=transfer-out)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.sourceStoreId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.supplier.resolve().identifier.value (chi nhánh xuất)" }] }, { "id" : "vnPharmacyStockOutLm.sourceWarehouseId", "path" : "vnPharmacyStockOutLm.sourceWarehouseId", "short" : "source_warehouse_id — Mã kho xuất (reason=transfer-out)", "definition" : "source_warehouse_id — Mã kho xuất (reason=transfer-out)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.sourceWarehouseId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Location.identifier.value (kho xuất)" }] }, { "id" : "vnPharmacyStockOutLm.targetStoreId", "path" : "vnPharmacyStockOutLm.targetStoreId", "short" : "target_store_id — Mã chi nhánh nhập hàng (reason=transfer-out)", "definition" : "target_store_id — Mã chi nhánh nhập hàng (reason=transfer-out)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.targetStoreId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination.resolve().identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.targetWarehouseId", "path" : "vnPharmacyStockOutLm.targetWarehouseId", "short" : "target_warehouse_id — Mã kho nhập (reason=transfer-out)", "definition" : "target_warehouse_id — Mã kho nhập (reason=transfer-out)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.targetWarehouseId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination.resolve().identifier.value (Location kho nhập)" }] }, { "id" : "vnPharmacyStockOutLm.supplierId", "path" : "vnPharmacyStockOutLm.supplierId", "short" : "supplier_id — Mã định danh nhà cung cấp (reason=return — xuất trả nhà cung cấp)", "definition" : "supplier_id — Mã định danh nhà cung cấp (reason=return — xuất trả nhà cung cấp)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.supplierId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination hoặc receiver (bên nhận hàng trả) — adapter quyết định theo ngữ cảnh" }] }, { "id" : "vnPharmacyStockOutLm.referenceNumber", "path" : "vnPharmacyStockOutLm.referenceNumber", "short" : "reference_number — Số chứng từ xuất hàng", "definition" : "reference_number — Số chứng từ xuất hàng", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.referenceNumber", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.identifier.value (sale-retail) | SupplyDelivery.identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.practiceLicenseCode", "path" : "vnPharmacyStockOutLm.practiceLicenseCode", "short" : "practice_license_code — Số GCN đủ điều kiện sản xuất/kinh doanh thuốc của chi nhánh (bổ sung ở v1.1; tài khoản cơ sở chính đẩy hộ thành viên chuỗi)", "definition" : "practice_license_code — Số GCN đủ điều kiện sản xuất/kinh doanh thuốc của chi nhánh (bổ sung ở v1.1; tài khoản cơ sở chính đẩy hộ thành viên chuỗi)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.practiceLicenseCode", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.identifier.value (GCN đủ điều kiện kinh doanh dược — chưa có NamingSystem VN Core; ghi nhận gap)" }] }, { "id" : "vnPharmacyStockOutLm.note", "path" : "vnPharmacyStockOutLm.note", "short" : "note — Ghi chú (tối đa 500 ký tự)", "definition" : "note — Ghi chú (tối đa 500 ký tự)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.note", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.note.text (sale-retail) | — (SupplyDelivery không có note)" }] }, { "id" : "vnPharmacyStockOutLm.item", "path" : "vnPharmacyStockOutLm.item", "short" : "items[] — Danh sách thuốc trong phiếu xuất", "definition" : "items[] — Danh sách thuốc trong phiếu xuất", "min" : 1, "max" : "*", "base" : { "path" : "vnPharmacyStockOutLm.item", "min" : 1, "max" : "*" }, "type" : [{ "code" : "BackboneElement" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "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" : "vnPharmacyStockOutLm.item.id", "path" : "vnPharmacyStockOutLm.item.id", "representation" : ["xmlAttr"], "short" : "Unique id for inter-element referencing", "definition" : "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.", "min" : 0, "max" : "1", "base" : { "path" : "Element.id", "min" : 0, "max" : "1" }, "type" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type", "valueUrl" : "string" }], "code" : "http://hl7.org/fhirpath/System.String" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyStockOutLm.item.extension", "path" : "vnPharmacyStockOutLm.item.extension", "slicing" : { "discriminator" : [{ "type" : "value", "path" : "url" }], "description" : "Extensions are always sliced by (at least) url", "rules" : "open" }, "short" : "Additional content defined by implementations", "definition" : "May 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.", "comment" : "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.", "alias" : ["extensions", "user content"], "min" : 0, "max" : "*", "base" : { "path" : "Element.extension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyStockOutLm.item.modifierExtension", "path" : "vnPharmacyStockOutLm.item.modifierExtension", "short" : "Extensions that cannot be ignored even if unrecognized", "definition" : "May 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.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).", "comment" : "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.", "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](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).", "alias" : ["extensions", "user content", "modifiers"], "min" : 0, "max" : "*", "base" : { "path" : "BackboneElement.modifierExtension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : true, "isModifierReason" : "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them", "isSummary" : true, "mapping" : [{ "identity" : "rim", "map" : "N/A" }] }, { "id" : "vnPharmacyStockOutLm.item.drugId", "path" : "vnPharmacyStockOutLm.item.drugId", "short" : "items[].drug_id — Mã định danh thuốc (bắt buộc — validator trả lỗi khi để trống)", "definition" : "items[].drug_id — Mã định danh thuốc (bắt buộc — validator trả lỗi khi để trống)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.drugId", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.medicationCodeableConcept.coding.code (hệ mã GPLH) | VNCoreMedicationDispense.extension[registrationNumber].valueString | SupplyDelivery.suppliedItem.itemReference.resolve().code" }] }, { "id" : "vnPharmacyStockOutLm.item.unitId", "path" : "vnPharmacyStockOutLm.item.unitId", "short" : "items[].unit_id — Mã đơn vị tính (bắt buộc — validator trả lỗi khi để trống)", "definition" : "items[].unit_id — Mã đơn vị tính (bắt buộc — validator trả lỗi khi để trống)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.unitId", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.quantity.code | SupplyDelivery.suppliedItem.quantity.code" }] }, { "id" : "vnPharmacyStockOutLm.item.quantity", "path" : "vnPharmacyStockOutLm.item.quantity", "short" : "items[].quantity — Số lượng", "definition" : "items[].quantity — Số lượng", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.quantity", "min" : 1, "max" : "1" }, "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.quantity.value | SupplyDelivery.suppliedItem.quantity.value" }] }, { "id" : "vnPharmacyStockOutLm.item.batchNo", "path" : "vnPharmacyStockOutLm.item.batchNo", "short" : "items[].batch_no — Số lô sản xuất (tối đa 20 ký tự)", "definition" : "items[].batch_no — Số lô sản xuất (tối đa 20 ký tự)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.batchNo", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Medication.batch.lotNumber (khi dùng Medication resource)", "comment" : "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ô)." }] }, { "id" : "vnPharmacyStockOutLm.item.packagingSpecifications", "path" : "vnPharmacyStockOutLm.item.packagingSpecifications", "short" : "items[].packaging_specifications — Quy cách đóng gói (bổ sung ở v1.1)", "definition" : "items[].packaging_specifications — Quy cách đóng gói (bổ sung ở v1.1)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.packagingSpecifications", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (tham khảo MedicationKnowledge.packaging)" }] }, { "id" : "vnPharmacyStockOutLm.item.expiryDate", "path" : "vnPharmacyStockOutLm.item.expiryDate", "short" : "items[].expiry_date — Hạn sử dụng của lô", "definition" : "items[].expiry_date — Hạn sử dụng của lô", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.expiryDate", "min" : 1, "max" : "1" }, "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Medication.batch.expirationDate (khi dùng Medication resource; cùng gap với batch_no ở nhánh sale-retail)" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerId", "path" : "vnPharmacyStockOutLm.item.manufacturerId", "short" : "items[].manufacturer.id — Mã nhà sản xuất", "definition" : "items[].manufacturer.id — Mã nhà sản xuất", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.manufacturerId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.resolve().identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerName", "path" : "vnPharmacyStockOutLm.item.manufacturerName", "short" : "items[].manufacturer.name — Tên nhà sản xuất (tối đa 200 ký tự)", "definition" : "items[].manufacturer.name — Tên nhà sản xuất (tối đa 200 ký tự)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.manufacturerName", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.display | Organization.name" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerCountry", "path" : "vnPharmacyStockOutLm.item.manufacturerCountry", "short" : "items[].manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "definition" : "items[].manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.manufacturerCountry", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.country" }] }, { "id" : "vnPharmacyStockOutLm.item.gtin", "path" : "vnPharmacyStockOutLm.item.gtin", "short" : "items[].gtin — Mã GTIN theo cấp độ đóng gói", "definition" : "items[].gtin — Mã GTIN theo cấp độ đóng gói", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.gtin", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.medicationCodeableConcept.coding (system https://www.gs1.org/gtin) | VNCoreMedication.code.coding" }] }, { "id" : "vnPharmacyStockOutLm.item.price", "path" : "vnPharmacyStockOutLm.item.price", "short" : "items[].price — Đơn giá xuất (2 chữ số thập phân)", "definition" : "items[].price — Đơn giá xuất (2 chữ số thập phân)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.item.price", "min" : 0, "max" : "1" }, "type" : [{ "code" : "decimal" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Invoice.lineItem.priceComponent | VNCoreClaim.item.unitPrice (bối cảnh BHYT) — không có carrier trên MedicationDispense/SupplyDelivery" }] }, { "id" : "vnPharmacyStockOutLm.transactionId", "path" : "vnPharmacyStockOutLm.transactionId", "short" : "transaction_id — Mã giao dịch do hệ thống cấp trong response", "definition" : "transaction_id — Mã giao dịch do hệ thống cấp trong response", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.transactionId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "MedicationDispense.identifier | SupplyDelivery.identifier (system của TTYQG — bổ sung sau tiếp nhận)" }] }, { "id" : "vnPharmacyStockOutLm.processingStatus", "path" : "vnPharmacyStockOutLm.processingStatus", "short" : "status — Trạng thái xử lý bất đồng bộ (mục 6.2: accepted | processing | completed | error | rejected)", "definition" : "status — Trạng thái xử lý bất đồng bộ (mục 6.2: accepted | processing | completed | error | rejected)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyStockOutLm.processingStatus", "min" : 0, "max" : "1" }, "type" : [{ "code" : "code" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (trạng thái tiếp nhận của CSDL Dược, KHÔNG phải MedicationDispense.status; giữ ở tầng adapter)" }] }] }, "differential" : { "element" : [{ "id" : "vnPharmacyStockOutLm", "path" : "vnPharmacyStockOutLm", "short" : "Phiếu xuất hàng CSDL Dược — Logical Model", "definition" : "Logical model cho payload phiếu xuất hàng gửi lên Hệ thống cơ sở dữ liệu về dược (POST /transactions/stock-out, API v1.1 mục 5.4.4). Bao trùm cả nghiệp vụ BÁN LẺ THUỐC (reason=sale-retail — v1.1 đã bỏ nhóm API hóa đơn /invoices của v1.0, bán lẻ chỉ còn liên thông qua stock-out): với bán lẻ theo đơn, đích FHIR chủ đạo là VNCoreMedicationDispense; với các nghiệp vụ kho khác là SupplyDelivery. reason=recall gắn trực tiếp quy trình thu hồi thuốc theo TT 30/2025/TT-BYT." }, { "id" : "vnPharmacyStockOutLm.transactionDate", "path" : "vnPharmacyStockOutLm.transactionDate", "short" : "transaction_date — Ngày/giờ xuất hàng (GMT+7 không ghi offset — mục 6.3.1)", "definition" : "transaction_date — Ngày/giờ xuất hàng (GMT+7 không ghi offset — mục 6.3.1)", "min" : 1, "max" : "1", "type" : [{ "code" : "dateTime" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.whenHandedOver (sale-retail) | SupplyDelivery.occurrenceDateTime (nghiệp vụ khác)", "comment" : "FHIR dateTime bắt buộc có offset khi có giờ — adapter gắn +07:00 khi chuyển đổi." }] }, { "id" : "vnPharmacyStockOutLm.reason", "path" : "vnPharmacyStockOutLm.reason", "short" : "reason — Loại phiếu xuất/Lý do xuất (mục 6.4.2; tối đa 20 ký tự)", "definition" : "reason — Loại phiếu xuất/Lý do xuất (mục 6.4.2; tối đa 20 ký tự)", "comment" : "Cơ sở bán lẻ: sale-retail | return | destroy | other. Cơ sở khác thêm: sale-wholesale | transfer-out | recall (xuất thu hồi theo công văn/khuyến cáo BYT). Giá trị return bắt buộc kèm supplier_id; transfer-out bắt buộc kèm cặp source_*/target_*.", "min" : 1, "max" : "1", "type" : [{ "code" : "code" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Phân nhánh adapter: sale-retail → MedicationDispense; còn lại → SupplyDelivery.type + ngữ cảnh nghiệp vụ", "comment" : "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." }] }, { "id" : "vnPharmacyStockOutLm.sourceStoreId", "path" : "vnPharmacyStockOutLm.sourceStoreId", "short" : "source_store_id — Mã chi nhánh xuất hàng (chuỗi nhà thuốc, reason=transfer-out)", "definition" : "source_store_id — Mã chi nhánh xuất hàng (chuỗi nhà thuốc, reason=transfer-out)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.supplier.resolve().identifier.value (chi nhánh xuất)" }] }, { "id" : "vnPharmacyStockOutLm.sourceWarehouseId", "path" : "vnPharmacyStockOutLm.sourceWarehouseId", "short" : "source_warehouse_id — Mã kho xuất (reason=transfer-out)", "definition" : "source_warehouse_id — Mã kho xuất (reason=transfer-out)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Location.identifier.value (kho xuất)" }] }, { "id" : "vnPharmacyStockOutLm.targetStoreId", "path" : "vnPharmacyStockOutLm.targetStoreId", "short" : "target_store_id — Mã chi nhánh nhập hàng (reason=transfer-out)", "definition" : "target_store_id — Mã chi nhánh nhập hàng (reason=transfer-out)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination.resolve().identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.targetWarehouseId", "path" : "vnPharmacyStockOutLm.targetWarehouseId", "short" : "target_warehouse_id — Mã kho nhập (reason=transfer-out)", "definition" : "target_warehouse_id — Mã kho nhập (reason=transfer-out)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination.resolve().identifier.value (Location kho nhập)" }] }, { "id" : "vnPharmacyStockOutLm.supplierId", "path" : "vnPharmacyStockOutLm.supplierId", "short" : "supplier_id — Mã định danh nhà cung cấp (reason=return — xuất trả nhà cung cấp)", "definition" : "supplier_id — Mã định danh nhà cung cấp (reason=return — xuất trả nhà cung cấp)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "SupplyDelivery.destination hoặc receiver (bên nhận hàng trả) — adapter quyết định theo ngữ cảnh" }] }, { "id" : "vnPharmacyStockOutLm.referenceNumber", "path" : "vnPharmacyStockOutLm.referenceNumber", "short" : "reference_number — Số chứng từ xuất hàng", "definition" : "reference_number — Số chứng từ xuất hàng", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.identifier.value (sale-retail) | SupplyDelivery.identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.practiceLicenseCode", "path" : "vnPharmacyStockOutLm.practiceLicenseCode", "short" : "practice_license_code — Số GCN đủ điều kiện sản xuất/kinh doanh thuốc của chi nhánh (bổ sung ở v1.1; tài khoản cơ sở chính đẩy hộ thành viên chuỗi)", "definition" : "practice_license_code — Số GCN đủ điều kiện sản xuất/kinh doanh thuốc của chi nhánh (bổ sung ở v1.1; tài khoản cơ sở chính đẩy hộ thành viên chuỗi)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.identifier.value (GCN đủ điều kiện kinh doanh dược — chưa có NamingSystem VN Core; ghi nhận gap)" }] }, { "id" : "vnPharmacyStockOutLm.note", "path" : "vnPharmacyStockOutLm.note", "short" : "note — Ghi chú (tối đa 500 ký tự)", "definition" : "note — Ghi chú (tối đa 500 ký tự)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.note.text (sale-retail) | — (SupplyDelivery không có note)" }] }, { "id" : "vnPharmacyStockOutLm.item", "path" : "vnPharmacyStockOutLm.item", "short" : "items[] — Danh sách thuốc trong phiếu xuất", "definition" : "items[] — Danh sách thuốc trong phiếu xuất", "min" : 1, "max" : "*", "type" : [{ "code" : "BackboneElement" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "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" : "vnPharmacyStockOutLm.item.drugId", "path" : "vnPharmacyStockOutLm.item.drugId", "short" : "items[].drug_id — Mã định danh thuốc (bắt buộc — validator trả lỗi khi để trống)", "definition" : "items[].drug_id — Mã định danh thuốc (bắt buộc — validator trả lỗi khi để trống)", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.medicationCodeableConcept.coding.code (hệ mã GPLH) | VNCoreMedicationDispense.extension[registrationNumber].valueString | SupplyDelivery.suppliedItem.itemReference.resolve().code" }] }, { "id" : "vnPharmacyStockOutLm.item.unitId", "path" : "vnPharmacyStockOutLm.item.unitId", "short" : "items[].unit_id — Mã đơn vị tính (bắt buộc — validator trả lỗi khi để trống)", "definition" : "items[].unit_id — Mã đơn vị tính (bắt buộc — validator trả lỗi khi để trống)", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.quantity.code | SupplyDelivery.suppliedItem.quantity.code" }] }, { "id" : "vnPharmacyStockOutLm.item.quantity", "path" : "vnPharmacyStockOutLm.item.quantity", "short" : "items[].quantity — Số lượng", "definition" : "items[].quantity — Số lượng", "min" : 1, "max" : "1", "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.quantity.value | SupplyDelivery.suppliedItem.quantity.value" }] }, { "id" : "vnPharmacyStockOutLm.item.batchNo", "path" : "vnPharmacyStockOutLm.item.batchNo", "short" : "items[].batch_no — Số lô sản xuất (tối đa 20 ký tự)", "definition" : "items[].batch_no — Số lô sản xuất (tối đa 20 ký tự)", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Medication.batch.lotNumber (khi dùng Medication resource)", "comment" : "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ô)." }] }, { "id" : "vnPharmacyStockOutLm.item.packagingSpecifications", "path" : "vnPharmacyStockOutLm.item.packagingSpecifications", "short" : "items[].packaging_specifications — Quy cách đóng gói (bổ sung ở v1.1)", "definition" : "items[].packaging_specifications — Quy cách đóng gói (bổ sung ở v1.1)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (tham khảo MedicationKnowledge.packaging)" }] }, { "id" : "vnPharmacyStockOutLm.item.expiryDate", "path" : "vnPharmacyStockOutLm.item.expiryDate", "short" : "items[].expiry_date — Hạn sử dụng của lô", "definition" : "items[].expiry_date — Hạn sử dụng của lô", "min" : 1, "max" : "1", "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Medication.batch.expirationDate (khi dùng Medication resource; cùng gap với batch_no ở nhánh sale-retail)" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerId", "path" : "vnPharmacyStockOutLm.item.manufacturerId", "short" : "items[].manufacturer.id — Mã nhà sản xuất", "definition" : "items[].manufacturer.id — Mã nhà sản xuất", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.resolve().identifier.value" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerName", "path" : "vnPharmacyStockOutLm.item.manufacturerName", "short" : "items[].manufacturer.name — Tên nhà sản xuất (tối đa 200 ký tự)", "definition" : "items[].manufacturer.name — Tên nhà sản xuất (tối đa 200 ký tự)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.display | Organization.name" }] }, { "id" : "vnPharmacyStockOutLm.item.manufacturerCountry", "path" : "vnPharmacyStockOutLm.item.manufacturerCountry", "short" : "items[].manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "definition" : "items[].manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.country" }] }, { "id" : "vnPharmacyStockOutLm.item.gtin", "path" : "vnPharmacyStockOutLm.item.gtin", "short" : "items[].gtin — Mã GTIN theo cấp độ đóng gói", "definition" : "items[].gtin — Mã GTIN theo cấp độ đóng gói", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationDispense.medicationCodeableConcept.coding (system https://www.gs1.org/gtin) | VNCoreMedication.code.coding" }] }, { "id" : "vnPharmacyStockOutLm.item.price", "path" : "vnPharmacyStockOutLm.item.price", "short" : "items[].price — Đơn giá xuất (2 chữ số thập phân)", "definition" : "items[].price — Đơn giá xuất (2 chữ số thập phân)", "min" : 0, "max" : "1", "type" : [{ "code" : "decimal" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Invoice.lineItem.priceComponent | VNCoreClaim.item.unitPrice (bối cảnh BHYT) — không có carrier trên MedicationDispense/SupplyDelivery" }] }, { "id" : "vnPharmacyStockOutLm.transactionId", "path" : "vnPharmacyStockOutLm.transactionId", "short" : "transaction_id — Mã giao dịch do hệ thống cấp trong response", "definition" : "transaction_id — Mã giao dịch do hệ thống cấp trong response", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "MedicationDispense.identifier | SupplyDelivery.identifier (system của TTYQG — bổ sung sau tiếp nhận)" }] }, { "id" : "vnPharmacyStockOutLm.processingStatus", "path" : "vnPharmacyStockOutLm.processingStatus", "short" : "status — Trạng thái xử lý bất đồng bộ (mục 6.2: accepted | processing | completed | error | rejected)", "definition" : "status — Trạng thái xử lý bất đồng bộ (mục 6.2: accepted | processing | completed | error | rejected)", "min" : 0, "max" : "1", "type" : [{ "code" : "code" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (trạng thái tiếp nhận của CSDL Dược, KHÔNG phải MedicationDispense.status; giữ ở tầng adapter)" }] }] } }