Câu hỏi thường gặp

Giải đáp nhanh khi tích hợp HiTechPos: xác thực, đồng bộ tồn kho, đơn hàng, webhook và các vấn đề thường gặp.

Xem Markdown

Dùng product_id hay variation_id khi tạo đơn?

Luôn dùng variation_id. Trong HiTechPos, biến thể mới là đơn vị được bán và trừ kho; một sản phẩm có thể có nhiều biến thể với giá và tồn khác nhau.

Tồn kho được tính theo kho hay theo cửa hàng?

Theo từng kho. Mỗi cặp (biến thể, kho) có một con số tồn riêng. Khi tạo đơn, bạn phải chỉ định warehouse_id để hệ thống biết trừ ở kho nào.

Làm sao đồng bộ đơn hàng mới mà không kéo lại toàn bộ?

Dùng tham số updated_since trên endpoint danh sách đơn hàng để chỉ lấy đơn thay đổi sau một mốc thời gian. Kết hợp với webhook order.created/order.updated để gần như tức thời.

Huỷ đơn có hoàn lại tồn kho không?

Có. Khi chuyển đơn sang cancelled, số lượng đã trừ sẽ được cộng lại vào kho tương ứng và phát sự kiện stock.changed.

Webhook bị trùng, xử lý thế nào?

Dùng header X-HitechPos-Delivery làm khoá idempotency: lưu các delivery ID đã xử lý và bỏ qua nếu nhận lại. HiTechPos có thể gửi lại khi chưa nhận được phản hồi 2xx.

Sandbox và Production có dùng chung API Key không?

Không. API Key Sandbox chỉ chạy trên pos-sandbox.hitechcloud.vn, Key Production chỉ chạy trên pos.hitechcloud.vn. Dữ liệu hai môi trường hoàn toàn tách biệt.