Công văn 3617/BYT-KCB năm 2023 về cập nhật API và đôn đốc liên thông dữ liệu Giấy chứng sinh, Giấy báo tử lên Cổng giám định bảo hiểm y tế triển khai Đề án 06 trên phạm vi toàn quốc do Bộ Y tế ban hành
| Số hiệu | 3617/BYT-KCB |
| Ngày ban hành | 13/06/2023 |
| Ngày có hiệu lực | 13/06/2023 |
| Loại văn bản | Công văn |
| Cơ quan ban hành | Bộ Y tế |
| Người ký | Trần Văn Thuấn |
| Lĩnh vực | Công nghệ thông tin,Thể thao - Y tế |
|
BỘ Y TẾ |
CỘNG HÒA XÃ
HỘI CHỦ NGHĨA VIỆT NAM |
|
Số: 3617/BYT-KCB |
Hà Nội, ngày 13 tháng 6 năm 2023 |
|
Kính gửi: |
- Giám đốc bệnh viện trực thuộc Bộ Y
tế và Trường đại học; |
Tiếp theo Công văn số 1165/BYT-KCB ngày 8/03/2023 về việc liên thông dữ liệu Giấy chứng sinh, Giấy báo tử lên Cổng giám định BHYT triển khai Đề án 06, để đảm bảo yêu cầu kỹ thuật liên thông với Cổng dịch vụ công Quốc gia chuẩn bị thực hiện trên toàn quốc 2 nhóm dịch vụ công trực tuyến: “1- Đăng ký khai sinh, Đăng ký thường trú, cấp thẻ BHYT cho trẻ dưới 6 tuổi” và “2- Đăng ký khai tử, Xóa đăng ký thường trú, Trợ cấp mai táng phí”, Bộ Y tế đề nghị các cơ quan, đơn vị chỉ đạo các cơ sở khám chữa bệnh thực hiện các nội dung sau:
1. Đối với các đơn vị đang liên thông dữ liệu giấy chứng sinh, giấy báo tử qua API: Sửa đổi API liên thông dữ liệu giấy chứng sinh, và giấy báo tử để tách địa chỉ nơi sinh, nơi tử vong thành 4 cấp Tỉnh/ Huyện/ Xã/ Địa chỉ đầy đủ, cụ thể như sau (có trong Phụ lục đính kèm công văn):
a) Đối với API tiếp nhận dữ liệu Giấy chứng sinh: Chỉ tiêu số 28 NOI_SINH_CON Ghi địa chỉ nơi con được sinh ra theo cấu trúc: {mã tỉnh}:{mã huyện (nếu tỉnh không có huyện thì thay bằng dấu _)}:{mã xã (nếu huyện không có xã thì thay bằng dấu _)}:{địa chỉ full text có cả tên tỉnh huyện xã theo chuẩn chung}. Trong đó, mã tỉnh, huyện, xã tra cứu theo bảng mã của Tổng cục Thống kê.
Ví dụ: 01:006:00232:78 đường Giải Phóng, phường Phương Mai, quận Đống Đa, Hà Nội
b) Đối với API tiếp nhận dữ liệu Giấy báo tử: Chỉ tiêu số 35 DIACHI_CSKCB ghi Địa chỉ Cơ sở khám bệnh, chữa bệnh theo cấu trúc: {mã tỉnh}:{mã huyện (nếu tỉnh không có huyện thì thay bằng dấu _)}:{mã xã (nếu huyện không có xã thì thay bằng dấu _)}:{địa chỉ full text có cả tên tỉnh huyện xã theo chuẩn chung}. Trong đó, mã tỉnh, huyện, xã tra cứu theo bảng mã của Tổng cục Thống kê.
Ví dụ: 01:006:00232:78 đường Giải Phóng, phường Phương Mai, quận Đống Đa, Hà Nội
2. Đối với các cơ sở khám chữa bệnh nhập trực tiếp và ký số trên phần mềm Cổng giám định BHYT: phải nhập tách riêng các trường thành 4 cấp Tỉnh/ Huyện/ Xã/ Địa chỉ đầy đủ, theo như thiết kế trên phần mềm.
3. Thời gian liên thông dữ liệu lên cổng giám định BHYT không quá 04 giờ sau khi cấp bản giấy. Đề nghị cơ sở khám chữa bệnh bổ sung tính năng, hoặc trang bị phần mềm, chứng thư số để liên thông theo hình thức qua API để đảm bảo tính chính xác của dữ liệu, bảo đảm thời gian liên thông dữ liệu và tiết kiệm nhân lực.
4. Thời gian dự kiến triển khai trên phạm vi toàn quốc 2 nhóm dịch vụ công trực tuyến liên quan đến giấy chứng sinh và giấy báo tử là trong tháng 6 (Bộ Công An sẽ có thông báo chính thức sau). Đề nghị các cơ quan, đơn vị chỉ đạo các cơ sở khám chữa bệnh trực thuộc có cấp giấy chứng sinh, giấy báo tử bảo đảm liên thông dữ liệu tất cả giấy chứng, sinh, và giấy báo tử đã cấp theo hướng dẫn của Bộ Y tế để phục vụ nhân dân.
Sở Y tế các tỉnh, thành phố, Y tế ngành phân công cán bộ để theo dõi, đôn đốc, giám sát hỗ trợ các cơ sở khám chữa bệnh trực thuộc trong quá trình triển khai thực hiện, báo cáo kết quả, khó khăn, vướng mắc (nếu có) về Bộ Y tế để xem xét, giải quyết./.
|
|
KT. BỘ
TRƯỞNG |
CẬP
NHẬT API LIÊN THÔNG DỮ LIỆU GIẤY CHỨNG SINH, GIẤY BÁO TỬ
(Ban hành kèm theo công văn số 3617/BYT-KCB ngày 13
tháng 6 năm 2023 của Thứ trưởng Bộ Y tế)
|
Địa chỉ |
https://egw.baohiemxahoi.gov.vn/api/token/take |
|
Operation |
POST |
|
Request header |
|
|
ContentType |
application/json |
|
Request Body |
|
|
Body |
{ username: Tên đăng nhập hệ thống BHXH cung cấp, password: Mật khẩu hệ thống BHXH cung cấp, được mã hóa MD5, } |
|
Response Body |
|
|
Body |
{ maKetQua: 200 - thành công, APIKey: { access_token: token của phiên đăng nhập, id_token: ID của token, token_type: Bearer, username: Tên đăng nhập hệ thống BHXH cung cấp, expires in: thời gian hết phiên đăng nhập(theo giờ quốc tế) } } |
2. API tiếp nhận dữ liệu Giấy chứng sinh
2.1. Mô tả bản tin
|
Địa chỉ |
https://egw.baohiemxahoi.gov.vn/api/hososuckhoe/guigiaytodientu |
|
Operation |
POST |
|
Request header |
|
|
ContentType |
application/json |
|
Authorization |
Token lấy từ API |
|
Request Body |
|
|
Body |
{ maCskcb: Mã cơ sở khám chữa bệnh token: Token lấy ở bước 1 id_token: Id token lấy ở bước 1 username: Tên đăng nhập được BHXH cung cấp password: Mật khẩu hệ thống BHXH cung cấp, được mã hóa MD5 loaiHs: mặc định điền 61 fileBase64Str: chuỗi base64 file XML giấy chứng sinh đã được ký số } |
|
Response Body |
|
|
Body |
{ MaKetQua: Mã kết quả, 200 nếu thành công MaGD: Mã giao dịch nếu tiếp nhận thành công ThoiGianTiepNhan: Thời điểm tiếp nhận(định dạng yyyyMMddHHmmss) } |
2.2. Mô tả cấu trúc dữ liệu
|
STT |
Chỉ tiêu |
Kiểu dữ liệu |
Bắt buộc |
Kích thước tối đa |
Diễn giải |
|
1 |
MA_GCS |
Chuỗi |
x |
18 |
Mã giấy chứng sinh được quản lý tại cơ sở khám chữa bệnh theo quy định của Bộ Y tế, mã gồm 18 ký tự theo định dạng XXXXX.GCS.ZZZZZ.YY Trong đó
Ví dụ: 00005.GCS.01924.22 |
|
2 |
MA_BN |
Chuỗi ký tự |
x |
200 |
Mã bệnh nhân quản lý tại cơ sở khám chữa bệnh |
|
3 |
MA CT |
Chuỗi ký tự |
|
200 |
Mã chứng từ phục vụ việc quản lý nội bộ của cơ sở khám chữa bệnh |
|
4 |
SO_SERI |
Chuỗi ký tự |
|
200 |
Số mã hóa định danh do BHXH thiết lập |
|
5 |
MA_BHXH_NND |
Chuỗi ký tự |
x |
10 |
Mã số BHXH của mẹ hoặc người nuôi dưỡng. Trang hỗ trợ tra cứu mã số BHXH https://baohiemxahoi.gov.vn/Pages/default.aspx. |
|
6 |
MA_THE_NND |
Chuỗi ký tự |
|
15 |
Mã thẻ BHYT của mẹ hoặc người nuôi dưỡng |
|
7 |
HOTEN_NND |
Chuỗi ký tự |
x |
200 |
Họ và tên của mẹ hoặc người nuôi dưỡng |
|
8 |
NGAYSINH_NND |
Chuỗi ký tự |
x |
12 |
Ngày sinh của mẹ hoặc người nuôi dưỡng, định dạng yyyyMMdd hoặc yyyy, với yyyy là năm sinh, MM là tháng sinh, dd là ngày sinh |
|
9 |
MA_DANTOC_NND |
Chuỗi ký tự |
x |
10 |
Ghi mã dân tộc của mẹ hoặc người nuôi dưỡng theo Danh mục các dân tộc Việt Nam ban hành kèm theo Quyết định số 121-TCTK/PPCĐ ngày 02 tháng 3 năm 1979 của Tổng cục trưởng Tổng cục Thống kê để điền chi tiết). Tra cứu mã dân tộc tại đường link: http://tongdieutradanso.vn/danh-muc-cac-dan-toc-viet-nam.html |
|
10 |
MA_QUOCTICH_NND |
Chuỗi ký tự |
x |
10 |
Ghi mã quốc tịch của mẹ hoặc người nuôi dưỡng theo quy định tại Phụ lục 2 Thông tư số 07/2016/TT-BCA ngày 01 tháng 2 năm 2016 của Bộ trưởng Bộ Công an. |
|
11 |
LOAI_GIAYTO_NND |
Số |
x |
1 |
Loại giấy tờ (1=CCCD, 2=CMND, 3= Hộ chiếu). |
|
12 |
SO_CCCD_NND |
Chuỗi ký tự |
x |
15 |
Số CMND/ Căn cước công dân/Hộ chiếu của mẹ hoặc người nuôi dưỡng |
|
13 |
NGAYCAP_CCCD_NND |
Chuỗi ký tự |
x |
8 |
Ngày cấp CMND/ Căn cước công dân/Hộ chiếu của mẹ hoặc người nuôi dưỡng, định dạng yyyyMMdd |
|
14 |
NOICAP_CCCD_NND |
Chuỗi ký tự |
x |
1024 |
Nơi cấp CMND/ Căn cước công dân/Hộ chiếu của mẹ hoặc người nuôi dưỡng |
|
15 |
NOI_CU_TRU_NND |
Chuỗi ký tự |
x |
1024 |
Ghi địa chỉ nơi cư trú hiện tại của mẹ hoặc người nuôi dưỡng. Lưu ý: - Nếu là người Việt Nam: Ghi địa chỉ nơi cư trú theo địa danh 4 cấp: Thôn/bản, xã/phường/thị trấn, quận/huyện/ thành phố thuộc tỉnh, tỉnh/thành phố trực thuộc trung ương; - Trường hợp người nước ngoài có địa chỉ nơi cư trú tại Việt Nam thì ghi giống như người Việt Nam; - Trường hợp người nước ngoài không có địa chỉ nơi cư trú tại Việt Nam nhưng sinh đẻ tại cơ sở y tế của Việt Nam thì ghi tên tỉnh/thành phố/bang và quốc gia nơi họ đang sinh sống. |
|
16 |
MATINH_CU_TRU |
Chuỗi ký tự |
x |
2 |
Mã đơn vị hành chính cấp tỉnh nơi cư trú hiện tại của mẹ hoặc người nuôi dưỡng. Ghi theo 02 ký tự cuối của mã đơn vị hành chính của tỉnh, thành phố trực thuộc Trung ương nơi người bệnh cư trú (Quy định tại Phụ lục 1 Thông tư số 07/2016/TT-BCA ngày 01 tháng 2 năm 2016 của Bộ trưởng Bộ Công an). |
|
17 |
MAHUYEN_CU_TRU |
Chuỗi ký tự |
x |
3 |
Mã huyện thường trú mẹ hoặc người nuôi dưỡng bảng mã của Tổng cục Thống kê |
|
18 |
MAXA_CU_TRU |
Chuỗi ký tự |
x |
5 |
Mã xã thường trú mẹ hoặc người nuôi dưỡng bảng mã của Tổng cục Thống kê |
|
19 |
HO_TEN_CHA |
Chuỗi ký tự |
|
255 |
Ghi họ và tên cha (bố) của trẻ được cấp giấy chứng sinh. |
|
20 |
MA_THE_TAM |
Chuỗi ký tự |
|
15 |
Ghi mã thẻ BHYT tạm thời của người con. Cơ sở KBCB sử dụng chức năng “Thông tuyến khám chữa bệnh\Tra cứu thẻ tạm của trẻ em hoặc của người hiến tạng” trên Cổng tiếp nhận dữ liệu Hệ thống thông tin giám định BHYT của BHXH Việt Nam để tra cứu mã thẻ BHYT tạm thời. |
|
21 |
TEN_CON |
Chuỗi ký tự |
x |
200 |
Tên dự định đặt cho con (Tên dự kiến này có thể thay đổi khi đăng ký khai sinh) |
|
22 |
GIOI_TINH_CON |
Số |
x |
1 |
Giới tính mã hóa (1: Nam, 2: Nữ, 3: Chưa xác định) |
|
23 |
SO_CON |
Chuỗi ký tự |
x |
10 |
Số con sinh trong lần sinh |
|
24 |
LAN_SINH |
Số |
x |
2 |
Ghi số lần sinh con (tính cả lần sinh này). |
|
25 |
SO_CON_SONG |
Số |
x |
2 |
Ghi số con hiện đang sống (tính cả trẻ sinh ra lần này). |
|
26 |
CAN_NANG_CON |
Chuỗi ký tự |
|
10 |
Ghi số cân nặng của con, tính theo gram (ký hiệu là: g) (ví dụ: 3.6 kg = 3600g). |
|
27 |
NGAY_SINH_CON |
Chuỗi ký tự |
x |
12 |
Ngày sinh con, định dạng yyyyMMddHHss, với yyyy là năm sinh, MM là tháng sinh, dd là ngày sinh, HH là giờ sinh, ss là phút sinh |
|
28 |
NOI_SINH_CON |
Chuỗi ký tự |
x |
1024 |
Ghi địa chỉ nơi con được sinh ra theo cấu trúc: {mã tỉnh}:{mã huyện (nếu tỉnh không có huyện thì thay bằng dấu _)}:{mã xã (nếu huyện không có xã thì thay bằng dấu _)}:{địa chỉ full text có cả tên tỉnh huyện xã theo chuẩn chung}. Trong đó, Mã tỉnh, huyện, xã theo bảng mã của Tổng cục Thống kê. Ví dụ: 01:006:00232:78 đường Giải Phóng, phường Phương Mai, quận Đống Đa, Hà Nội Lưu ý: - Trường hợp trẻ em được sinh ra tại bệnh viện, thì ghi tên bệnh viện và địa danh hành chính nơi trẻ em được sinh ra. Ví dụ: bệnh viện đa khoa tỉnh Nam Định); - Trường hợp trẻ em được sinh tại cơ sở y tế khác thì ghi tên cơ sở y tế và địa danh hành chính 3 cấp nơi trẻ em sinh ra (Ví dự: Trạm y tế xã Liên Bảo, huyện Vụ Bản, tỉnh Nam Định); - Trường hợp trẻ em được sinh tại nhà thì ghi địa chỉ nhà và địa danh 3 cấp: cấp xã/phường, quận/huyện, tỉnh/thành phố trực thuộc trung ương. Ví dụ: sinh tại nhà ở xã Liên Bảo, huyện Vụ Bản, tỉnh Nam Định; - Trường hợp trẻ em được sinh ra tại nơi khác, ngoài cơ sở KBCB thì cũng ghi nơi trẻ em được sinh ra và địa danh 3 cấp hành chính. Ví dụ: đẻ trên đường đi, tại xã Liên Bảo, huyện Vụ Bản, tỉnh Nam Định. - Trường hợp trẻ em bị bỏ rơi thì ghi rõ trẻ bị bỏ rơi và nơi tìm thấy trẻ, với địa danh 3 cấp hành chính. Ví dụ: trẻ bị bỏ rơi tại xã Liên Bảo, huyện Vụ Bản, tỉnh Nam Định. |
|
29 |
TINH_TRANG_CON |
Chuỗi ký tự |
x |
500 |
Ghi rõ tình trạng của trẻ tại thời điểm làm Giấy chứng sinh: khỏe mạnh, yếu, dị tật hoặc các biểu hiện liên quan đến sức khỏe khác (nếu có). Lưu ý: Nếu trẻ bị dị dạng, dị tật, ghi cụ thể loại dị dạng, dị tật, kể cả khuyết tật về hình thái của trẻ nếu phát hiện được. |
|
30 |
SINHCON_PHAUTHUAT |
Số |
|
1 |
1: sinh con phải phẫu thuật 0: sinh con không phải phẫu thuật |
|
31 |
SINHCON_DUOI32TUAN |
Số |
|
1 |
1: sinh con dưới 32 tuần tuổi 0: không sinh con dưới 32 tuần tuổi |
|
29 |
GHI_CHU |
Chuỗi ký tự |
|
1500 |
Trường hợp sinh con phải phẫu thuật hoặc sinh con dưới 32 tuần tuổi hoặc vừa sinh con dưới 32 tuần tuổi lại vừa phải phẫu thuật thì trong phần ghi chú phải ghi rõ một trong các nội dung sau "Sinh con phải phẫu thuật" hoặc "Sinh con dưới 32 tuần tuổi" hoặc "Phẫu thuật, sinh con dưới 32 tuần tuổi". |
|
30 |
NGUOI_DO_DE |
Chuỗi ký tự |
x |
255 |
Ghi họ và tên người đỡ đẻ. |
|
31 |
NGUOI_GHI_PHIEU |
Chuỗi ký tự |
x |
255 |
Ghi họ và tên người ghi phiếu. |
|
32 |
MA_TTDV |
Số |
x |
10 |
Ghi mã số định danh y tế (mã số BHXH) của Thủ trưởng cơ sở KBCB cấp giấy chứng sinh. |
|
33 |
THU_TRUONG_DVI |
Chuỗi ký tự |
x |
200 |
Người đứng đầu cơ sở khám bệnh, chữa bệnh hoặc người được người đứng đầu cơ sở khám bệnh, chữa bệnh ủy quyền được ký và đóng dấu của cơ sở khám bệnh, chữa bệnh đó. |
|
34 |
NGAY_CT |
Chuỗi ký tự |
x |
8 |
Ngày cấp giấy chứng sinh, định dạng yyyyMMdd với yyyy là năm cấp, MM là tháng cấp, dd là ngày cấp. ghi theo ngày dương lịch. |
|
35 |
SO |
Chuỗi ký tự |
|
200 |
Ghi số của chứng từ (Giấy chứng sinh) tại cơ sở KBCB. |
|
36 |
QUYEN_SO |
Chuỗi ký tự |
|
200 |
Ghi quyển số của chứng từ (Giấy chứng sinh) tại cơ sở KBCB |
2.3. Mô tả cấu trúc file XML
3. API tiếp nhận dữ liệu Giấy báo tử
3.1. Mô tả bản tin
