convertLead 方法
目的
您可以用此方法将线索转换为潜在客户、账户和联系人。 您也可以使用此方法将现有联系人或账户与转化线索关联。
关于线索转换流程，请参阅用户手册中的将线索转换为其它销售记录。
请求 URL
XML 格式：
https://crm.zoho.com.cn/crm/private/xml/Leads/convertLead?authtoken=Auth Token&scope=crmapi &leadId=entity Id&xmlData=POTENTIALXMLDATA
JSON 格式：
https://crm.zoho.com.cn/crm/private/json/Leads/convertLead?authtoken=Auth Token&scope=crmapi &leadId=entity Id&xmlData=POTENTIALXMLDATA
请求参数
| 参数 | 数据类型 | 说明 |
| authtoken* | 字符串 | 验证您的 Zoho 凭据的加密字母数字字符串。 |
| scope* | 字符串 | 将数值指定为crmapi |
| leadId* | 字符串 | 指定线索的唯一 ID |
| xmlData* | XML | 指定字段和对应数值 |
| newFormat | 整数值 | newFormat=1： 插入来自您的 CRM 账户的数据时排除有 "null" 的字段。 newFormat=2:插入来自您的 CRM 账户的数据时将有 "null" 的字段包括在内。 |
| 版本 | 整数值 | version = 1： （默认值）这将基于之前的 API 执行即在进行强化之前获取响应。 version = 2： 这将基于上一次 API 执行获取响应。 |
* - 必填参数
注意：
- 参考发布说明页面了解关于 API 执行中进行的强化的更多信息。
将线索转换为账户、联系人和商机的示例 XML
<Potentials>
<row no="1">
<option val="createPotential">true</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
<row no="2">
<FL val="Potential Name">Samplepotential</FL>
<FL val="Closing Date">12/21/2009</FL><FL val="Potential Stage">Closed Won</FL>
<FL val="Contact Role">Purchasing</FL>
<FL val="Amount">3432.23</FL>
<FL val="Probability">100</FL>
</row>
</Potentials>
注意：
- 在此 XML 中， <row no="2">为必填字段，唯一前提是 "createPotential" 的值被设置为真。如果 "createPotential" 的值被设置为假，线索转换完成后不会创建潜在客户。
将现有联系人或账户与转换线索关联的示例 XML
<Potentials>
<row no="1">
<option val="createPotential">true</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
<row no="2">
<FL val="Potential Name">Samplepotential</FL>
<FL val="Closing Date">12/21/2009</FL><FL val="Potential Stage">Closed Won</FL>
<FL val="Contact Role">Purchasing</FL>
<FL val="Amount">3432.23</FL>
<FL val="Probability">100</FL>
<FL val="ACCOUNTID">543212345</FL>
<FL val="CONTACTID">1234554321</FL>
<FL val="OVERWRITE">真</FL>
</row>
</Potentials>
注意：
- assignTo 值可以是 SMOWNERID 或邮件 id。
- 无论线索是否被转换为潜在客户，您都可以将现有联系人或账户与转换线索关联。 为达到这一目的，您必须通过 xml 发送 ACCOUNTID 和 CONTACTID
- 如果<FL val="ACCOUNTID"></FL> 和 <FL val="OVERWRITE">true</FL> 的值都给出，那么在与现有账户关联时，账户名称将被公司名称取代。 但是，账户数据依然不变
- 如果 OVERWRITE 值为假，则将仅发生关联。 但是，如果您在未给出 ACCOUNTID 的情况下给了 OVERWRITE 值，则此方法的作用保持不变
- 如果 <FL val="CONTACTID"></FL> 给出，则转换线索将与现有联系人关联
在不创建潜在客户的情况下转换线索的示例 XML
<Potentials>
<row no="1">
<option val="createPotential">false</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
</Potentials>