Nội dung bài viết
Kết nối API hóa đơn điện tử với website hoặc máy POS giúp mỗi đơn hàng tự sinh hoá đơn, không cần kế toán nhập lại. Phần khó không nằm ở việc gọi API, mà ở các tình huống hoàn tiền, huỷ đơn, chiết khấu. Bài viết trình bày kiến trúc tham khảo, các điểm dễ lỗi và cách ước tính chi phí, theo góc nhìn kế toán mà ACCA Consulting Vietnam dùng khi tư vấn cho startup và doanh nghiệp bán lẻ.
1. Kiến trúc kết nối API hóa đơn điện tử
Một kiến trúc tối giản gồm bốn thành phần: hệ thống bán hàng (website, POS), lớp trung gian xử lý, nhà cung cấp hoá đơn điện tử và phần mềm kế toán. Lớp trung gian có thể là một dịch vụ nhỏ do doanh nghiệp tự viết hoặc công cụ tích hợp có sẵn.
- 1Đơn hoàn tất
Website, POS ghi nhận đơn đã thanh toán hoặc đã giao, gửi sự kiện sang lớp trung gian.
- 2Chuẩn hoá dữ liệu
Lớp trung gian ánh xạ mã hàng, thuế suất, thông tin người mua theo mẫu của nhà cung cấp.
- 3Gọi API phát hành
Gửi dữ liệu kèm mã đơn hàng làm khoá chống trùng; nhà cung cấp ký và chuyển cơ quan thuế theo quy trình.
- 4Nhận kết quả
Lưu số hoá đơn, mã tra cứu, trạng thái vào đơn hàng; gửi hoá đơn cho khách.
- 5Đồng bộ kế toán
Đẩy dữ liệu hoá đơn sang phần mềm kế toán hoặc xuất file định kỳ để đối chiếu.
Nguyên tắc quan trọng: lớp trung gian phải ghi nhật ký mọi lần gọi và phản hồi. Khi có tranh chấp hoặc lỗi, nhật ký giúp xác định hoá đơn đã phát hành hay chưa.
2. Điểm dễ lỗi khi kết nối: góc nhìn kế toán
| Tình huống | Rủi ro | Cách thiết kế gợi ý |
|---|---|---|
| Huỷ đơn trước khi xuất hoá đơn | Vẫn phát hành hoá đơn | Chỉ phát hành khi đơn ở trạng thái hoàn tất |
| Huỷ, trả hàng sau khi đã xuất | Doanh thu ghi nhận sai | Đưa vào hàng chờ kế toán xử lý theo quy định về hoá đơn sai sót, điều chỉnh |
| Hoàn tiền một phần | Tổng hoá đơn khác tiền thực thu | Tách luồng hoàn tiền, đối chiếu với cổng thanh toán |
| Chiết khấu, voucher | Sai cách thể hiện giảm giá trên hoá đơn | Thống nhất với kế toán cách ghi dòng chiết khấu trước khi lập trình |
| Giao hàng nhiều lần | Xuất hoá đơn sai thời điểm | Xác định thời điểm lập hoá đơn cùng kế toán |
| Mất kết nối, gửi lại | Hoá đơn trùng | Dùng mã đơn hàng làm khoá duy nhất, kiểm tra trước khi gửi lại |
Theo kinh nghiệm của ACCA Consulting Vietnam, nhiều rắc rối sau khi chạy thật đến từ việc đội kỹ thuật tự quyết cách xử lý chiết khấu và hoàn tiền mà không hỏi kế toán. Hãy đưa kế toán vào ngay từ giai đoạn đặc tả. Với hoá đơn đã phát hành có sai sót, tham khảo sơ đồ xử lý hóa đơn điện tử sai sót.
3. Ước tính chi phí tích hợp
Chi phí phụ thuộc nền tảng bán hàng, nhà cung cấp hoá đơn và mức tuỳ biến. Bảng dưới là ví dụ minh hoạ để doanh nghiệp tự lập dự toán, không phải báo giá.
Ví dụ minh hoạ với giả định đơn giá và khối lượng; doanh nghiệp cần xin báo giá thực tế từ đơn vị phát triển và nhà cung cấp.
Xem dạng bảng
| Tự phát triển | Công cụ có sẵn | |
|---|---|---|
| Phân tích, đặc tả | 10 triệu đ | 3 triệu đ |
| Lập trình, cấu hình | 40 triệu đ | 5 triệu đ |
| Kiểm thử với kế toán | 15 triệu đ | 5 triệu đ |
| Vận hành, phí năm đầu | 12 triệu đ | 12 triệu đ |
| Hạng mục | Câu hỏi cần trả lời | Ước tính |
|---|---|---|
| Phân tích | Có bao nhiêu kênh bán, loại giao dịch đặc biệt? | ... ngày công |
| Lập trình | Nhà cung cấp hoá đơn có tài liệu API, môi trường thử nghiệm không? | ... ngày công |
| Kiểm thử | Bộ tình huống: huỷ, hoàn, chiết khấu, trùng, mất kết nối đã đủ chưa? | ... ngày công |
| Vận hành | Ai theo dõi lỗi hằng ngày, phí dịch vụ hằng năm bao nhiêu? | ... đồng/năm |
Ví dụ minh hoạ cho doanh nghiệp giả định khoảng 3.000 đơn/tháng.
Xem dạng bảng
| Nhập tay | 60 giờ |
| Nhập file Excel theo ngày | 15 giờ |
| Kết nối API, xử lý ngoại lệ | 5 giờ |
4. Lộ trình triển khai và dùng AI hỗ trợ
- Tuần 1–2
Đặc tả cùng kế toán: thời điểm xuất, chiết khấu, hoàn tiền, khách doanh nghiệp.
- Tuần 3–5
Lập trình trên môi trường thử nghiệm của nhà cung cấp.
- Tuần 6
Kiểm thử bộ tình huống, kế toán duyệt hoá đơn mẫu.
- Tuần 7
Chạy song song với cách cũ, đối chiếu hằng ngày.
- Tuần 8
Chuyển chính thức, theo dõi nhật ký lỗi.
Trợ lý AI có thể giúp viết đặc tả, bộ tình huống kiểm thử. Không dán khoá API, mật khẩu hay dữ liệu khách hàng thật vào công cụ AI công cộng.
| Mục đích | Câu lệnh gợi ý |
|---|---|
| Bộ tình huống kiểm thử | "Liệt kê 20 tình huống kiểm thử cho tích hợp website bán hàng với phần mềm hoá đơn điện tử: huỷ đơn, hoàn tiền một phần, voucher, giao nhiều lần, mất kết nối, gửi trùng. Mỗi tình huống có kết quả mong đợi." |
| Đặc tả ánh xạ | "Tạo bảng ánh xạ trường dữ liệu từ đơn hàng (mã đơn, khách, dòng hàng, thuế suất, chiết khấu) sang trường hoá đơn, có cột 'kế toán xác nhận'." |
Sau khi chạy ổn định, bước tiếp theo là đối chiếu 3 chiều hoá đơn, doanh thu, tiền về.
Câu hỏi thường gặp
Startup nhỏ có nên làm API ngay từ đầu?
Nếu số đơn còn ít, nhập file Excel theo ngày thường đủ và rẻ hơn. Nên thiết kế dữ liệu đơn hàng chuẩn ngay từ đầu để chuyển sang API dễ dàng sau này.
Ai chịu trách nhiệm khi API xuất sai hoá đơn?
Doanh nghiệp là người bán vẫn chịu trách nhiệm về hoá đơn đã lập. Vì vậy cần nhật ký, đối chiếu hằng ngày và quy trình xử lý sai sót rõ ràng.
Có cần môi trường thử nghiệm của nhà cung cấp hoá đơn không?
Rất nên. Kiểm thử trên môi trường thật có thể phát hành hoá đơn thật, sau đó phải xử lý sai sót.
ACCA Consulting Vietnam có hỗ trợ kết nối API hóa đơn điện tử không?
Chúng tôi không lập trình tích hợp, nhưng hỗ trợ phần nghiệp vụ: đặc tả cách xuất hoá đơn, duyệt hoá đơn mẫu khi kiểm thử và đối chiếu sau khi chạy thật.
Tích hợp hoá đơn đúng nghiệp vụ ngay từ đầu
ACCA Consulting Vietnam (ACCA Consulting VN) cùng đội kỹ thuật thống nhất quy tắc xuất hoá đơn và đối chiếu trong gói dịch vụ kế toán. Nhận tư vấn.
Nhận tư vấn miễn phíZaloWhatsApp
