Bỏ qua đến nội dung
Quay lại Blog

Kết nối AI với KiotViet, Haravan, Sapo, MISA: Làm được gì, cần kiểm tra gì trước?

Tổng hợp những gì KiotViet, Haravan, Sapo và MISA AMIS Kế toán công bố về API, webhook; năm kịch bản AI xếp theo rủi ro, kiến trúc tích hợp an toàn và 10 câu hỏi kỹ thuật trước khi kết nối.

Kết nối AI với KiotViet, Haravan, Sapo, MISA: Làm được gì, cần kiểm tra gì trước?

Trả lời ngắn: AI không "đọc thẳng" phần mềm bán hàng hay kế toán; nó kết nối qua API và webhook mà từng nền tảng cung cấp. Haravan, Sapo, KiotViet và MISA AMIS Kế toán đều có tài liệu công khai về API hoặc webhook, nhưng phạm vi khác nhau. Hãy bắt đầu với kịch bản chỉ đọc (tra giá, tồn kho, báo cáo), và chỉ cho AI ghi dữ liệu (đơn hàng, chứng từ) khi đã có bước duyệt, chống trùng và nhật ký.

Phần lớn SME Việt Nam vận hành trên một phần mềm bán hàng và một phần mềm kế toán quen thuộc. Khi nghĩ đến AI, câu hỏi tự nhiên là: chatbot có trả lời được tồn kho thật không, có tự tạo đơn được không, có đẩy chứng từ sang kế toán được không?

Câu trả lời phụ thuộc vào ba thứ: nền tảng công bố API gì, gói dịch vụ của bạn có quyền dùng API đó không, và quy trình kiểm soát phía bạn chặt đến đâu. Bài viết tổng hợp những gì bốn nền tảng phổ biến công bố công khai, các kịch bản nên và chưa nên làm, cùng checklist kỹ thuật trước khi tích hợp.

FlowNexa không phải đối tác chính thức của các nền tảng nêu trong bài. Thông tin lấy từ tài liệu công khai tại thời điểm viết và có thể thay đổi; hãy xác nhận với nhà cung cấp phần mềm của bạn.

Nguyên lý

AI kết nối với phần mềm bán hàng, kế toán bằng cách nào?

Có hai cơ chế chính:

  • API (gọi chủ động): hệ thống AI hoặc workflow gọi vào phần mềm để lấy dữ liệu (giá, tồn kho, đơn hàng) hoặc tạo, cập nhật dữ liệu. API luôn yêu cầu xác thực và thường có giới hạn số lần gọi.
  • Webhook (nhận thông báo): phần mềm tự gửi thông báo khi có sự kiện, ví dụ đơn hàng mới, đơn được thanh toán, khách hàng mới. Hệ thống nhận cần trả lời nhanh và xác minh thông báo đến từ đúng nguồn.

AI thường không gọi API trực tiếp. Cách an toàn hơn là đặt AI trong một workflow (ví dụ n8n): workflow lo việc gọi API, áp dụng quy tắc cố định, còn AI chỉ xử lý những bước cần hiểu ngôn ngữ như phân loại yêu cầu, trích xuất thông tin, soạn câu trả lời.

Nền tảng

KiotViet, Haravan, Sapo, MISA công bố những gì?

Bảng tổng hợp tài liệu API và webhook công khai của Haravan, Sapo, KiotViet và MISA AMIS Kế toán
Khả năng thực tế còn phụ thuộc gói dịch vụ và phiên bản bạn đang dùng; hãy kiểm tra với nhà cung cấp.

Chi tiết từ tài liệu công khai của từng nền tảng:

  • Haravan: bộ tài liệu API cho nhà phát triển mô tả Admin API dùng để đọc và ghi dữ liệu về cửa hàng, sản phẩm, đơn hàng và các đối tượng khác. Mọi API đều yêu cầu xác thực và có giới hạn tốc độ.
  • Sapo: trang hướng dẫn webhook liệt kê các sự kiện cho đơn hàng (tạo, thanh toán, hủy, giao hàng…), sản phẩm, khách hàng, giao vận và hoàn tiền. Webhook được quản lý qua Admin API; mỗi webhook cần một chủ đề và một địa chỉ URL, và được tạo cho một Sapo App đã cài đặt.
  • KiotViet: có các hướng dẫn kết nối API và thiết lập webhook. Với ví dụ ngành khách sạn, webhook gửi sự kiện đặt phòng, khách hàng, hóa đơn, thanh toán QR dưới dạng HTTP POST JSON, kèm chữ ký x-signature theo chuẩn HMAC-SHA256; máy chủ nhận phải phản hồi mã 200 trong vòng 3 giây.
  • MISA AMIS Kế toán: trung tâm trợ giúp hướng dẫn bật tùy chọn cho phép đẩy dữ liệu từ phần mềm khác qua kết nối API, thiết lập quy tắc dữ liệu và đồng bộ chứng từ bán hàng, kèm liên kết đến tài liệu OpenAPI cho nhà phát triển.

