当前位置： API文档

purchase_provider_create.php（创建供应商）

¥标准

1.接口说明

1.1 接口描述：推送供应商给旺店通网页版ERP
1.2 适用版本：

2.调用场景

2.1 SCM、SRM系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

https://openapi.ali.huice.cc/openapi/purchase_provider_create.php

正式环境

https://openapi.huice.com/openapi/purchase_provider_create.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 业务请求参数

名称字段类型长度
必须描述
供应商编码provider_novarchar20是代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置），用于创建供应商数据信息
供应商名称provider_namevarchar64是供应商名称
供应商分组provider_groupvarchar64否供应商分组
联系人contactvarchar64否联系人
电话mobilevarchar40否手机号
邮箱emailvarchar64否电子邮箱
地址addressvarchar128否省、市、区（县）、地址详情
最后采购日期last_purchase_timedatetime
否对供应商最后一次采购日期，不传默认接口创建供应商的年月日，格式：yyyy-MM-dd HH:mm:ss
状态is_disabledtinyint1否0 启用 1停用

资质信息列表

qualifica_list

data[]


否

资质信息列表

qualifica_list 节点


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

证件名称

certificate_name

varchar20是

注意：当 qualifica_list 不为空时，该字段必传。 资质证件的名称，如“营业执照”

证件编码

certificate_no

varchar64否

证件上的统一社会信用代码或编号

证件有效期开始时间

start_date

varchar64否证件有效期开始时间，格式：yyyy-MM-dd HH:mm:ss

证件有效期结束时间

end_date

varchar64否

证件有效期结束时间，格式：yyyy-MM-dd HH:mm:ss

到期提醒(天)

expire_remind_day

varchar40否

证件有效期结束前*天

附件证件图片列表节点

certificate_img_list

varchar64否

证件图片数组节点，包含具体的图片明细

certificate_img_list节点


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

附件图片名称

img_name

varchar255否

图片文件的名称

附件图片链接

img_url

varchar1024否

外部可访问的图片 URL 地址

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint40是状态码:0表示成功,其他表示失败
错误原因messagevarchar255是错误原因

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	$c->sid = '';  
	$c->appkey = '';  
	$c->appsecret = '';  
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/purchase_provider_create.php';

	$c->putApiParam('provider_no', 'rmlS0410');
	$c->putApiParam('provider_name', '室内滑雪场供应商');
	$c->putApiParam('contact', '联系人');
	$c->putApiParam('mobile', '17000000000');
	$c->putApiParam('email', '2120012456@163.com');
	$c->putApiParam('address', '天津天津市滨海新区室内滑雪场');
	$c->putApiParam('last_purchase_time', '2026-04-10 08:00:00');
	$c->putApiParam('is_disabled', '0');
	$qualifica_list = [
		[
			'certificate_name' => '营业执照',
			'certificate_no' => '91000000MA0F0K0Y0P',
			'start_date' => '2023-04-10 00:00:00',
			'end_date' => '2033-04-09 23:59:59',
			'expire_remind_day' => '30',
			'certificate_img_list' => [
				[
					'img_name' => '附件图片文件的名称',
					'img_url' =>'https://www.keaitupian.cn/cjpic/frombd/0/253/3119496853/2980537814.jpg'
				]
			]
		]
	];

	$c->putApiParam('qualifica_list', json_encode($qualifica_list, JSON_UNESCAPED_UNICODE));
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": ""
}

   6.2 异常响应示例

JSON
{
    "code": 17000001,
    "message": "供应商名称或者编码重复"
}





常用工具