会员管理类

    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下载