跳到主要内容

三方仓接口日志查询

接口描述​

分页查询当前授权企业的三方仓接口日志，支持按时间、仓库、单据、货主、模块及处理结果筛选。

请求地址​

环境服务地址（HTTP/HTTPS）
V2正式环境https://gw.superboss.cc/router

公共参数​

参数名称参数类型是否必须参数描述
methodstring是固定为 erp.party3.warehouse.logs.query
appKeystring是分配给应用的 AppKey
timestampstring是时间戳，时区为 GMT+8，格式为 yyyy-MM-dd HH:mm:ss。服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式，默认为 json，可选值：json
versionstring是API协议版本：1.0
sign_methodstring否签名摘要算法，默认为 hmac，可选值：hmac、md5、hmac-sha256
signstring是签名
sessionstring是授权会话信息，即 access_token；查询范围由该授权会话确定

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.party3.warehouse.logs.query
必填

请求参数​

全部展开
参数名
类型
描述
必填
startTime
string
查询开始时间，格式 yyyy-MM-dd HH:mm:ss
必填
endTime
string
查询结束时间，格式 yyyy-MM-dd HH:mm:ss
必填
type
integer
单据类型编码
busiCode
string
操作内容对应的业务编码，多个值用英文逗号分隔
success
integer
处理结果：1 成功，0 失败
warehouseIds
string
仓库 ID，多个值用英文逗号分隔，例如 10001,10002
tid
string
平台单号
customerId
string
货主 ID 查询条件
modules
string
模块编码，多个值用英文逗号分隔
senders
string
发起方，多个值用英文逗号分隔
clueId
string
日志跟踪号
types
string
单据类型编码，多个整数用英文逗号分隔，例如 1,2
customerIds
string
货主 ID 查询条件，多个值用英文逗号分隔
tids
string
平台单号，多个值用英文逗号分隔
pageNo
integer
页码，默认 1
pageSize
integer
每页条数，默认 20

请求示例​

以下 JSON 用于展示业务参数；实际调用时将这些参数与公共参数一起按表单提交，并计算签名。

{
  "startTime": "2026-09-15 00:00:00",
  "endTime": "2026-09-15 23:59:59",
  "warehouseIds": "10001,10002",
  "tids": "DEMO202609150001,DEMO202609150002",
  "success": 1,
  "pageNo": 1,
  "pageSize": 20
}

响应参数​

全部展开
参数名
类型
描述
必填
success
boolean
本次开放接口调用是否成功
traceId
string
本次调用的链路追踪 ID
list
array
当前页日志明细列表
id
long
日志 ID
source
string
第三方平台编码
sender
string
发起方
module
string
业务模块编码
content
string
日志内容
busiCode
string
业务编码
created
long
日志创建时间，Unix 毫秒时间戳
warehouseId
long
仓库 ID
success
integer
日志处理结果：0 失败，1 成功，2 失败已处理
requestBody
string
原始请求报文；若内容为 JSON，仍以字符串返回
responseBody
string
原始响应报文；若内容为 JSON，仍以字符串返回
clueId
string
日志跟踪号
type
integer
日志单据类型编码
customerId
string
三方仓路由 ID
tid
string
平台单号
sid
long
系统单号
sourceName
string
第三方平台名称
moduleName
string
模块名称
typeName
string
日志单据类型名称
warehouseName
string
仓库名称
warehouseCode
string
仓库编码
party3WarehouseCode
string
第三方仓仓库编码
agreeOnName
string
协议名称
wmsSystemName
string
WMS系统名称
shopNick
string
店铺名称
ownerCoe
string
货主 ID
appKey
string
日志关联的三方仓应用 AppKey
logisticsCode
string
物流公司编码
logisticsName
string
物流公司名称
customerName
string
货主名称
total
long
符合查询条件的日志总数
code
string
调用失败时的错误码
msg
string
调用失败时的错误信息

响应示例​

以下为虚构数据，展示一条日志的部分字段。

{
  "success": true,
  "trace_id": "demo-query-trace-001",
  "total": 1,
  "list": [
    {
      "id": 100001,
      "content": "发货单推送成功",
      "created": 1789437600000,
      "warehouseId": 10001,
      "warehouseName": "示例三方仓",
      "warehouseCode": "WH-DEMO-001",
      "party3WarehouseCode": "WMS-DEMO-001",
      "success": 1,
      "requestBody": "{\"orderCode\":\"DEMO202609150001\"}",
      "responseBody": "{\"success\":true}",
      "clueId": "demo-log-clue-001",
      "type": 1,
      "typeName": "发货单推送",
      "tid": "DEMO202609150001",
      "sid": 5000000000000001,
      "ownerCoe": "OWNER-DEMO-001",
      "customerName": "示例货主"
    }
  ]
}

异常示例​

缺少 startTime 或 endTime：

{
  "code": "40001",
  "msg": "查询时间范围不能为空",
  "success": false
}

错误码解释​

错误码错误信息解决方案
40001查询时间范围不能为空同时传入 startTime 和 endTime
33参数错误，具体信息以 msg 为准检查查询条件，确保 warehouseIds 为整数 ID，types 为整数编码，多值使用英文逗号分隔
9三方仓接口日志查询失败稍后重试；若持续失败，提供调用时间和链路追踪 ID 联系技术支持