Método convertLead
Tabla de contenido
Finalidad
Puede utilizar este método para convertir clientes potenciales en potenciales, cuentas y contactos. También puede utilizar este método para asociar el contacto o la cuenta existentes al cliente potencial por convertir.
Para realizar el proceso de conversión de clientes potenciales, consulte Convertir clientes potenciales en otros registros de ventas en el Manual del usuario.
URL de la solicitud
Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=Auth Token
Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/convertLead?authtoken=Auth Token
Parámetros de la solicitud
| Parámetro | Tipo de datos | Descripción |
| authtoken* | Cadena | Cadena alfanumérica encriptada para autenticar sus credenciales de Zoho. |
| scope* | Cadena | Especificar el valor como crmapi |
| leadId* | Cadena | Especificar el ID único del cliente potencial |
| xmlData* | XML | Especificar los campos y valores correspondientes |
| newFormat | Entero | newFormat=1: para excluir campos con valores "null" mientras inserta datos de su cuenta de CRM. newFormat=2: para incluir campos con valores "null" mientras inserta datos en su cuenta de CRM. |
| versión | Entero | version = 1 (valor predeterminado): mediante este valor, se capturarán respuestas basadas en la implementación de una API anterior, es decir, previa a las mejoras realizadas. version = 2: mediante este valor, se capturarán respuestas basadas en la implementación de la API más reciente. |
* Parámetro obligatorio
Nota:
- Consulte la página Notas de la versión para obtener más información sobre las mejoras realizadas en la implementación de la API.
Ejemplo de XML para convertir un cliente potencial en una cuenta, un potencial y un contacto
Nota:
- En este XML,
< el valor row no="2"> se debe ingresar SOLO si el valor de "createPotential" se establece en true. Si el valor de "createPotential" se establece en false, NO se creará un potencial luego de la conversión del cliente potencial.
Ejemplo de XML para vincular el contacto o la cuenta existente al cliente potencial que se debe convertir
Nota:
- El valor de assignTo puede ser SMOWNERID o el ID del correo electrónico.
- Puede vincular el contacto o la cuenta existente al cliente potencial que se debe convertir incluso si dicho cliente potencial se convierte o no en un potencial. Para lograrlo, debe enviar los valores ACCOUNTID y CONTACTID a través de xml
- Si se ingresan los valores
< FL val="ACCOUNTID"> < /FL> y< FL val="OVERWRITE"> true< /FL> , el nombre de la cuenta será reemplazado por el nombre de la empresa mientras se vincule a la cuenta existente. Sin embargo, los datos de esa cuenta seguirán siendo los mismos - Si el valor de OVERWRITE es false, solo se producirá la vinculación. Sin embargo, si ingresa el valor OVERWRITE sin ingresar el campo ACCOUNTID, no se modificará el funcionamiento de este método.
- Si se ingresa
< FL val="CONTACTID"> < /FL> , el cliente potencial por convertir se vinculará al contacto existente