开放标准API · 46个接口覆盖串号全业务场景

46个标准接口覆盖串号管理全业务场景,企业级安全认证,轻松对接任何系统

46 标准接口
9 业务模块
256 位HMAC签名
HTTPS 加密传输

六大核心能力

ERP双向同步

与主流ERP系统数据双向同步。采购入库自动推送、调拨出库实时联动、库存查询毫秒响应,无需手动导入导出。

采购入库调拨出库库存查询双向同步

企业级安全认证

HMAC-SHA256签名确保请求完整性,nonce随机数防重放攻击,IP白名单限制访问来源,全链路HTTPS加密传输,多AppKey独立授权管控。

HMAC-SHA256Nonce防重放IP白名单多AppKey

全业务场景覆盖

46个标准RESTful接口覆盖串号管理全生命周期:新增、查询、调拨、盘点、采购、库存统计、商品管理、客户供应商等9大模块。

串号管理采购调拨盘点库存基础数据

幂等提交保障

externalDocCode外部单据号机制确保同一业务请求不会重复创建,部分失败不影响其他记录,网络抖动安全重试,企业级可靠性。

防重复提交安全重试部分失败隔离

多应用独立授权

支持创建多个AppKey,每个应用独立token和IP白名单,适合ERP、电商平台、WMS仓储、BI报表等多系统并行对接场景。

多AppKey独立白名单权限隔离

完整开发文档

每个接口提供完整的请求参数、响应字段、示例代码和错误码说明。支持Java、Python、PHP、Node.js、C#等任何开发语言快速对接。

在线文档示例代码错误码说明

接口分类一览

9大业务模块,46个标准接口,覆盖串号管理全生命周期

📱

串号管理

5个接口
  1. 新增串号
  2. 批量新增串号
  3. 查询串号详情
  4. 查询串号列表
  5. 修改串号备注
📦

采购单管理

6个接口
  1. 创建采购单
  2. 修改采购单
  3. 查询采购单详情
  4. 确认采购入库
  5. 作废采购单
  6. 查询采购单列表
🔄

调拨单管理

7个接口
  1. 创建调拨单
  2. 查询调拨单详情
  3. 确认调拨单
  4. 作废调拨单
  5. 退货入库
  6. 销售出库/报废出库
  7. 查询调拨单列表
📊

库存统计

4个接口
  1. 库存汇总
  2. 分仓库库存统计
  3. 异常预警
  4. 出入库流水
🏷️

商品管理

4个接口
  1. 新增商品
  2. 修改商品
  3. 查询商品详情
  4. 查询商品列表
📋

基础数据

13个接口
  1. 仓库列表
  2. 虚拟仓库列表
  3. 调拨类型列表
  4. 品牌列表 / 新增 / 修改
  5. 产地列表 / 新增 / 修改
  6. 计量单位列表
  7. 商品分类树
  8. 业务员列表
  9. 仓库类型列表
🔍

盘点管理

3个接口
  1. 创建盘点单
  2. 查询盘点差异
  3. 提交盘点结果
👥

客户管理

2个接口
  1. 客户列表
  2. 查询客户详情
🏭

供应商管理

2个接口
  1. 供应商列表
  2. 查询供应商详情

安全认证机制

多层防护,确保API调用安全可靠

1

HTTPS加密传输

全链路HTTPS/TLS 1.2+加密,防止数据传输过程中被窃听或篡改

→
2

HMAC-SHA256签名

请求方使用AppToken对请求内容生成HMAC签名,服务端验证签名确保请求完整性与身份真实性

→
3

Nonce防重放

每次请求携带唯一nonce随机数,服务端校验nonce唯一性,拒绝重复请求,有效时间±5分钟

→
4

IP白名单

每个AppKey可配置独立IP白名单(支持CIDR),非白名单IP请求直接拒绝

多AppKey独立授权,每个应用独立token和白名单
时间戳校验,拒绝超出±5分钟范围的过期请求
签名防篡改校验,请求内容任何变动均被拒绝
nonce唯一性校验,服务重启后仍有效防重放

快速开始

3步完成对接,任何开发语言均可快速接入

1

获取AppKey和AppToken

在系统管理后台的「开放平台授权管理」模块中创建应用,获取AppKey和AppToken,配置IP白名单。

2

构造签名请求

每次请求携带身份认证信息,服务端验证身份和请求完整性后处理业务数据。详细认证方式在系统内查看。

请求示例
POST /openapi/serial/add.jsp
Host: your-domain.com
Content-Type: application/json
Authorization: {认证头信息}

{
  "serialNo": "SN2024010001",
  "productId": "SP0001",
  "warehouseId": "CK0001"
}
3

处理响应结果

所有接口返回统一JSON格式,包含code(状态码)、message(描述)、data(业务数据)。

响应示例
{
  "code": 200,
  "message": "操作成功",
  "data": {
    "skuId": "sku_001",
    "docCode": "CH0001"
  }
}

典型对接场景

🏢

ERP系统对接

采购单自动推送到串号系统入库,销售出库后串号状态自动回写ERP,库存实时同步,告别手工录入。

ERP采购单 → API创建采购 → 自动入库 → 库存回写ERP
🛒

电商平台对接

订单发货时自动调用出库接口,串号与订单绑定,消费者扫码可追溯来源,防窜货防伪。

电商订单 → API销售出库 → 串号绑定订单 → 消费者扫码追溯
🏭

WMS仓储对接

仓库收货后自动触发串号入库,拣货出库同步串号状态,多仓调拨实时仓间协同。

WMS收货 → API串号入库 → 拣货出库 → 状态同步
📊

BI报表对接

定时拉取库存统计、出入库流水、异常预警数据,构建自定义经营分析看板。

定时任务 → API拉取数据 → 数据清洗 → BI看板展示

立即体验开放标准API

免费试用7天,全功能开放,包含完整API接口