CRM Help

Método getSearchRecordsByPDC

Finalidad

Puede utilizar este método para buscar los valores según columnas predefinidas y campos de búsqueda personalizada.

URL de la solicitud

Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/getSearchRecordsByPDC?newFormat=1&authtoken=Auth Token&scope=crmapi

Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/getSearchRecordsByPDC?newFormat=1&authtoken=Auth Token&scope=crmapi

Parámetros de la solicitud

ParámetroTipo de datosDescripción
authotoken*CadenaCadena alfanumérica encriptada para autenticar sus credenciales de Zoho.
scope*CadenaEspecificar crmapi como alcance
selectColumns*CadenaTodos o módulo (campo 1, campo 2, campo 3, campo n…)
Ejemplo: clientes potenciales (apellido, sitio web y correo electrónico)
fromIndexEnteroValor predeterminado: 1
toIndexEnteroValor predeterminado: 20
Valor máximo del rango: 200
[Maximum range value = toIndex - fromIndex]
searchColumn*Cadena

Especifique la columna de búsqueda predefinida (consulte las columnas predefinidas predeterminadas que se muestran a continuación).

Nota: También puede buscar valores basados en campos de búsqueda personalizada.

searchValue*CadenaEspecifique el valor que se debe buscar
newFormatEnteronewFormat=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 de su cuenta de CRM.
versiónEnteroversion = 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.

Columnas predefinidas predeterminadas

MóduloCampos
Clientes potenciales
  • email
Cuentas
  • accountid
  • accountname
Contactos
  • contactid
  • accountid
  • vendorid
  • email
Potenciales
  • potentialid
  • accountid
  • campaignid
  • contactid
  • potentialname
Campañas
  • campaignid
  • campaignname
Casos
  • caseid
  • productid
  • accountid
  • potentialid
Soluciones
  • solutionid
  • productid
Productos
  • productid
  • vendorid
  • productname
Orden de compra
  • purchaseorderid
  • contactid
  • vendorid
Cotizaciones
  • quoteid
  • potentialid
  • accountid
  • contactid
Pedidos de ventas
  • salesorderid
  • potentialid
  • accountid
  • contactid
  • quoteid
Facturas
  • invoiceid
  • accountid
  • salesorderid
  • contactid
Proveedores
  • vendorid
  • vendorname
Tareas
  • taskid
Eventos
  • eventid
Notas
  • notesid

Ejemplos

Clientes potenciales con la columna email entre 20 y 200

https://crm.zoho.com/crm/private/xml/Leads/getSearchRecordsByPDC?newFormat=1&authtoken=Auth Token&scope=crmapi&fromIndex=20&toIndex=200&selectColumns=leads(Last Name,Website,Email)&searchColumn=email &searchValue=abc@testingdomain.com

Clientes potenciales con la columna email

https://crm.zoho.com/crm/private/xml/Leads/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&selectColumns=Leads(Last Name,Website,Email)
&searchColumn=email
&searchValue=test@test.com

Clientes potenciales con la columna campaignid

https://crm.zoho.com/crm/private/xml/Leads/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&selectColumns=Leads(Last Name,Website,Email)
&searchColumn=campaignid
&searchValue=2000000017011

Contactos con la columna vendorid

https://crm.zoho.com/crm/private/xml/Contacts/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&selectColumns=Contacts(Contact Owner,Lead Source,First Name,Last Name,Account Name)
&searchColumn=vendorid
&searchValue=2000000017022

Productos con la columna vendorid

https://crm.zoho.com/crm/private/xml/Products/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&selectColumns=Products(Product Owner,Product Name,Product Code,Manufacturer,Product Category,Unit Price)
&searchColumn=vendorid
&searchValue=2000000017022

SalesOrders con la columna accountid

https://crm.zoho.com/crm/private/xml/SalesOrders/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&selectColumns=SalesOrders(SO Number,Subject,Due Date,Carrier,Status)
&searchColumn=accountid
&searchValue=2000000017003

Buscar registros mediante campos de búsqueda personalizada

https://crm.zoho.com/crm/private/xml/Leads/getSearchRecordsByPDC?authtoken=Auth Token&scope=crmapi
&searchColumn=ProductLookup_ID
&searchValue=108149000062016

Esto arrojará una respuesta como la que se menciona a continuación:

<Leads>
<row no="1">
<FL val="LEADID">108490000020024</FL>
<FL val="SMOWNERID">1081490000078001</FL>
<FL val="Lead Owner">John</FL>
<FL val="Company">Zylker Inc.</FL>
<FL val="Last Name">Scott</FL>
<FL val="SMCREATORID">1081490000078001</FL>
<FL val="Created By">John</FL>
<FL val="MODIFIEDBY">1081490000078001</FL>
<FL val="Modified By">John</FL>
<FL val="Created Time">2014-10-27 15:18:11</FL>
<FL val="Modified Time">2014-11-26 12:53:13</FL>
<FL val="Last Activity Time">2014-11-26 12:53:13</FL>
<FL val="ProductLookup_ID">108149000062016</FL>
<FL val="ProductLookup">CPU</FL>
</row>
</Leads>

Programa de prueba

Puede utilizar el programa vinculado para ejecutar y probar el funcionamiento del método getSearchRecordsByPDC en el entorno Java.
En el programa Java se incluye lo siguiente:

  • el formato de generación del authtoken
  • los parámetros y sus valores
  • el uso real del método

Haga clic aquí para descargar el programa

Share this post : FacebookTwitter

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

Escríbenos: support@zohocrm.com