# Tích hợp phần mềm: API, file trung gian hay nhập tay

> Ba mức tích hợp và chi phí tương ứng, khi nào file định kỳ là đủ, và nguyên tắc một dữ liệu chỉ có một chủ.

URL: https://ndtex.vn/tich-hop-phan-mem-api-file-trung-gian-hay-nhap-tay/
Cập nhật: 2026-09-09T11:39:58+07:00

Hai hệ thống cùng chứa danh mục vật tư, cùng cho sửa, và sau sáu tháng không ai biết bên nào đúng. Vấn đề không phải công nghệ tích hợp mà là chưa ai quyết định dữ liệu đó thuộc về hệ nào.

## Nguyên tắc trước công nghệ

Mỗi dữ liệu chỉ có một chủ. Một hệ là nguồn sự thật; các hệ khác đọc, không ghi. Quyết định này phải có trước khi bàn tới API hay file.

Khi hai hệ cùng ghi vào cùng một trường, xung đột không phải khả năng mà là điều chắc chắn xảy ra — và việc xử lý xung đột tốn công hơn nhiều so với tích hợp một chiều.

## Ba mức tích hợp

MứcChi phíHợp khi

Nhập tay hai lầnKhông tốn tiền, tốn công liên tụcSố bản ghi rất ít, tần suất thấp

File trung gian định kỳThấpDữ liệu không cần tức thời, khối lượng vừa

Kết nối trực tiếp qua APICao, kèm chi phí duy trìCần tức thời hoặc khối lượng lớn

Mức giữa bị đánh giá thấp một cách bất công. Một file CSV xuất ra và nạp vào mỗi đêm giải quyết được phần lớn nhu cầu tích hợp trong nhà máy, với chi phí bằng một phần nhỏ so với API — và khi nó hỏng thì ai cũng hiểu vì sao.

Ba mức tích hợp

## Khi nào cần API

- Dữ liệu phải cập nhật trong vài giây, ví dụ trạng thái đơn hàng hiển thị cho khách.

- Khối lượng lớn tới mức file trở nên khó xử lý.

- Cần ghi hai chiều với kiểm soát xung đột.

- Quy trình nghiệp vụ bắc qua hai hệ và không chờ được.

Chưa gặp trường hợp nào thì API là chi phí cho một nhu cầu chưa có, kèm theo một điểm hỏng mới cần duy trì.

## Những gì phải thoả thuận khi tích hợp

- Trường nào đồng bộ, và chiều nào.

- Tần suất và thời điểm chạy.

- Xử lý lỗi — bản ghi lỗi thì bỏ qua, dừng cả lô, hay đưa vào hàng chờ.

- Ai được báo khi tích hợp hỏng, và báo bằng cách nào.

- Nhật ký — lưu bao lâu, ai xem được.

Mục thứ tư quyết định tích hợp có đáng tin không. Một luồng đồng bộ hỏng âm thầm ba ngày nguy hiểm hơn một luồng chưa từng được xây, vì mọi người vẫn tin dữ liệu đang đúng.

Khi nào cần API

## Thử với dữ liệu thật

Kiểm thử bằng dữ liệu mẫu sạch sẽ không phát hiện được vấn đề. Dữ liệu thật có ký tự lạ, trường bỏ trống, mã trùng, đơn vị tính không thống nhất — và đó chính là những thứ làm hỏng tích hợp.

Chạy song song một thời gian: tích hợp chạy nhưng vẫn giữ quy trình cũ, đối chiếu kết quả hằng ngày, và chỉ tắt quy trình cũ khi hai bên khớp nhau qua nhiều chu kỳ.