轻易云
注册体验

领星ERP添加入库单接口

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

添加入库单

POST/erp/sc/routing/storage/storage/orderAdd
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/storage/storage/orderAdd"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "{\n    \"wid\": \"CUSTOM-ID-1\",\n    \"sys_wid\": 1,\n    \"type\": 1,\n    \"supplier_id\": \"S1929\",\n    \"sys_supplier_id\": 125,\n    \"order_sn\": \"PO220118001\",\n    \"is_shelf\": 1,\n    \"remark\": \"备注\",\n    \"ship_fee\": \"1.22\",\n    \"other_fee\": \"5\",\n    \"fee_part_type\": 2,\n    \"inbound_time\": \"2022-12-02\",\n    \"product_list\": [\n        {\n            \"sku\": \"MDR-ZX110\",\n            \"good_num\": 10,\n            \"bad_num\": 0,\n            \"price\": \"8.66\",\n            \"seller_id\": 21,\n            \"fnsku\": \"FN206265A\",\n            \"good_whb_code\":\"A-1-1\",\n            \"bad_whb_code\":\"次品暂存\",\n        }\n    ]\n}"
}

接口请求参数

序号字段名称类型默认值必填描述
1wid自定义仓库idstring—可选自定义仓库id,wid和sys_wid其中一项必填,都填则优先wid
2sys_wid系统仓库idinteger—必填系统仓库id,wid和sys_wid其中一项必填,都填则优先wid
3type单据类型integer—必填单据类型: 1 其他入库 2 采购入库 26 退货入库 27 移除入库
4supplier_idsupplier_idstring—可选自定义供应商id【supplier_id、sys_supplier_id 二选一必填,都填优先取supplier_id】
5sys_supplier_idsys_supplier_idinteger—可选系统供应商id【supplier_id、sys_supplier_id 二选一必填,都填优先取supplier_id】
6order_sn采购单号【对此采购单执行快捷入库】string—可选采购单号【对此采购单执行快捷入库】,不支持自定义采购单号
7is_shelf采购单快捷入库是否进入【上架暂存仓位】integer—可选采购单快捷入库是否进入【上架暂存仓位】,1:进入,默认0
8remark单据备注string—可选单据备注
9ship_fee运费string—可选运费
10other_fee其它费用string—可选其它费用
11fee_part_type费用分配方式integer—可选费用分配方式: 0 不分摊 1 按金额 2 按数量
12inbound_time自定义入库时间string—可选自定义入库时间,格式:Y-m-d
13inbound_idempotent_code(入库单)客户参考号string—可选(入库单)客户参考号, 该字段校验唯一不可重复
14product_list产品明细array<object>—必填产品明细
14.1skuskustring—必填sku
14.2good_num良品数量integer—必填良品数量
14.3bad_num次品数量integer—必填次品数量
14.4price单价string—必填单价
14.5seller_id店铺id【没有店铺时传0】integer—必填店铺id【没有店铺时传0】 亚马逊店铺对应查询亚马逊店铺信息字段【sid】 多平台店铺对应查询多平台店铺信息字段【store_id】
14.6fnskufnsku【存在fnsku时店铺id必填string—必填fnsku【存在fnsku时店铺id必填,没有时传空字符串】
14.7good_whb_code可用仓位string—可选可用仓位
14.8bad_whb_code次品仓位string—可选次品仓位

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring5A1EBE67-7793-9E94-7790-AA457B81B3F2必填请求链路id
5response_time响应时间string2022-06-27 11:54:31必填响应时间
6data响应数据object—必填响应数据
6.1order_sn_arr入库单号数组【兼容多个单号情况】array<any>[IB221207001,IB221207002]必填入库单号数组【兼容多个单号情况】
6.2order_snorder_snstringIB221207001必填入库单号【多个单号情况下值为order_sn_arr里的第一个】

领星ERP的接口:添加入库单(/erp/sc/routing/storage/storage/orderAdd),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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