Ngày bán và ngày hóa đơn

Phân biệt sold_at và invoice_date, giới hạn thời điểm bán và trường hợp kỳ thuế đã khóa.

Phản hồi có hai ngày. Bán trong ngày thì hai ngày bằng nhau.

  • sold_at: ngày bán, lấy từ issued_at theo giờ Việt Nam (Asia/Ho_Chi_Minh).

  • invoice_date: ngày lập hóa đơn trên hóa đơn điện tử.

Bán ngày trước, gửi hôm nay

Ví dụ máy bơm mất mạng cuối ngày, gửi lại sáng hôm sau. Khi đó invoice_date là hôm nay, còn ngày hạch toán của doanh nghiệp giữ là ngày bán. Hóa đơn điện tử không được ghi ngày lập ở quá khứ.

Ngày cuối cùng trên hóa đơn điện tử luôn lấy từ GET hoặc webhook, trường invoice_date. Lệnh phát hành xếp lúc gần nửa đêm có thể được dời sang ngày hôm sau.

Giới hạn của issued_at

Trường hợp

Kết quả

Ở tương lai quá 5 phút so với giờ máy chủ

422 invoice.issued_at_in_future

Ở tương lai dưới 5 phút

Nhận, vì đồng hồ máy bán hàng hay chạy nhanh vài phút

Cũ hơn giới hạn của ứng dụng, mặc định 3 ngày

422 invoice.too_old. Hóa đơn cũ hơn phải nhờ kế toán lập tay

Kỳ thuế đã khóa

Kỳ kê khai thuế GTGT của invoice_date đã nộp tờ khai thì request bị từ chối 409 invoice.period_locked. Doanh nghiệp xử lý việc này trên NexERP, bạn gửi lại sau.

Lưu ý

  • issued_at phải có múi giờ, ví dụ 2026-10-22T07:41:05+07:00.

  • Đồng bộ giờ máy bán hàng để tránh lỗi invoice.issued_at_in_future.