当前位置: API文档
vip_stat_refund_by_spec_shop_warehouse_query.php(查询销售退货汇总)
1.1 接口描述:获取销售订单退回货品汇总数据,查询旺店通EREP统计→销售→单品销售汇总表的“退货量”。 |
1.2 适用版本:客户端 V2.4.5.0及以上版本 |
1.3 全量获取:按照日期请求返回汇总数据 |
1.4 注意事项:本接口不返回淘系及系统供销平台订单数据,相关平台规则单击这里。淘系及系统供销平台订单数据获取办法单击这里。其他平台的敏感信息会根据平台规则同步调整。 |
2.1 财务、SAP、线下ERP等系统对接 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/vip_stat_refund_by_spec_shop_warehouse_query.php |
正式环境 | https://api.wangdian.cn/openapi2/vip_stat_refund_by_spec_shop_warehouse_query.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | 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输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
退货入库日期 | stockin_date | date | 是 | 示例值:2018-12-23 | |
是否支持分页获取 | is_page | int | 否 | 该字段传0或者不传时 不进行分页获取,当传1时可以分页获取数据 | |
分页大小 | page_size | int | 否 | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里 | |
页号 | page_no | int | 否 | 不传值默认从0页开始 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
数据条数 | total_count | int | 10 | 否 | 只有,page_no = 0 时才返回的符合条件的数据总条数,用来分页 |
主列表节点 | content[ ] | data | 是 | 响应参数的级数据节点,包含当前页的库存管理信息的数据节点,节点下数据字段详见下述“content”列表 |
content
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
汇总维度 | pack_no | varchar | 255 | 是 | 退货类型+日期 |
汇总明细节点 | Data | | 是 | 以明细序号+明细内容的形式体现,格式如下:"0":{XXX},"1":{XXX}... |
spec_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
行标识 | rec_id | Int | 是 | 行标识 | |
创建日期 | created | datetime | 是 | 数据统计日期 格式:yyyy-MM-dd HH:mm:ss | |
退货入库日期 | stockin_date | datetime | 是 | 退货入库日期 格式:yyyy-MM-dd HH:mm:ss | |
退货类型 | order_type | varchar | 40 | 是 | 固定值"退货类型" |
店铺编号 | shop_no | varchar | 40 | 是 | 店铺编号 |
仓库编号 | warehouse_no | varchar | 40 | 是 | 仓库编号 |
仓库编号 | sap_warehouse_no | varchar | 40 | 是 | 同warehouse_no字段 |
商家编码 | spec_no | varchar | 40 | 是 | 商家编码 |
退货总量 | num | decimal | (19,4) | 是 | 退货总量,包含赠品和退款数量 |
单位名称 | unit_name | varchar | 40 | 是 | 单位名称 |
成交单价 | avg_price | decimal | (19,4) | 是 | 成交单价 |
成交金额 | amount | decimal | (19,4) | 是 | 单品销售汇总表的发货后实际退款金额 |
退货总金额 | return_amount | decimal | (19,4) | 是 | 退货总金额 |
退货总成本 | return_cost | decimal | (19,4) | 是 | 退货总成本 |
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
JSON | { "code": 1060, "message": "充值余额为0或应用已欠费,请联系商务充值 " } |