轻易云
注册体验

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

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

创建待到货的采购单

POST/erp/sc/routing/purchase/purchase/createPurchaseOrder
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message响应消息string操作成功必填响应消息
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring8DFEE1CA-EC9B-F401-5D41-9F95251D5D50必填请求链路id
5response_time响应时间string2020-09-21 15:48:58必填响应时间
6data响应数据object—必填响应数据
6.1order_sn采购单号stringPO211112002必填采购单号
6.2custom_order_sn自定义采购单号stringPO211112002必填自定义采购单号

领星ERP的接口:创建待到货的采购单(/erp/sc/routing/purchase/purchase/createPurchaseOrder),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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