← Tất cả tích hợp

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

Những điểm này ảnh hưởng đến khả năng kết nối hoàn chỉnh.
  • 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.

CUKCUK — menu API trong ứng dụng
CUKCUK — menu API trong ứng dụng · CUKCUK OpenPlatform API

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.

CUKCUK — AppID, Domain, Secret Key sau khi cho phép kết nối
CUKCUK — AppID, Domain, Secret Key sau khi cho phép kết nối · CUKCUK OpenPlatform 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

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.
Field omniVNTên trong tài liệu officialBắt buộcLấy từ đâu
CUKCUK AppIDAppIDBắt buộcuser_entered

Backend CUKCUK có connector nhưng chưa có route trong frontend.

CUKCUK domainTên miền / mã cửa hàngBắt buộcuser_entered
CUKCUK Secret KeySecret KeyBắt buộcuser_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.

Nguồn chính thức

Hướng dẫn kết nối CUKCUK
graphapi.cukcuk.vn·Công khai·Đã kiểm chứng 2026-08-31
CUKCUK API - Danh sách chi nhánh
graphapi.cukcuk.vn·Công khai·Đã kiểm chứng 2026-08-29
CUKCUK API - Danh sách hàng hóa
graphapi.cukcuk.vn·Công khai·Đã kiểm chứng 2026-08-29
CUKCUK API - Danh sách khách hàng
graphapi.cukcuk.vn·Công khai·Đã kiểm chứng 2026-08-29
CUKCUK API - Danh sách hóa đơn
graphapi.cukcuk.vn·Công khai·Đã kiểm chứng 2026-08-29