当前位置: API文档

vip_stat_sales_by_spec_shop_warehouse_query.php(查询销售汇总)

¥增值

1.接口说明

1.1 接口描述:获取销售订单出库单汇总数据,查询旺店通ERP统计→销售→单品销售汇总表的“发货量”。
1.2 适用版本:客户端 V2.4.5.0及以上版本

1.3 全量获取:按照日期请求返回汇总数据

1.4 注意事项:本接口不返回淘系及系统供销平台订单数据,相关平台规则单击这里。淘系订单数据获取办法单击这里其他平台的敏感信息会根据平台规则同步调整。

2.调用场景

2.1 财务、SAP、线下ERP等系统对接

3.请求参数说明

   3.1 请求地址

环境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

   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 业务请求参数

名称字段类型长度
必须描述
发货日期consign_datedate

示例值:2018-12-23
是否支持分页获取is_pageint
该字段传0或者不传时 不进行分页获取,当传1时可以分页获取数据
分页大小page_sizeint
每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里
页号page_noint
不传值默认从0页开始

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint40状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint10只有,page_no = 0 时才返回的符合条件的数据总条数,用来分页
主列表节点content
data
响应参数的1级数据节点,包含销售出库汇总节点,节点下数据字段详见下述content列表

   4.2 业务响应参数

content

名称字段类型长度必须描述
汇总维度
stat_novarcharvarchar
订单类型+日期,返回数据格式:SALES_YYYY-MM-DD
汇总明细节点
spec_listdata[ ]


   spec_list

名称字段类型长度必须描述
行标识rec_idint11
行标识
创建日期createddatetime
汇总创建日期,时间格式:yyyy-MM-dd HH:mm:ss
发货日期consign_date
datetime
发货日期,时间格式:yyyy-MM-dd HH:mm:ss
销售类型
order_typevarchar40返回固定值“1 ”
销售类型名称
order_type_namevarchar40返回固定值“销售类型”
店铺编号shop_novarchar40店铺编号
仓库编号warehouse_novarchar40仓库编号
商家编码spec_novarchar40商家编码
发货总量numdecimal(19,4)发货的总数量,包含赠品和退款数量
单位名称unit_namevarchar40单位名称
成交单价avg_pricedecimal(19,4)成交单价
成交金额amountdecimal(19,4)
成交金额(发货总金额)
销售日期sales_datevarchar20默认为'',日期
店铺idshop_idint
11默认为'0',店铺
仓库idwarehouse_idint11默认为'0',仓库
货品规格idspec_idint11货品规格id
赠品数量gift_numdecimal(19,4)默认为'0.0000',赠品数量
未付款量unpay_numdecimal(19,4)默认为'0.0000',未付款量
退款量refund_numdecimal(19,4)默认为'0.0000',退款量
退货量return_numdecimal(19,4)默认为'0.0000',退货量
换货量swap_numdecimal(19,4)默认为'0.0000',换货量
当前退款量cur_refund_numdecimal(19,4)默认为'0.0000',此时发出订单的退款量,受后来影响
当前换货量cur_swap_numdecimal(19,4)默认为'0.0000',换货量
当前退货量cur_return_numdecimal(19,4)默认为'0.0000',退货量
库存量stock_numdecimal(19,4)默认为'0.0000',统计时该商品的总库存
未知商品金额unknown_goods_amountdecimal(19,4)默认为'0.0000',未知成本销售金额
退款总金额refund_amountdecimal(19,4)默认为'0.0000',退款总金额
佣金成本commissiondecimal(19,4)默认为'0.0000',佣金成本
退货成本return_costdecimal(19,4)默认为'0.0000',退货成本
退货金额return_amountdecimal(19,4)默认为'0.0000',退货金额
换货金额swap_amountdecimal(19,4)默认为'0.0000',换货总金额
商品成本goods_costdecimal(19,4)默认为'0.0000',成本
赠品成本gift_costdecimal(19,4)默认为'0.0000',赠品成本
邮费金额post_amountdecimal(19,4)默认为'0.0000',邮费收入
邮费成本post_costdecimal(19,4)默认为'0.0000',邮费成本
店铺名称
shop_namevarchar128店铺名称

5.请求示例

PHP
<?php
require_once("../WdtClient.php");
$c = new WdtClient;
$c->sid = '';
$c->appkey = '';
$c->appsecret = '';
$c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/vip_stat_sales_by_spec_shop_warehouse_query.php';


//添加查询参数
$c->putApiParam('consign_date', '2019-05-21');
$json = $c->wdtOpenApi();
var_dump($json);

?>
JAVA
package com.wangdian.api.vip;

import com.wangdian.api.WdtClient;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class VipStatSalesByShopWarehouseQuery {
    public static void main(String[] args) {
        WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url");
        //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看,测试环境url=https://sandbox.wangdian.cn/openapi2/
        //调用正式环境时请将sid、appkey、appsecret切换为实际参数,参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看,调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/
        
        Map<String, String> params = new HashMap<String, String>();
        params.put("consign_date", "2019-05-21");
        try {
            String response = client.execute("vip_stat_sales_by_spec_shop_warehouse_query.php", params);
            System.out.println(response);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;
namespace VipStatSalesByShopWarehouseQuery
{
    class VipStatSalesByShopWarehouseQuery
    {
        static void Main(string[] args)
        {
            WdtClient client = new WdtClient();
            client.sid = "";
            client.appkey = "";
            client.appsecret = "";
            client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/vip_stat_sales_by_spec_shop_warehouse_query.php";
            client.putParams("consign_date", "2019-05-21");
            string result = client.wdtOpenapi();
            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}
python
import WdtClient

t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/')
params = {}
params.update({"consign_date": '1000'})
params.update({"is_page": '1'})
params.update({"page_size": '100'})
params.update({"page_no": '0'})

response = t.execute("vip_stat_sales_by_spec_shop_warehouse_query.php", params)
print(response)

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "content": {
        "stat_no": "SALES_2019-05-21",
        "spec_list": [{
            "rec_id": "15368",
            "consign_date": "2019-05-21",
            "shop_no": "001",
            "warehouse_no": "G-CK001",
            "spec_no": "0080072",
            "created": "2019-05-22 03:00:32",
            "unit_name": "无",
            "num": "1.0000",
            "amount": "0.0000",
            "avg_price": "0.0000",
            "order_type": 1,
            "order_type_name": "销售类型"
        }, {
            "rec_id": "15374",
            "consign_date": "2019-05-21",
            "shop_no": "16097913",
            "warehouse_no": "16097913",
            "spec_no": "songyu002",
            "created": "2019-05-22 03:00:32",
            "unit_name": "个",
            "num": "1.0000",
            "amount": "42.0000",
            "avg_price": "42.0000",
            "order_type": 1,
            "order_type_name": "销售类型"
        }, {
            "rec_id": "15383",
            "consign_date": "2019-05-21",
            "shop_no": "74460904",
            "warehouse_no": "74460904",
            "spec_no": "lgj0428-1",
            "created": "2019-05-22 03:00:32",
            "unit_name": "无",
            "num": "2.0000",
            "amount": "0.0000",
            "avg_price": "0.0000",
            "order_type": 1,
            "order_type_name": "销售类型"
        }]
    },
    "total_count": "3"
}

   6.2 异常响应示例

JSON
{
    "code": 1060,
    "message": "充值余额为0或应用已欠费,请联系商务充值 "
}



常用工具