Chi tiết tài liệu mở

<h2 role="presentation" dir="ltr">Hướng dẫn thiết lập</h2> <h3 role="presentation" dir="ltr">Cấu hình hệ thống</h3> <p dir="ltr">Mục đích: Để tạo ra được mã Qr có số tiền thanh toán trên các biểu in và phục vụ tạo giao dịch thanh toán trên HIS</p> <p dir="ltr">Hướng dẫn: Cần vào chức năng Cấu hình hệ thống, khai báo vào ô Giá trị của các cấu hình sau:</p> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">HIS.Desktop.Plugins.PaymentQrCode.NAPASInfo: Khai báo các tham số phục vụ tạo mã QR thanh toán do NAPAS cung cấp.</p> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">Các tham số phân cách nhau bởi dấu , theo định dạng sau: {"PayLoad":"mã phiên bản(01)",<br>"methodCode": "phương thức khởi tạo(12)",<br>"guid": "Mã định danh phương thức(A000000727)",<br>"acquierOrBnb":"Mã định danh ngân hàng PVDB(971133)",<br>"merchantOrConsumer":"Mã điểm thu(NPVSVSMVSM01)",<br>"qrType":"Hình thức QR (QRIBFTTA)",<br>"Ccy":"mã tiền tệ (704)",<br>"CountryCode":"Mã code quốc gia (VN)",<br>"GenQrMethod":"Hình thưc genQR. OPEN_API: HIS gọi api của BIDV để gen QR. LOCAL hoặc rỗng: HIS tự gen QR theo chuẩn QRCode"}</p> </li> <li aria-level="1" dir="ltr">Ví dụ: <br>{"PayLoad":"01","methodCode": "12","guid": "A000000727","acquierOrBnb":"971133","merchantOrConsumer":"NPVSVSMVSM01","qrType":"QRIBFTTA","Ccy":"704","CountryCode":"VN","GenQrMethod":"OPEN_API"}</li> <li dir="ltr">Trong đó: Các giá trị giá trị do NAPAS cung cấp bao gồm: acquierOrBnb, merchantOrConsumer </li> </ul> </li> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">MOS.HIS_TRAN_REQ.AUTO_CREATE.OPTION: Thiết lập tùy chọn tạo yêu cầu thanh toán (sử dụng để sinh mã QR phục vụ trong các quy trình thanh toán dùng mã QR có tích hợp ngân hàng): </p> <ul> <li dir="ltr">- 1: Tự động tạo yêu cầu thanh toán khi thêm/sửa/xóa chỉ định dịch vụ khám, cận lâm sàng (với đối tượng thanh toán khác BHYT và diện điều trị là Khám), tạo yêu cầu tạm ứng (với bệnh nhân điều trị nội trú) và kết thúc điều trị nếu bệnh nhân còn nợ viện phí</li> <li dir="ltr">- Khác 1: Không tự động tạo yêu cầu thanh toán</li> </ul> </li> </ul> <p dir="ltr">Ví dụ: Để sử dụng được tính năng thì khai báo Giá trị = 1</p> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr"> MOS.HIS_TRANSACTION.QR_PAYMENT.BILL_INFO: Cấu hình phòng thu ngân, thu ngân, sổ hóa đơn sử dụng khi thanh toán. Khai báo các giá trị ngăn cách nhau bằng dấu “|”: <Mã phòng thu ngân>|<tên đăng nhập> - <họ tên>|<Mã sổ biên lai/Hóa đơn>.</p> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">Ví dụ: TN|admin - admin|HD1</p> </li> </ul> </li> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr"> MOS.HIS_TRANSACTION.QR_PAYMENT.DEPOSIT_INFO: Cấu hình phòng thu ngân, thu ngân, sổ hóa đơn sử dụng khi tạm ứng. Khai báo các giá trị ngăn cách nhau bằng dấu “|”: <Mã phòng thu ngân>|<tên đăng nhập> - <họ tên>|<Mã sổ biên lai/Hóa đơn>.</p> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">Ví dụ: TN|admin - admin|HD2</p> </li> </ul> </li> <li dir="ltr">Trong đó:  <ul> <li dir="ltr"><Mã phòng thu ngân> là Mã phòng được khai báo tại ô Mã phòng TN của chức năng “Phòng thu ngân”<strong style="font-size: 16px;"> </strong></li> </ul> </li> </ul> <p style="padding-left: 120px;" dir="ltr"><img height="277" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfDOHHz-78VIMxl07YahvF66hyBJ3iDVFPF2zZ2YIZ7Ng7o-nIBSpDceDl7Wil3NBzWw97_9KZ6u90x_7CkfR9T4vVZbrxibscOHKWB1OGZF-Io2BlPRizIjGRNSG2HmRyNJbbVRtQdxjjoDBjnUF9lMVsECtvNMO1oMnpxAfTlGKxN1-Rl7hU?key=cMedd6pEDljWX-QHInVoNg"></p> <ul> <li style="list-style-type: none;"> <ul> <li dir="ltr"><tên đăng nhập> - <họ tên> là thông tin tương ứng với Tên đăng nhập, Họ tên được khai báo tại chức năng “Tài khoản nhân viên”</li> </ul> </li> </ul> <p style="padding-left: 120px;" dir="ltr"><img height="356" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe0L5Tw0SmZKI7g0ykMu8lAmerAprzYPg6pO4UYxWPliwVbtOMYzyyr9sRGxaTqtAtIlqnKWRUuxGJmkMFg9wdvRIL6Bou78dXeP4E2Yk1hwlTkRitoyV-eaSroYtkN1byP_56A6-yr0SKQylB-OU2DwqRVH-urSWelK5mwwipdXVRFOKzONQ?key=cMedd6pEDljWX-QHInVoNg"></p> <ul> <li style="list-style-type: none;"> <ul> <li dir="ltr"><Mã sổ biên lai/Hóa đơn> là thông tin Mã sổ được khai báo tại chức năng Sổ biên lai/hóa đơn</li> </ul> </li> </ul> <p style="padding-left: 120px;" dir="ltr"><img height="181" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcgFhEWxYHM0f0reaGzlkg-ilSd_1JcyIotUrKpzy4L7EBJlW1JhawOVeUR0OBz1HuQPZyhY6oQM4tmc1YmTzVWHhNVJS6OkQOKN3OhSf36mk5v1DmjwQST1APpE1JMRSWQqGVsU8CsmNuW3qWXS4ON6uf10alzwhfwCqXJ4DRNxBc_Ge7A-Q?key=cMedd6pEDljWX-QHInVoNg"></p> <h3 role="presentation" dir="ltr"> </h3> <h3 role="presentation" dir="ltr">Cấu hình web.config của MOS</h3> <p dir="ltr">Mục đích: Sử dụng để ký số và verify (kiểm tra) chữ ký của ngân hàng để đảm bảo tính toàn vẹn của dữ liệu nhận được cũng như gửi dữ liệu cho ngân hàng</p> <p dir="ltr">Hướng dẫn: Mở file web.config của MOS</p> <p dir="ltr"><img height="331" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfv125lEc1n9t4Nn4JQSRZGwJyd1PUXDf0YtnxJuNRZ69wDTIYEmKH8vNcO8y3xaKtdh3ObQTmS1UQvqYNy2C9WP-92ieKGQ9Lj4BS4d0WMmEztTTtdKx1DIGAxbgrsU5nkpQ0WN8oCUyN0EhF7yhFVUlj-GIMzeM4A1a-XaWIuH_ICRIbNouM?key=cMedd6pEDljWX-QHInVoNg"></p> <p dir="ltr">Bổ sung các key sau:</p> <ul> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.BaseURI" value="https://apg-stg.napas.com.vn/" /> : Cấu hình địa chỉ hệ thống NAPAS</li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.ClientId" value="VIETSENS" /> : Cấu hình thông tin ClientId do NAPAS cung cấp</li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.ClientSecret" value="b3huAXe6bVStMfTBspgbGerXBy7t4SF7" /> : Cấu hình thông tin ClientSecret do NAPAS cung cấp</li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.UrlCreateOrder" value="private/ms/pg-paygate/paygate/v2/create-order" /></li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.PublicCertPath" value="D:\\BACKEND\\MOS\\File\\Napas\\cert_verify.cer" />: Cấu hình đường dẫn chính xác đến vị trí file chứng thư(*.cer) public do bên NAPAS cung cấp. File này được dùng để verify (kiểm tra) dữ liệu do ngân hàng trả về khi thực hiện quét mã Qr và thanh toán. Ví dụ: D:\\BACKEND\\MOS\\File\\Napas\\cert_verify.cer</li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.PrivateCertPath" value="D:\\BACKEND\\MOS\\File\\Napas\\ach-clientcert-vietsens-to-apg.cer" />: Cấu hình đường dẫn chính xác đến vị trí file chứng thư (*.cer) private của bệnh viện. File này được dùng để ký số trên mỗi giao dịch và gửi kết quả cho NAPAS. Ví dụ: D:\\BACKEND\\MOS\\File\\Napas\\ach-clientcert-vietsens-to-apg.cer</li> <li aria-level="1" dir="ltr"><add key="MOS.MANAGER.NAPAS.PrivateCertPass" value="123456" />: Cấu hình mật khẩu tương ứng của chứng thư (*.cer) private của bệnh viện</li> </ul> <h3 role="presentation" dir="ltr"> </h3> <h3 role="presentation" dir="ltr">Hướng dẫn tạo chứng thư số</h3> <p dir="ltr">Bước 1: Cài đặt phần mềm Win64OpenSSL-1_1_1g.msi</p> <p dir="ltr">Bước 2:  Chạy cmd với quyền Administrator(Run cmd as administrator)</p> <p dir="ltr">Bước 3:  Vào thư mục bin của Open SSL chạy các lênh sau :</p> <ul> <li dir="ltr"> <p>#Tạo key, csr và self sign</p> <ul> <li dir="ltr"> <p>openssl genrsa -out dvptml.key 2048</p> </li> <li dir="ltr"> <p>openssl req -key dvptml.key -new -out dvptml.csr</p> </li> </ul> </li> <li dir="ltr"> <p>Tự ký csr</p> <ul> <li dir="ltr"> <p>openssl x509 -signkey dvptml.key -in dvptml.csr -req -days 3650 -out dvptml.crt</p> </li> </ul> </li> <li dir="ltr"> <p>File dvptml.crt và dvptml.csr chính là file cần gửi cho NAPAS</p> <p> </p> </li> </ul> <h3 role="presentation" dir="ltr">Cách sử dụng key trên các biểu in (phiếu chỉ định,...)</h3> <ul> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">Key <#PAYMENT_QR_CODE_DYNAMIC;>: Hình ảnh mã QR để bệnh nhân thanh toán</p> </li> <li aria-level="1" dir="ltr"> <p role="presentation" dir="ltr">Key <#PAYMENT_AMOUNT;>: Số tiền tương ứng với mã QR</p> </li> </ul>

Nội dung

Tệp đính kèm