MISA CUKCUK: trạng thái hỗ trợ trong omniVN
Backend có, UI chưa mởBackend có connector nhưng UI chưa mở. Merchant tự lấy AppID, Domain và Secret Key trên CUKCUK.
Giới hạn hiện tại
- Trang kết nối CUKCUK chưa được mở trong workspace Omni0.
- Tồn kho theo chi nhánh chưa có endpoint công khai rõ ràng.
Tổng quan
CUKCUK Open Platform dùng AppID, Domain (tên miền shop) và Secret Key để đăng nhập HMAC-SHA256 lấy access token (~1 ngày). Omni0 backend đã có connector; trang Integrations chưa mở form.
Điều kiện trước khi bắt đầu
- Có tên miền CUKCUK đang hoạt động (ví dụ https://tenban.cukcuk.vn).
- Quyền quản trị để mở menu Ứng dụng → API trên CUKCUK.
Các bước lấy credential
1. Đăng nhập domain CUKCUK
Truy cập tên miền CUKCUK của bạn (ví dụ https://test51.cukcuk.vn), đăng nhập tài khoản quản trị.
2. Mở API trong menu Ứng dụng
Chọn Ứng dụng → API để vào cấu hình Open Platform.

3. Tạo mã kết nối và cho phép kết nối
Nhấn TẠO MÃ KẾT NỐI để sinh AppID, Domain (tên kết nối) và Secret Key (mã bảo mật). Sau đó bấm CHO PHÉP KẾT NỐI để bật cổng API.

4. Đăng nhập API lấy access token
Dùng AppID, Domain và Secret Key gọi API login (HMAC-SHA256) theo tài liệu graphapi.cukcuk.vn. Access token dùng cho các API chi nhánh, hàng hóa, khách hàng, đơn hàng.
5. Hạn chế Omni0
UI kết nối CUKCUK chưa mở trong workspace. Tồn kho theo chi nhánh chưa có endpoint công khai rõ trong product list.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| CUKCUK AppID | AppID | Bắt buộc | user_entered Backend CUKCUK có connector nhưng chưa có route trong frontend. |
| CUKCUK domain | Tên miền / mã cửa hàng | Bắt buộc | user_entered |
| CUKCUK Secret Key | Secret Key | Bắt buộc | user_entered Dùng để tạo HMAC-SHA256 login lấy access token. |
appId → AppID; domain → Domain / tên miền CUKCUK; secretKey → Secret Key.
Vòng đời token
Access token do CUKCUK cấp sau login, thời hạn khoảng 1 ngày. Cần login lại khi hết hạn.