启航电商ERP V5.0 开放API接口文档，支持第三方系统集成与AI Agent调用
获取访问令牌，用于调用其他API接口
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | String | 是 | 应用标识，从系统获取 |
| appSecret | String | 是 | 应用密钥，从系统获取 |
获取订单列表，支持多条件筛选
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shopId | Long | 是 | 店铺ID |
| status | String | 否 | 订单状态：PENDING/PAID/SHIPPED/COMPLETED/CANCELLED |
| startDate | String | 否 | 开始日期 yyyy-MM-dd |
| endDate | String | 否 | 结束日期 yyyy-MM-dd |
| pageNum | Integer | 否 | 页码，默认1 |
| pageSize | Integer | 否 | 每页数量，默认20 |
获取订单详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| orderId | Long | 订单ID |
手动同步平台订单，从电商平台拉取最新订单
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shopId | Long | 是 | 店铺ID |
查询库存信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| warehouseId | Long | 否 | 仓库ID |
| sku | String | 否 | 商品SKU编码 |
| productId | Long | 否 | 商品ID |
库存调整
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| warehouseId | Long | 是 | 仓库ID |
| sku | String | 是 | 商品SKU编码 |
| quantity | Integer | 是 | 调整数量，正数增加，负数减少 |
| reason | String | 否 | 调整原因 |
创建发货单/备货单
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| orderId | Long | 是 | 订单ID |
| warehouseId | Long | 是 | 发货仓库ID |
| shippingType | String | 是 | 发货类型：LOCAL/CLOUD/SUPPLIER |
获取物流轨迹
| 参数名 | 类型 | 说明 |
|---|---|---|
| shippingId | Long | 发货单ID |
获取商品列表
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| categoryId | Long | 否 | 分类ID |
| status | String | 否 | 商品状态：ON_SALE/OFF_SALE |
| pageNum | Integer | 否 | 页码 |
| pageSize | Integer | 否 | 每页数量 |
获取结算记录
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | String | 是 | 结算类型：MERCHANT/SUPPLIER |
| startDate | String | 否 | 开始日期 |
| endDate | String | 否 | 结束日期 |
| Header名 | 必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer {accessToken}，通过登录接口获取 |
| Content-Type | 是 | application/json |
| code | msg | 说明 |
|---|---|---|
| 0 | success | 请求成功 |
| 401 | unauthorized | 未授权或token过期 |
| 403 | forbidden | 无权限访问 |
| 404 | not_found | 资源不存在 |
| 500 | internal_error | 服务器内部错误 |
联系我们获取定制化API开发服务