用友优普开放平台

member/add

1.接口说明

1.1接口描述

添加一个新会员

1.2适用版本

支持U8V12.0 及更高版本

2.使用场景

电商集成、会员管理

3.接口调用说明

3.1请求说明

url	https://api.yonyouup.com/api/member/add
格式	JSON
https请求方式	POST
编码类型	UTF-8

3.2url参数说明

参数	类型	是否必填	描述
from_account	string	是	调用方id
to_account	string	是	提供方id
app_key	string	是	应用编码
token	string	是	api调用唯一识别码
tradeid	string	是	交易唯一识别码，tradeid与biz_id只能传入一个
ds_sequence	number	否	数据源序号（默认取应用的第一个数据源）
biz_id	string	是	上游id，需要保证biz_id与ERP主键唯一对应关系，tradeid与biz_id只能传入一个
sync	number	否	0=异步新增（默认）;1=同步新增;

3.3请求体参数说明

参数	类型	参数路径	是否必填	描述
ccode	string		否	会员编号
cname	string		是	姓名
cnickname	string		是	昵称
cgradecode	string		是	会员等级编号
cgradename	string		是	会员等级名称
ddate	date		否	会员注册日期
dstopdate	date		否	停用日期
cmobilephone	string		否	手机
cemail	string		否	e-mail
cmicromessage	string		否	微信号
cqqcode	string		否	QQ号
cprovince	string		否	省
ccity	string		否	市
carea	string		否	区县
caddress	string		否	详细地址
cvalidcardnum	string		否	有效证件编号
cvalidcard	string		否	有效证件类型
cmemo	string		否	备注
crecommendcode	string		否	推荐人编码
crecommendname	string		否	推荐人名称
cretailstorecode	string		否	归属门店编码
cretailstorename	string		否	归属门店名称
wechatmemberid	number		否	易联会员Id
wechatrecommendmemberid	number		否	易联推荐人Id
retailguid	string		否	零售GUID
retailrecommendguid	string		否	零售推荐人GUID
wechatrecommendtime	date		否	易联推荐日期
dlastbuydate	date		否	最后购买日期
retailrecommenddate	date		否	零售推荐日期
drecommenddate	date		否	推荐日期
isumbuycount	number		否	累计购买次数
fsumbuymoney	number		否	累计购买金额
imembersource	number		否	会员来源(0=;1=手工;2=Excel导入;3=电商平台;4=零售;5=CRM;6=易联;)
cretailareacode	string		否	门店地区编码
cretailareaname	string		否	门店地区
cbrandcode	string		否	品牌编码
cbrandname	string		否	品牌
bstop	string		否	是否停用
dbirthdate	date		否	会员生日
cphone	string		否	联系电话
czip	string		否	邮编
csex	string		否	性别
cbuyfavor	string		否	购买爱好
fmemberfee	number		否	会员积分
cprovinceid	string		否	省id
ccityid	string		否	市id
careaid	string		否	区县id
cmaker	string		否	制单人
cpersoncode	string		否	业务员编号
cpersonname	string		否	业务员
cdefine1	string		否	表头自定义项1
cdefine2	string		否	表头自定义项2
cdefine3	string		否	表头自定义项3
cdefine4	date		否	表头自定义项4
cdefine5	number		否	表头自定义项5
cdefine6	date		否	表头自定义项6
cdefine7	number		否	表头自定义项7
cdefine9	string		否	表头自定义项9
cdefine10	string		否	表头自定义项10
cdefine11	string		否	表头自定义项11
cdefine12	string		否	表头自定义项12
cdefine13	string		否	表头自定义项13
cdefine15	number		否	表头自定义项15
cdefine16	number		否	表头自定义项16
cdefine14	string		否	表头自定义项14
cdefine8	string		否	表头自定义项8
cwechat	string		否	微信绑定号
dbuydate	date	trades	否	最近购买日期
cebplatform	string	trades	否	电商平台
cebnickname	string	trades	否	昵称
cshopname	string	trades	否	店铺
imembersourcetrade	number	trades	否	交易信息来源
cdefine28	string	trades	否	表体自定义项7
cdefine29	string	trades	否	表体自定义项8
cdefine30	string	trades	否	表体自定义项9
cdefine31	string	trades	否	表体自定义项10
cdefine32	string	trades	否	表体自定义项11
cdefine33	string	trades	否	表体自定义项12
cdefine34	number	trades	否	表体自定义项13
cdefine35	number	trades	否	表体自定义项14
cdefine36	date	trades	否	表体自定义项15
cdefine37	date	trades	否	表体自定义项16
cdefine22	string	trades	否	表体自定义项1
cdefine23	string	trades	否	表体自定义项2
cdefine24	string	trades	否	表体自定义项3
cdefine25	string	trades	否	表体自定义项4
cdefine26	number	trades	否	表体自定义项5
cdefine27	number	trades	否	表体自定义项6
dregdate	date	trades	否	表体注册日期
cmemos	string	trades	否	表体备注
cshopid	string	trades	否	店铺Id
cretailmembercode	string	trades	否	零售会员编码
cshopcode	string	trades	否	店铺编号
ibuycount	number	trades	否	购买次数
fbuymoney	number	trades	否	购买金额
creceiveprovince	string	addresses	否	收货人省
creceivecity	string	addresses	否	收货人市
creceivearea	string	addresses	否	收货人区县
creceivename	string	addresses	否	收货人姓名
creceivemobilephone	string	addresses	否	收货人手机
creceiveaddress	string	addresses	否	收货人详细地址
bdefaultaddress	string	addresses	否	是否默认
cdefine22	string	addresses	否	表体自定义项1
cdefine23	string	addresses	否	表体自定义项2
cdefine24	string	addresses	否	表体自定义项3
cdefine25	string	addresses	否	表体自定义项4
cdefine26	number	addresses	否	表体自定义项5
cdefine27	number	addresses	否	表体自定义项6
cdefine28	string	addresses	否	表体自定义项7
cdefine29	string	addresses	否	表体自定义项8
cdefine30	string	addresses	否	表体自定义项9
cdefine31	string	addresses	否	表体自定义项10
cdefine32	string	addresses	否	表体自定义项11
cdefine33	string	addresses	否	表体自定义项12
cdefine34	number	addresses	否	表体自定义项13
cdefine35	number	addresses	否	表体自定义项14
cdefine36	date	addresses	否	表体自定义项15
cdefine37	date	addresses	否	表体自定义项16
cebplatform	string	addresses	否	电商平台
cmemos	string	addresses	否	表体备注
creceivezip	string	addresses	否	收货人邮编
creceivephone	string	addresses	否	收货人电话
autoid	number	addresses	否	autoid
oid	number	addresses	否	oid
creceiveprovinceid	string	addresses	否	收货人省id
creceivecityid	string	addresses	否	收货人市id
creceiveareaid	string	addresses	否	收货人区县id
imembersourceaddress	number	addresses	否	来源类型

