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 · 请求参数 8 个(必填 2) · 响应参数 105 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询采购单列表

POST/erp/sc/routing/data/local_inventory/purchaseOrderList
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/data/local_inventory/purchaseOrderList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "search_field_time": "create_time",
    "start_date": "2024-05-30",
    "end_date": "2024-08-02",
    "order_sn": [
      "PO240802012",
      "PO240802011"
    ],
    "custom_order_sn": [
      "PO240802012",
      "PO240802011"
    ],
    "purchase_type": 1,
    "offset": 0,
    "length": 20
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "46CDFE68-C43F-03A8-0A58-093B8AB18ED8",
    "response_time": "2023-10-10 11:38:50",
    "data": [
      {
        "order_sn": "PO230914108",
        "custom_order_sn": "PO230914108",
        "supplier_id": 925,
        "supplier_name": "xxx",
        "opt_uid": 10317908,
        "opt_realname": "账户2",
        "create_time": "2023-09-14 15:34:19",
        "order_time": "2023-09-14 15:34:28",
        "purchase_currency": "CNY",
        "shipping_currency": "CNY",
        "purchase_rate": "1.0000",
        "status_shipped": 3,
        "status_shipped_text": "全部到货",
        "quantity_total": 10,
        "payment": "0.00",
        "pay_status": 0,
        "pay_status_text": "未申请",
        "principal_uids": [
          {
            "id": 10317908,
            "name": "账户2"
          }
        ],
        "auditor_uid": 0,
        "auditor_time": "",
        "auditor_realname": "",
        "last_uid": 10317908,
        "last_time": "2023-09-14 17:40:34",
        "last_realname": "账户2",
        "purchaser_id": 129,
        "contact_person": "",
        "contact_number": "",
        "settlement_method": 7,
        "settlement_description": "",
        "payment_method": 0,
        "reason": "",
        "wid": 1,
        "is_tax": 0,
        "status": 9,
        "status_text": "已完成",
        "ware_house_name": "默认仓库测试",
        "ware_house_bak_name": "默认仓库测试",
        "shipping_price": "0.00",
        "amount_total": "660.00",
        "other_fee": "0.00",
        "other_currency": "CNY",
        "fee_part_type": 0,
        "total_price": "660.00",
        "icon": "¥",
        "remark": "",
        "quantity_entry": 10,
        "quantity_real": 10,
        "quantity_receive": 0,
        "update_time": "2023-09-14 17:40:34",
        "logistics_info": [],
        "item_list": [
          {
            "id": 8727,
            "plan_sn": "",
            "product_id": 22500,
            "product_name": "规格测试-1",
            "model": "",
            "wid": 1,
            "ware_house_name": "默认仓库测试",
            "sku": "guigeceshi-1",
            "fnsku": "",
            "sid": 0,
            "price": "66.0000",
            "amount": "660.00",
            "quantity_plan": 0,
            "quantity_real": 10,
            "quantity_per_case": 0,
            "quantity_return": 0,
            "quantity_exchange": 0,
            "cases_num": 0,
            "msku": [],
            "attribute": [
              {
                "attr_id": 770,
                "attr_name": "规格22",
                "attr_value": "10-10"
              }
            ],
            "tax_rate": "0.00",
            "spu": "guigeceshi",
            "spu_name": "规格测试",
            "quantity_entry": 10,
            "quantity_receive": 0,
            "quantity_qc": 9,
            "quantity_qc_prepare": 9,
            "expect_arrive_time": "",
            "remark": "",
            "is_delete": 0
          }
        ]
      }
    ],
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1start_date开始时间string—Required开始时间,格式:Y-m-d,双闭区间 当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
2end_date结束时间string—Required结束时间,格式:Y-m-d,双闭区间 当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
3search_field_time时间搜索维度string—Optional时间搜索维度: create_time 创建时间【默认值】 expect_arrive_time 预计到货时间 update_time 更新时间
4order_sn采购单号array<any>—Optional采购单号,上限500
5custom_order_sn自定义采购单号array<any>—Optional自定义采购单号,上限500
6purchase_type采购类型integer—Optional采购类型,1:普通采购,2:1688采购
7offset分页偏移量integer—Optional分页偏移量,默认0
8length分页长度integer—Optional分页长度,默认500,上限500

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring929A1D7D-D656-0EA0-C78A-A686790C7090Required请求链路id
5response_time响应时间string2022-05-20 16:57:03Required响应时间
6data响应数据array<object>—Required响应数据
6.1order_sn采购单号stringPO201019001Required采购单号
6.2custom_order_sn自定义单号string—Required自定义单号
6.3supplier_id供应商idinteger291Required供应商id
6.4supplier_name供应商string深圳xxx有限公司Required供应商
6.5opt_uid采购员idinteger297Required采购员id
6.6principal_uids单据负责人信息array<object>—Required单据负责人信息
6.6.1id单据负责人UIDstring1221Required单据负责人UID
6.6.2name单据负责人名称string用户ARequired单据负责人名称
6.7auditor_realname审核人姓名string—Required审核人姓名
6.8opt_realname操作人姓名string测试人员Required操作人姓名
6.9last_realname最后操作人姓名string测试人员Required最后操作人姓名
6.10create_time创建时间string2020-10-19 10:43:01Required创建时间
6.11order_time下单时间string2020-10-19 10:43:01Required下单时间
6.12payment应付货款(手工)string0.00Required应付货款(手工)
6.13auditor_uid审核人员idinteger10Required审核人员id
6.14auditor_time审核时间string2020-10-19 10:43:01Required审核时间
6.15last_uid最后操作人员idinteger297Required最后操作人员id
6.16last_time最后操作时间string2020-10-19 10:43:01Required最后操作时间
6.17reason作废原因string采购数量有误Required作废原因
6.18is_tax是否含税integer—Required是否含税:0 否,1 是
6.19status采购单状态integer1Required采购单状态: -1 作废 3 待提交 1 待下单 - 已审核 2 待签收(待到货) - 已下单 9 完成 121 (审批流)待审核 122 (审批流)驳回 124 (审批流)作废
6.20status_text状态说明string待审核Required状态说明
6.21pay_status_text支付状态说明string未申请Required支付状态说明
6.22status_shipped到货状态integer1Required到货状态: 1 未到货 2 部分到货 3 全部到货
6.23status_shipped_text到货状态说明string未到货Required到货状态说明
6.24amount_total货物总价number200Required货物总价
6.25total_price总金额number200Required总金额
6.26icon币种符号string¥Required币种符号
6.27pay_status付款状态integer1Required付款状态: 0 未申请 1 已申请 2 部分付款 3 已付款
6.28remark备注string—Required备注
6.29other_fee其他费用number0Required其他费用
6.30other_currency其他费用币种stringCNYRequired其他费用币种
6.31fee_part_type费用分摊方式integer1Required费用分摊方式: 0 不分摊 1 按金额 2 按数量
6.32shipping_price运费number0Required运费
6.33shipping_currency运费币种stringCNYRequired运费币种
6.34purchase_currency采购币种stringCNYRequired采购币种
6.35purchase_rate采购汇率number1Required采购汇率
6.36quantity_total采购总量number200Required采购总量
6.37wid仓库idinteger8Required仓库id
6.38ware_house_name仓库名string测试仓库Required仓库名
6.39ware_house_bak_name仓库名(备份)string测试仓库Required仓库名(备份)
6.40quantity_entry入库量integer10Required入库量
6.41quantity_real实际采购量integer200Required实际采购量
6.42quantity_receive待到货量integer20Required待到货量
6.43update_time采购单更新时间string2020-10-19 10:43:01Required采购单更新时间
6.44purchaser_id采购方idinteger—Required采购方id
6.45contact_person联系人string—Required联系人
6.46contact_number联系方式string—Required联系方式
6.47settlement_method结算方式integer—Required结算方式: 7 现结 8 月结
6.48settlement_description结算描述string—Required结算描述
6.49purchase_type采购类型 1string—Required采购类型 1:普通采购;2:1688采购
6.50purchase_type_text采购类型文本string—Required采购类型文本
6.51alibaba_order_sn1688订单号string—Required1688订单号
6.52sub_status1688订单状态string—Required1688订单状态,1:待1688下单,2:等待买家付款,3:等待买家
6.53sub_status_text1688订单状态文本string—Required1688订单状态文本
6.54custom_fields自定义字段array<any>—Required自定义字段
6.55payment_method支付方式integer0Required支付方式
6.56item_list采购单子项array<object>—Required采购单子项
6.56.1id采购单子项idinteger112Required采购单子项id
6.56.2wid仓库idinteger—Required仓库id
6.56.3ware_house_name仓库名称string—Required仓库名称
6.56.4relation_purchase_plan更多采购计划号array<any>—Required更多采购计划号
6.56.5plan_sn采购计划号stringPP171225003Required采购计划号
6.56.6product_id本地产品idinteger11528Required本地产品id
6.56.7product_name品名string铅笔Required品名
6.56.8skuskustringWYLS003RequiredSKU
6.56.9fnskufnskustringES3001RequiredFNSKU
6.56.10sid店铺idstring6Required店铺id
6.56.11model型号string—Required型号
6.56.12price含税单价number1Required含税单价
6.56.13amount价税合计number100Required价税合计
6.56.14quantity_plan计划采购量integer10Required计划采购量
6.56.15quantity_real实际采购量integer100Required实际采购量
6.56.16quantity_entry到货入库量integer10Required到货入库量
6.56.17quantity_receive待到货量integer2Required待到货量
6.56.18quantity_return退货数integer—Required退货数
6.56.19quantity_exchange换货量integer120Required换货量
6.56.20quantity_qc质检量integer10Required质检量
6.56.21quantity_qc_prepare待质检量integer10Required待质检量
6.56.22expect_arrive_time期待到货时间string2020-10-01Required期待到货时间
6.56.23first_receive_time首次到货时间string—Required首次到货时间
6.56.24last_receive_time最后到货时间string—Required最后到货时间
6.56.25first_qc_time首次质检时间string—Required首次质检时间
6.56.26remark备注string—Required备注
6.56.27cases_num箱数integer—Required箱数
6.56.28quantity_per_case单箱数量integer20Required单箱数量
6.56.29is_delete是否删除integer1Required是否删除:0 否,1 是
6.56.30mskumskuarray<any>—RequiredMSKU
6.56.31attribute属性string—Required属性
6.56.32tax_rate税率string—Required税率
6.56.33spuspustring—Requiredspu
6.56.34spu_name款名string—Required款名
6.56.35custom_fields自定义字段array<any>—Required自定义字段
6.57logistics_info物流信息array<object>—Required物流信息
6.57.1logistics_company物流公司string—Required物流公司
6.57.2logistics_order_no物流单号string—Required物流单号
6.57.3pol_id物流信息记录idstring—Required物流信息记录id
6.57.4purchase_order_id采购订单唯一idstring—Required采购订单唯一id
6.57.5purchase_order_sn采购订单号(order_sn)string&nbsp;Required采购订单号(order_sn)

The 查询采购单列表 API (/erp/sc/routing/data/local_inventory/purchaseOrderList) 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.