当前位置: API文档

purchase_provider_query.php(查询供应商)    

¥标准    

1.接口说明    

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

2.调用场景 

  2.1 暂无                            

3.请求参数说明        

  3.1 请求地址  

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

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

返回字段

column

varchar


需要返回的字段,多个用‘,’隔开(可选字段:provider_id,provider_no,provider_name,provider_group,contact,telno,mobile,fax,zip,email,qq,wangwang,address,website,remark,is_disabled,deleted,modified,created,account_bank_no,account_bank,collect_name,country,province,city,district,min_purchase_num,purchase_cycle_days,arrive_cycle_days,charge_cycle_days,last_purchase_time)不传默认查全部字段

供应商编号

provider_no

varchar


代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息

供应商名称

provider_name

varchar


供应商名称(ERP内自定义的名称)

分页大小

page_size

int


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

页号

page_no

int


不传值默认从0页开始

4.响应参数

  4.1公共响应参数

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

   4.2 业务响应参数

名称字段类型长度必须描述
供应商IDprovider_idint11主键
供应商编号provider_novarchar20代表供应商所有属性的唯一编码,用于供应商区分,ERP内支持自定义(ERP供应商界面设置),用于获取指定供应商数据信息
供应商名称provider_namevarchar64供应商名称(ERP内自定义的名称)
联系人contactvarchar 64ERP中编辑的联系人
电话
telnovarchar20供应商设置中座机信息
移动电话mobilevarchar20供应商设置中移动电话
传真faxvarchar20供应商设置中传真
邮编zipvarchar20供应商设置中邮编
email
emailvarchar64供应商设置中邮件
QQqqvarchar20供应商设置中QQ 
旺旺账号wangwangvarchar 64供应商设置中旺旺账号
收款银行账户
account_bank_no         varchar40收款银行账户
收款银行
account_bank
varchar40
收款银行   
收款人collect_namevarchar40
收款人
国家countryint
11
国家编码,默认为0
省份provinceint
11
是   省份编码
城市cityint
11
城市编码
区县districtint        
11
区县编码
地址addressvarchar 128供应商设置中地址 
最小采购量 
min_purchase_numdecimal(19,4)   
最小采购量
网址websitevarchar 128   供应商设置中网址
采购周期
purchase_cycle_daysint
11
是    采购周期
供应商分组provider_groupvarchar64分组
到货周期
arrive_cycle_daysint
11 
到货周期
结算周期
charge_cycle_daysint
11 
结算周期
最后采购日期
last_purchase_timedatetime

最后采购日期  格式:yyyy-MM-dd HH:mm:ss
备注remarkvarchar256供应商设置中备注
是否禁用is_disabledtinyint1是否禁用:0.否;1.是
删除时间戳deletedint11 1970年至删除时间的时长
最后修改时间modifieddatetime
最后修改时间    格式:yyyy-MM-dd HH:mm:ss
创建时间createddatetime
创建时间    格式:yyyy-MM-dd HH:mm:ss

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

   6.2 异常响应示例

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

常用工具