轻易云
注册体验

领星ERP查询采购单列表接口

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

查询采购单列表

POST/erp/sc/routing/data/local_inventory/purchaseOrderList
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

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

需要对接这个接口?

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