轻易云
注册体验

领星ERP按采购单号查询跟单记录接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
采购 · POST · 请求参数 1 个(必填 1) · 响应参数 22 个 · 限流令牌桶容量 1
更新日期
2026-11-21

按采购单号查询跟单记录

POST/basicOpen/purchase/record/listByOrderSn
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/purchase/record/listByOrderSn"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/purchase/record/listByOrderSn?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\"orderSn\":\"PO260930007\"}'",
  "responseExample": {
    "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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1orderSn系统采购单号stringPO260930007必填系统采购单号,单个字符串,按原值精确匹配;不支持自定义采购单号

接口响应参数

序号字段名称类型默认值必填描述
1code状态码int0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array—必填数据校验失败时的错误详情
4request_id请求链路 IDstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路 ID
5response_time响应时间string2026-10-26 12:00:00必填响应时间
6data跟单记录列表array—必填跟单记录列表;无记录时为空数组
6.1prId跟单记录唯一 IDstring901234567890123456必填跟单记录唯一 ID,以字符串返回以避免大整数精度丢失
6.2vid跟单记录表自增 IDint10001必填跟单记录表自增 ID
6.3companyId企业 IDlong1000001必填企业 ID
6.4zid企业 ZIDint10001必填企业 ZID
6.5gmt_create跟单记录创建时间string2026-09-30 10:00:00必填跟单记录创建时间,格式 YYYY-MM-DD HH:mm:ss
6.6gmt_modified跟单记录最后修改时间string2026-09-30 11:00:00必填跟单记录最后修改时间,格式 YYYY-MM-DD HH:mm:ss
6.7remark当前跟单内容string供应商确认明日发货。必填当前跟单内容
6.8tagId跟单标签 IDlong101必填跟单标签 ID;无有效标签时为 0
6.9createUid跟单记录创建人 UIDint10001必填跟单记录创建人 UID
6.10editUid跟单记录最后编辑人 UIDint10002必填跟单记录最后编辑人 UID
6.11orderSn系统采购单号stringPO260930007必填系统采购单号
6.12tagName当前标签名称string现结必填当前标签名称;无有效标签时为空字符串
6.13tagColor标签颜色stringF05B56必填标签颜色,十六进制值,不含 #;无有效标签时为空字符串
6.14createUserName创建人姓名string示例创建人必填创建人姓名;用户信息未匹配时为空字符串
6.15editUserName最后编辑人姓名string示例编辑人必填最后编辑人姓名;用户信息未匹配时为空字符串
7total跟单记录总数int1必填跟单记录总数,等于 data 的长度;该接口不分页

领星ERP的接口:按采购单号查询跟单记录(/basicOpen/purchase/record/listByOrderSn),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。