1. Tổng quan
Mục đích: Bài viết hướng dẫn thiết lập cổng API để các phần mềm khác kết nối với AMIS CRM.
Nội dung bài viết bao gồm:
- Các bước thiết lập API
- Cách lấy dữ liệu từ CRM về hệ thống, website đối tác
- Lưu ý khi sử dụng API
Phạm vi áp dụng: chỉ dành cho người dùng có quyền thiết lập API.
2. Hướng dẫn thực hiện
Thiết lập API
Bước 1: Trên AMIS CRM, nhấn biểu tượng 
để hiển thị Thiết lập. Vào Kết nối\API.
Bước 2: Ở tab Thiết lập, khai báo thông tin:
- AppID: là tên của nhà phát triển (bao gồm các ký tự a-z, A-Z, số). Thông tin này do khách hàng chủ động tự đặt (không cần liên hệ MISA, nếu trùng phần mềm sẽ tự cảnh báo để KH đặt lại tên AppID khác)
- Địa chỉ Webhook: là thông tin địa chỉ Webhook ứng với tên domain của khách hàng
Bước 3: Nhấn Kết nối để kết nối AMIS CRM với hệ thống, website khác.
Lấy dữ liệu từ CRM về hệ thống của đối tác
Sau khi kết nối thành công trên CRM, đối tác thực hiện lấy dữ liệu từ CRM theo 2 bước:
Xem Tài liệu hướng dẫn kỹ thuật chi tiết tại đây.
Bước 1: Đăng nhập để lấy Token
API thực hiện cấp thông tin Token để xác thực request hợp lệ cho khi thực hiện gửi, lấy dữ liệu từ hệ thống CRM.
Cấu hình kết nối:
- “client_id”: AppID
- “client_secret”: Mã bảo mật
Token được sinh ra sau khi kết nối thành công.
Cấu hình kết nối:
- “client_id”: AppID
- “client_secret”: Mã bảo mật
Token được sinh ra sau khi kết nối thành công.
Bước 2: Gọi request lấy dữ liệu và cập nhật dữ liệu từ CRM
- Thông tin cấu hình cần thiết: Authorization là giá trị truyền vào header của các request.
Cấu trúc như sau: Authorization: Bearer + Token (sinh ở bước 1)
- Sau đó, thực hiện lấy dữ liệu theo hướng dẫn tại Tài liệu hướng dẫn kỹ thuật
3. Lưu ý
- Chỉ hỗ trợ lấy thông tin từ AMIS CRM, không cập nhật vào AMIS CRM các dữ liệu: Hàng hóa, Tồn kho, Công nợ khách hàng
- Hỗ trợ Thêm/Cập nhật 2 chiều AMIS CRM với ứng dụng bên ngoài các dữ liệu: Khách hàng, Đơn hàng. (Lưu ý chỉ hỗ trợ Cập nhật đơn hàng từ phần mềm khác vào CRM với đơn hàng có tình trạng Bản nháp)
- Trường hợp khách hàng có những yêu cầu kết nối API khác, anh chị vui lòng liên hệ với MISA để được hỗ trợ. Để MISA có thể hỗ trợ nhanh chóng, anh chị vui lòng mô tả chi tiết nhu cầu theo mẫu tại đây.