Đối tượng sử dụng:
Nhân viên kỹ thuật của các Nhà phát triển bên ngoài MISA.
Tóm tắt nội dung tài liệu:
Tài liệu này hướng dẫn chi tiết về tích hợp API cho nền tảng Hợp đồng điện tử MISA weSign, bao gồm tổng quan về luồng kết nối, phương thức xác thực (qua SID và access token), cấu trúc API, và quy trình tạo luồng ký hoàn chỉnh trước khi thực hiện. Nội dung trình bày các định nghĩa API, mô tả dữ liệu, mã lỗi thường gặp và quy trình thao tác chuẩn.
API hỗ trợ các nghiệp vụ từ khâu chuẩn bị tài liệu như tải tệp lên (upload), sử dụng tài liệu mẫu (templates), và trộn dữ liệu hàng loạt (merge batch) từ tệp Excel hoặc JSON để tự động tạo ra nhiều hợp đồng. Tiếp đó, tài liệu hướng dẫn chi tiết cách thiết lập và khởi tạo một luồng ký (sign flow), chỉ định người ký, vai trò, thứ tự ký, và các tùy chọn gửi email thông báo. Ngoài ra, API còn cho phép kiểm tra trạng thái của tài liệu trong luồng ký và tải về tài liệu đã hoàn tất ký số. Mỗi hạng mục đều đi kèm hướng dẫn về endpoint, tham số, dữ liệu đầu ra và cách xử lý kết quả, hỗ trợ lập trình viên nhanh chóng tích hợp quy trình hợp đồng điện tử của MISA weSign vào các hệ thống khác.
Ngày phát cập nhật tài liệu lần cuối: 15/09/2025
Người phát hành tài liệu: Phòng Tích hợp hệ thống – Công ty Cổ phần MISA
Nội dung chi tiết tài liệu Open API: Tại đây
Đăng ký tài khoản dùng thử MISA weSign: Tại đây
Các bước tiến hành thttps://misajsc.amis.vn/oneai/#ích hợp:
- Nghiên cứu Tài liệu: Đọc kỹ tài liệu API mở để nắm vững các luồng nghiệp vụ và yêu cầu kỹ thuật.
- Đăng ký sử dụng API: Liên hệ với MISA để đăng ký và nhận
x-client-id,x-client-secret. - Xác thực: Thực hiện luồng điều hướng để lấy
x-amis-sid, sau đó gọi API để lấyaccess tokencho các phiên làm việc. - Tích hợp Luồng Hợp đồng: Xây dựng các bước gọi API theo quy trình: Tải tệp lên -> Tạo luồng ký (hoặc sử dụng tính năng trộn dữ liệu hàng loạt) -> Theo dõi trạng thái (qua API hoặc webhook) -> Tải về tài liệu đã ký.
- Nghiệm thu: Kiểm tra và xác thực các luồng tạo và ký hợp đồng hoạt động thành công.
Nếu bạn đến từ Nhà phát triển phần mềm thương mại, muốn trở thành Đối tác tích hợp chính thức của MISA (miễn phí & có nhóm hỗ trợ riêng) thì đăng ký: Tại đây.
