GHTK: trạng thái hỗ trợ trong omniVN
Adapter tạm hoãnAdapter tạm hoãn. GHTK cấp API Token và Partner code trên trang thông tin shop.
Giới hạn hiện tại
- Adapter GHTK tạm hoãn, chưa thể đồng bộ trong Omni0.
Tổng quan
GHTK Open API yêu cầu header Token và X-Client-Source (partner code). Production: https://services.giaohangtietkiem.vn. Token lấy trên website khách hàng GHTK. Adapter GHTK trong Omni0 đang deferred.
Điều kiện trước khi bắt đầu
- Tài khoản GHTK đang hoạt động.
- Đăng nhập được cổng khách hàng (Production: https://khachhang.giaohangtietkiem.vn).
Các bước lấy credential
1. Đăng nhập website khách hàng GHTK
Production: https://khachhang.giaohangtietkiem.vn. Staging: https://khachhang-staging.ghtklab.com (theo tài liệu pro-docs.ghtk.vn).
2. Mở trang thông tin shop / tài khoản
Truy cập đường dẫn {CUSTOMER_WEBSITE}/web/thong-tin-shop/tai-khoan (ví dụ https://khachhang.giaohangtietkiem.vn/web/thong-tin-shop/tai-khoan).
3. Copy API Token và Partner code
API Token hiển thị ở sidebar Thông tin shop (Shop Information). Partner code là mã shop hoặc mã đối tác private — dùng làm X-Client-Source trên mọi request.
4. Gọi API với header Token
Mọi request gửi tới OPEN_API kèm Token: {API_TOKEN} và X-Client-Source: {PARTNER_CODE}. Thiếu hoặc sai token trả HTTP 403.
5. Hiện trạng Omni0
Adapter GHTK bị deferred. Chưa thể lưu credential và đồng bộ trong workspace.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| API Token | Token | Bắt buộc | provider_generated Lấy từ trang thông tin shop trên website GHTK của khách hàng. |
| Partner Code | Partner code | Bắt buộc | user_entered |
| Webhook Hash | Webhook hash | Tùy chọn | operator_managed |
token → API Token; partnerCode → Partner code (X-Client-Source); webhookHash → Webhook Hash (Omni0 operator, nếu dùng webhook).
Vòng đời token
Token quản lý trên trang thông tin shop GHTK. Đổi token trên GHTK sẽ vô hiệu token cũ.