TÍCH HỢP HỆ THỐNG
Dữ liệu chạy nhanh nhưng vẫn phải đúng, có dấu vết và đối soát được.
Chào bạn,
Tích hợp không phải nối được API là xong. Luồng phải xác định dữ liệu nguồn, thời điểm, người duyệt, lỗi, chống trùng, nhật ký và trách nhiệm giữa các nhà cung cấp. Với hóa đơn và chữ ký số, còn phải theo pháp luật 2026.
Trả lời nhanh
Mình thiết kế bốn luồng riêng: hóa đơn đầu ra, hóa đơn đầu vào, ngân hàng và chữ ký. Mỗi luồng có ID duy nhất, trạng thái, retry, đối soát và cảnh báo. Không cho hệ thống tự hạch toán không kiểm soát.
1. Kiến trúc nguồn chủ
| Dữ liệu | Nguồn chủ gợi ý | Hệ nhận |
|---|---|---|
| Đơn bán | POS, ERP hoặc CRM được chỉ định | Hóa đơn, kế toán |
| Hóa đơn | Hệ hóa đơn điện tử | Kế toán, khách hàng |
| Giao dịch ngân hàng | Ngân hàng hoặc file sao kê | Kế toán |
| Danh mục tài khoản | Phần mềm kế toán | POS, tích hợp |
| Người dùng và quyền | Hệ định danh được chọn | Các ứng dụng |
Một trường dữ liệu chỉ có một nguồn chủ. Nếu hai hệ cùng được sửa, cần quy tắc ưu tiên và xử lý xung đột.
2. Khung pháp luật
Hóa đơn theo Luật Quản lý thuế, Nghị định 254/2026 và Thông tư 91/2026. Chữ ký điện tử và dịch vụ tin cậy theo Luật Giao dịch điện tử 20/2023 và Nghị định 23/2025. Dữ liệu theo Luật Dữ liệu, Luật Bảo vệ dữ liệu cá nhân và văn bản hướng dẫn hiện hành.
3. Luồng hóa đơn đầu ra
- Đơn đạt trạng thái đủ điều kiện.
- Kiểm tra khách, hàng, thuế, đơn vị, thời điểm.
- Tạo nháp có ID nguồn.
- Người có quyền kiểm tra, ký.
- Gửi và nhận phản hồi.
- Đồng bộ trạng thái, số, XML về nguồn.
- Hạch toán theo mapping đã duyệt.
4. Luồng hóa đơn đầu vào
Tệp đầu vào được tiếp nhận, kiểm tra trùng, người bán, trạng thái, dữ liệu và phân loại. AI có thể gợi ý nhưng người có trách nhiệm duyệt tài khoản, đối tượng, kỳ và điều kiện thuế.
5. Luồng ngân hàng
Nhập API hoặc sao kê, giữ mã giao dịch, ngày, số tiền, nội dung. Rule ghép công nợ cần độ tin cậy và hàng chờ. Không tự ghép chỉ theo số tiền nếu nhiều giao dịch giống nhau.
| Trạng thái | Xử lý |
|---|---|
| Khớp chắc chắn | Tạo đề nghị hoặc chứng từ theo quyền |
| Khớp nhiều khả năng | Đưa người kiểm tra |
| Không khớp | Hàng chờ có owner |
| Trùng | Chặn bằng ID ngân hàng |
| Đảo, hoàn | Liên kết giao dịch gốc |
6. Chữ ký số
Tách người lập, kiểm tra và ký. Dữ liệu tạo chữ ký phải nằm trong kiểm soát người ký theo cơ chế pháp luật và nhà cung cấp. Chứng thư hết hạn, thu hồi hoặc đổi người phải cập nhật nhanh.
Không lưu mã mở khóa trong mã nguồn hoặc bảng chia sẻ. Ký tự động cần phạm vi, hạn mức, log, cảnh báo và người chịu trách nhiệm.
7. Chống trùng và xử lý retry
- Mỗi giao dịch có idempotency key.
- Retry không tạo chứng từ mới.
- Trạng thái có mã lỗi và thời điểm.
- Không sửa lặng lẽ dữ liệu đã ký.
- Hàng chờ có SLA, owner.
- Đối soát tổng theo ngày.
8. Phân quyền và bảo vệ dữ liệu
Đánh giá dữ liệu cá nhân, tài chính đi qua từng bên. Hợp đồng xác định mục đích, phạm vi, bảo mật, lưu, xóa, sự cố và bên thứ ba. Quyền API tối thiểu, khóa được xoay và thu hồi.
9. Giám sát và đối soát
| Chỉ số | Cảnh báo |
|---|---|
| Tỷ lệ đồng bộ thành công | Giảm dưới ngưỡng nội bộ |
| Thời gian phản hồi | Tăng bất thường |
| Giao dịch chờ | Quá SLA |
| Giao dịch trùng | Phải bằng 0 sau kiểm soát |
| Chênh tổng | Bán hàng – hóa đơn – kế toán – ngân hàng |
| Lỗi theo phiên bản | Tăng sau cập nhật |
10. Thử nghiệm trước triển khai
- Môi trường test tách dữ liệu thật.
- Giao dịch bình thường và ngoại lệ.
- Mất mạng, timeout, gửi lại.
- Đổi chứng thư, người ký.
- Hủy hoặc sửa ở hệ nguồn.
- Khối lượng cao điểm.
- Phục hồi và replay có kiểm soát.
11. Checklist nghiệm thu
- Sơ đồ dữ liệu và owner.
- Mapping trường và tài khoản.
- Luồng lỗi, retry, chống trùng.
- Phân quyền và log.
- Luật hóa đơn, chữ ký, dữ liệu được kiểm tra.
- Đối soát tổng và chi tiết.
- SLA và đầu mối các bên.
- Tài liệu vận hành, phương án quay lại.
12. FAQ
API hoạt động là tích hợp xong?
Chưa. Cần xử lý trạng thái, lỗi, retry, quyền, đối soát và trách nhiệm.
Có nên tự động hạch toán 100%?
Chỉ giao dịch đủ tin cậy; ngoại lệ phải qua người duyệt.
Ai xử lý khi lỗi giữa hai nhà cung cấp?
Hợp đồng và sơ đồ vận hành phải có owner, SLA, dữ liệu chẩn đoán.
13. Từ điển dữ liệu và mapping
| Trường | Định nghĩa cần chốt | Lỗi thường gặp |
|---|---|---|
| Mã giao dịch | Duy nhất toàn luồng | Đổi ID, tạo trùng |
| Ngày chứng từ | Ngày nghiệp vụ theo quy tắc | Lẫn ngày gửi |
| Ngày hạch toán | Kỳ ghi sổ | Sai cut-off |
| Đối tượng | Mã khách, NCC duy nhất | Trùng hoặc thiếu MST |
| Số tiền | Nguyên tệ, quy đổi, làm tròn | Sai dấu, thập phân |
| Trạng thái | Nháp, ký, gửi, chấp nhận, lỗi | Hai hệ hiểu khác |
Từ điển dữ liệu có owner và phiên bản. Mỗi thay đổi field hoặc enum phải thông báo, test tương thích và kế hoạch chuyển.
14. Quản lý khóa API và chứng thư
- Không lưu khóa trong mã nguồn hoặc chat.
- Dùng kho bí mật, quyền tối thiểu.
- Xoay khóa định kỳ và khi nhân sự đổi.
- Tách môi trường test và thật.
- Giới hạn IP, phạm vi nếu hỗ trợ.
- Log sử dụng và cảnh báo bất thường.
Chứng thư số có lịch gia hạn, người sở hữu, thiết bị hoặc dịch vụ. Thử quy trình đổi chứng thư trước khi hết hạn.
15. Hàng chờ ngoại lệ
Không bỏ lỗi vào log kỹ thuật rồi chờ. Hàng chờ cần hiển thị giao dịch, nguồn, mã lỗi, mức ảnh hưởng, số lần thử, owner và hạn. Người nghiệp vụ phải hiểu lỗi nào sửa dữ liệu, lỗi nào cần nhà cung cấp.
| Mức | Ví dụ | SLA nội bộ |
|---|---|---|
| Chặn | Không phát hành, không ghi tiền | Xử lý ngay |
| Cao | Sai số, trùng, mất trạng thái | Trong ngày |
| Trung bình | Thiếu chiều quản trị | Theo kỳ đối soát |
| Thấp | Hiển thị, mô tả | Gom cải tiến |
16. Kế hoạch liên tục
Khi hóa đơn hoặc ngân hàng gián đoạn, hệ thống cần lưu hàng chờ mà không tạo trùng. Quy trình thủ công tạm thời có số thứ tự, quyền và bước nhập lại. Sau phục hồi, đối soát toàn bộ khoảng gián đoạn.
Không thiết kế tích hợp khiến POS dừng hoàn toàn chỉ vì một hệ phụ lỗi, trừ khi pháp luật hoặc nghiệp vụ bắt buộc. Mức suy giảm phải được quyết định trước.
17. Kiểm toán tích hợp
- Chọn mẫu từ nguồn tới sổ và ngược lại.
- Kiểm tra ID, timestamp, người ký, trạng thái.
- So tổng theo ngày, kênh, phương thức.
- Rà giao dịch retry, trùng, đảo.
- Rà quyền API, tài khoản dịch vụ.
- Rà thay đổi mapping và phiên bản.
18. 30 ngày vận hành đầu
Tuần đầu theo dõi liên tục và đối soát ngày. Tuần hai xử lý lỗi lặp, tuần ba test cao điểm, tuần bốn nghiệm thu SLA, tài liệu và bàn giao. Chỉ mở thêm automation khi luồng cốt lõi ổn.
19. Hợp đồng giữa các nhà cung cấp
Nếu POS, hóa đơn, ngân hàng, kế toán do nhiều bên cung cấp, mỗi hợp đồng cần điểm giao, định dạng, SLA, log và trách nhiệm. Không để khoảng trống khi bên A nói đã gửi còn bên B nói chưa nhận.
Doanh nghiệp nên có đầu mối tích hợp tổng và quyền truy log hai bên. Khi nâng phiên bản, bên thay đổi phải thông báo, cung cấp môi trường test và thời gian tương thích.
20. Quản lý phiên bản API
- Ghi endpoint, version, schema.
- Không thay field âm thầm.
- Có deprecation notice.
- Test backward compatibility.
- Quản lý quota và timeout.
- Changelog và owner.
21. Đối soát bốn chiều
| Nguồn | Tổng cần so |
|---|---|
| Bán hàng | Đơn hoàn tất, giảm, hoàn |
| Hóa đơn | Giá trị, trạng thái, thời điểm |
| Ngân hàng, tiền | Thu theo phương thức, phí |
| Kế toán | Doanh thu, thuế, công nợ, tiền |
Chênh lệch được phân nhóm thời điểm, phí, công nợ, lỗi, hoàn. Báo cáo hàng ngày cho vận hành và hàng tháng cho khóa sổ.
22. Sự cố chữ ký
Khi chứng thư hết hạn, bị thu hồi hoặc mất kiểm soát, khóa hoạt động liên quan, báo người có thẩm quyền và nhà cung cấp. Không đổi người ký bằng chia sẻ khóa. Sau khôi phục, rà giao dịch trong khoảng sự cố.
23. Kiểm soát tự động hạch toán
- Rule có phiên bản và ngày hiệu lực.
- Ngưỡng tin cậy cho AI hoặc matching.
- Ngoại lệ vào hàng duyệt.
- Báo cáo bút toán tự động riêng.
- Test sau cập nhật.
- Có cách đảo theo phê duyệt.
24. Hồ sơ bàn giao
Gồm kiến trúc, từ điển dữ liệu, mapping, API, quyền, khóa, runbook, log, dashboard, test, lỗi mở, hợp đồng và contact. Không nghiệm thu khi hệ thống chỉ một người hiểu.
25. Hội đồng thay đổi tích hợp
Mọi thay đổi mapping, API, rule hạch toán, chữ ký hoặc hóa đơn được review bởi nghiệp vụ, kế toán, IT và bảo mật phù hợp. Thay đổi có risk, test, rollback, lịch và người duyệt.
26. Ma trận RACI vận hành
| Hoạt động | Chủ trì | Phối hợp |
|---|---|---|
| Mapping nghiệp vụ | Kế toán | Vận hành, IT |
| API, hạ tầng | IT hoặc nhà tích hợp | Nhà cung cấp |
| Hóa đơn | Kế toán thuế | Bán hàng, nhà HĐĐT |
| Chữ ký | Người được ủy quyền | IT, pháp chế |
| Sự cố dữ liệu | Bảo mật, owner dữ liệu | Các bên liên quan |
| Đối soát | Kế toán tổng hợp | Bán hàng, ngân hàng |
27. Kiểm tra thay đổi pháp luật
Khi Nghị định, Thông tư hoặc chuẩn XML đổi, không chỉ cập nhật phần mềm hóa đơn. Rà mapping, field, rule, mẫu, báo cáo, chữ ký, test và đào tạo. Ghi ngày hiệu lực và giao dịch chịu ảnh hưởng.
28. Bài test cuối
- Tạo 100 giao dịch gồm bình thường và ngoại lệ.
- Ngắt một hệ thống giữa luồng.
- Gửi lại, bảo đảm không trùng.
- Đổi người ký và khóa cũ.
- Đối soát bốn nguồn.
- Xuất log, dữ liệu, báo cáo.
- Khôi phục từ backup cấu hình.
Chỉ nghiệm thu khi kết quả đo được và đội vận hành tự xử lý kịch bản, không phụ thuộc người triển khai đứng bên cạnh.
Kết luận
Tích hợp tốt không chỉ nhanh mà phải kiểm tra được. Mỗi giao dịch cần ID, trạng thái, quyền, log và cầu nối tới chứng từ, sổ, ngân hàng, hóa đơn.
Doanh nghiệp chỉ tự động hóa sâu sau khi luồng cốt lõi ổn và ngoại lệ có owner. Mọi thay đổi API, luật hóa đơn, chữ ký hoặc mapping phải được test, đối soát và có phương án quay lại.
– Gr Hanh Lee · Một người, ít lời – nhiều ý, nhiều hành trình
Lặng lẽ học, vững vàng đi 🌸