当前位置: API文档
purchase_provider_query.php(查询供应商)
1.1 接口描述:批量获取旺店通ERP内供应商档案信息。
|
1.2 适用版本:客户端 V2.4.5.0及以上版本。 |
1.3 全量获取:该接口是全量获取数据或按照provider_no获取,无法按照时间段增量获取数据。 |
2.1 暂无 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/purchase_provider_query.php |
正式环境 | https://api.wangdian.cn/openapi2/purchase_provider_query.php
|
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | 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输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
返回字段 | 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页开始 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
数据条数 | total_count | int | 10 | 否 | 只有,page_no = 0 时才返回的符合条件的数据总条数,用来分页 |
供应商信息列表 | provider_list[] | data | 是 | 供应商信息,详见本接口provider_list附录结构 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
供应商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 | varchar | 64 | 是 | 供应商设置中邮件 | |
varchar | 20 | 是 | 供应商设置中QQ | ||
旺旺账号 | wangwang | varchar | 64 | 是 | 供应商设置中旺旺账号 |
收款银行账户 | account_bank_no | varchar | 40 | 是 | 收款银行账户 |
收款银行 | account_bank | varchar | 40 | 是 | 收款银行 |
收款人 | collect_name | varchar | 40 | 是 | 收款人 |
国家 | country | int | 11 | 是 | 国家编码,默认为0 |
省份 | province | int | 11 | 是 | 省份编码 |
城市 | city | int | 11 | 是 | 城市编码 |
区县 | district | int | 11 | 是 | 区县编码 |
地址 | address | varchar | 128 | 是 | 供应商设置中地址 |
最小采购量 | min_purchase_num | decimal | (19,4) | 是 | 最小采购量 |
网址 | website | varchar | 128 | 是 | 供应商设置中网址 |
采购周期 | purchase_cycle_days | int | 11 | 是 | 采购周期 |
供应商分组 | provider_group | varchar | 64 | 是 | 分组 |
到货周期 | arrive_cycle_days | int | 11 | 是 | 到货周期 |
结算周期 | charge_cycle_days | int | 11 | 是 | 结算周期 |
最后采购日期 | last_purchase_time | datetime | 是 | 最后采购日期 格式:yyyy-MM-dd HH:mm:ss | |
备注 | remark | varchar | 256 | 是 | 供应商设置中备注 |
是否禁用 | is_disabled | tinyint | 1 | 是 | 是否禁用:0.否;1.是 |
删除时间戳 | deleted | int | 11 | 是 | 1970年至删除时间的时长 |
最后修改时间 | modified | datetime | 是 | 最后修改时间 格式:yyyy-MM-dd HH:mm:ss | |
创建时间 | created | datetime | 是 | 创建时间 格式:yyyy-MM-dd HH:mm:ss |
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
JSON | { "code": 1007, "message": "接口appkey已停用【解决办法:联系商务人员,重新开启接口appkey】 " } |