当前位置: API文档

stockin_order_query_refund.php(查询退货入库单)

¥标准

1.接口说明

1.1 接口描述:获取旺店通ERP销售退货(换货)订单对应的入库单信息
1.2 适用版本:网页版
1.3 增量获取:按照ERP退货入库单的最后修改时间增量获取数据,请求时输入start_time和end_time作为时间跨度的筛选条件。
1.4 时间跨度:start_time和end_time最大跨度为30天,开始时间和结束时间取值范围为闭区间取值,例如2018-11-01 00:00:00至2018-11-30 23:59:59,建议根据获取数据量的多少适当减小时间跨度。
1.5 注意事项:本接口不返回淘系及系统供销平台订单数据,相关平台规则单击这里。淘系及系统供销订单数据获取办法单击这里其他平台的敏感信息会根据平台规则同步调整。

2.调用场景

2.1 财务系统、SAP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

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

名称字段类型长度
必须描述
状态statustinyint4入库单状态 10已取消20编辑中30待审核60待结算80已完成(默认查询80已完成单据)
开始时间start_timedatetime                

按时间增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss
结束时间end_timedatetime
按时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss
入库单号
stockin_novarchar             
40

入库单号,传该字段可以不传时间范围
退换单号src_order_novarchar             
40

系统退换单号,默认TK开头,传该字段可以不传时间范围
分页大小
page_size
int          


每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里
页号
page_no
int          


页号默认从0开始
仓库编号warehouse_novarchar             40仓库id

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint40状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint10符合条件的数据条数,用来分页 当page_no = 0时返回
入库单详情stockin_listdata[]
入库单详情数据节点

   4.2 业务响应参数

   stockin_list

名称Y 字段Y父级字段Y类型Y枚举是否必须默认值是否可变更
销售入库单idstockin_id
bigint(20)

入库状态status
tinyint(4)10已取消20编辑中30待审核60待结算80已完成(默认查询80已完成单据)
系统退单idrefund_id
bigint(20)

销售入库单号order_no
string

系统退单号src_order_no
string

入库时间stockin_time
datetime

物流公司idlogistics_id
int(11)

物流单号logistics_no
string

仓库idwarehouse_id
int(11)

备注remark
string

最后修改时间modified
datetime

货品列表details_list
array[]


销退入库明细idrec_iddetails_listbigint(20)

系统退单明细idsrc_order_detail_iddetails_listbigint(20)

货品明细idspec_iddetails_listint(11)

预计入库数量numdetails_listdecimal(21, 6)

实际入库数量right_numdetails_listdecimal(21, 6)

批次号batch_nodetails_liststring
null
最后修改时间modifieddetails_listdatetime

删除标记
tinyint(4)0未删除 >0已删除0
原订单原始子单号oiddetails_listvarchar(64)


原订单原始单号tiddetails_listvarchar(64)


商家编码spec_nodetails_listvarchar(40)


erp商品主键spec_iddetails_listbigint(20)


商品名称goods_namedetails_listvarchar(100)


货品编号goods_nodetails_listvarchar(40)


规格名称spec_namedetails_listvarchar(100)


平台idplatform_iddetails_listint(11)


正品残次品defectdetails_listint(11)
0



常用工具