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

Các câu hỏi lập trình viên đối tác hay hỏi khi tích hợp.

Gửi và nhận

Mất mạng giữa chừng, không biết hóa đơn đã tạo chưa? Gửi lại y hệt với cùng external_id. Đã tạo thì nhận 200 và hóa đơn cũ, chưa tạo thì nhận 202.

Chưa thấy số hóa đơn? Phát hành chạy nền nên điều này bình thường. Hỏi lại GET /invoices/{id} hoặc chờ webhook. Nếu queued quá lâu ngoài giờ cao điểm, báo kèm id.

Không thấy hóa đơn tạo bằng khóa cũ? Hóa đơn thuộc về ứng dụng, không thuộc về khóa. Khóa mới của cùng ứng dụng và cùng doanh nghiệp vẫn thấy.

Tiền và ngày

Gửi thành tiền 100.000 đồng, hóa đơn có ghi đúng 100.000 không? Có. Thành tiền là gốc, số lượng là phần tính ra.

Vì sao `quantity` phải là chuỗi? Để không bị làm tròn nhị phân lúc truyền. "3.742515" luôn đúng là 3,742515.

Bán chiều qua, gửi sáng nay thì hóa đơn ghi ngày nào? Ngày lập hóa đơn điện tử là hôm nay, ngày bán (sold_at) vẫn là hôm qua. Quá 3 ngày, hoặc mức doanh nghiệp đặt, thì bị từ chối. Xem Ngày bán và ngày hóa đơn.

Một hóa đơn có nhiều thuế suất được không? Ví dụ xăng KKKNT và nhớt 8 %. API nhận, nhưng phát hành được hay không tùy mẫu hóa đơn điện tử của cửa hàng.

• Mẫu «một thuế suất»: nhà cung cấp từ chối hóa đơn trộn thuế suất, hóa đơn kết thúc ở error.

• Chưa chắc mẫu của cửa hàng là loại nào thì hỏi doanh nghiệp. Trong lúc chờ, mỗi hóa đơn chỉ gửi một thuế suất: tách xăng và hàng khác thành hai hóa đơn.

Cần giá trị `THE`, `VI` cho `payment_method`? Phiên bản 1 chỉ có TM, CK, TM/CK.

Webhook

Nhận webhook trùng? Loại trùng theo X-Nex-Event-Id.

Nhận webhook mà chữ ký sai? Kiểm tra bạn ký trên byte thô của thân, đúng bí mật, và dùng "{t}." ghép với thân. Đồng hồ máy lệch quá 300 giây cũng bị từ chối, hãy đồng bộ giờ máy.

Phạm vi phiên bản 1

Hủy hoặc điều chỉnh tăng giảm hóa đơn qua API được không? Chưa có. Phiên bản 1 chỉ có tạo, tra cứu và thay thế.