Giải đáp thắc mắc

Access token của Nhanh.vn có hạn 1 năm và không tự gia hạn. Bấm Get accessCode ở tab Nhanh.vn, đăng nhập Nhanh.vn và đồng ý cấp quyền lại là xong — không phải tạo app mới. Ngày hết hạn luôn hiện ở khung cuối tab; ghi lịch nhắc trước vài hôm. Xem bài kết nối API.

Nhanh.vn cho mỗi API tối đa 150 lần gọi trong 30 giây, tính theo app và cửa hàng. Vượt mức thì Nhanh.vn khoá API đó một lúc và trả ERR_429. Plugin tự giữ dưới mức 120 lần, và khi vẫn bị khoá thì tự chờ hết thời gian khoá rồi gọi lại một lần.

Hay gặp khi đồng bộ hàng nghìn sản phẩm bằng tay, hoặc khi một hệ thống khác dùng chung App ID với website. Dùng Đồng bộ trong nền, chờ vài phút rồi thử lại, và tạo app riêng cho website.

Có. Nhanh.vn ngừng hỗ trợ Webhooks version 2.0 sau 31/08/2026 và API v2.0 sau 30/11/2026. Chuyển gồm: đổi webhook của app sang version 3.0, chọn Version 3 và nhập Business ID ở tab Nhanh.vn, cấp quyền lại, đồng bộ kho và hãng vận chuyển lại, khởi tạo bảng đồng bộ sản phẩm. ID Nhanh đã gắn cho sản phẩm vẫn giữ. Các bước chi tiết ở cuối bài kết nối API.

Ba việc:

1. License — plugin báo "Tên miền hoặc license key đã thay đổi, cần kích hoạt lại". Nhắn hỗ trợ để chuyển mã sang tên miền mới rồi bấm Active License.
2. App trên open.nhanh.vn — sửa Redirect URL và Webhooks callback URL theo hai dòng mới ở tab Nhanh.vn.
3. Bấm Get accessCode để cấp quyền lại từ tên miền mới.

Tồn trên website bằng tổng tồn của các kho đã kéo về ở tab Kho hàng. Danh sách kho trống (chưa bấm đồng bộ kho) hoặc thiếu kho đang chứa hàng thì tồn bị tính thiếu, có khi về 0. Vào tab Kho hàng bấm Đồng bộ kho từ Nhanh.vn về web, rồi bấm Load từ API Nhanh.vn ở tab Đồng bộ sản phẩm và đồng bộ lại. Mỗi lần mở kho mới trên Nhanh.vn, nhớ đồng bộ kho lại ngay.

Kiểm tra theo thứ tự: có kho nào tích Không tính tồn kho không; kho mới đã kéo về chưa; sản phẩm đã có ID Nhanh chưa; webhook có về không (tab Webhook Queue có dòng inventoryChange mới không). Đừng dùng nút Đồng bộ tồn kho ở tab Đồng bộ sản phẩm để "sửa" ngay sau khi webhook chạy: nút đó đọc danh sách tải về lần trước, có thể ghi đè số mới bằng số cũ.

Kho chính là kho gửi hàng mặc định khi tính phí ship và khi đăng đơn, và là kho dự phòng cho những tỉnh chưa gán kho nào. Hãy luôn đặt một kho chính: chưa có thì plugin có thể không chọn được kho gửi và trang thanh toán chỉ hiện "Phí vận chuyển sẽ báo sau.". Xem bài kho hàng.

Không. Đồng bộ sản phẩm đi một chiều từ Nhanh.vn về website. Giá, tồn kho nên sửa trên Nhanh.vn; tên và SKU trên website thì sửa thoải mái vì đồng bộ không ghi đè hai trường này sau lần tạo đầu.

Không. Plugin chỉ gỡ liên kết (ID Nhanh) của sản phẩm đó. Muốn ẩn trên website thì tự chuyển sản phẩm sang bản nháp.

Plugin không xử lý sự kiện "Thêm sản phẩm". Vào tab Đồng bộ sản phẩm, bước 2, bấm Load từ API Nhanh.vn, chọn Tạo mới cho sản phẩm đó rồi đồng bộ. Từ lúc đó, mọi thay đổi của nó tự về qua webhook.

Nhanh.vn không trả được giá cho địa chỉ đó. Hay gặp nhất: chưa đặt kho chính, token hết hạn, hãng đã tích không có dịch vụ cho tuyến đó, hoặc đang bị giới hạn số lần gọi. Bảng kiểm tra đầy đủ ở bài vận chuyển.

Không. Đăng tay, đăng hàng loạt và tự động đăng đơn đều có sẵn trong plugin. Xem bài đăng đơn.

Với API v2, trạng thái đơn trên website đổi theo bảng ở tab Webhook. Với API v3, plugin 1.6.4 không đổi trạng thái đơn WooCommerce theo Nhanh.vn — bạn cập nhật trạng thái trên website như bình thường. Riêng đơn bị xoá trên Nhanh.vn thì đơn trên website vẫn tự chuyển Đã huỷ.

Không. Plugin đăng đơn và huỷ đơn trên Nhanh.vn; sửa đơn, in phiếu giao hàng làm trên Nhanh.vn.

Chiều đẩy lên (website → Nhanh.vn) chạy ngay khi khách đăng ký, sửa hồ sơ hay đặt hàng. Chiều kéo về (Nhanh.vn → website) không theo thời gian thực vì Nhanh.vn chưa có webhook cho khách hàng — chạy theo lịch mỗi giờ, mỗi ngày hoặc khi bạn bấm. Xem bài đồng bộ khách hàng.

Không. Hết hạn thì phí ship Nhanh.vn biến mất, website ngừng nhận webhook, không đăng được đơn và không đồng bộ được. Phần trang thanh toán (tab Cài đặt chung) vẫn chạy và dữ liệu đã đồng bộ vẫn nằm nguyên. Gia hạn xong bấm Active License. Xem bài License.

License còn hạn: cập nhật ngay trong quản trị (Bảng tin → Cập nhật, hoặc nút Kiểm tra cập nhật ở tab License). License đã hết hạn: gia hạn rồi cập nhật. Sao lưu trước khi cập nhật, rồi cân nhắc chuyển sang API v3.

Một license cho một tên miền. Bản thử nghiệm (staging) là một tên miền khác.

Trường địa chỉ của plugin chạy ở trang thanh toán dạng block khi dùng bộ địa chỉ 2 cấp. Kiểm tra số điện thoại Việt Nam, chặn IP, chặn từ khoá và reCAPTCHA thì chỉ chạy ở trang thanh toán cổ điển (mã ngắn [woocommerce_checkout]). Xem bài trang thanh toán.

Được. Các plugin này dùng chung một module trang thanh toán, bản nạp trước chạy và tất cả đọc chung một bộ cấu hình ở tab Cài đặt chung.

WooCommerce 5.6 trở lên (đã kiểm tới 11.1.1, hỗ trợ HPOS), PHP 7.2 trở lên với ionCube Loader, website chạy https để nhận webhook. Xem bài cài đặt.

Ảnh chụp màn hình lỗi, tên miền, phiên bản plugin và phiên bản API (v2 hay v3) đang dùng. Che App ID, Secret Key, Business ID, License Key trước khi gửi. Nếu được yêu cầu log gỡ lỗi, chỉ chép đoạn liên quan và che token, thông tin khách — đừng gửi nguyên file log, và xoá file log khi dò lỗi xong (xem bài hook).