文档中心 > API类目 > 天猫新零售

alibaba.lsy.crm.customer.add.new (导购域留资接口)

导购域提供留资入口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req_d_t_o NrtCrmCreateCustomerReq 可选 入参DTO
  • └ wechat_name
  • String
  • 可选
  • 昵称
  • 微信昵称
  • └ guider_id
  • Number
  • 必须
  • 1
  • 导购员ID
  • └ store_id
  • Number
  • 必须
  • 1
  • 摊位ID
  • └ name
  • String
  • 可选
  • 张三
  • 姓名
  • └ biz_code
  • String
  • 可选
  • BIZCODE
  • 业务身份:红星/居然
  • └ phone
  • String
  • 必须
  • 12345678901
  • 手机号
  • └ activity_id
  • Number
  • 必须
  • 1
  • 活动ID

响应参数

名称 类型 示例值 描述
result ResultDo null 返回结果
  • └ err_msg
  • String
  • **错误
  • 错误信息
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • data
  • NrtRecordDTO
  • null
  • 出参对象
  • └ certificate_end_time
  • Date
  • 2020-1-1
  • 有效结束时间
  • └ certificate_start_time
  • Date
  • 2020-1-1
  • 有效开始时间
  • └ certificate_code
  • String
  • XY2823
  • 电子凭证编码
  • └ open_id
  • Number
  • 1
  • 会员openId-废弃
  • coupon_list
  • NrtCrmBenefitDto []
  • 券信息集合
  • └ effective_end_time
  • String
  • 2020-1-1
  • 有效结束时间
  • └ effective_start_time
  • String
  • 2020-1-1
  • 有效开始时间
  • └ face_value
  • String
  • 100
  • 面额
  • └ start_fee
  • String
  • 门槛
  • 门槛
  • └ benefit_code
  • String
  • CODE
  • 券Code
  • └ benefit_name
  • String
  • 优惠券
  • 券名称
  • └ template_code
  • String
  • 2222
  • 券模板实例Code
  • └ error_code
  • String
  • ERROR
  • 券发放错误Code
  • └ error_msg
  • String
  • 发券失败
  • 券发放错误信息
  • └ template_id
  • String
  • 111
  • 券模板实例ID
  • └ open_id_str
  • String
  • AXE13232
  • 加密后的会员ID
  • └ err_code
  • String
  • 500
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaLsyCrmCustomerAddNewRequest req = new AlibabaLsyCrmCustomerAddNewRequest();
AlibabaLsyCrmCustomerAddNewRequest.NrtCrmCreateCustomerReq obj1 = new AlibabaLsyCrmCustomerAddNewRequest.NrtCrmCreateCustomerReq();
obj1.setWechatName("昵称");
obj1.setGuiderId(1L);
obj1.setStoreId(1L);
obj1.setName("张三");
obj1.setBizCode("BIZCODE");
obj1.setPhone("12345678901");
obj1.setActivityId(1L);
req.setReqDTO(obj1);
AlibabaLsyCrmCustomerAddNewResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_lsy_crm_customer_add_new_response>
    <result>
        <err_msg>**错误</err_msg>
        <success>true</success>
        <data>
            <certificate_end_time>2020-1-1</certificate_end_time>
            <certificate_start_time>2020-1-1</certificate_start_time>
            <certificate_code>XY2823</certificate_code>
            <open_id>1</open_id>
            <coupon_list>
                <nrt_crm_benefit_dto>
                    <effective_end_time>2020-1-1</effective_end_time>
                    <effective_start_time>2020-1-1</effective_start_time>
                    <face_value>100</face_value>
                    <start_fee>门槛</start_fee>
                    <benefit_code>CODE</benefit_code>
                    <benefit_name>优惠券</benefit_name>
                    <template_code>2222</template_code>
                    <error_code>ERROR</error_code>
                    <error_msg>发券失败</error_msg>
                    <template_id>111</template_id>
                </nrt_crm_benefit_dto>
            </coupon_list>
            <open_id_str>AXE13232</open_id_str>
        </data>
        <err_code>500</err_code>
    </result>
</alibaba_lsy_crm_customer_add_new_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部