Các lệnh và đồng bộ hóa theo từng bước

Bản đồ lưu trữ sản phẩm đến SelSup productId trước khi tạo đơn đặt hàng. Đừng giải quyết sản phẩm bằng tên hiển thị thay đổi trong khi thanh toán.

Gửi số lệnh bên ngoài vào externalOrderId và kiểm tra nó trong cơ sở dữ liệu của bạn trước khi thử lại. tổ chứcId đặc biệt quan trọng trong các tài khoản đa tổ chức.

Bao gồm sản phẩm, số lượng và giá được yêu cầu bởi logic kênh bán hàng của bạn cho mỗi mặt hàng.

{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

Đọc lệnh trong các trang kích thước cố định. Sử dụng count=true chỉ khi báo cáo tiến bộ hoặc nhu cầu hòa giải số cuối cùng là tổng.

Cố gắng giữ cả ID SelSup và externalOrderId. Cung cấp từng trang được xử lý một cách nguyên tử trước khi chuyển sang trang tiếp theo.

1. 1

   Tận dụng giới hạn xuất khẩu

   Tiết kiệm thời gian bắt đầu để thay đổi xảy ra trong quá trình quét đầy đủ được nhận được bởi quá trình tăng dần.

2. 2

   Phân tích từng trang

   Tránh các trang song song từ cùng phạm vi khi sắp xếp và các hồ sơ cơ bản có thể thay đổi.

3. 3

   Tham gia thẻ đổi

   Sau khi tải đầy đủ, yêu cầu lệnh được sửa đổi từ biên giới được lưu lại với sự chồng chéo nhỏ.

Sử dụng bộ lọc ModifiedDate khi có trong hợp đồng tìm kiếm hiện tại. Chỉ cần tiến bộ trình chiếu sau khi trang hoàn chỉnh đã được xử lý thành công.

Tự chồng chéo cửa sổ thời gian bằng vài phút và sao chép bằng id và modifiedDate. Điều này bảo vệ chống lại sự chậm trễ viết và sự khác biệt đồng hồ.

Thay thế biểu diễn thứ tự địa phương vì trạng thái, địa chỉ, mục, mã đánh dấu hoặc dữ liệu liên quan có thể thay đổi.

GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

1. 1

   Định hành trước khi gửi

   Kiểm tra tổ chức, loại đơn đặt hàng, kho, thị trường, số lượng và giá của mỗi mặt hàng.

2. 2

   Các lỗi tạm thời và vĩnh viễn riêng biệt

   Dữ liệu không hợp lệ cần sửa chữa, trong khi một lỗi mạng cần một lần thử lại kiểm soát sau khi kiểm tra kết quả.

3. 3

   Hoàn thiện thường xuyên

   So sánh trạng thái và nội dung đặt hàng trong một thời gian chồng chéo độc lập với dòng thay đổi chính.