Điểm chung: tài liệu công khai chưa phải lời cam kết rằng gói của bạn dùng được. Trước khi lên kế hoạch, hãy hỏi nhà cung cấp phần mềm: gói hiện tại có quyền dùng API không, giới hạn bao nhiêu lần gọi, ai cấp quyền ứng dụng, và có môi trường thử nghiệm không.

Kịch bản

AI nên làm gì trước, việc gì để sau?

Bảng năm kịch bản kết nối AI với phần mềm bán hàng và kế toán, phân loại đọc hoặc ghi, mức rủi ro và kiểm soát cần có
Bắt đầu với kịch bản chỉ đọc; chỉ cho AI ghi dữ liệu khi đã có bước duyệt và nhật ký.

Kịch bản chỉ đọc là điểm bắt đầu tốt nhất:

  • Chatbot tra giá, tồn kho thật. Thay vì trả lời "vui lòng liên hệ để biết còn hàng không", chatbot tra API và trả lời ngay. Cần giới hạn trường hiển thị (ví dụ chỉ báo "còn hàng" thay vì số lượng chính xác) và kiểm tra dữ liệu có cập nhật kịp không, nhất là khi bán đa kênh; xem đơn hàng đa kênh và tồn kho.
  • Báo cáo quản trị mỗi sáng. Tổng hợp doanh thu, đơn hàng, công nợ từ phần mềm bán hàng và kế toán vào một bản tóm tắt; xem tự động tạo báo cáo quản trị từ nhiều nguồn.
  • Tra tình trạng đơn cho khách. Hữu ích nhưng cần xác minh người hỏi đúng là chủ đơn trước khi trả thông tin, tránh lộ địa chỉ, số điện thoại của khách khác.

Kịch bản ghi dữ liệu cần bước duyệt:

  • Tạo đơn nháp từ hội thoại. AI soạn đơn nháp từ nội dung khách nhắn, nhân viên kiểm tra và xác nhận. Không để AI tự xác nhận đơn.
  • Đẩy chứng từ sang kế toán. Đây là kịch bản rủi ro cao nhất vì ảnh hưởng trực tiếp đến sổ sách và thuế. Cần kế toán duyệt, chống trùng chứng từ và lưu nhật ký mọi thay đổi; xem AI đọc sai hóa đơn: kiểm soát trước khi đưa vào kế toán.

Kiến trúc

Thiết kế luồng tích hợp an toàn như thế nào?

Luồng tích hợp an toàn: webhook đến, hàng đợi chống trùng, workflow quy tắc nghiệp vụ, bước AI, duyệt rồi mới ghi
AI chỉ là một bước trong luồng; quy tắc cố định và bước duyệt giữ dữ liệu kế toán, tồn kho an toàn.

Năm nguyên tắc kỹ thuật giúp tích hợp chạy ổn định lâu dài:

  1. Nhận nhanh, xử lý sau. Webhook có thể yêu cầu phản hồi trong vài giây (KiotViet nêu 3 giây cho ví dụ ngành khách sạn). Hãy xác minh chữ ký, trả mã 200 ngay và đưa sự kiện vào hàng đợi; việc gọi AI hay API khác làm ở bước sau.
  2. Một sự kiện chỉ xử lý một lần. Webhook có thể được gửi lại khi mạng chậm hoặc lỗi. Dùng mã sự kiện để chống trùng; xem webhook gửi nhiều lần: chỉ xử lý một lần và retry không tạo dữ liệu trùng.
  3. Ít quyền nhất. Ứng dụng tích hợp chỉ được cấp đúng quyền cần dùng. Chatbot tra tồn kho không cần quyền tạo phiếu chi. Xem thiết kế permission cho AI Agent.
  4. Bảo vệ khóa API. Token và khóa bí mật lưu trong kho credential, không nằm trong mã nguồn hay bảng tính; xem quản lý credential và API key an toàn trong n8n.
  5. Không gom toàn bộ dữ liệu về một chỗ. AI chỉ cần lấy đúng dữ liệu cho từng câu hỏi qua API, thay vì sao chép cả cơ sở dữ liệu bán hàng; xem AI Agent dùng nhiều hệ thống mà không gom dữ liệu.

Ví dụ

Một ví dụ đi qua từng bước: chatbot trả lời "còn hàng không?"

