Dữ liệu không truyền — hóa đơn không lên hệ thống HĐĐT

Khách báo "hóa đơn không lên", "dữ liệu không truyền", "xuất rồi mà bên kia không thấy" — đây là nhóm sự cố HĐĐT được phản ánh nhiều nhất. Bài này đi theo triệu chứng: xác định dữ liệu đang tắc ở đâu trước, rồi mới xử lý theo nguyên nhân.

Câu hỏi đầu tiên: dữ liệu đã rời khỏi iPOS chưa?

Luồng thật là POS → Partner (nhà cung cấp HĐĐT) → Cơ quan Thuế. Gần như mọi ca "dữ liệu không truyền" đều quy về một câu hỏi duy nhất:

Hóa đơn đã được iPOS đẩy đi thành công, hay còn nằm lại dưới POS?

Trả lời được câu này là phân luồng được toàn bộ phần còn lại. Kiểm tra trên báo cáo D02, xem trạng thái từng hóa đơn:

• Còn ở trạng thái chờ / xuất thất bại → dữ liệu chưa rời iPOS. Đây là phạm vi iPOS xử lý được, xem các nguyên nhân bên dưới.
• Đã xuất thành công, đã được cấp số nhưng bên partner không hiển thị → dữ liệu đã rời iPOS. Phần còn lại thuộc phía partner.

Hệ thống partner lỗi, bảo trì hoặc quá tải

Nguyên nhân phổ biến nhất, và không phải lỗi cấu hình phía khách. Dấu hiệu nhận biết:

• Xảy ra đồng loạt nhiều hóa đơn, thường nhiều cửa hàng cùng lúc, bắt đầu từ một mốc giờ cụ thể.
• Bấm xuất lại không có tác dụng, hóa đơn quay về trạng thái thất bại.
• Trang web HĐĐT của partner truy cập chậm, treo hoặc không vào được.

Cách xử lý: giải thích cho khách đây là gián đoạn phía partner; chờ partner khắc phục rồi bấm xuất lại các hóa đơn đang thất bại trên POS hoặc web FABi. Dữ liệu không mất — hóa đơn vẫn nằm ở trạng thái chờ/thất bại cho tới khi đẩy được. Trang thông báo của partner thường có tin gián đoạn hệ thống để đối chiếu.

Hóa đơn kẹt hàng đợi, đẩy chậm

Hóa đơn không báo lỗi nhưng đứng yên, không lên; hoặc chỉ lên một phần. Khác với ca trên ở chỗ không có lỗi rõ ràng, dữ liệu chỉ chậm.

• Kiểm tra hàng đợi đồng bộ; thử mở lại phần mềm xuất hóa đơn để hàng đợi tiếp tục chạy.
• Nếu xuất dồn vào giờ khóa sổ hoặc khung cao điểm thì đây là hiện tượng đã biết — xem Cơ chế đồng bộ hóa đơn & xử lý đồng bộ chậm.
• Khuyến nghị lâu dài: xuất hóa đơn ngay tại thời điểm in bill, tránh dồn vào lúc chốt ca.

Lệch ngày — không xuất lại được theo ngày cũ

Hóa đơn phát sinh hôm trước nhưng sang hôm sau mới xuất lại, hệ thống báo ngày hóa đơn không hợp lệ hoặc phải lớn hơn/bằng ngày hiện tại.

Ngày xuất HĐĐT được ghi nhận theo ngày thao tác xuất VAT, không phải ngày đẩy thành công. Chi tiết và các tình huống bán qua đêm: Thay đổi luồng ngày xuất hóa đơn. Nếu cần đọc ngày dạng số trong payload, dùng Chuyển đổi timestamp.

Sót đơn khi xuất số lượng lớn

Xuất nhiều hóa đơn cùng lúc (hoặc auto xuất khi chốt ca) nhưng một vài đơn không lên, không kèm báo lỗi nào. Thường phát hiện muộn, lúc đối soát cuối tháng.

• Đối chiếu danh sách hóa đơn trên D02 với danh sách bên partner để xác định đơn nào thiếu, thay vì kết luận chung chung là "mất đơn".
• Với các đơn thiếu: bấm xuất lại theo đúng quy trình ngày hiện tại.
• Hạn chế tái diễn bằng cách dùng cơ chế xuất khi chốt ca/cuối ngày thay vì xuất dồn thủ công.

Trùng số hoặc trùng chứng từ

Hóa đơn đã được cấp số nhưng trạng thái đồng bộ chưa cập nhật, bấm xuất lại thì báo hóa đơn đã phát hành. Kiểm tra lại mã hóa đơn/số chứng từ và chọn đúng chứng từ cần đẩy — tránh đẩy trùng tạo thêm hóa đơn thừa.

Sai ký hiệu hóa đơn

Dữ liệu đẩy đi nhưng partner từ chối do ký hiệu/mẫu số hóa đơn không khớp với dải hóa đơn đã đăng ký bên partner. Ký hiệu do phía partner cấu hình, nên khách cần liên hệ partner kiểm tra lại; sau khi partner chỉnh xong thì bấm xuất lại trên hệ thống.

Chữ ký số

Hóa đơn không ký được thì không gửi lên được. Kiểm tra USB token cắm đúng máy, chữ ký số còn hạn, và cấu hình ký (tự động/thủ công) đúng. Xem thêm Ký tự động & tự động gửi hóa đơn lên CQT.

Lệch số liệu khi đối soát

Khách báo doanh thu lệch giữa báo cáo iPOS và báo cáo HĐĐT, không thấy hóa đơn nào báo lỗi cụ thể. Đây thường là hệ quả của các nguyên nhân trên (sót đơn, kẹt hàng đợi, lệch ngày) chứ không phải một lỗi riêng — cần đối chiếu để tìm ra hóa đơn cụ thể bị thiếu trước khi kết luận.

Cần chuẩn bị gì trước khi báo Kỹ thuật

Phần lớn ca "dữ liệu không truyền" hiện phải remote vào máy khách mới xác định được nguyên nhân. Thu thập sẵn những thông tin sau sẽ rút ngắn đáng kể thời gian xử lý:

• Partner đang dùng (Me-invoice, iPOS-invoice, M-invoice, S-invoice, BKAV, VNPT).
• Phạm vi: một hóa đơn, một vài hóa đơn, hay toàn bộ? Một cửa hàng hay nhiều cửa hàng?
• Thời điểm bắt đầu phát sinh, và ngày của các hóa đơn chưa lên.
• Trạng thái trên D02: chờ, thất bại, hay đã cấp số.
• Ảnh màn hình báo lỗi (nếu có) — có thể tra nhanh bằng Gửi ảnh — tự tìm lỗi.
• Đã thử bấm xuất lại chưa, kết quả thế nào.