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

添加入库单

POST/erp/sc/routing/storage/storage/orderAdd
Factory
{
  "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}"
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring5A1EBE67-7793-9E94-7790-AA457B81B3F2Required请求链路id
5response_time响应时间string2022-06-27 11:54:31Required响应时间
6data响应数据object—Required响应数据
6.1order_sn_arr入库单号数组【兼容多个单号情况】array<any>[IB221207001,IB221207002]Required入库单号数组【兼容多个单号情况】
6.2order_snorder_snstringIB221207001Required入库单号【多个单号情况下值为order_sn_arr里的第一个】

The 添加入库单 API (/erp/sc/routing/storage/storage/orderAdd) 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.