API kết nối hóa đơn với kế toán, ERP và POS: Checklist triển khai

Cập nhật ngày 27/08/2026 theo quy định có hiệu lực từ 01/07/2026.

Tóm tắt nhanh

Kết nối tốt phải xác định hệ thống nguồn, khóa giao dịch, ánh xạ thuế, thời điểm lập, ký, cấp mã và phản hồi. API không chỉ là nút gửi dữ liệu.

Kết luận áp dụng

Thiết kế theo nguyên tắc một giao dịch tạo một hóa đơn hợp lệ, có idempotency, hàng đợi, retry có kiểm soát, webhook xác thực và đối soát độc lập. Tách môi trường thử nghiệm với sản xuất.

Người nộp thuế chịu trách nhiệm về nội dung hóa đơn; phần mềm hoặc nhà cung cấp hỗ trợ kỹ thuật nhưng không thay thế trách nhiệm kiểm tra dữ liệu nguồn.

Căn cứ pháp lý và nguồn chính thức

Nghị định 254/2026/NĐ-CP, hiệu lực 01/07/2026.
Thông tư 91/2026/TT-BTC, hiệu lực 01/07/2026.
Tổng hợp điểm mới do Cục Thuế công bố.
Hướng dẫn xác thực sinh trắc học người đại diện theo Công văn 3078/CT-NVT.

Quy trình thực hiện

Bước 1: Lập bản đồ dữ liệu từ POS, ERP và kế toán.
Bước 2: Định nghĩa khóa giao dịch và trạng thái.
Bước 3: Kiểm thử ký, cấp mã, lỗi và gửi lại.
Bước 4: Bảo vệ khóa API, webhook và dữ liệu cá nhân.
Bước 5: Chạy song song, đối soát rồi mới cắt chuyển.

Điểm kiểm soát và hồ sơ cần lưu

Dữ liệu đăng ký, cấu hình và phân quyền đang có hiệu lực.
XML, bản thể hiện, chữ ký số và phản hồi của cơ quan thuế.
Mã giao dịch, nhật ký truyền nhận và lịch sử thao tác.
Biên bản kiểm thử, đối soát và xử lý sự cố.
Bản sao lưu, kết quả khôi phục thử và tài liệu nhà cung cấp.

Sai lầm thường gặp

Dùng số hóa đơn làm khóa trước khi cấp.
Không kiểm tra chữ ký webhook.
Cho môi trường thử gọi dữ liệu thật.

So sánh quy định trước và từ 01/07/2026

Tiêu chí	Trước 01/07/2026	Từ 01/07/2026
Căn cứ chính	Nghị định 123/2020, Nghị định 70/2025, Thông tư 32/2025.	Nghị định 254/2026 và Thông tư 91/2026.
Dữ liệu	Đã áp dụng hóa đơn điện tử và định dạng chuẩn.	Tiếp tục chuẩn dữ liệu, tăng kết nối hóa đơn và chứng từ.
Điểm cập nhật	Quy trình theo bộ văn bản giai đoạn trước.	Trước đây nhiều hệ thống truyền lô hoặc nhập tay. Khung 2026 mở rộng dữ liệu kết nối, khiến kiểm soát thời gian thực và dấu vết kỹ thuật trở thành trọng tâm.
Vận hành	Phụ thuộc nhiều vào từng quy trình và nhà cung cấp.	Cần kiểm soát định danh, truyền nhận, nhật ký và khả năng phục hồi.

Ví dụ thực tế

Tình huống: POS tạo đơn, ERP ghi nhận doanh thu, dịch vụ hóa đơn lập và cấp mã; cả ba phải dùng cùng mã giao dịch để không phát hành trùng khi retry.

Nguyên tắc xử lý: Không sửa dữ liệu đã ký; luôn kiểm tra trạng thái, bảo toàn dấu vết và đối soát trước khi gửi lại hoặc khôi phục.

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

PDF có phải dữ liệu gốc của hóa đơn không?

Thông thường PDF là bản thể hiện để đọc. Cần lưu XML, chữ ký, mã và phản hồi truyền nhận theo quy trình áp dụng.

Nhà cung cấp có chịu thay trách nhiệm nội dung không?

Không. Người bán chịu trách nhiệm về tính chính xác của hóa đơn; nhà cung cấp chịu trách nhiệm trong phạm vi dịch vụ kỹ thuật và hợp đồng.

Khi lỗi có được bấm gửi lại ngay không?

Chỉ gửi lại sau khi xác định trạng thái giao dịch cũ chưa được tiếp nhận hoặc xử lý, nhằm tránh phát hành trùng.

Bài liên quan

Cách tra cứu chứng từ điện tử năm 2026