API文档

stockin_order_push.php（创建其他入库单）

¥标准

1.接口说明

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

1.2 适用版本：网页版

1.3 注意事项：该接口不支持创建委外类型仓库的其他入库单

2.调用场景

2.1 线下ERP、SAP等系统对接

3.请求参数说明

3.1 请求地址

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

3.2 公共请求参数

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

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
外部单号	outer_no	varchar	40	是	外部系统的唯一单据编号，避免重复推送数据
仓库编号	warehouse_id	varchar	40	是	代表仓库所有属性的唯一编码，用于仓库区分， ERP内支持自定义（ERP仓库界面设置）
物流编号	logistics_code	varchar	20	否	代表物流所有属性的唯一编码，用于物流区分， ERP内支持自定义（ERP物流界面设置）
物流单号	logistics_no	varchar	40	否	物流公司的运单号，用于追踪物流、快递流转信息（路由）的数字编码
是否审核	is_save	bool	1	否	传false自动审核传true为不审核默认为false
邮资	post_amount	decimal	(19,4)	否	物流或者快递运输货物产生的费用
备注	remark	varchar	255	否	其他入库单备注
入库原因	reason	varchar	255	否	入库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败）
货品明细节点	stock_in_order_detail_list	data[]		是	入库单货品列表节点
源单类型	src_order_type	int	11	是	源单类型-目前仅允许其他入库(type=6)和采购入库(type=1)
源单号	src_order_no	varchar	40	是	上层单据编号，如果是采购入库就是采购单号，调拨入库就是调拨号，以此类推
是否更新覆盖生产批号	is_coverage_production_batch_no	int		否	是否更新覆盖生产批号。1：覆盖 0和其他都不覆盖

stock_in_order_detail_list

名称	字段	类型	长度	必须	描述
商家编码	sku_no	varchar	40	是	ERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。注：推送的sku_no值在ERP货品档案必须存在，否则单据会创建失败。
源单明细id	src_order_detail_id	int	11	否	源单明细id
入库数量	real_num	decimal	(19,4)	是	入库数量
货位编号	position_no	varchar	20	否	商品在仓库内的位置编号
批次	batch_no	varchar	20	否	货品批次编号
生产日期	production_date	datetime		否	货品生产日期，格式：yyyy-MM-dd HH:mm:ss
有效期天数	validity_days	int	11	否	商品有效期，单位：天
有效期	expire_date	datetime		否	有效期日期，格式：yyyy-MM-dd HH:mm:ss
入库价	stockin_price	decimal	(19,4)	是	入库价格，如不传该字段入库价默认取0
入库金额	stockin_amount	decimal	(19,4)	否	入库金额，默认：数量*单价
明细备注	remark	varchar	255	否	明细备注
生产批号	production_batch_no	varchar	64	否	生产批号

4. 响应参数

4.1公共响应参数

5.请求示例

PHP	<?php require_once('../WdtClient.php'); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; //测试环境地址 //上线时需要换成线上的 $c->gatewayUrl = 'https://openapitest.huice.com/openapi/stockin_order_push.php'; // 测试的 //$c->gatewayUrl = 'https://openapi.huice.com/openapi/stockin_order_push.php'; //正式的 $spec_item = new stdClass(); $spec_item->sku_no = "test1"; $spec_item->real_num = "1"; $spec_item->stockin_price = "1"; $stock_in_order_detail_list = [$spec_item]; $c->putApiParam('outer_no', 'test1'); $c->putApiParam('warehouse_id', '130'); $c->putApiParam('src_order_type', 6); $c->putApiParam("stock_in_order_detail_list", json_encode($stock_in_order_detail_list, JSON_UNESCAPED_UNICODE)); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

JSON	{ "code":0, "message":"", "stockin_no":"RK2512300005", "fail_item_list":null }

JSON	{ "code":21000003, "message":"必要参数缺失：src_order_type" }