Giả sử một cửa hàng bán trên website và Zalo, quản lý tồn kho trên phần mềm bán hàng có API đọc sản phẩm (ví dụ minh họa, không gắn với nền tảng cụ thể):

  1. Khách hỏi: "Áo khoác size L màu xanh còn không?"
  2. AI hiểu câu hỏi: trích ra sản phẩm "áo khoác", thuộc tính "size L, màu xanh". Nếu không chắc là mẫu nào, chatbot hỏi lại thay vì đoán.
  3. Workflow gọi API: tìm sản phẩm theo tên và thuộc tính, lấy số lượng tồn của biến thể tương ứng. Bước này do workflow làm theo quy tắc cố định, không để AI tự tạo câu truy vấn tùy ý.
  4. Áp quy tắc hiển thị: nếu tồn trên ngưỡng an toàn (ví dụ 3), trả lời "còn hàng"; nếu dưới ngưỡng, trả lời "sắp hết, bạn muốn giữ hàng không?"; nếu hết, gợi ý màu khác còn hàng.
  5. Chuyển người khi cần: khách muốn giữ hàng hoặc đặt số lượng lớn thì chuyển nhân viên kèm tóm tắt.
  6. Ghi nhật ký: lưu câu hỏi, sản phẩm đã tra và câu trả lời để kiểm tra khi có khiếu nại.

Chỉ có bước 2 cần AI. Phần còn lại là quy tắc nghiệp vụ rõ ràng, dễ kiểm thử, nên kịch bản này rủi ro thấp mà giá trị thấy ngay: khách nhận câu trả lời trong vài giây, kể cả ngoài giờ.

Checklist

10 câu hỏi kỹ thuật cần trả lời trước khi tích hợp

  1. Gói phần mềm hiện tại có quyền dùng API và webhook không?
  2. Dữ liệu cần dùng (giá, tồn kho, đơn hàng, chứng từ) có trong API công khai không?
  3. Ai trong doanh nghiệp cấp quyền ứng dụng, và quyền đó gồm những gì?
  4. Giới hạn số lần gọi API là bao nhiêu, có đủ cho giờ cao điểm không?
  5. Webhook xác minh nguồn gửi bằng cách nào (chữ ký, khóa bí mật)?
  6. Hệ thống nhận phải phản hồi trong bao lâu, và có gửi lại khi lỗi không?
  7. Có môi trường thử nghiệm để chạy thử mà không ảnh hưởng dữ liệu thật không?
  8. Thao tác ghi nào cần người duyệt, và ai là người duyệt?
  9. Khi tích hợp lỗi, ai nhận cảnh báo và quy trình xử lý thế nào?
  10. Nhật ký thay đổi được lưu ở đâu, giữ bao lâu?

Hỏi đáp

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

Chatbot có trả lời được tồn kho thật từ phần mềm bán hàng không?

Được, nếu phần mềm cung cấp API đọc tồn kho và gói của bạn có quyền dùng. Nên cân nhắc hiển thị "còn hàng/hết hàng" thay vì số lượng chính xác, và kiểm tra độ trễ cập nhật khi bán trên nhiều kênh.

AI có tự tạo đơn hàng trên phần mềm bán hàng được không?

Về kỹ thuật là có thể nếu API cho phép ghi đơn. Nhưng nên để AI tạo đơn nháp và nhân viên xác nhận, ít nhất trong giai đoạn đầu, vì sai sót về giá, số lượng hay địa chỉ ảnh hưởng trực tiếp đến khách hàng.

Có nên cho AI đẩy chứng từ thẳng vào phần mềm kế toán không?

Chỉ khi có bước kế toán duyệt, cơ chế chống trùng và nhật ký thay đổi. Chứng từ kế toán ảnh hưởng đến sổ sách và nghĩa vụ thuế, nên đây là kịch bản cần kiểm soát chặt nhất.

FlowNexa có phải đối tác của KiotViet, Haravan, Sapo hay MISA không?

Không. Bài viết dựa trên tài liệu công khai của các nền tảng. Khi triển khai, FlowNexa làm việc với API mà doanh nghiệp được cấp quyền sử dụng và khuyến nghị xác nhận phạm vi API với nhà cung cấp phần mềm.

Không có API thì có tích hợp được không?

Có thể dùng cách tạm thời như xuất file định kỳ, nhưng kém tin cậy và khó kiểm soát. Không nên tự động hóa bằng cách giả lập thao tác trên giao diện (đăng nhập, bấm nút) cho dữ liệu tiền và kho, vì dễ lỗi khi giao diện thay đổi và khó truy vết.

Bắt đầu từ kịch bản nào là hợp lý nhất?

Báo cáo quản trị mỗi sáng hoặc chatbot tra giá, tồn kho: chỉ đọc dữ liệu, rủi ro thấp, giá trị thấy ngay. Khi luồng đọc chạy ổn định, mới mở rộng sang tạo đơn nháp và chứng từ có duyệt.

Nguồn tham khảo

FlowNexa

Kết nối AI với hệ thống bạn đang dùng

FlowNexa khảo sát API của phần mềm bán hàng, kế toán bạn đang dùng, đề xuất kịch bản chỉ đọc trước và thiết kế bước duyệt cho thao tác ghi.