Lingxing
切换旧版

按采购单号查询跟单记录

POST/basicOpen/purchase/record/listByOrderSn

按单个系统采购单号查询全部跟单记录。记录按创建时间升序排列;创建时间相同时顺序不固定。已删除的记录不会返回。

请求

orderSnstring必填
系统采购单号,单个字符串,按原值精确匹配

响应

200 成功
codeinteger
状态码,0:成功
示例 0
messagestring
消息提示
示例 success
error_detailsarray<string>
数据校验失败时的错误详情
request_idstring
请求链路 ID
response_timestring
响应时间
dataarray<object>
跟单记录列表
隐藏子属性
prIdstring
跟单记录唯一 ID
示例 901234567890123456
vidinteger
跟单记录表自增 ID
示例 10001
companyIdinteger
企业 ID
示例 1000001
zidinteger
企业 ZID
示例 10001
gmt_createstring
跟单记录创建时间
示例 2026-09-30 10:00:00
gmt_modifiedstring
跟单记录最后修改时间
示例 2026-09-30 11:00:00
remarkstring
当前跟单内容
示例 供应商确认明日发货。
tagIdinteger
跟单标签 ID;无有效标签时为 0
示例 101
createUidinteger
跟单记录创建人 UID
示例 10001
editUidinteger
跟单记录最后编辑人 UID
示例 10002
orderSnstring
系统采购单号
示例 PO260930007
tagNamestring
当前标签名称;无有效标签时为空字符串
示例 现结
tagColorstring
标签颜色,十六进制值,不含 #
示例 F05B56
createUserNamestring
创建人姓名
示例 示例创建人
editUserNamestring
最后编辑人姓名
示例 示例编辑人
totalinteger
跟单记录总数
示例 1

示例

{
  "code": 0,
  "message": "success",
  "error_details": [
    "<string>"
  ],
  "request_id": "<string>",
  "response_time": "<string>",
  "data": [
    {
      "prId": "901234567890123456",
      "vid": 10001,
      "companyId": 1000001,
      "zid": 10001,
      "gmt_create": "2026-09-30 10:00:00",
      "gmt_modified": "2026-09-30 11:00:00",
      "remark": "供应商确认明日发货。",
      "tagId": 101,
      "createUid": 10001,
      "editUid": 10002,
      "orderSn": "PO260930007",
      "tagName": "现结",
      "tagColor": "F05B56",
      "createUserName": "示例创建人",
      "editUserName": "示例编辑人"
    }
  ],
  "total": 1
}

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/purchase/record/listByOrderSnHTTPSPOST1

请求参数

参数名说明必填类型示例
orderSn系统采购单号,单个字符串,按原值精确匹配;不支持自定义采购单号是[string]PO260930007

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/purchase/record/listByOrderSn?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{"orderSn":"PO260930007"}'

返回结果

Json Array

参数名说明必填类型示例
code状态码,0:成功是[int]0
message消息提示是[string]success
error_details数据校验失败时的错误详情是[array]
request_id请求链路 ID是[string]a0d54debf93140f3b58d1ed81e8e3583
response_time响应时间是[string]2026-10-26 12:00:00
data跟单记录列表;无记录时为空数组是[array]
data>>prId跟单记录唯一 ID,以字符串返回以避免大整数精度丢失是[string]901234567890123456
data>>vid跟单记录表自增 ID是[int]10001
data>>companyId企业 ID是[long]1000001
data>>zid企业 ZID是[int]10001
data>>gmt_create跟单记录创建时间,格式 YYYY-MM-DD HH:mm:ss是[string]2026-09-30 10:00:00
data>>gmt_modified跟单记录最后修改时间,格式 YYYY-MM-DD HH:mm:ss是[string]2026-09-30 11:00:00
data>>remark当前跟单内容是[string]供应商确认明日发货。
data>>tagId跟单标签 ID;无有效标签时为 0是[long]101
data>>createUid跟单记录创建人 UID是[int]10001
data>>editUid跟单记录最后编辑人 UID是[int]10002
data>>orderSn系统采购单号是[string]PO260930007
data>>tagName当前标签名称;无有效标签时为空字符串是[string]现结
data>>tagColor标签颜色,十六进制值,不含 #;无有效标签时为空字符串是[string]F05B56
data>>createUserName创建人姓名;用户信息未匹配时为空字符串是[string]示例创建人
data>>editUserName最后编辑人姓名;用户信息未匹配时为空字符串是[string]示例编辑人
total跟单记录总数,等于 data 的长度;该接口不分页是[int]1

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
  "response_time": "2026-10-26 12:00:00",
  "data": [{
    "prId": "901234567890123456",
    "vid": 10001,
    "companyId": 1000001,
    "zid": 10001,
    "gmt_create": "2026-09-30 10:00:00",
    "gmt_modified": "2026-09-30 11:00:00",
    "remark": "供应商确认明日发货。",
    "tagId": 101,
    "createUid": 10001,
    "editUid": 10002,
    "orderSn": "PO260930007",
    "tagName": "现结",
    "tagColor": "F05B56",
    "createUserName": "示例创建人",
    "editUserName": "示例编辑人"
  }],
  "total": 1
}

附加说明

该接口只接受一个 orderSn,不支持批量单号、分页或时间筛选。无有效标签时,标签 ID 为 0,标签名称和颜色为空字符串。ERP 补充用户或标签信息异常时,相关字段可能缺失。