当前位置: API文档

vip_stat_sales_by_spec_shop_warehouse_query.php(查询销售汇总)

¥增值

1.接口说明

1.1 接口描述:获取销售订单出库单汇总数据,查询EREP统计→销售→单品销售汇总表的“发货量”。
1.2 适用版本:客户端 V2.4.0.5及以上版本
1.3 全量获取:按照日期请求返回汇总数据

2.调用场景

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

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://sandbox.wangdian.cn/openapi2/vip_stat_sales_by_spec_shop_warehouse_query.php
正式环境http://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_datedata

示例值:2018-12-23

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
行标识
创建日期createddate
汇总创建日期,返回数据格式:YYYY-MM-DD HH:MM:SS
发货日期consign_date
date
发货日期,返回数据格式: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)成交金额

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("", "", "", "http://sandbox.wangdian.cn/openapi2/vip_stat_sales_by_spec_shop_warehouse_query.php");
        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();
        }
    }
}

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或应用已欠费,请联系商务充值 "
}



常用工具