Qeasy Cloud
Get Started

领星ERP 查询采购计划列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
采购 · POST · 请求参数 10 个(必填 3) · 响应参数 50 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询采购计划列表

POST/erp/sc/routing/data/local_inventory/getPurchasePlans
Factory
{
  "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}"
}

Request Parameters

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

Response Parameters

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

The 查询采购计划列表 API (/erp/sc/routing/data/local_inventory/getPurchasePlans) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.