CRM Help

Método searchRecords

 Finalidad

Puede utilizar el método searchRecords para obtener la lista de registros que cumplan sus criterios de búsqueda.

 URL de la solicitud

Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/searchRecords?authtoken=Auth Token&scope=crmapi&criteria=(((Last Name:Steve)AND(Company:Zillum))OR(Lead Status:Contacted))

Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/searchRecords?authtoken=Auth Token&scope=crmapi&criteria=(((Last Name:Steve)AND(Company:Zillum))OR(Lead Status:Contacted))

 Parámetros de la solicitud

ParámetroTipo de datosDescripción
authtoken*CadenaCadena alfanumérica encriptada para autenticar sus credenciales de Zoho. 
scope*CadenaEspecificar el valor como crmapi.
criterios*cadenaEspecificar los criterios de búsqueda según se muestra en la sección URL de la solicitud
selectColumnsCadenaMódulo (columnas opcionales), es decir, Clientes potenciales (apellido, sitio web y correo electrónico) O Todos
fromIndexEnteroValor predeterminado: 1
toIndexEnteroValor predeterminado: 20
Valor máximo del rango: 200
[Maximum range value = toIndex - fromIndex]
lastModifiedTimeaaaa-MM-dd HH:mm:ss Valor predeterminado: null
Si especifica el tiempo, los datos creados/modificados se capturarán después del tiempo configurado.
newFormat Entero newFormat=1: para excluir campos con valores "null" mientras inserta datos en su cuenta de CRM.
newFormat=2: para incluir campos con valores "null" mientras inserta datos en su cuenta de CRM.

* Parámetro obligatorio

Nota:

  • Puede activar este método solo 60 veces por minuto.
  • La cantidad máxima de llamadas que puede realizar por día es de 10 000. Sin embargo, el conteo de la API de su edición es menor que 10 000, se aplicará dicho conteo mientras utilice este método.
  • Puede utilizar un máximo de 5 criterios (con la misma columna o diferentes columnas) con condiciones de equals y startsWith. Otros operadores no son compatibles con este método.
  • 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 respuesta

<response uri="/crm/private/xml/Leads/searchRecords">

<result>
<Leads>
<row no="1">
<FL val="LEADID">508020000000556003</FL>
<FL val="SMOWNERID">508020000000050003</FL>
<FL val="Lead Owner">
<![CDATA[ John Doe ]]>
</FL>
<FL val="Company">
<![CDATA[ Zillum ]]>
</FL>
<FL val="Last Name">
<![CDATA[ Steve ]]>
</FL>
<FL val="No of Employees">
<![CDATA[ 0 ]]>
</FL>
<FL val="Annual Revenue">
<![CDATA[ 0 ]]>
</FL>
<FL val="SMCREATORID">508020000000050003</FL>
<FL val="Created By">
<![CDATA[ John Doe ]]>
</FL>
<FL val="MODIFIEDBY">508020000000050003</FL>
<FL val="Modified By">
<![CDATA[ John Doe ]]>
</FL>
<FL val="Created Time">
<![CDATA[ 2013-06-26 10:37:48 ]]>
</FL>
<FL val="Modified Time">
<![CDATA[ 2013-06-26 10:37:48 ]]>
</FL>
<FL val="Email Opt Out">
<![CDATA[ false ]]>
</FL>
<FL val="Currency">
<![CDATA[ INR ]]>
</FL>
<FL val="Exchange Rate">
<![CDATA[ 1.000000000 ]]>
</FL>
<FL val="Last Activity Time">
<![CDATA[ 2013-06-26 10:37:48 ]]>
</FL>
</row>
</Leads>
</result>
</response>

Share this post : FacebookTwitter

Todavía no puede encontrar lo que está buscando?

Escríbenos: support@zohocrm.com