Kết nối API KiotViet

Đây là bước bắt buộc. Chưa kết nối được thì mọi chức năng còn lại của plugin đều không chạy. Cần khoảng 5 phút.

Lấy thông tin kết nối trên KiotViet

Ba thông tin dưới đây lấy từ trang quản trị KiotViet, không phải từ website của bạn:

Thông tin	Lấy ở đâu
Retailer	Chính là tên gian hàng nằm trong địa chỉ đăng nhập KiotViet. Nếu bạn vào bằng `cuahang-demo.kiotviet.vn` thì Retailer là `cuahang-demo`.
Client ID	Trong KiotViet vào Thiết lập → Thiết lập cửa hàng → Kết nối API, tạo một kết nối mới rồi lấy Client ID.
Client Secret	Hiện ra cùng lúc với Client ID khi vừa tạo kết nối.

Client Secret chỉ hiện một lần

KiotViet không cho xem lại Client Secret sau khi bạn đóng cửa sổ đó. Hãy sao chép và lưu lại ngay. Lỡ mất thì tạo kết nối API mới, không cần xoá cái cũ.

Mở tab Cài đặt API

Trong trang quản trị WordPress, vào menu Đồng bộ KiotViet rồi chọn tab Cài đặt API.

Thanh tab của plugin, chấm số 1 chỉ vào tab Cài đặt API — Thanh tab nằm ngay dưới tiêu đề trang. Bấm vào ô được đánh số.

Tab Cài đặt API — nơi khai báo thông tin kết nối. Các tab khác chỉ dùng được sau khi tab này kết nối thành công.

Điền thông tin và lưu

Biểu mẫu Cài đặt API với sáu vị trí được đánh số — Biểu mẫu Cài đặt API. Bấm vào ảnh để phóng to.

Retailer — gõ đúng tên gian hàng, chỉ phần trước .kiotviet.vn, không kèm https://.
Client ID — dán nguyên chuỗi lấy từ KiotViet, không thêm dấu cách ở đầu hay cuối.
Client Secret — dán vào đây. Ô này che ký tự nên hãy dán chứ đừng gõ tay.
Chi nhánh — Tuỳ chọn Để trống thì plugin lấy tồn kho từ tất cả chi nhánh. Chỉ chọn khi bạn muốn website chỉ bán theo kho của một vài chi nhánh. Danh sách chỉ hiện ra sau khi đã lưu và kết nối thành công.
Kiểm tra kết nối — bấm để thử. Nút này chỉ đọc, không làm thay đổi gì trên KiotViet.
Lưu cài đặt — bấm để ghi lại. Phải lưu trước rồi mới kiểm tra kết nối, vì plugin đọc thông tin đã lưu chứ không đọc chữ đang gõ dở trên màn hình.

Thứ tự đúng

Điền ba ô đầu → bấm Lưu cài đặt → bấm Kiểm tra kết nối → nếu thành công thì quay lại chọn Chi nhánh nếu cần → lưu lần nữa.

Kết quả kiểm tra kết nối

Bấm Kiểm tra kết nối, sau vài giây sẽ hiện một hộp thoại:

Hộp thoại thông báo Thành công, kết nối thành công — Hiện chữ "Thành công" nghĩa là website đã nói chuyện được với KiotViet.

Thấy hộp thoại này là xong bước 3. Bạn có thể chuyển sang Đồng bộ sản phẩm.

Khi báo lỗi thì xử lý thế nào

Thông báo	Nguyên nhân thường gặp
Sai thông tin đăng nhập	Client ID hoặc Client Secret bị dán thiếu ký tự, hoặc dính dấu cách ở đầu/cuối. Xoá sạch ô rồi dán lại.
Không tìm thấy gian hàng	Ô Retailer bị gõ cả `.kiotviet.vn` hoặc cả `https://`. Chỉ để lại phần tên gian hàng.
License chưa kích hoạt	Plugin chặn mọi kết nối khi chưa kích hoạt license. Sang tab License kích hoạt trước.
Hết thời gian chờ	Máy chủ website chặn kết nối ra ngoài, hoặc KiotViet đang bảo trì. Thử lại sau vài phút, còn lỗi thì hỏi nhà cung cấp hosting xem có chặn kết nối ra ngoài không.

Đừng chia sẻ Client Secret cho ai

Ai có Client ID và Client Secret là đọc và sửa được dữ liệu cửa hàng của bạn. Khi gửi ảnh nhờ hỗ trợ, hãy che hai ô này lại.

Còn vướng chỗ nào, xem thêm Giải đáp thắc mắc.