alibaba.seller.vendor.write.client (客户动态回写)

客户动态开放API接口,外部服务商回写数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_id String 必须 28572967 开放平台appId
param_third_party_client_data_params ThirdPartyClientDataParams 必须 要回写的数据
  • client
  • Client
  • 可选
  • 客户数据
  • contact_person_list
  • ContactPerson []
  • 可选
  • 联系人列表
  • └ contact_name
  • String
  • 可选
  • 张三
  • 联系人姓名
  • └ contact_number
  • String
  • 可选
  • 18888888888
  • 联系电话
  • └ contact_position
  • String
  • 可选
  • 运营总监
  • 联系人岗位
  • └ merchant_login_id
  • String
  • 可选
  • fr1436366681xfbi
  • 客户登陆账号
  • └ ext
  • String
  • 可选
  • {"orderNo":"FW201121055735"}
  • 扩展字段,这里可支持扩展,但是需要报备
  • └ generation_time
  • Date
  • 必须
  • 2021-08-10 11:12:13
  • 数据生成时间
  • └ phone
  • String
  • 必须
  • 13888888888
  • 电话
  • └ record_contents
  • String
  • 必须
  • 进行了Q3的营销聚焦
  • 录入信息
  • └ record_id
  • String
  • 必须
  • Test23536456767
  • 外部数据记录唯一id
  • └ recorder
  • String
  • 必须
  • 王小欧
  • 录入人
  • └ service_code
  • String
  • 必须
  • ISVXX2D0E34
  • 服务代码
  • └ service_type
  • String
  • 必须
  • VISIT_ONLINE
  • 服务类型:电话 PHONE, 预约上门APPOINTMENT_TO_DOOR, 未预约上门 NO_APPOINTMENT_TO_DOOR, 培训服务 TRAIN, 在线拜访 VISIT_ONLINE, 其他 OTHER;

响应参数

名称 类型 示例值 描述
error_description String 必填参数为空 错误信息
return_code Number -1 错误代码
return_data Boolean false 数据写入结果 true为成功
successed Boolean true 服务调用结果

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSellerVendorWriteClientRequest req = new AlibabaSellerVendorWriteClientRequest();
req.setAppId("28572967");
AlibabaSellerVendorWriteClientRequest.ThirdPartyClientDataParams obj1 = new AlibabaSellerVendorWriteClientRequest.ThirdPartyClientDataParams();
AlibabaSellerVendorWriteClientRequest.Client obj2 = new AlibabaSellerVendorWriteClientRequest.Client();
List<AlibabaSellerVendorWriteClientRequest.ContactPerson> list4 = new ArrayList<AlibabaSellerVendorWriteClientRequest.ContactPerson>();
AlibabaSellerVendorWriteClientRequest.ContactPerson obj5 = new AlibabaSellerVendorWriteClientRequest.ContactPerson();
list4.add(obj5);
obj5.setContactName("张三");
obj5.setContactNumber("18888888888");
obj5.setContactPosition("运营总监");
obj2.setContactPersonList(list4);
obj2.setMerchantLoginId("fr1436366681xfbi");
obj1.setClient(obj2);
obj1.setExt("{\"orderNo\":\"FW201121055735\"}");
obj1.setGenerationTime(StringUtils.parseDateTime("2021-08-10 11:12:13"));
obj1.setPhone("13888888888");
obj1.setRecordContents("进行了Q3的营销聚焦");
obj1.setRecordId("Test23536456767");
obj1.setRecorder("王小欧");
obj1.setServiceCode("ISVXX2D0E34");
obj1.setServiceType("VISIT_ONLINE");
req.setParamThirdPartyClientDataParams(obj1);
AlibabaSellerVendorWriteClientResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_seller_vendor_write_client_response>
    <error_description>必填参数为空</error_description>
    <return_code>-1</return_code>
    <return_data>false</return_data>
    <successed>true</successed>
</alibaba_seller_vendor_write_client_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

返回
顶部