API文档

aftersale_stockin_confirm.php（创建退货入库单）

¥标准

1.接口说明

1.1 接口描述：推送旺店通ERP销售退货（换货）订单对应的入库单据给旺店通ERP，推送前提旺店通ERP的退换单状态为“待收货”

1.2 适用版本：网页版

2.调用场景

2.1 线下ERP等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/aftersale_stockin_confirm.php
正式环境	https://openapi.huice.com/openapi/aftersale_stockin_confirm.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 业务请求参数

名称	字段	类型	长度	必须	描述
退货单列表节点	stockin_refund_info	data		是	请求参数的1级数据节点，包含销售退货单所有属性信息的数据节点，节点下数据字段详见下述“stockin_refund_info”

stockin_refund_info

名称	字段	类型	长度	必须	描述
退换单号	refund_no	varchar	40	是	系统退换单的单号，默认RT开头
仓库id	warehouse_id	varchar	40	是	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看。不支持推送多个仓库编号
物流公司编号	logistics_code	varchar	20	是	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
物流单号	logistics_no	varchar	40	是	物流单号
邮费	post_fee	decimal	(19,4)	否	邮费
备注	remark	varchar	255	否	备注
货品列表节点	detail_list	data[ ]		是	请求参数的2级数据节点，包含销售退货入库单所有属性信息的数据节点，节点下数据字段详见下述“detail_list”

名称	字段	类型	长度	必须	描述
商家编码	spec_no	varchar	40	是	代表单品(sku)所有属性的唯一编码，ERP内单品唯一编码（sku）。推送的spec_no值在ERP货品档案必须存在，且上一层单据退换单也必须存在此编号，否则单据会创建失败。SKU概念介绍,单击这里
货位	position_no	varchar	20	否	商品在仓库内的位置编号，传值时货位编号为空，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。
批次号	batch_no	varchar	20	否	商品批次编号，ERP“批次管理”不存在推送的批次号，是否允许单据创建成功，并创建新的“批次号”0：否；1：是，默认是0。is_create_batch=0时，入库单推送的“批次号”ERP“批次管理不存在”，单据创建失败，并返回错误信息。is_create_batch=1时，入库单推送的“批次号”ERP“批次管理不存在，单据会创建成功，并在ERP“批次管理”创建一个新的批次，请谨慎使用此字段。
批次备注	batch_remark	varchar	255	否	批次备注
入库数量	stockin_num	decimal	(19,4)	是	入库数量
生产日期	production_date	datetime		否	生产日期，格式：yyyy-MM-dd HH:mm:ss
有效期	expire_date	datetime		否	有效期，格式：yyyy-MM-dd HH:mm:ss
备注	remark	varchar	255	否	备注

4.响应参数

4.1 响应参数

5.请求示例

PHP	<?php require_once '../WdtClient.php'; $c = new WdtClient(); $c->sid =''; $c->appkey =''; $c->appsecret =""; //测试环境地址 //上线时需要换成线上的 $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/aftersale_stockin_confirm.php'; $stockin_refund_info = array ( "refund_no" => "RT2603170237", "outer_no" => "zd202603180001", "warehouse_id" => "240", "logistics_code" => "11111", "logistics_no" => "11111", "is_check" => "1", "detail_list" => array( array( "spec_no" => "10022740", "stockin_num" => 2 ) ) ); $c->putApiParam('stockin_refund_info', json_encode($stockin_refund_info, JSON_UNESCAPED_UNICODE)); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

JSON	{ "code": 0, "message": "", "stockin_id": "2807203546011795458", "stockin_no": "RK2603180004", "refund_id": "2806954438558744604", "refund_no": "RT2603170237" }

JSON	{ "code": 11000000, "message": "该售后单状态不允许入库" }