按采购单号查询跟单记录
POST
/basicOpen/purchase/record/listByOrderSn按单个系统采购单号查询全部跟单记录。记录按创建时间升序排列;创建时间相同时顺序不固定。已删除的记录不会返回。
请求
orderSnstring必填响应
200 成功
codeintegermessagestringerror_detailsarray<string>request_idstringresponse_timestringdataarray<object>隐藏子属性
prIdstringvidintegercompanyIdintegerzidintegergmt_createstringgmt_modifiedstringremarkstringtagIdintegercreateUidintegereditUidintegerorderSnstringtagNamestringtagColorstringcreateUserNamestringeditUserNamestringtotalinteger示例
{
"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/listByOrderSn | HTTPS | POST | 1 |
请求参数
| 参数名 | 说明 | 必填 | 类型 | 示例 |
|---|---|---|---|---|
| orderSn | 系统采购单号,单个字符串,按原值精确匹配;不支持自定义采购单号 | 是 | [string] | PO260930007 |
请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/purchase/record/listByOrderSn?access_token=value×tamp=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 补充用户或标签信息异常时,相关字段可能缺失。