SelSup Developers

终端到终端工作流程 · 导游

订单和步骤同步

创建网店订单,防止重复,页面化出口,

4 部分开发人员指南
→

可靠的集成将初始负载,变更流和调整分开.

网上商店,订单管理和交货系统

01

创建一个网上商店订单

在订单之前将产品存储在SelSup产品Id上.在收购过程中不要用可变显示名称解决产品.

在重试之前,请将外部订单号码发送到外部订單Id,并在数据库中检查.

包含产品ID,量和每项销售道逻辑所要求的价格.

!
重新尝试POST

网络时间过后,先搜索外部命令Id.不要盲目重新创建,因为第一个请求可能在响应丢失之前已经提交.

零售订单 · JSON
{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

相关的API终端点

POST/api/order/创建一个订单GET/api/product/find图片产品

02

首次出口

阅读固定尺寸页面中的订单. 只有在报告进展或最终计数调整需要总数时使用count=true.

继续使用 SelSup id 和外部OrderId. 在转向下一页之前,按次序将每个处理的页面进行提交.

  1. 1

    捕获出口边界

    保存启动时间,以便在完整扫描过程中发生的变化被增量通过检测.

  2. 2

    处理每页

    避免在分类和底层记录可能发生变化时,从同一范围的平行页面.

  3. 3

    运行变更通行

    完成后,请要求订单从保存的边界中进行修改,并进行小重叠.

相关的API终端点

GET/api/order/find搜索命令

03

过程变化没有缺口

使用当前搜索合同中存在的修改日期过器. 只有在完整页面成功处理后先推进缓冲器.

时间窗口在几分钟内重叠,并通过 id 和 modifiedDate 进行复制. 这可以防止写入延误和时钟差异.

取代本地顺序表示,因为状态,地址,项目,标记码或相关数据可能会发生变化.

i
时间处理

存储标记在 UTC 中使用精确的 API 精度.不要绕秒或使用服务器本地时间,而不需要对比.

改变的订单 · HTTP
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

相关的API终端点

GET/api/order/find增长搜索GET/api/order/{orderId}按身份证上传订单

04

处理故障和不一致

  1. 1

    在发送之前验证

    查看各项的组织,订单类型,仓库,市场,数量和价格.

  2. 2

    暂时和永久的错误分别

    无效数据需要纠正,而网络故障需要检查结果后再次控制尝试.

  3. 3

    定期调整

    独立于主要变化流程,对重叠期的状态和订单内容进行比较.

!
错误代码,不是文字

分支在 error. localMessage是为代币所有者定位,可以更改.