当前位置: API文档

purchase_provider_query.php(查询供应商)    

 ¥标准    

1.接口说明  

1.1 接口描述:批量获取ERP内供应商档案信息。                
1.2 适用版本:客户端 V2.3.1.6及以上版本
1.3 全量获取:该接口是全量获取数据或按照provider_no获取,无法按照时间段增量获取数据。                            

2.调用场景 

  2.1 暂无                            

3.请求参数说明        

  3.1 请求地址  

环境            HTTP地址            
测试环境            http://sandbox.wangdian.cn/openapi2/purchase_provider_query.php            
正式环境            http://api.wangdian.cn/openapi2/purchase_provider_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 业务请求参数

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

需要返回的字段,多个用‘,’隔开(可选字段:provider_id,provider_no,provider_name,contact,telno,mobile,fax,zip,email,qq,wangwang,address,website,remark,is_disabled,deleted,modified,created)

供应商编号provider_novarchar
代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息
供应商名称provider_namevarchar
供应商名称(ERP内自定义的名称)
分页大小page_sizeint
每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为30,使用举 单击这里     
页号page_noint
不传值默认从0页开始

4.响应参数

  4.1公共响应参数

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

   4.2 业务响应参数

名称字段类型长度必须描述
供应商ID            provider_id            int            11            否            主键            
供应商编号            provider_no            varchar            20            否            代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息            
供应商名称            provider_name            varchar            64            否            供应商名称(ERP内自定义的名称)            
联系人            contact            varchar            64            否            ERP中编辑的联系人            
电话            telno            varchar            20            否            供应商设置中座机信息            
移动电话            mobile            varchar            20            否            供应商设置中移动电话            
传真            fax            varchar            20            否            供应商设置中传真            
邮编            zip            varchar            20            否            供应商设置中邮编            
Email            email            varchar            64            否            供应商设置中邮件            
QQ            qq            varchar            20            否            供应商设置中QQ            
旺旺账号            wangwang            varchar            64            否            供应商设置中旺旺账号            
收款银行账户
account_bank_no          varchar            40    
否            收款银行账户        
收款银行
account_bank  
varchar            40    
否            收款银行     
收款人collect_namevarchar            40    
否            收款人    
国家countryint        
11
否            国家编码,默认为0   
省份provinceint        
11
否            省份编码
城市cityint        
11
否            城市编码
区县districtint        
11
否            区县编码
地址            address            varchar            128            否            供应商设置中地址            
网址            website            varchar            128            否            供应商设置中网址            
最小采购量 
min_purchase_numdecimal (19,4)   
否            最小采购量          
采购周期
purchase_cycle_daysint
 11 
否            采购周期       
到货周期
arrive_cycle_daysint
 11 
否            到货周期       
结算周期
charge_cycle_daysint
 11 
否            结算周期       
最后采购日期
last_purchase_timedatetime

否            最后采购日期    
备注            remark            varchar            256            否            供应商设置中备注            
是否禁用            is_disabled            tinyint            1            否            是否禁用:0.否;1.是            
删除时间戳            deleted            int            11            否            1970年至删除时间的时长            
最后修改时间            modified            date            
否            最后修改时间            
创建时间            created            date            
否            创建时间           

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_query.php';
    
    $c->putApiParam('column', 'provider_name,address,website,remark,is_disabled,deleted,modified,created');
    $c->putApiParam('page_no', 0);
    $c->putApiParam('page_size', 10);
    $c->putApiParam('provider_no', '88888805');
    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
package com.wangdian.api.basic;

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("", "", "", "");
        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();
        }
    }
}

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",
        "modified": "2019-05-17 14:59:45",
        "created": "2018-11-26 13:41:05"
    }]
}

   6.2 异常响应示例

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

常用工具