当前位置: API文档

purchase_provider_goods_info_query.php(查询供应商货品接口)    

¥标准    

1.接口说明    

1.1 接口描述:批量获取旺店通ERP内供应商货品档案信息。                
1.2 适用版本:客户端 V2.4.5.0及以上版本
1.3 增量获取: 该接口的时间范围是必填的,最大跨度为30天,搜出来的数据都是在该最后修改时间范围内的供应商货品                         

2.调用场景 

  2.1 暂无                            

3.请求参数说明        

  3.1 请求地址  

环境         HTTP地址            
测试环境 https://sandbox.wangdian.cn/openapi2/purchase_provider_goods_info_query.php            
正式环境 https://api.wangdian.cn/openapi2/purchase_provider_goods_info_query.php           

   3.2 公共请求参数

名称字段类型长度必须描述

卖家账号 

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输入参数签名结果,签名算法介绍单击这里 

  3.3 业务请求参数

名称字段类型长度必须描述

开始时间

start_time

date


按最后修改时间增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss

结束时间

end_time

date


按最后修改时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss

商家编码

spec_no

varchar


代表单品(SKU)所有属性的唯一编码,用于获取指定的系统单品的数据

条码

barcode

varchar


条码

分页大小

page_size

int


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

页号

page_no

int


不传值默认从0页开始

4.响应参数

  4.1公共响应参数

名称字段类型长度必须描述
错误码codeint 40 是 状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述 
数据条数total_countint10只有,page_no = 0 时才返回的符合条件的数据总条数,用来分页 
供应商信息列表 purchase_provider_goods_list[]data
供应商货品信息,详见本接口purchase_provider_goods_list附录结构

   4.2 业务响应参数

名称字段类型长度必须描述
供应商货品主键rec_idint11主键信息
供应商provider_namevarchar20供应商
供应商编号provider_novarchar20代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息
采购价pricedecimal(19,4)采购价
最小采购量min_purchase_numdecimal (19,4)最小采购量
采购周期 purchase_cycle_daysint11采购周期
税率taxdecimal(19,4)税率
是否停用is_disabledtinyint1是否停用
商家编码spec_novarchar20商家编码
货品名称goods_namevarchar20货品名称
货品编号goods_novarchar20货品编号
规格名称spec_namevarchar 64规格名称
规格码spec_code         varchar40规格码
分类class_namevarchar64分类  
货品简称short_namevarchar64货品简称
品牌brand_namevarchar64品牌
产地originvarchar64是   产地
最后采购价last_pricedecimal(19,4)最后采购价
上一次采购价last_second_price        
decimal(19,4)上一次采购价
最低采购价lowest_pricedecimal (19,4)最低采购价 
基本单位 
base_unit_idvarchar20  
基本单位
采购单位unitvarchar 20采购单位
单位变换率base_ratiodecimal(19,4)是    单位变换率
零售价retail_pricedecimal(19,4)零售价
自定义属性1prop1varchar64
自定义属性1
自定义属性2prop2varchar64
自定义属性2
自定义属性3prop3varchar64自定义属性3
自定义属性4prop4varchar64自定义属性4
自定义属性5prop5varchar64自定义属性5
自定义属性6prop6varchar64自定义属性6
备注remarkvarchar256备注

5.请求示例

PHP
<?php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/purchase_provider_goods_info_query.php';
    
    $c->putApiParam('start_time', '2020-06-03 00:00:00');
    $c->putApiParam('end_time', '2020-06-21 20:13:41');
    $c->putApiParam('page_no', 0);
    $c->putApiParam('page_size', 10);
    $c->putApiParam('spec_no', '');
    $c->putApiParam('barcode', '');
    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
package com.wangdian.api.purchase;

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

import com.wangdian.api.WdtClient;

public class PurchaseProviderQuery {

    public static void main(String[] args) {
        // TODO Auto-generated method stub
        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("column", "provider_name,address,website,remark,is_disabled,deleted,modified,created");

        try {
            String response = client.execute("purchase_provider_query.php", params);
            System.out.println(response);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}
C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;

namespace PurchaseProviderQuery
{
    class PurchaseProviderQuery
    {
        static void Main(string[] args)
        {
            WdtClient client = new WdtClient();
            client.sid = "";
            client.appkey = "";
            client.appsecret = "";
            client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/purchase_provider_query.php";

            client.putParams("page_no", "0");
            client.putParams("page_size", "10");
            client.putParams("provider_no", "GYS01217");
            client.putParams("column", "provider_name,address,website,remark,is_disabled,deleted,modified,created");
            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({"column": 'provider_id,provider_no,provider_name,contact,telno,mobile,fax,zip,email,qq,wangwang,address,website,remark,is_disabled,deleted,modified,created'})
params.update({"provider_no": '123'})
params.update({"page_size": '100'})
params.update({"page_no": '0'})

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

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": "0",
    "message": "ok",
    "total_count": "1",
    "provider_list": [{
        "provider_id": "1",
        "provider_no": "001",
        "provider_name": "旺店通PDA供应商2",
        "contact": "小鹏",
        "telno": "010-00000000",
        "mobile": "13500001111",
        "fax": "chuanzhenhao",
        "zip": "100089 ",
        "email": "openapiqyb@wangdian.cn",
        "qq": "2306668782",
        "wangwang": "",
        "account_bank_no": "6216000000000008266",
        "account_bank": "中国银行",
        "collect_name": "小鹏",
        "country": "0",
        "province": "110000",
        "city": "110100",
        "district": "110108",
        "address": "花园路13号",
        "website": "http://www.wangdian.cn/",
        "min_purchase_num": "1000.0000",
        "purchase_cycle_days": "15",
        "arrive_cycle_days": "7",
        "charge_cycle_days": "30",
        "last_purchase_time": "2019-05-08 00:00:00",
        "remark": "测试供应商数据",
        "is_disabled": "0",
        "deleted": "0",
        "created": "2018-11-26 13:41:05"
    }]
}

   6.2 异常响应示例

JSON
{
    "code": 1007,
    "message": "接口appkey已停用【解决办法:联系商务人员,重新开启接口appkey】 "
}

常用工具