Lingxing
切换旧版

添加入库单

POST/erp/sc/routing/storage/storage/orderAdd

支持添加本地仓库入库单，并增加入库仓库库存

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/storage/orderAddHTTPSPOST1

请求参数

widstring
自定义仓库id，wid和sys_wid其中一项必填，都填则优先wid
sys_widinteger必填
系统仓库id，wid和sys_wid其中一项必填，都填则优先wid
typeinteger必填
单据类型：
1 其他入库
2 采购入库
26 退货入库
27 移除入库
supplier_idstring
自定义供应商id【supplier_id、sys_supplier_id 二选一必填，都填优先取supplier_id】
sys_supplier_idinteger
系统供应商id【supplier_id、sys_supplier_id 二选一必填，都填优先取supplier_id】
order_snstring
采购单号【对此采购单执行快捷入库】，不支持自定义采购单号
is_shelfinteger
采购单快捷入库是否进入【上架暂存仓位】，1：进入，默认0
remarkstring
单据备注
ship_feestring
运费
other_feestring
其它费用
fee_part_typeinteger
费用分配方式:
0 不分摊
1 按金额
2 按数量
inbound_timestring
自定义入库时间，格式：Y-m-d
inbound_idempotent_codestring
（入库单）客户参考号, 该字段校验唯一不可重复
product_listarray<object>必填
产品明细
隐藏子属性
skustring必填
sku
good_numinteger必填
良品数量
bad_numinteger必填
次品数量
pricestring必填
单价
seller_idinteger必填
店铺id【没有店铺时传0】
亚马逊店铺对应查询亚马逊店铺信息字段【sid】
多平台店铺对应查询多平台店铺信息字段【store_id】
fnskustring必填
fnsku【存在fnsku时店铺id必填，没有时传空字符串】
good_whb_codestring
可用仓位
bad_whb_codestring
次品仓位

请求示例

{
    "wid": "CUSTOM-ID-1",
    "sys_wid": 1,
    "type": 1,
    "supplier_id": "S1929",
    "sys_supplier_id": 125,
    "order_sn": "PO220118001",
    "is_shelf": 1,
    "remark": "备注",
    "ship_fee": "1.22",
    "other_fee": "5",
    "fee_part_type": 2,
    "inbound_time": "2022-12-02",
    "product_list": [
        {
            "sku": "MDR-ZX110",
            "good_num": 10,
            "bad_num": 0,
            "price": "8.66",
            "seller_id": 21,
            "fnsku": "FN206265A",
            "good_whb_code":"A-1-1",
            "bad_whb_code":"次品暂存",
        }
    ]
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 5A1EBE67-7793-9E94-7790-AA457B81B3F2
response_timestring必填
响应时间
示例 2022-06-27 11:54:31
dataobject必填
响应数据
隐藏子属性
order_sn_arrarray<any>必填
入库单号数组【兼容多个单号情况】
示例 [IB221207001,IB221207002]
order_snstring必填
入库单号【多个单号情况下值为order_sn_arr里的第一个】
示例 IB221207001

附加说明

针对采购单快捷入库【即入参order_sn传入采购单号】，以下字段会直接引用传入的采购单号对应的相关数据： 1. type 单据类型【自动根据采购入库类型变更】； 2. remark 单据备注； 3. fee_part_type 费用分配方式； 4. price 单价【单价 = 采购单单价 × 汇率】；