SelSup nền tảng · Các hướng dẫn
Các phần mở rộng và tích hợp tùy chỉnh
Chọn giữa một dịch vụ hậu kết bên ngoài, một UI React nhúng, và một thị trường bên máy chủ hoặc mô-đun phân phối.
Hầu hết các tích hợp nên bắt đầu như một nền tảng bên ngoài sử dụng công cộng API. Một UI nhúng là thích hợp khi người dùng phải vận hành tính năng trực tiếp bên trong SelSup.
Các nhà phát triển ứng dụng và đối tác công nghệ01
Chọn loại tích hợp
- 1
Dịch vụ hậu kết bên ngoài
Tốt nhất cho ERP, cửa hàng web, WMS, BI và đồng bộ hóa tương tự. token vẫn ở trên máy chủ của bạn và dữ liệu di chuyển thông qua API và webhooks.
- 2
Tăng cường phản ứng
Sử dụng nó cho một giao diện người dùng phải chạy bên trong SelSup và tái sử dụng các mô hình tương tác của sản phẩm.
- 3
SelSup backend module
Cần cho một thị trường sâu hoặc tích hợp giao hàng tham gia vào các quy trình nền SelSup chia sẻ.
Thực hiện một dòng công việc hoàn chỉnh và khả năng quan sát của nó trước. Thêm hàng loạt nhập khẩu, UI và nhiều loại sự kiện sau khi hòa giải ổn định.
02
Kiến trúc ứng dụng bên ngoài
Giữ token trong một quản lý bí mật và gọi SelSup chỉ từ backend của bạn. Ứng dụng trình duyệt của bạn nên nói chuyện với API của bạn và không bao giờ nhận token SelSup.
Chia tách bộ điều chỉnh SelSup, hàng xếp và mô hình miền.
Sử dụng hộp thư đến cho các sự kiện tiếp theo và hộp thư ra để thay đổi ra ngoài. Cả hai tạp chí nên hỗ trợ chơi lại và kiểm toán.
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation
Các điểm cuối API liên quan
GET/api/product/findBài đọc từ điển ví dụGET/api/order/findVí dụ về đồng bộ hóa tăng trưởng
03
Tương tự React mở rộng
Các thành phần chạy bên trong giao diện SelSup. Một miền bên ngoài phải cho phép yêu cầu từ selsup.ru và xử lý đúng các hạn chế trình duyệt.
Không bao giờ đặt một token API vĩnh viễn trong gói. Đường bộ công việc đặc quyền thông qua backend của bạn và bối cảnh người dùng ngắn hạn được xác định bởi kiến trúc mở rộng.
Hình thức tương tác sản phẩm phù hợp và bao gồm các trạng thái trống, tải và error có thể truy cập.
Một nguồn gốc được phép kiểm soát truy cập trình duyệt nhưng không xác thực người dùng.
https://github.com/SelSup/component
04
Modul tích hợp bên máy chủ
Một dịch vụ giao hàng thường bao gồm mã thông báo, thẻ, giá cả, cổ phiếu, đơn đặt hàng và cập nhật tình trạng nền.
Module này thay đổi nền SelSup chính và theo dõi quá trình xem xét, kiểm tra, định vị và phát hành của nó.
Chuyển đổi lỗi API bên ngoài thành giá trị ApplicationError ổn định và mã thông báo bên ngoài bị hủy hoặc không hợp lệ thành AccessException theo các quy tắc dự án hậu kết.
Không thêm các trường cụ thể thị trường vào các đơn vị chia sẻ. Giữ hợp đồng nguyên liệu trong DTO tích hợp và lập bản đồ chúng tại biên giới.
05
Tự phát hành và hoạt động
- 1
Tạo tài khoản thử nghiệm
Các mã chỉ thử nghiệm, kho, sản phẩm và đơn đặt hàng riêng biệt từ dữ liệu sản xuất của khách hàng.
- 2
Thêm khả năng quan sát
Theo dõi sự chậm trễ hàng, lỗi theo mã, số lần thử lại và sự khác biệt về sự hòa giải.
- 3
Kế hoạch di cư hợp đồng
Cung cấp các trường cũ trong quá trình chuyển đổi và triển khai người tiêu dùng trước khi vô hiệu hóa định dạng cũ.
- 4
Phân khép tài liệu
Người dùng phải biết cách hủy bỏ token, loại bỏ webhook và ngừng đồng bộ hóa mà không mất dữ liệu.