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

qimen.alibaba.alsc.crm.sales.business.leads.receive (接收第三方线索介绍)

接收第三方的线索转介绍给自身

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
param_qimen_leads_receive_callback_request	QimenLeadsReceiveCallbackRequest	可选			转入leads回调请求
└ req_id String 必须 13rg1c23olfa46j 外部请求id，每次请求唯一 └ tenant_code String 必须 KRY 租户code └ territory_code String 必须 ter_keruyun_pos 领地code └ ext_info String 必须 {} 扩展信息，json格式 └ so_territory_code String 必须 ter_koubei_catering_item 来源领地code └ leads_id String 必须 20191214001 alsc线索id leads_info_ext_create LeadsInfoExtCreate 必须商机信息 └ name String 必须甜品的店主店名 └ branch_name String 可选民生路店分店名 └ category_code String 必须 200000010 一级类目code └ category_name String 必须美食一级类目名称 └ sub_category_code String 可选 200100010 二级类目code └ sub_category_name String 必须中餐二级类目名称 └ detail_category_code String 可选 200101010 三级类目code └ detail_category_name String 可选川菜三级类目名称 └ province_code String 必须 310000 省code └ province_name String 必须上海省名称 └ city_code String 必须 310100 市code └ city_name String 必须上海市市名称 └ district_code String 可选 310115 区code └ district_name String 可选浦东新区区名称 └ address String 必须民生路1155号地址 └ longitude String 可选 121.549728 经度 └ latitude String 可选 31.226948 纬度 └ contact_id String 可选 104910 联系人id,alsc侧商户联系人id └ contact_mbl String 可选 13988888666 联系人电话,此处唯一 └ contact_name String 可选王老板联系人名称 └ cbd_name String 可选丁香国际所属商圈名称 └ leads_type String 必须 KB_ITEM 线索类型 └ hopsca_name String 可选五道口大楼综合体名称 └ operator_id String 必须 kyr13386 操作人id └ operator_name String 必须王五操作人名称 └ memo String 可选这是备注备注信息 └ so_tenant_code String 必须 KB 来源租户code

响应参数

名称	类型	示例值	描述
result	QimenBaseCallbackResult		结果
└ success Boolean true 请求是否处理成功 └ error_code String SYSTEM_ERROR 错误码 └ error_message String 系统错误错误信息 └ recall Boolean false 回调处理失败是否需要回调重试：需要再次回调:true, 不需要再次回调:false；只有success=false时，此属性设定才有效果

请求示例

{"param_qimen_leads_receive_callback_request":{"req_id":"13rg1c23olfa46j","territory_code":"ter_keruyun_pos","operator_name":"王五","leads_id":"20191214001","so_tenant_code":"KB","operator_id":"kyr13386","so_territory_code":"ter_koubei_catering_item","memo":"这是备注","ext_info":"{}","leads_info_ext_create":{"contact_name":"王老板","category_name":"美食","address":"民生路1155号","category_code":"200000010","detail_category_code":"200101010","latitude":"31.226948","city_code":"310100","leads_type":"KB_ITEM","province_code":"310000","contact_id":"104910","contact_mbl":"13988888666","cbd_name":"丁香国际","province_name":"上海","district_name":"浦东新区","city_name":"上海市","detail_category_name":"川菜","district_code":"310115","branch_name":"民生路店","hopsca_name":"五道口大楼","name":"甜品的店","sub_category_name":"中餐","sub_category_code":"200100010","longitude":"121.549728"},"tenant_code":"KRY"}}

响应示例

{
    "result":{
        "success":true,
        "error_code":"SYSTEM_ERROR",
        "error_message":"系统错误",
        "recall":false
    }
}

验签示例

{"error_message":"Illegal request","recall":"false","error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

本地生活API

qimen.alibaba.alsc.crm.sales.business.leads.receive (接收第三方线索介绍)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