3.4请求示例

POST https://api.yonyouup.com/api/member/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1

POST 内容：
{
	"member":{
		"cgradecode":"34767",
		"cgradename":"永久钻石卡",
		"cname":"张三",
		"cnickname":"小张",
		"trades":{
			"dbuydate":"2015-05-05",
			"fbuymoney":"23"
		},
		"addresses":{
			"cmemos":"地址备注",
			"creceiveaddress":"北清路68号用友软件园"
		}
	}
}

3.5返回参数说明

参数说明	类型	描述
errcode	string	错误码，0 为正常。
errmsg	string	错误信息。
id	string
tradeid	string	新增成功后返回交易唯一识别码

3.6正确返回示例

JSON示例:

{
    "tradeid": "158f3f05730711e591c702004c4f4f50",
    "ping_after": "3",
    "url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
}
上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果，结果格式如下：
{
  "errcode" : "0", 
  "errmsg" : "", 
  "id" : "883",
  "tradeid" : "158f3f05730711e591c702004c4f4f50"
}

3.7错误返回示例

application/json;charset=UTF-8
{
	"errcode" : "30021",
	"errmsg" : "此应用未上线"
}

4.API测试

API测试 SDK下载

会员管理类

member/add

目录

1.接口说明

1.1接口描述

1.2适用版本

2.使用场景

3.接口调用说明

3.1请求说明

3.2url参数说明

3.3请求体参数说明

3.4请求示例

3.5返回参数说明

3.6正确返回示例

3.7错误返回示例

4.API测试