轻易云
注册体验

领星ERP查询采购计划列表接口

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

查询采购计划列表

POST/erp/sc/routing/data/local_inventory/getPurchasePlans
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/data/local_inventory/getPurchasePlans"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "{\n{\n    \"search_field_time\": \"creator_time\",\n    \"start_date\": \"2024-07-30\",\n    \"end_date\": \"2024-08-02\",\n    \"plan_sns\": [\n        \"PP240730001\",\n        \"PP240730002\",\n        \"PP240730005\"\n    ],\n    \"is_combo\": 0,\n    \"is_related_process_plan\": 0,\n    \"status\": [\n        -2\n    ],\n    \"sids\": [\n        0\n    ],\n    \"offset\": 0,\n    \"length\": 20\n}",
  "responseExample": "{\n    \"code\": 0,\n    \"message\": \"success\",\n    \"error_details\": [],\n    \"request_id\": \"350C7176-A759-3517-9CDA-369C9E1A5743\",\n    \"response_time\": \"2022-05-20 11:48:25\",\n    \"total\": 1,\n    \"data\": [\n        {\n            \"plan_sn\": \"PP230712003\",\n            \"ppg_sn\": \"PPG230712003\",\n            \"product_name\": \"10369333测试\",\n            \"sku\": \"10369333\",\n            \"fnsku\": \"\",\n            \"pic_url\": \"\",\n            \"supplier_id\": 590,\n            \"status_text\": \"待采购\",\n            \"status\": 2,\n            \"sid\": 0,\n            \"expect_arrive_time\": \"\",\n            \"remark\": \"\",\n            \"quantity_plan\": 1,\n            \"product_id\": 18791,\n            \"group_id\": 2689,\n            \"cg_uid\": 0,\n            \"is_combo\": 0,\n            \"is_aux\": 0,\n            \"spu\": \"\",\n            \"spu_name\": \"\",\n            \"attribute\": [],\n            \"creator_uid\": 10317908,\n            \"wid\": 1,\n            \"warehouse_name\": \"默认仓库\",\n            \"purchaser_id\": 113,\n            \"supplier_name\": \"好的供应商111\",\n            \"cg_opt_username\": \"\",\n            \"creator_real_name\": \"验证账户2\",\n            \"file\": [\n                {\n                    \"name\": \"导入计划采购商品模板news.xlsx\",\n                    \"url\": \"https://imagexxxx/d73aaf35f.xlsx\"\n                }\n            ],\n            \"plan_remark\": \"\",\n            \"create_time\": \"2021-10-11 01:20:20\",\n            \"msku\": [],\n            \"cg_box_pcs\": 0,\n            \"seller_name\": \"\",\n            \"marketplace\": \"\",\n            \"purchaser_name\": \"基本abc\",\n            \"is_related_process_plan\": 0,\n            \"perm_uid\": [10001, 10002],\n            \"perm_username\": {10001: \"AA\", 10002: \"BB\"},\n            \"is_urgent\": 1\n        }\n    ]\n}"
}

接口请求参数

序号字段名称类型默认值必填描述
1search_field_time时间搜索维度string—必填时间搜索维度: creator_time 创建时间 expect_arrive_time 预计到货时间 update_time 更新时间
2start_date开始日期string—必填开始日期,Y-m-d,闭区间,当筛选update_time时,格式为:Y-m-d H:i:s
3end_date结束日期string—必填结束日期,Y-m-d,闭区间,当筛选update_time时,格式为:Y-m-d H:i:s
4plan_sns采购计划编号array<any>—可选采购计划编号
5is_combo是否为组合商品integer—可选是否为组合商品:0 否,1 是
6is_related_process_plan是否关联加工计划integer—可选是否关联加工计划,0:否,1:是
7status状态array<any>—可选状态: 2 待采购 -2 已完成 121 待审批 122 已驳回 -3、124 已作废
8sids店铺idarray<any>—可选店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
9offset分页偏移量integer—可选分页偏移量,默认0
10length分页长度integer—可选分页长度,默认500,上限500

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息string—必填错误信息
4request_id请求链路idstring350C7176-A759-3517-9CDA-369C9E1A5743必填请求链路id
5response_time响应时间string2022-05-20 11:48:25必填响应时间
6total总数integer1必填总数
7data响应数据array<object>—必填响应数据
7.1plan_sn采购计划编号stringPP230712003必填采购计划编号
7.2ppg_sn采购计划批次号stringPPG230712003必填采购计划批次号
7.3status_text状态说明string待采购必填状态说明
7.4status状态值integer2必填状态值
7.5creator_real_name创建人名称string小明必填创建人名称
7.6creator_uid创建人idinteger297必填创建人id
7.7create_time创建时间string2021-10-11 01:20:20必填创建时间
7.8file附件array<object>—必填附件
7.8.1name附件名string导入计划采购商品模板news.xlsx必填附件名
7.8.2url附件urlstringhttps://imagexxxx/d73aaf35f.xlsx必填附件url
7.9plan_remark备注string备注必填备注
7.10pic_url产品图片stringhttps://image-1254213xxxxx.com/xxx4%B5%E7%9B%92.jpg必填产品图片
7.11spu_name款名string童黄土-橘白条必填款名
7.12spuspustring—必填SPU
7.13product_name品名string[演示数据]三星真无线耳塞含无线充电盒必填品名
7.14product_id商品idinteger1019必填商品id
7.15skuskustringSKU627B4F6必填SKU
7.16attribute属性array<any>—必填属性
7.17sid店铺idnumber1必填店铺id
7.18seller_name店铺名称string店铺1必填店铺名称
7.19marketplace国家string美国必填国家
7.20fnskufnskustringFN004必填FNSKU
7.21mskumskuarray<any>—必填MSKU
7.22supplier_id供应商idobject2必填供应商id
7.23supplier_name供应商名称string测试供应商必填供应商名称
7.24wid仓库idinteger2必填仓库id
7.25warehouse_name仓库名称string广州仓库必填仓库名称
7.26purchaser_id采购方idinteger1必填采购方id
7.27purchaser_name采购方名称string默认采购方必填采购方名称
7.28cg_box_pcs单箱数量integer10必填单箱数量
7.29quantity_plan计划采购量integer100必填计划采购量
7.30expect_arrive_time期望到货时间string2022-04-15必填期望到货时间
7.31cg_uid采购员idinteger1必填采购员id
7.32cg_opt_username采购员名称string小米必填采购员名称
7.33remark产品备注string备注必填产品备注
7.34is_combo是否为组合商品integer1必填是否为组合商品:0 否,1 是
7.35is_aux是否为辅料integer1必填是否为辅料:0 否,1 是
7.36is_related_process_plan是否关联了加工计划integer1必填是否关联了加工计划:0 否,1 是
7.37perm_uid单据负责人uidarray<any>[10001,10002]必填单据负责人uid
7.38perm_username单据负责人名称object{10001: "AA", 10002: "BB"}必填单据负责人名称
7.39is_urgent是否加急integer1必填是否加急:1 加急,0 未加急
7.40purchase_mark采购标识integer—必填采购标识:0-无;1-组合采;2-单品采;3-委外采
7.41purchase_mark_text采购标识文本string—必填采购标识文本

领星ERP的接口:查询采购计划列表(/erp/sc/routing/data/local_inventory/getPurchasePlans),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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