文档中心 > API类目 > 本地生活API

alibaba.alsc.sales.visit.query (拜访数据查询)

口饿拜访数据供给客如云,传入poiId,返回拜访记录

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_top_poi_visit_query_request TopPoiVisitQueryRequest 必须 请求入参
  • └ ext_info
  • String
  • 可选
  • {}
  • 拓展信息
  • └ memo
  • String
  • 可选
  • 客如云请求
  • 备注
  • └ poi_id
  • String
  • 可选
  • L1DXZ000171
  • poiId

响应参数

名称 类型 示例值 描述
values VisitInfo [] 拜访信息
  • └ contact_person_is_kp
  • String
  • 1
  • 拜访对象是否是关键人 | 1:是,0:不是
  • └ contact_person_name
  • String
  • 老板
  • 拜访对象姓名
  • └ contact_person_position
  • String
  • 店长
  • 拜访对象职位
  • └ contact_person_tel
  • String
  • 13802402300
  • 拜访对象手机号
  • └ poi_id
  • String
  • L1DXZ000171
  • poiId
  • └ shop_name
  • String
  • 李活记快餐(科汇金谷店)
  • 门店名称
  • └ source
  • String
  • koubei
  • 数据来源 | 枚举值:eleme、koubei
  • └ visit_content
  • String
  • 拜访内容
  • 拜访内容脱敏 | 脱敏规则:签独=战略合作,破独=战略新签,守独=维持战略合作,部分不文明用语/手机号=**
  • └ visit_purpose
  • String
  • 信息更改
  • 拜访目的
  • └ visit_result
  • String
  • 信息更改:基本信息
  • 拜访目的及对应结果 格式:“目的:结果”,若有多个,以逗号分隔
  • └ visit_time
  • String
  • 2020-05-19 17:34:56
  • 拜访时间 | 拜访记录创建时间
  • └ visit_way
  • String
  • 上门
  • 拜访方式 | 枚举值:电话、上门、其他 | 电话:电话拜访,针对直营人员,不含电销记录
  • └ visitor_mobile
  • String
  • 13698116340
  • 拜访人手机号 | 明文,饿侧离职员工不展示
  • └ visitor_name
  • String
  • 庞靖净
  • 拜访人姓名

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscSalesVisitQueryRequest req = new AlibabaAlscSalesVisitQueryRequest();
AlibabaAlscSalesVisitQueryRequest.TopPoiVisitQueryRequest obj1 = new AlibabaAlscSalesVisitQueryRequest.TopPoiVisitQueryRequest();
obj1.setExtInfo("{}");
obj1.setMemo("客如云请求");
obj1.setPoiId("L1DXZ000171");
req.setParamTopPoiVisitQueryRequest(obj1);
AlibabaAlscSalesVisitQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_sales_visit_query_response>
    <values>
        <visit_info>
            <contact_person_is_kp>1</contact_person_is_kp>
            <contact_person_name>老板</contact_person_name>
            <contact_person_position>店长</contact_person_position>
            <contact_person_tel>13802402300</contact_person_tel>
            <poi_id>L1DXZ000171</poi_id>
            <shop_name>李活记快餐(科汇金谷店)</shop_name>
            <source>koubei</source>
            <visit_content>拜访内容</visit_content>
            <visit_purpose>信息更改</visit_purpose>
            <visit_result>信息更改:基本信息</visit_result>
            <visit_time>2020-05-19 17:34:56</visit_time>
            <visit_way>上门</visit_way>
            <visitor_mobile>13698116340</visitor_mobile>
            <visitor_name>庞靖净</visitor_name>
        </visit_info>
    </values>
</alibaba_alsc_sales_visit_query_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

返回
顶部