NGHIỆP VỤ KẾT NỐI THẺ Y TẾ MB

NGHIỆP VỤ KẾT NỐI THẺ Y TẾ MB MỤC LỤC TÍNH NĂNG SẢN PHẨM THẺ Y TẾ .3 a Tính ngân hàng b Tính bệnh viện (Triển khai phần mềm HIS bệnh viện) API ĐỊNH DANH THẺ Y TẾ a Mô tả chung b Luồng quy trình nghiệp vụ c Luồng quy trình tích hợp 10 API NẠP TIỀN TẠI BỆNH VIỆN 15 a Mô tả chung .15 b Luồng quy trình nghiệp vụ 15 c Luồng quy trình tích hợp 16 API HOÀN TIỀN TỪ BỆNH VIỆN .22 a Mô tả chung .22 b Luồng quy trình nghiệp vụ 22 c Luồng quy trình tích hợp 24 API THANH TỐN VIỆN PHÍ 28 a Mô tả chung .28 b Luồng quy trình nghiệp vụ 28 c Luồng quy trình tích hợp 29 API PHÁT HÀNH LẠI THẺ Y TẾ 34 a Mô tả chung .34 b Luồng quy trình nghiệp vụ 34 c Luồng quy trình tích hợp 36 API PHÁT HÀNH LẠI PIN/MỞ KHÓA THẺ THẺ Y TẾ 45 a Mô tả chung .45 b Luồng quy trình nghiệp vụ 45 c Luồng quy trình tích hợp 46 TÍNH NĂNG SẢN PHẨM THẺ Y TẾ a Tính ngân hàng i) Tính sản phẩm thẻ y tế - Thẻ định danh Tiêu chí ATM MB NH Khác POS POS MB CDM POS NH Khác APP MB Quầy CN/ PGD MB  Nạp tiền Rút tiền mặt   Vấn tin số dư   Sao kê GD gần  Đổi PIN   Chi tiêu              Thẻ vô danh Tiêu chí ATM MB NH Khác POS POS MB CDM POS NH Khác APP MB  Quầy CN/ PGD MB  Nạp tiền Rút tiền mặt Vấn tin số dư    Thanh tốn viện phí -     Quầy bệnh viện   Quầy bệnh viện  Sao kê GD gần  Đổi PIN    Chi tiêu       Thanh tốn viện phí ii) Hạn mức thẻ y tế - Thẻ định danh  Số dư:  Số dư tối thiểu: VNĐ  Số dư tối đa: Không giới hạn  Nạp tiền:  Số lần nạp tiền vào TK: Không giới hạn  Số tiền nạp tối đa: Không giới hạn  Rút tiền mặt ATM:  Số tiền tối đa/ ngày: 20.000.000 VNĐ  Số tiền tối đa/1 lần: 5.000.000 VNĐ  Số tiền tối thiểu/1 lần: 10.000 VNĐ  Số lần giao dịch/ngày: 20 lần  Rút tiền mặt Quầy: Giới hạn theo số dư thẻ  Chuyển khoản App MB/eMB: Theo hạn mức  Tối thiếu giao dịch: 50.000VNĐ  Tối đa giao dịch 500.000.000VNĐ  Chuyển khoản POS:  Chuyển khoản qua POS tối đa/ngày : 20.000.000 VNĐ  Chuyển khoản qua POS tối đa/lần : 20.000.000 VNĐ  Chuyển khoản qua POS tối thiểu/lần : 10.000 VNĐ  Số lần giao dịch/ngày: 20 lần  Chi tiêu POS:  Chi tiêu POS tối đa/ngày: 20.000.000 VNĐ  Chi tiêu qua ATM/POS tối đa/lần: 20.000.000 VNĐ  Thanh tốn viện phí: Khơng hạn chế - Thẻ vơ danh  Số dư:  Số dư tối thiểu:  Số dư tối đa:  Nạp tiền VNĐ 5.000.000 VNĐ     Số lần nạp tiền vào TK: Không giới hạn  Số tiền nạp tối đa: 5.000.000 VNĐ/Lần Rút tiền mặt ATM, Quầy  Không Cho phép Chuyển khoản POS  Chuyển khoản qua POS tối đa/ngày : Không phép  Chuyển khoản qua POS tối đa/lần : Không phép  Chuyển khoản qua POS tối thiểu/lần : Không phép  Số lần giao dịch/ngày: Không phép Chi tiêu POS:  Chi tiêu POS tối đa/ngày: 5.000.000 VNĐ  Chi tiêu qua ATM/POS tối đa/lần: hạn mức 5.000.000 VNĐ Thanh tốn viện phí: Khơng hạn chế  iii) Luồng phát hành thẻ đối tác - Lưu đồ QUY TRÌNH PHÁT HÀNH THẺ Y TẾ ĐỐI TÁC MBBANK QUY TRÌNH PHÁT HÀNH THẺ Y TẾ Start Gửi yêu cầu PHT theo lô ITMB Thực tạo lô thẻ TTVHT chạy mã hóa thẻ TTVHT Nhập kho (IT Hỗ Trợ) Nhận file DL dập thẻ TTVHT Xuất kho (IT Hỗ Trợ) Kết thúc - Diễn giải lưu đồ : MB thực phát hành thẻ theo lô theo yêu cầu đối tác - Phát hành trước - theo trình tự sau  Bước 1: Gửi yêu cầu phát hành thẻ theo lô  Đối tác gửi sang MB (Phòng Kinh doanh – NHS) yêu cầu phát hành lơ thẻ (Có cơng văn xác nhận lãnh đạo đơn vị);  Phòng Kinh doanh – NHS gửi yêu cầu sang IT (yêu cầu tạo lơ thẻ) TTVHT (Thực chạy mã hóa thẻ)  Bước 2: IT MB thực tạo lô thẻ  IT Thực tạo lô thẻ theo yêu cầu NHS  Thông tin lô thẻ bao gồm thông tin sau: Tên KH (Mặc định BankPlus S) ||Số thẻ || ID Thẻ || Số Serial || Ngày phát hành || Ngày Update (Ngày mã hóa) || Người phát hành (Tên User tạo lơ thẻ)  Bước 3: Trung tâm vận hành thẻ chạy mã hóa thẻ sau IT tạo xong lơ thẻ  Lưu ý: Không chạy bước in PIN  Bước + 5: Trung tâm vận hành thẻ thực nhập kho  Nhập kho Trên CardPortal  Xuất kho (Cập nhật trạng thái thẻ chờ khách hàng tự kích hoạt CardPortal)  Bước 6: Trung tâm vận hành thẻ gửi file dập thẻ sang đối tác qua email (File dập thẻ phải mã hóa trước chạy); iv) Luồng phát hành thẻ MB - Lưu đồ QUY TRÌNH PHÁT HÀNH THẺ Y TẾ ĐỐI TÁC MBBANK QUY TRÌNH PHÁT HÀNH THẺ Y TẾ Start Gửi yêu cầu PHT theo lô ITMB Thực tạo lơ thẻ TTVHT chạy mã hóa thẻ TTVHT Nhập kho (IT Hỗ Trợ) Nhận lô thẻ TTVHT Dập thẻ Xuất kho (IT Hỗ Trợ) Kết thúc - Diễn giải lưu đồ  Bước 1: Gửi yêu cầu phát hành thẻ theo lô  Đối tác gửi sang MB (Phòng Kinh doanh – NHS) yêu cầu phát hành lơ thẻ (Có cơng văn xác nhận lãnh đạo đơn vị);  Phòng Kinh doanh – NHS gửi yêu cầu sang IT (yêu cầu tạo lơ thẻ) TTVHT (Thực chạy mã hóa thẻ)  Bước 2: IT MB thực tạo lô thẻ  IT Thực tạo lô thẻ theo yêu cầu NHS  Thông tin lô thẻ bao gồm thông tin sau: Tên KH (Mặc định BankPlus S) ||Số thẻ || ID Thẻ || Số Serial || Ngày phát hành || Ngày Update (Ngày mã hóa) || Người phát hành (Tên User tạo lô thẻ)  Bước 3: Trung tâm vận hành thẻ chạy mã hóa thẻ sau IT tạo xong lô thẻ  Bước + 5: Trung tâm vận hành thẻ thực nhập kho  Nhập kho Trên CardPortal  TTVH Thực dập liệu thẻ y tế  Xuất kho (Cập nhật trạng thái thẻ chờ khách hàng tự kích hoạt CardPortal)  Bước 6: Đối tác nhận liệu thẻ chuyển đến bệnh viện phát hành; b Tính bệnh viện (Triển khai phần mềm HIS bệnh viện) - Định danh thẻ y tế - Nạp tiền vào thẻ y tế - Hoàn tiền từ bệnh viện vào thẻ y tế - Thanh tốn viện phí bệnh viện - Phát hành lại thẻ y tế bệnh viện - Phát hành lại PIN bệnh viện - Khóa thẻ tạm thời - Mở khóa thẻ tạm thời API ĐỊNH DANH THẺ Y TẾ a Mô tả chung - Khách hàng đến khám chữa bệnh bệnh viện có nhu cầu mở thẻ y tế - Nhân viên bệnh viện thực lấy thẻ in thông tin bệnh nhân lên thẻ Sau vào phần mềm HIS bệnh viện gửi yêu cầu định danh tới Ngân hàng - Sau định danh xong, thẻ khách hàng sử dụng tính bệnh viện ngân hàng mục 1.a mục 1.b b Luồng quy trình nghiệp vụ - Lưu đồ Luồng định danh thẻ trả trước y tế ĐỐI TÁC MB Start N Gửi thông tin thẻ yêu cầu định danh Validate thông tin thẻ trả trước Trả lỗi thẻ không hợp lệ Trả lỗi thẻ định danh 8.3 Ktra họ tên KH có khớp thơng tin? Y N Y Có phải thẻ y tế trả trước? 8.2 Ktra số CMND KH có tồn HT Y Y Thẻ định danh? N N 10.Mở thẻ định danh Y N 8.4 KH có thẻ y tế đối tác? Y 8.KH có thơng tin GTTT? N 9.Mở thẻ vơ danh Hiển thị KQ 14 Trả kết định danh thành cơng N 12 KH có đăng ký SĐT? 11.Kích hoạt cập nhật thông tin thẻ Y 13 Reset PIN gửi SMS cho khách hàng End Phase 8.5 Trả lối định danh thất bại - Diễn giải lưu đồ  Bước 1: Hệ thống đối tác (Onelink/ISHOFH/…) gửi thông tin thẻ y tế yêu cầu thực định danh, Thông tin gửi sang MB bao gồm thông tin sau:  Số thẻ (M)  Mã bệnh nhân (M)  Mã bệnh viện (M)  Mã chi nhánh phát hành thẻ (M)  Tên khách hàng (M)  Số GTTT, ngày cấp, nơi cấp (O)  Số điện thoại (O)  Email (O)  Ngày sinh, giới tính (O)  Mã giao dịch (Request id) (M)  Bước + + + + 7: Validate thông tin thẻ trả trước  Hệ thống MB kiểm tra xem thẻ có tồn hay khơng? (Dựa vào số thẻ để kiểm tra)  Nếu thẻ không tồn tại, trả thông báo lỗi “Thẻ không tồn tại, vui lòng kiểm tra lại”; Chuyển sang bước 5: Hiển thị kết lỗi cho khách hàng  Nếu thẻ tồn chuyển sang bước để check;  Số thẻ có phải thẻ trả trước hay khơng? (Dựa vào đầu BIN thẻ)        Nếu đầu BIN thẻ 97042291, Trả thông báo lỗi “Thẻ thẻ y tế, vui lòng kiểm tra lại”; Chuyển sang bước 5: Hiển thị kết lỗi cho khách hàng  Nếu đầu BIN thẻ thẻ y tế - 97042291, Chuyển sang bước để check;  Hệ thống MB kiểm tra xem thẻ định danh hệ thống hay chưa? (Dựa vào số thẻ)  (1) Nếu thẻ trạng thái thẻ Contract Status PIN BLOCKED, trả thông báo lỗi, chuyển sang bước “Thẻ định danh, không phép định danh lại Vui lịng kiểm tra lại thơng tin thẻ”  (2) Nếu Trạng thái thẻ Contract Status = PIN BLOCKED cho phép chuyển sang bước để định danh thẻ Bước 8: Hệ thống kiểm tra thông tin gửi định danh có có giấy tờ tùy thân chuyển sang khơng?  Nếu khơng có giấy tờ tùy thân, MB thực mở thẻ vô danh, chuyển sang bước – Mở thẻ vơ danh cho KH  Nếu có giấy tờ tùy thân, hệ thống chuyển sang bước 8.2 để kiểm tra tiếp KH có tồn hệ thống chưa Bước 8.2: Hệ thống kiểm tra tiếp KH có thơng tin hệ thống chưa?  Nếu KH có thơng tin hệ thống chuyển sang bước 8.3 để kiểm tra  Nếu KH chưa có thơng tin hệ thống chuyển sang bước 10 Bước 8.3: Nếu KH có tồn số GTTT có thơng tin hệ thống hệ thống kiểm tra tiếp họ tên KH có trùng khớp không?  Nếu họ tên KH khớp thông tin định danh hệ thống chuyển sang bước 8.4  Nếu họ tên KH không khớp thơng tin định danh hệ thống chuyển sang bước 8.5 “Thông tin định danh không trùng khớp, vui lòng kiểm tra lại.” Bước 8.4: Kiểm tra tiếp trường hợp KH có có thẻ y tế đối tác khơng?  Nếu KH chưa có thẻ y tế có thẻ y tế (đầu pin 97042291) đối tác khác chuyển sang bước 10  Nếu KH có thẻ y tế (đầu pin 97042291) đối tác gửi yêu cầu định danh chuyển sang bước 8.5 hiển thị lỗi định danh “Khách hàng có thẻ y tế, vui lịng kiểm tra lại thơng tin.” Bước 8.5: Sau MB trả kết về, đối tác thẻ y tế hiển thị kết lỗi định danh cho khách hàng; Bước 9: MB thực mở thẻ vô danh:  Tạo client với thông tin lấy từ input đối tác truyền sang  Gắn thẻ sang client  KH khơng có CMND CMND fix theo nguyên tắc: YTE00001+ID client ảo  Update thông tin thẻ: Mã bệnh nhân (client_address.add_info: tag patientCode), Mã bệnh viện (client_address.add_info: tag merchantID), CNPH thẻ (client_address.add_info: tag ISSUE_BRANCH), Tên bệnh nhân (Contract_info.Contract), có trường lưu kênh định danh thẻ = Mã đối tác  Update trạng thái thẻ: Contract Status = Card OK, Plastic Status = Locked -> Active, Prod Status = Locked -> Ready  Chuyển sang bước 11;  Bước 10: MB thực mở thẻ định danh cho khách hàng: Dựa vào CMND để kiểm tra xem KH có Client hay chưa?  Nếu Client chưa tồn tại: Tạo client với thông tin lấy từ input, gắn thẻ sang client  Nếu Client tồn chưa gắn thẻ y tế kênh xét, trạng thái thẻ y tế Card Closed: gắn thẻ sang client  Update thông tin thẻ: Mã bệnh nhân (client_address.add_info: tag patientCode), Mã bệnh viện (client_address.add_info: tag merchantID), CNPH thẻ (client_address.add_info: tag ISSUE_BRANCH), Tên bệnh nhân (Contract_info.Contract), có trường lưu kênh định danh thẻ = Mã đối tác  Update trạng thái thẻ: Contract Status = Card OK, Plastic Status = Locked -> Active, Prod Status = Locked -> Ready  Update trạng thái định danh thẻ phần Add Packs: Chỉ add packs KH có CMND  Chuyển sang bước 11:  Bước 11: Kích hoạt cập nhật thơng tin thẻ: MB thực kích hoạt thẻ thực Update thông tin sau:  Update thẻ Way4: Plastic Status = Locked -> Active, Prod Status = Locked -> Ready  Update trạng thái thẻ trừ kho thẻ phần mềm Quản lý thẻ PIN (DB Card Portal)  Bước 12+13+14: Hệ thống kiểm tra xem khách hàng có điện thoại hay khơng?  Nếu khách hàng có số điện thoại: MB thực reset PIN cho khách hàng gửi PIN vào số điện thoại khách hàng đăng ký; Cấu trúc gửi PIN cho khách hàng theo format sau: THE [970422XXXXXX1234] DA DUOC KICH HOAT THANH CONG MA PIN SU DUNG DE THANH TOAN LA [XXXXXX] CAM ON QUY KHACH DA SU DUNG DICH VU THE MB HOTLINE: 1900545426 Lưu ý: Số PIN ngẫu nhiên hệ thống tự động sinh  Nếu khách hàng khơng có số điện thoại: Khơng thực reset PIN cho khách hàng;  Trả thông báo kết định danh thành công tới khách hàng c Luồng quy trình tích hợp Field name Input : Description Type Lengt h M/O Source System System Field IssueDate Supply date, format yyyy-MMdd'T'HH:mm:ss DateTime 20 O IssuedBy Supply place String 32 O PhoneNumber Phone number String 20 M ActionType There are actions of cards: String - - M Reset PIN : REISSUE_PIN_VAL Unlock Card: UNLOCK_VAL Output Field name Description Type Length M/O Header Same as Input Object M ResponseStatus Contains the response status of service Object M >Status Status of SOA operation String M >ErrorInfo : has error : success Contains the error information These error normally come from backend(s) String O >>ErrorCode Error code String O >>ErrorDesc Error message String O >>ErrorDetail Error detail String O Source System Body - ResponseCode ResponseCode Message SOA Error Mapping Fail case 000 Không lỗi, thực thao tác thành công 001 Invalid checksum 246 002 Invalid client ID! 247 003 Duplicate request ID! 404 004 Service not declare in config! 005 Client ID is not granted! 423 006 Client ID is not granted to this service! 494 007 Not support this card type 4080 4081 System Field 009 Merchant not config in bank 492 010 Required missing field 248 011 CardNumber not found 231 012 CardNumber and CustomerID doesn’t match 249 014 Convert card number to ID error 4082 015 Error when call get card info 4088 099 Input fields is not valid! 100 Could not send SMS 4083 101 Could not get OTP 4084 102 Reg number not match 204 103 Mobile number not match with card number 250 104 Channel not match with card number 251 105 Card status not valid 252 999 System error 500 - 203 Example :  Mở khóa thẻ  Input esbtest42 12115562442 t24 9704229100022677 8888554646649 BV010001 131590240 0907809333 UNLOCK_VAL  Output MBCardService.CardPayment changeCardStatus 1.0 changeCardStatus esbtest42 4448d6fa-9cee-47ae-9a9d4d3bc3404c67 12115562442 2019-11-07T09:30:45.394 t24 0 Success Successful  Phát hành lại PIN  Input esbtest43 12115562443 t24 9704229100022677 8888554646649 BV010001 131590240 0907809333 REISSUE_PIN_VAL  Output MBCardService.CardPayment changeCardStatus 1.0 changeCardStatus esbtest43 2cd4edd9-32d8-478c-8c22b1cff94f92e8 12115562443 2019-11-07T09:34:01.289 t24 0 Success Successful ii) Gửi Confirm (Xác thực OTP) - Input Field name Description Type Lengt h Header Input header Object M >Common Common information Object M >>BusinessDomain Business domain String O >>ServiceName Name of service String O >>ServiceVersion Version of service to invoke String O >>OperationName Name of operation String O >>ClientMessageId This is message id generated by service consumer String >>ServiceMessageId This is message id generated by ESB String 40 M/O M O Source System System Field >>TransactionId The transaction ID of the application It might be: String 30 M/O - >>MessageTimestamp >>AdditionalInformation Session id of the web application A sequence indicates unique number of the client Login session id The timestamp of the message being created and sent to messaging system Additional information that is not provided by standard header can be added a pairs (name and value) >>>NameValuePairs String O Object O DocumentList O >>>>Name Field name String O >>>>Value Value of name String O >Client External information Object O >>SourceAppID Unique Application Idendification to identify Source/Client application or system within an Organization, e.g “mcredit”, “mbal”, … String M >>TargetAppIDs Unique Application Idendification to identify Source/Client application or system within an Organization, e.g “T24”, “WAY4”, … String O CardNumber Card number String 16 M PatientId Patient code String 16 O ClinicId Clinic code String O BranchCode Branch code String O CustomerName Name of customer String 35 O IdentityCard Identity card number String 20 M IssueDate Supply date, format yyyy-MMdd'T'HH:mm:ss DateTime 20 O IssuedBy Supply place String 32 O PhoneNumber Phone number String 20 M ActionType There are actions of confirm: String Body - - Reset PIN : REISSUE_PIN_CONFIR M Lock Card : LOCK Unlock Card Confirm : UNLOCK_CONFIRM M OTP OTP - String M Output Field name Description Type Length M/O Header Same as Input Object M ResponseStatus Contains the response status of service Object M >Status Status of SOA operation String M >ErrorInfo : has error : success Contains the error information These error normally come from backend(s) String O >>ErrorCode Error code String O >>ErrorDesc Error message String O >>ErrorDetail Error detail String O Source System Body - ResponseCode ResponseCode Message SOA Error Mapping Fail case 000 Không lỗi, thực thao tác thành công 001 Invalid checksum 246 002 Invalid client ID! 247 003 Duplicate request ID! 404 004 Service not declare in config! 005 Client ID is not granted! 423 006 Client ID is not granted to this service! 494 007 Not support this card type 4081 008 Error when call makeTransfer T24 4088 009 Merchant not config in bank 492 010 Required missing field 248 011 CardNumber not found 231 012 CardNumber and CustomerID doesn’t match 249 014 Convert card number to ID error 4080 4082 System Field 015 Error when call get card info 099 Input fields is not valid! 203 102 Reg number not match 204 103 Mobile number not match with card number 250 104 Channel not match with card number 251 105 Card status not valid 252 110 OTP invalid or expired 237 111 Verify OTP error 999 System error 500 403 Card is locked 236 - 4088 4085 Example code  Khóa thẻ  Input esbtest31 15562434931 t24 9704229100022677 8888554646649 BV010001 131590240 0907809333 LOCK 123456  OutPut MBCardService.CardPayment confirmChangeCardStatus 1.0 confirmChangeCardStatus esbtest31 08b545ee-ba8c-45af-b20681e2a9eb370b 15562434931 2019-11-07T09:14:21.499 t24 0 Success Successful  Mở khóa thẻ  Input esbtest32 15562434932 t24 9704229100022677 8888554646649 BV010001 131590240 0907809333 UNLOCK_CONFIRM 74667956  OutPut MBCardService.CardPayment confirmChangeCardStatus 1.0 confirmChangeCardStatus esbtest32 310f17ee-f3aa-4d53-949d38d94594ab90 15562434932 2019-11-07T09:25:19.412 t24 1 301 Error mapping doesn't exist 000 - Successful  Phát hành lại PIN  Input esbtest35 15562434935 t24 9704229100022677 8888554646649 BV010001 131590240 0907809333 REISSUE_PIN_CONFIRM 88738343  Output MBCardService.CardPayment confirmChangeCardStatus 1.0 confirmChangeCardStatus esbtest35 5fbc46d9-4b23-49d5-8e6f36d27c130c1b 15562434935 2019-11-07T09:36:22.530 t24 0 Success Successful