MISA AMIS Accounting: trạng thái hỗ trợ trong omniVN
Adapter tạm hoãnAdapter tạm hoãn. MISA cấp app_id, admin kế toán cấp access_code.
Giới hạn hiện tại
- Adapter MISA AMIS Accounting tạm hoãn.
- Catalog yêu cầu appSecret nhưng docs chính thức không nêu rõ. Cần đối chiếu lại với MISA.
Tổng quan
AMIS Accounting Open API yêu cầu app_id từ MISA, access_code từ admin kế toán và org_company_code. Omni0 đổi các giá trị này qua /api/oauth/actopen/connect để lấy access_token. Adapter đang bị deferred.
Điều kiện trước khi bắt đầu
- Tài khoản AMIS Accounting đang hoạt động.
- Đã liên hệ MISA để đăng ký ứng dụng tích hợp.
Các bước lấy credential
1. Nhận app_id từ MISA
MISA cấp app_id khi đăng ký ứng dụng tích hợp. Giá trị này do MISA quản lý, không do người dùng tự tạo.
2. Lấy access_code từ admin kế toán
Admin kế toán đăng nhập AMIS, tạo access_code cho ứng dụng tích hợp.
3. Lấy org_company_code
org_company_code là mã công ty trong AMIS Accounting.
4. Đổi lấy access_token
Ứng dụng gọi /api/oauth/actopen/connect với app_id, access_code và org_company_code. API trả về access_token. Không tự tạo access_token.
5. Hiện trạng
Adapter MISA AMIS Accounting bị deferred. Backend hiện mock dictionary sync, chưa gọi API thật.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| App ID | app_id | Bắt buộc | operator_managed MISA cấp cho ứng dụng tích hợp, không phải của người dùng. |
| App Secret | app_secret | Bắt buộc | operator_managed Do MISA cấp cho ứng dụng. Catalog hiện tại yêu cầu nhưng docs chính thức chỉ nêu app_id. |
| Access Code | access_code | Tùy chọn | provider_generated Admin kế toán cấp trong AMIS để ứng dụng đổi lấy token. |
| Org Company Code | org_company_code | Tùy chọn | user_entered |
| Access Token | access_token | Tùy chọn | token_exchange Trả về từ /api/oauth/actopen/connect, không do người dùng tự tạo. |
| Base URL | API base URL | Tùy chọn | user_entered |
appId → App ID (MISA cấp); appSecret → App Secret (catalog yêu cầu nhưng docs chính thức chỉ nêu app_id); accessCode → Access Code (admin kế toán cấp); orgCompanyCode → Org Company Code; accessToken → Access Token (đổi từ API).
Vòng đời token
access_token do AMIS cấp sau khi đổi access_code. Thời hạn và cách làm mới theo tài liệu MISA.