Kết nối API cho phần mềm đối tác

Kết nối API cho phần mềm của đối tác (CRM, website, phần mềm kế toán) làm việc với dữ liệu phòng khám mà không cần tài khoản nhân viên. Mỗi đối tác một kết nối riêng, chỉ có đúng phần phòng khám chọn.

Tạo kết nối

1. Vào Cài đặt, mục Kết nối API, bấm Thêm kết nối.
2. Đặt tên để nhận ra đối tác, chọn các việc Được phép và Chi nhánh.
3. Nếu đối tác có địa chỉ IP cố định, khai ở ô Chỉ cho phép từ địa chỉ IP.
4. Với phần có dữ liệu cá nhân của khách, tích ô xác nhận phòng khám đã có căn cứ chia sẻ theo Nghị định 13/2023.
5. Bấm Tạo kết nối, chép mã kết nối và bí mật rồi gửi cho đối tác qua kênh an toàn.

Bí mật chỉ hiện một lần. Quên thì bấm Đổi bí mật, bí mật cũ dùng tiếp được 24 giờ để đối tác kịp cập nhật.

Phần đối tác làm được

• Xem, thêm, sửa thông tin hành chính của khách.
• Xem giờ trống, đặt, đổi, huỷ lịch hẹn.
• Tạo cơ hội vào phễu Khách tiềm năng.
• Đọc tên và giá bán của dịch vụ, hàng hoá.
• Đọc hoá đơn, dòng hàng và phiếu thu để đưa sang phần mềm kế toán.

Đối tác không xem được hồ sơ khám, chẩn đoán, toa thuốc, giá vốn, báo cáo doanh thu toàn phòng khám, và không ký hay thu tiền được.

Báo sự kiện cho đối tác (webhook)

Để phần mềm đối tác biết ngay khi có lịch hẹn mới hay phiếu thu mới, mà không phải hỏi lại liên tục:

1. Bấm ô Webhook ở dòng kết nối, rồi Thêm địa chỉ.
2. Dán địa chỉ https đối tác cung cấp và chọn các sự kiện. Chỉ chọn được sự kiện kết nối đã có quyền đọc.
3. Chép bí mật ký gửi cho đối tác để họ kiểm tra bản tin đúng do phần mềm gửi.
4. Bấm Gửi thử để kiểm tra, kết quả hiện ở mục Lịch sử gửi.

Bản tin chỉ có mã và trạng thái, không có tên hay số điện thoại khách. Chưa gửi được thì phần mềm tự thử lại trong khoảng một ngày. Hỏng liên tiếp nhiều lần thì địa chỉ tự tắt và chủ phòng khám nhận thông báo; sửa xong thì bật lại.

Lưu ý

• Chi nhánh giới hạn lịch hẹn và chi nhánh gốc của khách tạo mới. Hồ sơ khách dùng chung cả phòng khám nên kết nối có quyền xem khách sẽ thấy khách của mọi chi nhánh.
• Bấm Thu hồi là đối tác mất quyền ngay. Kết nối đã thu hồi không khôi phục được, cần thì tạo kết nối mới.
• Mọi lượt đối tác tạo, sửa hoặc xem hồ sơ đều ghi vào nhật ký hệ thống dưới tên kết nối.
• Gửi đường dẫn Tài liệu cho đối tác ở đầu mục để đội kỹ thuật của họ làm theo.
• Phạm vi Giấy tờ của khách mở số CCCD, hộ chiếu, thẻ BHYT; phạm vi Giá vốn mở giá vốn. Hai phạm vi này chỉ tích khi đối tác thật sự cần, và phòng khám chịu trách nhiệm chia sẻ dữ liệu đó theo NĐ 13/2023.
• Đội kỹ thuật dùng AI lập trình thì bấm Sao chép cho AI ở đầu trang tài liệu hoặc ở từng route, rồi dán vào khung chat. Nút Tải về lưu cùng nội dung thành tệp.

Câu hỏi thường gặp