当前位置: API文档

stockin_order_push.php(创建其他入库单)

¥标准

1.接口说明

   1.1 接口描述:旺店通ERP需要增加库存且入库单据没有对应的业务类型,调用本接口在旺店通ERP创建其他入库单,增加库存。

   1.2 适用版本:网页版
   1.3 注意事项:该接口不支持创建委外类型仓库的其他入库单

2.调用场景

   2.1 线下ERP、SAP等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapitest.huice.com/openapi/stockin_order_push.php
正式环境https://openapi.huice.com/openapi/stockin_order_push.php

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString
本开放平台“自助对接”功能模块内自助申请,申请流程单击这里
时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
外部单号outer_novarchar40外部系统的唯一单据编号,避免重复推送数据
仓库编号warehouse_idvarchar40代表仓库所有属性的唯一编码,用于仓库区分,
ERP内支持自定义(ERP仓库界面设置)
物流编号logistics_codevarchar20代表物流所有属性的唯一编码,用于物流区分,
ERP内支持自定义(ERP物流界面设置)
物流单号logistics_novarchar40物流公司的运单号,用于追踪物流、
快递流转信息(路由)的数字编码
是否审核is_savetinyintfalse传false自动审核    传true为不审核    默认为false
邮资post_amountdecimal(19,4)物流或者快递运输货物产生的费用
备注remarkvarchar255其他入库单备注
入库原因
stockin_reasonvarchar255入库原因(需要在客户端维护好该原因,
如客户端无该原因或者原因停用,则推送失败)
货品明细节点stock_in_order_detail_listdata[]
入库单货品列表节点
源单类型src_order_typeint11源单类型-目前仅允许其他入库(type=6)和采购入库(type=1)
源单号src_order_novarchar40上层单据编号,如果是采购入库就是采购单号,
调拨入库就是调拨号,以此类推

stock_in_order_detail_list

名称字段类型长度必须描述
商家编码sku_novarchar40ERP内单品唯一编码(SKU),代表单品(SKU)所有属性, 并且为库存量出入计算最小单元。
注:推送的sku_no值在ERP货品档案必须存在,否则单据会创建失败。
源单明细idsrc_order_detail_idint11源单明细id
入库数量realNumdecimal(19,4)入库数量
货位编号position_novarchar20商品在仓库内的位置编号,不传此参数,读ERP配置【入库开单货位优先级配置】,
来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。
批次batch_novarchar20货品批次编号
生产日期production_datedatetime
货品生产日期,格式:yyyy-MM-dd HH:mm:ss
有效期天数validity_daysint11商品有效期,单位:天
有效期expire_datedatetime
有效期日期,格式:yyyy-MM-dd HH:mm:ss
入库价stockin_pricedecimal(19,4)入库价格,如不传该字段入库价默认取0
入库金额stockin_amountdecimal(19,4)入库金额,默认:数量*单价
明细备注 remark varchar 255 否 明细备注 

   4. 响应参数

4.1公共响应参数

名称字段类型长度必须描述
错误码codeint11
状态码:0表示成功,其他表示失败
错误原因messagevarchar255错误原因
入库单号stockin_novarchar40ERP系统生成入库单据分配的单号

常用工具