当前位置: API文档
vip_stat_sales_by_spec_shop_warehouse_query.php(查询销售汇总)
1.1 接口描述:获取销售订单出库单汇总数据,查询旺店通ERP统计→销售→单品销售汇总表的“发货量”。 |
1.2 适用版本:客户端 V2.4.5.0及以上版本 |
1.3 全量获取:按照日期请求返回汇总数据 |
1.4 注意事项:本接口不返回淘系及系统供销平台订单数据,相关平台规则单击这里。淘系订单数据获取办法单击这里。其他平台的敏感信息会根据平台规则同步调整。 |
2.1 财务、SAP、线下ERP等系统对接 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/vip_stat_sales_by_spec_shop_warehouse_query.php |
正式环境 | https://api.wangdian.cn/openapi2/vip_stat_sales_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输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
发货日期 | consign_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 | 是 | 响应参数的1级数据节点,包含销售出库汇总节点,节点下数据字段详见下述“content”列表 |
content
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
汇总维度 | stat_no | varchar | varchar | 是 | 订单类型+日期,返回数据格式:SALES_YYYY-MM-DD |
汇总明细节点 | spec_list | data[ ] | 是 |
spec_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
行标识 | rec_id | int | 11 | 是 | 行标识 |
创建日期 | created | datetime | 是 | 汇总创建日期,时间格式:yyyy-MM-dd HH:mm:ss | |
发货日期 | consign_date | datetime | 是 | 发货日期,时间格式:yyyy-MM-dd HH:mm:ss | |
销售类型 | order_type | varchar | 40 | 是 | 返回固定值“1 ” |
销售类型名称 | order_type_name | varchar | 40 | 是 | 返回固定值“销售类型” |
店铺编号 | shop_no | varchar | 40 | 是 | 店铺编号 |
仓库编号 | warehouse_no | varchar | 40 | 是 | 仓库编号 |
商家编码 | spec_no | varchar | 40 | 是 | 商家编码 |
发货总量 | num | decimal | (19,4) | 是 | 发货的总数量,包含赠品和退款数量 |
单位名称 | unit_name | varchar | 40 | 是 | 单位名称 |
成交单价 | avg_price | decimal | (19,4) | 是 | 成交单价 |
成交金额 | amount | decimal | (19,4) | 是 | 成交金额(发货总金额) |
销售日期 | sales_date | varchar | 20 | 是 | 默认为'',日期 |
店铺id | shop_id | int | 11 | 是 | 默认为'0',店铺 |
仓库id | warehouse_id | int | 11 | 是 | 默认为'0',仓库 |
货品规格id | spec_id | int | 11 | 是 | 货品规格id |
赠品数量 | gift_num | decimal | (19,4) | 是 | 默认为'0.0000',赠品数量 |
未付款量 | unpay_num | decimal | (19,4) | 是 | 默认为'0.0000',未付款量 |
退款量 | refund_num | decimal | (19,4) | 是 | 默认为'0.0000',退款量 |
退货量 | return_num | decimal | (19,4) | 是 | 默认为'0.0000',退货量 |
换货量 | swap_num | decimal | (19,4) | 是 | 默认为'0.0000',换货量 |
当前退款量 | cur_refund_num | decimal | (19,4) | 是 | 默认为'0.0000',此时发出订单的退款量,受后来影响 |
当前换货量 | cur_swap_num | decimal | (19,4) | 是 | 默认为'0.0000',换货量 |
当前退货量 | cur_return_num | decimal | (19,4) | 是 | 默认为'0.0000',退货量 |
库存量 | stock_num | decimal | (19,4) | 是 | 默认为'0.0000',统计时该商品的总库存 |
未知商品金额 | unknown_goods_amount | decimal | (19,4) | 是 | 默认为'0.0000',未知成本销售金额 |
退款总金额 | refund_amount | decimal | (19,4) | 是 | 默认为'0.0000',退款总金额 |
佣金成本 | commission | decimal | (19,4) | 是 | 默认为'0.0000',佣金成本 |
退货成本 | return_cost | decimal | (19,4) | 是 | 默认为'0.0000',退货成本 |
退货金额 | return_amount | decimal | (19,4) | 是 | 默认为'0.0000',退货金额 |
换货金额 | swap_amount | decimal | (19,4) | 是 | 默认为'0.0000',换货总金额 |
商品成本 | goods_cost | decimal | (19,4) | 是 | 默认为'0.0000',成本 |
赠品成本 | gift_cost | decimal | (19,4) | 是 | 默认为'0.0000',赠品成本 |
邮费金额 | post_amount | decimal | (19,4) | 是 | 默认为'0.0000',邮费收入 |
邮费成本 | post_cost | decimal | (19,4) | 是 | 默认为'0.0000',邮费成本 |
店铺名称 | shop_name | varchar | 128 | 是 | 店铺名称 |
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
JSON | { "code": 1060, "message": "充值余额为0或应用已欠费,请联系商务充值 " } |