Qeasy Cloud
Get Started

领星ERP 创建待到货的采购单 API

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

创建待到货的采购单

POST/erp/sc/routing/purchase/purchase/createPurchaseOrder
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/purchase/purchase/createPurchaseOrder"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "sys_wid": 1,
    "sys_supplier_id": 2,
    "settlement_method": 8,
    "purchase_currency": "CNY",
    "fee_part_type": 0,
    "remark": "测试123",
    "opt_uid": 1,
    "purchaser_id": 1,
    "is_tax": 0,
    "product_list": [
      {
        "sku": "SKU-1",
        "price": "1.00",
        "quantity_real": 50,
        "plan_sn": "PP231211001",
        "expect_arrive_time": "2023-12-21",
        "tax_rate": "10"
      }
    ]
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "D41373ED-AF54-CDF1-1658-B8F86286F209",
    "response_time": "2021-11-12 12:37:55",
    "data": {
      "order_sn": "PO211112002",
      "custom_order_sn": "PO211112002"
    },
    "total": 0
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1wid客户仓库idinteger—Optional客户仓库id
2sys_wid系统仓库id【与客户仓库id 二选一必填】integer—Optional系统仓库id【与客户仓库id 二选一必填】
3supplier_id客户供应商idinteger—Optional客户供应商id
4sys_supplier_id系统供应商id【与客户供应商id 二选一必填】integer—Optional系统供应商id【与客户供应商id 二选一必填】
5custom_order_sncustom_order_snstring—Optional自定义采购单号【不传此字段则系统自动生成采购单号】
6contact_person联系人string—Optional联系人
7contact_number联系电话string—Optional联系电话
8settlement_method结算方式integer—Optional结算方式:7 现结,8 月结
9prepay_percent预付比例(%)number—Optional预付比例(%)
10period_config_key账期配置keystring—Optional账期配置key
11settlement_description结算描述string—Optional结算描述
12payment_method支付方式integer—Optional支付方式:1 网银转账,2 网上支付
13purchase_currency采购币种string—Optional采购币种
14rate汇率number—Optional汇率
15shipping_currency运费币种string—Optional运费币种
16shipping_price运费number—Optional运费
17other_currency其它费用币种string—Optional其它费用币种
18other_fee其它费用number—Optional其它费用
19fee_part_type费用分摊方式integer—Optional费用分摊方式:0 不分摊,1 按金额,2 按数量
20is_tax是否含税integer—Optional是否含税:0 否,1 是【当含税为1时,tax_rate为必传字段】
21remark备注string—Optional备注
22qc_type质检类型integer—Optional质检类型:【默认0】 0 仓库质检,1 预检,2 免检
23opt_uid采购员uidinteger—Required采购员uid
24purchaser_id采购方idinteger—Required采购方id,查询采购方列表 接口对应字段【purchaser_id】
25product_listproduct_listarray<object>—Required
25.1sid店铺idinteger—Optional店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
25.2seller_id亚马逊店铺id【建议使用sid替换】string—Optional亚马逊店铺id【建议使用sid替换】
25.3marketplace_idmarketplace_idstring—Optionalmarketplace_id【建议使用sid替换】
25.4skuskustring—Requiredsku
25.5fnskufnskustring—Optionalfnsku
25.6price单价string—Required单价
25.7tax_rate税率string—Optional税率,范围为[0,100)【当含税为1时,tax_rate为必传字段】
25.8cases_num箱数integer—Optional箱数
25.9quantity_per_case单箱数量integer—Optional单箱数量
25.10quantity_real实际采购量string—Required实际采购量
25.11expect_arrive_time预计到货时间string—Optional预计到货时间,格式:Y-m-d
25.12remark备注string—Optional备注
25.13plan_sn采购计划编号string—Optional采购计划编号
26options创建选项object—Optional创建选项
26.1is_auto_fill_store是否自动填充店铺integer—Optional是否自动填充店铺:【默认0】 0 否,1 是
26.2is_auto_fill_fnsku是否自动填充fnskuinteger—Optional是否自动填充fnsku:【默认0】0 否,1 是

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message响应消息string操作成功Required响应消息
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring8DFEE1CA-EC9B-F401-5D41-9F95251D5D50Required请求链路id
5response_time响应时间string2020-09-21 15:48:58Required响应时间
6data响应数据object—Required响应数据
6.1order_sn采购单号stringPO211112002Required采购单号
6.2custom_order_sn自定义采购单号stringPO211112002Required自定义采购单号

The 创建待到货的采购单 API (/erp/sc/routing/purchase/purchase/createPurchaseOrder) 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.