Doanh nghiệp thường dùng nhiều phần mềm cùng lúc: bán hàng, kế toán, hoá đơn điện tử, cổng thanh toán, đơn vị vận chuyển, Zalo, sàn thương mại điện tử. Khi chúng không nói chuyện với nhau, nhân viên thành người chép dữ liệu. ALODEV viết phần nối giữa các hệ thống qua API, webhook hoặc đọc dữ liệu trực tiếp, kèm những thứ phần nối nào cũng cần mà ít báo giá ghi: hàng đợi khi một bên lỗi, chống ghi trùng, nhật ký từng lần gửi và cảnh báo khi đường nối hỏng.
Tóm tắt
Thời gian
1 đến 4 tuần mỗi đường nối, tuỳ tài liệu API
Cách nối
API, webhook, tệp định kỳ, đọc cơ sở dữ liệu
Luôn có
Hàng đợi, chống trùng, nhật ký, cảnh báo
Sở hữu
Mã nguồn và khoá truy cập đứng tên doanh nghiệp
Dấu hiệu doanh nghiệp cần tích hợp
Cùng một đơn hàng được nhập hai lần: vào phần mềm bán hàng và vào phần mềm kế toán.
Nhân viên mở trang ngân hàng để đối soát từng khoản chuyển khoản với từng đơn.
Trạng thái giao hàng phải chép tay từ trang đơn vị vận chuyển sang hệ thống của mình.
Khách để lại thông tin trên website nhưng tới tay nhân viên kinh doanh sau vài giờ, qua email chuyển tiếp.
Báo cáo cuối tháng gộp từ năm tệp xuất ra từ năm phần mềm.
Mỗi dấu hiệu là một đường nối. Nên làm đường nối gây mất thời gian hoặc sai sót nhiều nhất trước, rồi mới tới đường khác.
Các kiểu kết nối và khi nào dùng
Bốn kiểu kết nối phổ biến
Kiểu
Cách chạy
Hợp khi
Điểm cần lưu ý
API gọi theo yêu cầu
Hệ thống A hỏi hệ thống B khi cần
Tra cứu, tạo đơn, lấy trạng thái
Giới hạn số lần gọi, hết giờ chờ
Webhook
Hệ thống B tự báo cho A khi có sự kiện
Thanh toán thành công, đơn đổi trạng thái
Phải xác minh chữ ký, có thể nhận trùng
Tệp định kỳ
Xuất tệp CSV, Excel, XML theo lịch rồi nhập
Hệ thống cũ không có API
Chậm, cần đối chiếu số dòng
Đọc cơ sở dữ liệu
Đọc trực tiếp bảng dữ liệu của phần mềm cũ
Phần mềm cũ đóng, không có cổng nào khác
Chỉ đọc, dễ vỡ khi phần mềm cũ nâng cấp
Thứ tự ưu tiên của ALODEV: dùng API và webhook chính thức nếu có; không có thì tệp định kỳ; đọc cơ sở dữ liệu là đường cuối và chỉ đọc, không bao giờ ghi thẳng vào dữ liệu của phần mềm khác.
Những đường nối hay gặp ở doanh nghiệp Việt Nam
Nhóm tích hợp thường gặp
Nhóm
Ví dụ
Dữ liệu đi qua
Cổng thanh toán
VNPay, MoMo, ZaloPay
Tạo giao dịch, kết quả thanh toán qua webhook, hoàn tiền
Ngân hàng
API ngân hàng, thông báo biến động số dư
Đối soát chuyển khoản với đơn hàng, công nợ
Vận chuyển
GHN, GHTK, Viettel Post
Tạo vận đơn, phí ship, trạng thái giao
Kế toán, hoá đơn
Phần mềm kế toán, hoá đơn điện tử
Đơn bán, hoá đơn, tệp XML hoá đơn
Kênh bán
Shopee, Lazada, TikTok Shop, website
Đơn hàng, tồn kho, giá
Chăm sóc khách
Zalo OA, ZNS, email, tổng đài
Tin nhắn thông báo, lịch sử liên hệ
Nội bộ
Máy chấm công, Google Workspace, Microsoft 365
Giờ công, tài khoản, lịch
Mỗi nhóm trên có một bài hướng dẫn riêng trong mục Đọc thêm ở cuối trang, gồm tài liệu API chính thức và những chỗ hay vướng khi làm.
Hàng đợi và chống trùng: phần làm nên một đường nối bền
Một đường nối viết nhanh gọi API bên kia, nhận kết quả, xong. Nó chạy tốt trong buổi thử và hỏng lặng lẽ vào ngày bên kia bảo trì máy chủ. ALODEV mô tả phần này bằng một đường nối thật: website alodev.vn gửi yêu cầu tư vấn của khách sang ALODEV AIO, phần mềm quản lý khách hàng của công ty.
Website gửi ngay khi khách bấm gửi, chờ tối đa 6 giây. AIO nhận thì website không lưu gì thêm.
AIO không trả lời hoặc báo lỗi: đơn vào hàng đợi trên máy website, khách vẫn thấy gửi thành công. Không đơn nào rơi.
Cứ 60 giây website gửi lại hàng đợi. AIO nhận đơn nào thì xoá đơn đó khỏi hàng đợi; đơn bị từ chối vì sai dữ liệu thì tách riêng, không chặn cả hàng.
Mỗi đơn mang một mã riêng. AIO gặp lại mã đã có thì trả thành công mà không ghi thêm dòng, nên gửi lại bao nhiêu lần cũng không nhân đôi khách.
Đường nối hỏng lần đầu thì báo ngay vào nhóm chat nội bộ, sau đó nhắc gộp tối đa 6 giờ một lần, và báo khi thông trở lại.
Bước 4 được kiểm bằng phép thử có chủ đích ngày 18/09/2026: đường nhận của AIO giới hạn 20 yêu cầu dồn một lúc rồi 1 yêu cầu mỗi giây. Gửi liền tay 30 đơn thì 19 vào, 11 bị từ chối vì quá nhanh. Gửi lại cả 30 đơn với khoảng cách 1,2 giây thì bảng dữ liệu có đúng 30 dòng, 30 mã khác nhau, không dòng nào bị nhân đôi. Không có bước 4, lần gửi lại đó đã tạo ra 19 khách trùng.
Bảo mật khoá truy cập và dữ liệu
Khoá API, mật khẩu kết nối nằm trong biến môi trường trên máy chủ, không nằm trong mã nguồn, tài liệu hay tin nhắn.
Mỗi đường nối một khoá riêng, quyền tối thiểu; lộ một khoá thì thu hồi một đường, không phải cả hệ thống.
Webhook nhận vào được xác minh chữ ký hoặc khoá bí mật trước khi xử lý.
Khoá đứng tên tài khoản của doanh nghiệp tại nhà cung cấp (cổng thanh toán, vận chuyển), không phải tài khoản của đơn vị làm.
Nhật ký ghi thời điểm, kết quả, mã lỗi của từng lần gửi; không ghi số thẻ, mật khẩu hay dữ liệu nhạy cảm vào nhật ký.
Một trung tâm nối hay nối từng cặp
Ba phần mềm nối từng cặp cần ba đường nối; năm phần mềm cần mười. Khi số hệ thống tăng, nối từng cặp trở thành mạng nhện không ai nắm hết. Khi đó nên có một phần mềm trung tâm giữ dữ liệu chuẩn (khách hàng, đơn hàng, sản phẩm) và các hệ thống khác chỉ nối với nó.
Trung tâm đó thường là chính phần mềm quản lý viết riêng của doanh nghiệp. Ví dụ ALODEV AIO: website, app iPhone, app Android và các công cụ nội bộ đều gọi chung một máy chủ viết bằng Go với khoảng 500 đường API, nên dữ liệu không bao giờ lệch giữa các nơi.
Tệp go.mod thật của ALODEV AIO: mười thư viện khai báo trực tiếp cho toàn bộ backend khoảng 500 đường API.
Là làm cho các phần mềm doanh nghiệp đang dùng trao đổi dữ liệu tự động, qua API, webhook, tệp định kỳ hoặc đọc dữ liệu trực tiếp, để nhân viên không phải nhập lại cùng một dữ liệu ở nhiều nơi.
Phần mềm cũ không có API thì có nối được không?
Thường được: qua tệp xuất định kỳ, hoặc đọc trực tiếp cơ sở dữ liệu ở chế độ chỉ đọc. ALODEV kiểm cụ thể trong buổi khảo sát và nói rõ độ bền của từng cách.
Một bên bị lỗi thì dữ liệu có mất không?
Không, khi đường nối có hàng đợi. Dữ liệu chưa gửi được nằm chờ và được gửi lại tự động khi bên kia thông; mã riêng của từng bản ghi bảo đảm gửi lại không tạo bản trùng.
Tích hợp một cổng thanh toán mất bao lâu?
Thường 1 đến 2 tuần gồm cả thử trên môi trường thử của cổng thanh toán, xử lý webhook, hoàn tiền và đối soát. Thời gian phụ thuộc tài liệu và thủ tục mở tài khoản của nhà cung cấp.
Khoá API do ai giữ?
Doanh nghiệp. Tài khoản tại cổng thanh toán, đơn vị vận chuyển, ngân hàng đứng tên doanh nghiệp; khoá đặt trong biến môi trường trên máy chủ, không nằm trong mã nguồn.
Có tích hợp với phần mềm kế toán đang dùng được không?
Tuỳ phần mềm có mở API hay nhận tệp nhập hay không. Nhiều phần mềm kế toán trong nước nhận nhập chứng từ từ tệp Excel hoặc qua API; ALODEV đọc tài liệu cụ thể trước khi đưa vào phạm vi.
