Kết nối API giữa ERP và bên thứ ba
ERP với bên thứ ba: CRM, logistics, thuế và danh tính
Kết nối REST, SOAP, webhook và iPaaS giữa ERP của bạn và các dịch vụ xung quanh, với thử lại và cảnh báo.
Bản thiết kế
Cuộn ngang để xem toàn bộ bản vẽ.
ERP sang bên thứ ba: một nền tảng, nhiều đối tác
Sự kiện kinh doanh rời ERP một lần và nền tảng tích hợp chuyển chúng đến từng đối tác theo định dạng đối tác cần. Callback quay về cùng đường. Thông điệp vẫn thất bại sau khi thử lại được đưa vào hàng đợi tin nhắn lỗi và tạo cảnh báo kèm dữ liệu.
- Luồng chính
- Bất đồng bộ
- Luồng ngoại lệ
Luồng gồm 9 bước
Luồng xử lý, từng bước
- Từ ERP đến Nền tảng tích hợp: Sự kiện kinh doanh, qua REST · OData · webhook (luồng chính).
- Từ Nền tảng tích hợp đến CRM: Khách hàng và đơn hàng, qua REST/JSON (luồng chính).
- Từ Nền tảng tích hợp đến Logistics và hãng vận chuyển: Lô hàng đã đặt, qua REST/JSON (luồng chính).
- Từ Logistics và hãng vận chuyển đến Nền tảng tích hợp: Sự kiện theo dõi, qua webhook (bất đồng bộ).
- Từ Nền tảng tích hợp đến Nền tảng hóa đơn điện tử và thuế: Hóa đơn để phê duyệt, qua SOAP/XML · REST (luồng chính).
- Từ Nền tảng tích hợp đến Nhà cung cấp KYC và danh tính: Kiểm tra danh tính, qua REST/JSON (luồng chính).
- Từ Nhà cung cấp KYC và danh tính đến Nền tảng tích hợp: Kết quả kiểm tra, qua webhook (bất đồng bộ).
- Từ Nền tảng tích hợp đến Hàng đợi tin nhắn lỗi và cảnh báo: Thất bại sau khi thử lại, vào hàng đợi tin nhắn lỗi (luồng ngoại lệ).
- Từ Hàng đợi tin nhắn lỗi và cảnh báo đến Đội hỗ trợ: Cảnh báo kèm dữ liệu và lỗi (luồng ngoại lệ).
Tổng quan
Đây là luồng giữa ERP của bạn và các dịch vụ xung quanh: CRM, hãng vận chuyển và nhà cung cấp logistics, nền tảng hóa đơn điện tử và thuế, cùng nhà cung cấp danh tính và KYC. Mỗi đối tác có API riêng, định dạng riêng và kiểu lỗi riêng, và mỗi tích hợp thường là một dự án riêng.
Thiết kế tham chiếu gửi sự kiện nghiệp vụ ra khỏi ERP một lần, tới một nền tảng tích hợp chuyển chúng đến từng đối tác theo định dạng đối tác cần, qua REST, SOAP, webhook hoặc EDI qua AS2 khi đối tác thương mại yêu cầu. Các callback, như sự kiện theo dõi hay kết quả kiểm tra, trở về qua cùng nền tảng.
Một đối tác ngừng hoạt động là sự kiện bình thường, không phải tình huống khẩn cấp. Lỗi tạm thời được thử lại. Thông điệp vẫn lỗi sau các lần thử lại được đưa vào hàng đợi tin nhắn lỗi, và cảnh báo đến đội hỗ trợ kèm dữ liệu gửi và lỗi, để có thể sửa và phát lại.
Luồng hoạt động
ERP công bố một sự kiện
Khi khách hàng, đơn hàng hoặc hóa đơn thay đổi, ERP công bố một sự kiện nghiệp vụ tới nền tảng tích hợp, qua API, dịch vụ OData hoặc webhook.
CRM luôn cập nhật
Nền tảng cập nhật tài khoản, người liên hệ và đơn hàng trong CRM, để đội bán hàng và dịch vụ thấy những gì ERP biết.
Đặt lô hàng
Đơn hàng sẵn sàng gửi được đặt với hãng vận chuyển hoặc nhà cung cấp logistics qua API của họ, và nhãn cùng mã tham chiếu trở về.
Thông tin theo dõi trở về
Hãng vận chuyển gửi sự kiện theo dõi và bằng chứng giao hàng qua webhook, và nền tảng cập nhật đơn hàng trong ERP.
Hóa đơn được phê duyệt
Hóa đơn được gửi tới nền tảng hóa đơn điện tử hoặc thuế theo định dạng cơ quan thuế yêu cầu, và trạng thái phê duyệt được lưu cùng hóa đơn.
Danh tính được kiểm tra
Khách hàng hoặc nhà cung cấp mới được gửi tới nhà cung cấp KYC hoặc danh tính, và kết quả trở về qua webhook trước khi tài khoản được kích hoạt.
Khi có lỗi xảy ra
Đối tác tạm thời không khả dụng
Lệnh gọi được thử lại với thời gian chờ tăng dần. Khóa lũy đẳng trên mọi lần ghi nghĩa là lần thử lại không bao giờ tạo lô hàng hay hóa đơn thứ hai.
Thông điệp vẫn lỗi sau các lần thử lại
Thông điệp vào hàng đợi tin nhắn lỗi kèm dữ liệu gửi và lỗi của đối tác, và đội hỗ trợ nhận cảnh báo. Sau khi sửa, thông điệp được phát lại từ hàng đợi.
Đối tác thay đổi API
Kiểm thử hợp đồng chạy với môi trường thử của từng đối tác và bắt được thay đổi. Thay đổi đã công bố được lên lịch và kiểm thử trước thời hạn của đối tác.
Dữ liệu bị từ chối
Khi đối tác từ chối dữ liệu vì lý do nghiệp vụ, như thiếu mã số thuế, lỗi được gửi trở về bản ghi ERP để người phụ trách sửa.
Tiêu chuẩn và hệ thống
- Tích hợp
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- Danh tính và quyền truy cập
- OAuth 2.0
Câu hỏi và trả lời
XSIS có thể kết nối những dịch vụ bên thứ ba nào?
Mọi dịch vụ có API hoặc giao diện tệp được ghi tài liệu. Ví dụ điển hình là nền tảng CRM, hãng vận chuyển và nhà cung cấp logistics, sàn thương mại, nền tảng hóa đơn điện tử và thuế, tính lương, nhà cung cấp KYC và danh tính, và đối tác thương mại trao đổi chứng từ EDI qua AS2. Chúng tôi xem xét API, giới hạn và môi trường thử của từng đối tác trước khi cam kết một kế hoạch.
Chúng tôi có cần nền tảng tích hợp cho việc này không?
Khi đã có nhiều đối tác kết nối với một ERP, một nền tảng như MuleSoft, Boomi hay Azure Logic Apps, hoặc một bộ dịch vụ tùy chỉnh xây trên hàng đợi thông điệp, giữ ánh xạ, thử lại và giám sát ở một nơi. Với một hoặc hai đối tác, kết nối trực tiếp có thể đủ. Chúng tôi trình bày các đánh đổi, gồm chi phí giấy phép, cho trường hợp của bạn.
XSIS có thể kết nối chúng tôi với nền tảng hóa đơn điện tử và nền tảng phê duyệt hóa đơn thuế không?
Có. Nhiều quốc gia hiện yêu cầu hóa đơn được phát hành hoặc phê duyệt qua một nền tảng chính phủ hoặc nền tảng được công nhận theo một định dạng xác định. Chúng tôi tích hợp ERP với nền tảng mà quốc gia của bạn yêu cầu hoặc với một nhà cung cấp được công nhận, lưu trạng thái phê duyệt và mã định danh cùng từng hóa đơn, và xử lý từ chối. Cố vấn thuế của bạn xác nhận các quy tắc áp dụng cho bạn.
XSIS bảo mật webhook đến thế nào?
Mọi webhook đến đều được xác minh trước khi xử lý: bằng chữ ký khi đối tác ký thông điệp, và bằng kiểm tra token, nguồn gửi và dấu thời gian khi họ không ký. Dữ liệu gửi được kiểm tra theo hợp đồng, và sự kiện được xử lý một lần dù đối tác gửi nhiều lần.
Điều gì xảy ra khi một đối tác gặp sự cố?
Các luồng còn lại vẫn chạy. Thông điệp cho đối tác đó được thử lại rồi xếp hàng đợi, đội hỗ trợ nhận cảnh báo, và không có gì bị mất. Khi đối tác hoạt động trở lại, thông điệp trong hàng đợi được phát lại theo thứ tự. Bảng điều khiển cho thấy đối tác nào bị ảnh hưởng và bao nhiêu thông điệp đang chờ.
Ai sở hữu các bộ kết nối do XSIS xây dựng?
Quyền sở hữu trí tuệ đối với những gì chúng tôi xây cho bạn thuộc về bạn từ lần commit đầu tiên, không cần bước chuyển nhượng nào vào cuối. Bộ kết nối được bàn giao kèm mã nguồn, kiểm thử và tài liệu, để đội ngũ của bạn hoặc nhà cung cấp khác bảo trì được. Mọi công cụ XSIS có trước vẫn thuộc về chúng tôi và được cấp phép cho bạn. API của đối tác và giấy phép nền tảng tích hợp vẫn theo điều khoản riêng của các nhà cung cấp đó.
Bắt đầu bằng một cuộc trò chuyện, không phải hợp đồng.
Cho chúng tôi biết bạn cần xây dựng, kết nối hoặc bảo vệ điều gì. Một kiến trúc sư sẽ cùng bạn xem xét, rồi đề xuất nơi nên bắt đầu.
Các bước tiếp theo
Thống nhất thời gian
Đội ngũ của chúng tôi gửi email để thống nhất thời gian cho buổi tư vấn.
Buổi tư vấn sơ bộ
Một buổi tư vấn sơ bộ trực tuyến miễn phí 30 phút: chúng tôi cùng bạn xem xét mục tiêu, hệ thống và ràng buộc.
Đánh giá mức độ sẵn sàng
Trong một đánh giá mức độ sẵn sàng miễn phí trong 48 giờ, một kiến trúc sư chính kiểm tra dự án của bạn theo định nghĩa sẵn sàng (Definition of Ready) gồm 6 điểm và đề xuất lộ trình phù hợp.
Chọn lộ trình
Các dự án đã rõ phạm vi nhận đề xuất có ràng buộc trong vòng 3 đến 5 ngày làm việc. Các dự án ở giai đoạn ý tưởng bắt đầu trong Blueprint Studio. Hệ thống đang vận hành gặp lỗi, thiếu tài liệu hoặc cần tích hợp bắt đầu bằng chẩn đoán kéo dài 1 đến 2 tuần. Blueprint Studio và chẩn đoán đều có phí cố định, được báo trong đề xuất.