CRM Help

Método insertRecords

Finalidad

Puede utilizar el método insertRecords para insertar registros en el módulo de Zoho CRM requerido.

Importante: Utilice el método POST para traspasar estos parámetros en lugar del método GET.

URL de la solicitud

Formato XML:

https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=AuthToken&scope=crmapi&xmlData=Your XML Data 

Parámetros de la solicitud

ParámetroTipo de datosDescripción
authtoken*CadenaCadena alfanumérica encriptada para autenticar sus credenciales de Zoho.
scope*CadenaEspecifique el alcance como crmapi
xmlData*XMLEsta es una cadena XML y el formato debe ser igual al de getRecords en formato XML de los registros capturados.
wfTriggerBooleanoEstablezca el valor como true para activar la regla de flujo de trabajo mientras inserta el registro en la cuenta de CRM. De manera predeterminada, este parámetro es false.
duplicateCheckEnteroEstablezca el valor como "1" para comprobar los registros de duplicados y arrojar una respuesta de error, o bien establezca el valor como "2" para comprobar los registros de duplicados y, si existe, realice una actualización de dichos registros.
isApprovalBooleanoDe manera predeterminada, los registros se insertan directamente. Para mantener los registros en modo de aprobación, establezca el valor como true. Puede utilizar este parámetro en los módulos de clientes potenciales, contactos y casos.
newFormatEnteronewFormat=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.
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.
version = 4: mediante este valor, se activará la funcionalidad de comprobación de duplicados de varios registros.

* 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.

Campos de comprobación de duplicados

Nombre del móduloCampo de comprobación de duplicados
Clientes potencialesCorreo electrónico
ContactosCorreo electrónico
CuentasNombre de la cuenta
PotencialesNombre del potencial
CampañasNombre de la campaña
CasosAsunto
ProductosNombre del producto
ProveedoresNombre del proveedor
CotizacionesAsunto
SalesOrdersAsunto
PurchaseOrdersAsunto
FacturasAsunto
CustomModuleNombre del CustomModule

Notas adicionales

  • Mientras inserta datos en su cuenta de Zoho CRM, se aplicará la seguridad basada en funciones (Funciones, Perfiles, Seguridad a nivel de campo y Reglas para compartir datos). Por lo tanto, utilice el ID de usuario con la función más alta (por ejemplo: director ejecutivo) y el perfil más alto (por ejemplo: administrador). También asegúrese de que todos los campos estén activados en la configuración de seguridad a nivel de campo. En el caso de la configuración de seguridad basada en funciones, consulte Administración de seguridad  mientras genere el token de autenticación.
  • Mientras inserte datos, asegúrese de que la fecha y hora estén en los formatos MM/dd/aaaa y aaaa-MM-dd HH:mm:ss, respectivamente

Ejemplos

Insertar registros en Zoho CRM desde aplicaciones de terceros

Formato de URL:
https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData=Your XML Data

Sample Request:

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

<Leads>
<row no="1">
<FL val="Lead Source">Web Download</FL>
<FL val="Company">Your Company</FL>
<FL val="First Name">Hannah</FL>
<FL val="Last Name">Smith</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Home Phone">0987654321</FL>
<FL val="Other Phone">1212211212</FL>
<FL val="Fax">02927272626</FL>
<FL val="Mobile">292827622</FL>
</row>
</Leads>

Ejemplo de XMLDATA de clientes potenciales

<Leads>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Lead Owner">Scott@zohotest.com</FL>
<FL val="Company">Zoho</FL>
<FL val="First Name">Peter</FL>
<FL val="Last Name">John</FL>
<FL val="Designation">CEO</FL>
<FL val="Email">john@test.com</FL>
<FL val="Phone">04422334455</FL>
<FL val="Fax">98889</FL>
<FL val="Mobile">09999999999</FL>
<FL val="Website">www.sample.com</FL>
<FL val="Lead Source">External Referral</FL>
<FL val="Lead Status">Contacted</FL>
<FL val="Industry">Financial Services</FL>
<FL val="No of Employees">100</FL>
<FL val="Annual Revenue">100.0</FL>
<FL val="Email Opt Out">true</FL>
<FL val="Skype ID">peter</FL>
<FL val="Salutation">Mr.</FL>
<FL val="Street">Street One</FL>
<FL val="City">Chennai</FL>
<FL val="State">Tamil Nadu</FL>
<FL val="Zip Code">6000001</FL>
<FL val="Country">India</FL>
<FL val="Description">Sample Description.</FL>
</row>
</Leads>

Ejemplo de XMLDATA de tareas con búsqueda de clientes potenciales

<Tasks>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Task Owner">Scott@zohotest.com</FL>
<FL val="Subject">Demo Call</FL>
<FL val="Due Date">11/23/2009</FL>
<FL val="SEID">2000000018003</FL>
<FL val="SEMODULE">Leads</FL>
<FL val="Status">In Progress</FL>
<FL val="Priority">Highest</FL>
<FL val="Send Notification Email">false</FL>
<FL val="Description">Sample Desc</FL>
</row>
</Tasks>

Ejemplo de XMLDATA de tareas con búsqueda de cuentas y contactos

<Tasks>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Task Owner">Scott@zohotest.com</FL>
<FL val="Subject">Demo Call</FL>
<FL val="Due Date">11/23/2009</FL>
<FL val="CONTACTID">2000000018443</FL>
<FL val="SEID">2000022218013</FL>
<FL val="SEMODULE">Accounts</FL>
<FL val="Status">In Progress</FL>
<FL val="Priority">Highest</FL>
<FL val="Send Notification Email">false</FL>
<FL val="Description">Sample Desc</FL>
</row>
</Tasks>

Insertar notas y vincularlas al módulo principal

Formato XML:

https://crm.zoho.com/crm/private/xml/Notes/insertRecords?newFormat=1&authtoken=Auth Token
&scope=crmapi
&xmlData=

<Notes>
<row no="1">
<FL val="entityId">2000000078001</FL>
<FL val="Note Title">Zoho CRM Sample Note</FL>
<FL val="Note Content">This is sample content to test Zoho CRM API</FL>
</row>
</Notes>

En este caso, el entityID es el ID único del registro primario (Cliente potencial, Cuenta, Contacto, etc.)

Asignar el propietario al registro

Mientras inserte un registro mediante API, asegúrese de especificar la dirección de correo electrónico o el ID de usuario del propietario del registro. Si utiliza el nombre del propietario del registro, este se asignará a la credencial de inicio de sesión predeterminada utilizada en el token de autenticación. Si desea utilizar el ID de usuario para especificar el propietario del registro, agregue las etiquetas <FL val="SMOWNERID">userID</FL> a su xmlData.

Nota:

  • En los ejemplos siguientes, reemplace los valores de "authotoken" y "scope" por los que haya generado.

Casos

https://crm.zoho.com/crm/private/xml/Cases/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Cases>
<row no="1">
<FL val="Case Origin">Phone</FL>
<FL val="Status">Escalated</FL>
<FL val="Subject">New Case</FL>
<FL val="Account Name">Account for Cases</FL>
<FL val="WHOID">508020014316189251</FL>
</row>
</Cases>

Nota:

  • El campo WHOID se refiere al campo Vinculado a en el módulo de casos. Ingrese el ID del registro que desee vincular a los casos como un valor del campo Vinculado a en el campo WHOID.

Tareas

https://crm.zoho.com/crm/private/xml/Tasks/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Tasks>
<row no="1">
<FL val="Subject">Call</FL>
<FL val="Due Date">2009-04-20</FL>
<FL val="Status">Deferred</FL>
<FL val="CONTACTID">2000000017017</FL>
</row>
</Tasks>

Eventos

https://crm.zoho.com/crm/private/xml/Events/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Events>
<row no="1">
<FL val="Subject">Conference</FL>
<FL val="Start DateTime">2009-08-04 01:00:00</FL>
<FL val="End DateTime">2009-08-05 01:00:00</FL>
<FL val="Venue">United States</FL>
<FL val="Send Notification Email">True</FL>
</row>
</Events>

Eventos con contactos y asignación de casos

https://crm.zoho.com/crm/private/xml/Events/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Events>
<row no="1">
<FL val="Subject">Conference</FL>
<FL val="Start DateTime">2009-09-24 01:00:00</FL>
<FL val="End DateTime">2009-09-25 01:00:00</FL>
<FL val="Venue">Chennai</FL>
<FL val="CONTACTID">2000000055003</FL>
<FL val="SEID">2000000055007</FL>
<FL val="SEMODULE">Cases</FL>
</row>
</Events>

Cuentas

https://crm.zoho.com/crm/private/xml/Accounts/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Accounts>
<row no="1">
<FL val="Account Name">Zillum</FL>
<FL val="Website">www.zillum.com</FL>
<FL val="Employees">200</FL>
<FL val="Ownership">Private</FL>
<FL val="Industry">Real estate</FL>
<FL val="Fax">99999999</FL>
<FL val="Annual Revenue">20000000</FL>
</row>
</Accounts>

Contactos

https://crm.zoho.com/crm/private/xml/Contacts/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Contacts>
<row no="1">
<FL val="First Name">Scott</FL>
<FL val="Last Name">James</FL>
<FL val="Email">test@test.com</FL>
<FL val="Department">CG</FL>
<FL val="Phone">999999999</FL>
<FL val="Fax">99999999</FL>
<FL val="Mobile">99989989</FL>
<FL val="Assistant">John</FL>
</row>
</Contacts>

SalesOrders

Nota:

  • Es obligatorio ingresar un valor en "ID del producto".

https://crm.zoho.com/crm/private/xml/SalesOrders/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<SalesOrders>
<row no="1">
<FL val="Subject">Zillium - SO</FL>
<FL val="Due Date">2009-03-10</FL>
<FL val="Sub Total">48000.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">48000.0</FL>
<FL val="Billing Street">test</FL>
<FL val="Shipping Street">test</FL>
<FL val="Billing City">test</FL>
<FL val="Shipping City">test</FL>
<FL val="Billing State">test</FL>
<FL val="Shipping State">test</FL>
<FL val="Billing Code">223</FL>
<FL val="Shipping Code">223</FL>
<FL val="Billing Country">test</FL>
<FL val="Shipping Country">test</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">2000000017001</FL>
<FL val="Unit Price">10.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Total">123.0</FL>
<FL val="Discount">1.23</FL>
<FL val="Total After Discount">121.77</FL>
<FL val="List Price">123.0</FL>
<FL val="Net Total">121.77</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Description">Test By Zoho</FL>
</row>
</SalesOrders>

Cotizaciones

Nota:

  • Es obligatorio ingresar un valor en "ID del producto".

https://crm.zoho.com/crm/private/xml/Quotes/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Quotes>
<row no="1">
<FL val="Subject">Zillium - Quote</FL>
<FL val="Due Date">2009-03-10</FL>
<FL val="Sub Total">48000.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">48000.0</FL>
<FL val="Billing Street">test</FL>
<FL val="Shipping Street">test</FL>
<FL val="Billing City">test</FL>
<FL val="Shipping City">test</FL>
<FL val="Billing State">test</FL>
<FL val="Shipping State">test</FL>
<FL val="Billing Code">223</FL>
<FL val="Shipping Code">223</FL>
<FL val="Billing Country">test</FL>
<FL val="Shipping Country">test</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">2000000017001</FL>
<FL val="Unit Price">10.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Total">123.0</FL>
<FL val="Discount">1.23</FL>
<FL val="Total After Discount">121.77</FL>
<FL val="List Price">123.0</FL>
<FL val="Net Total">121.77</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Description">Test By Zoho</FL>
</row>
</Quotes>

Ejemplo de una cotización con varios productos:

https://crm.zoho.com/crm/private/xml/Quotes/insertRecords?authtoken=Auth Token&scope=crmapi
&xmlData=

<Quotes>
<row no="1">
<FL val="Subject">TEST</FL>
<FL val="Quote Stage">Draft</FL>
<FL val="Carrier">FedEX</FL>
<FL val="ACCOUNTID">269840000000150037</FL>
<FL val="Account Name">phone account11 9pm</FL>
<FL val="SMOWNERID">269840000000034003</FL>
<FL val="Quote Owner">TEST</FL>
<FL val="SMCREATORID">269840000000034003</FL>
<FL val="Created By">TEST</FL>
<FL val="MODIFIEDBY">269840000000034003</FL>
<FL val="Modified By">TEST</FL>
<FL val="Created Time">2010-10-19 16:16:41</FL>
<FL val="Modified Time">2010-10-19 16:16:56</FL>
<FL val="Sub Total">23.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">23.0</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">269840000000136287</FL>
<FL val="Product Name">prd1</FL>
<FL val="Unit Price">0.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Quantity in Stock">0.0</FL>
<FL val="Total">23.0</FL>
<FL val="Discount">0.0</FL>
<FL val="Total After Discount">23.0</FL>
<FL val="List Price">23.0</FL>
<FL val="Net Total">23.0</FL>
<FL val="Tax">0.0</FL>
</product>
<product no="2">
<FL val="Product Id">269840000000128149</FL>
<FL val="Product Name">prd2</FL>
<FL val="Unit Price">0.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Quantity in Stock">0.0</FL>
<FL val="Total">23.0</FL>
<FL val="Discount">0.0</FL>
<FL val="Total After Discount">23.0</FL>
<FL val="List Price">23.0</FL>
<FL val="Net Total">23.0</FL>
<FL val="Tax">0.0</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Discount">0.0</FL>
<FL val="Date Field">07/21/2010</FL>
</row>
</Quotes>

Insertar llamadas con búsqueda de cuentas y contactos

<Calls>
<row no="1">
<FL val="SMOWNERID">2000000018005</FL>
<FL val="Subject">Product Support</FL>
<FL val="Call Type">Inbound</FL>
<FL val="Call Purpose">Prospecting</FL>
<FL val="CONTACTID">2000000018001</FL>
<FL val="SEID">2000000018003</FL>
<FL val="SEMODULE">Accounts</FL>
<FL val="Call Start Time">2011-06-10 22:10:00</FL>
<FL val="Call Duration">60:00</FL>
<FL val="Description">Required Product Demo</FL>
<FL val="Billable">true</FL>
<FL val="Call Result">Successful</FL>
</row>
</Calls>

Insertar llamadas con búsqueda de clientes potenciales

<Calls>
<row no="1">
<FL val="SMOWNERID">2000000018005</FL>
<FL val="Subject">Demo</FL>
<FL val="Call Type">Inbound</FL>
<FL val="Call Purpose">Prospecting</FL>
<FL val="SEID">2000000017201</FL>
<FL val="SEMODULE">Leads</FL>
<FL val="Call Start Time">2011-06-10 22:10:00</FL>
<FL val="Call Duration">60:00</FL>
<FL val="Description">Demo Call</FL>
<FL val="Billable">true</FL>
<FL val="Call Result">Successful</FL>
</row>
</Calls>

Uso de "CDATA"

Finalidad: Considerar los caracteres especiales como texto sin formato y NO como datos XML

Formato de URL:
https://crm.zoho.com/crm/private/xml/Contacts/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= Your XML Data

Ejemplo de datos XML:

como POST:

<Contacts>
<row no="1">
<FL val="First Name">Amy</FL>
<FL val="Last Name">Dawson</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Mobile">292827622</FL>
<FL val="Account Name"><![CDATA["A & A"]]></FL>
</row>
</Contacts>

como GET:

<Contacts>
<row no="1">
<FL val="First Name">Amy</FL>
<FL val="Last Name">Dawson</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Mobile">292827622</FL>
<FL val="Account Name"><![CDATA["A %26 A"]]></FL>
</row>
</Contacts>

Nota:

  • "%26" se considerará como "&"

Insertar varios registros

Formato de URL: https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= Your XML Data

Ejemplo de XMLDATA:

<Leads>
   <row no="1"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="2"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="3"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="4"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="5"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="6"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="7"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="8"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="9"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="10"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
 :
 :
 :
 
   <row no="100"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
</Leads>

Notas:

Cuando inserte varios registros con el método insertRecords:

  • La comprobación de duplicados no funcionará. Sin embargo, admitimos la comprobación de duplicados de varios registros  en la versión 4
  • Las reglas de flujo de trabajo no se activarán en el caso de registros que cumplan los criterios
  • No se pueden insertar varios registros en los módulos Cotizaciones, SalesOrders, Facturas y PurchaseOrders.
  • Cuando se inserten varios registros, solo se considerarán los primeros 100 registros.

Comprobación de duplicados de varios registros

Finalidad

Puede utilizar insertRecords para activar la funcionalidad de comprobación de duplicados de varios registros. Tenga en cuenta que version=4 es un parámetro obligatorio.

Ingresamos tres nuevos códigos que representarán el estado de resultado de la API de cada registro. Los códigos corresponden a los que se indican a continuación:

2000 = Registro agregado correctamente
2001 = Registro actualizado correctamente
2002 = El registro ya existe

Formato de URL:

https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=Auth  Token&scope=crmapi&duplicateCheck=( 1 OR 2 )&version=4&xmlData= Your XML Data

Ejemplo de datos XML

<Leads>
  <row no="1">
<FL val="Company">Company1</FL>
<FL val="Last Name">Last Name1</FL>
<FL val="Email">automation@crm.com 1</FL>
  </row>
  <row no="2">
<FL val="Company">Company2</FL>
<FL val="Last Name">Last Name2</FL>
<FL val="Email">automation@crm.com 2</FL>
  </row>
</Leads> 

Ejemplo de respuesta

Si se ingresan los valores duplicateCheck=1 y version=4 y existen algunos registros con la dirección de correo electrónico y otros no, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri=/crm/private/xml/Leads/insertRecords>
        <result>
          <row no=1>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120006</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no=2>
            <success>
              <code>2002</code>
              <details>
                <FL val=Id>2000000120007</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresan los valores duplicateCheck=1 y version=4 y no existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri=/crm/private/xml/Leads/insertRecords>
        <result>
          <row no=1>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120006</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no=2>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120007</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresan los valores duplicateCheck=1 y version=4 y existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2002</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2002</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresan los valores duplicateCheck=2 y version=4 y no existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresan los valores duplicateCheck=2 y version=4 y existen registros con la dirección de correo electrónico, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresan los valores duplicateCheck=2 y version=4 y existen algunos registros con la dirección de correo electrónico y otros no, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si se ingresa el valor version=4 y algunos registros contienen errores y otros no, la funcionalidad y la respuesta serán las que se mencionan a continuación:

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
        <error>
           <code>4832</code>
           <details>You have given a wrong value for the field : Annual Revenue</details>
            </error>
          </row>
        </result>
      </response>

Insertar datos en módulos personalizados

Ejemplo de solicitud

https://crm.zoho.com/crm/private/xml/CustomModule1/insertRecords?authtoken=Auth Token&scope=crmapi
&xmlData=

<CustomModule>
<row no="1">
<FL val="CustomModule1 Name">Registration-CS1000120160101</FL>
</row>
</CustomModule>

Nota:

  • La dirección de correo electrónico es el campo de comprobación de duplicados del módulo de clientes potenciales. El campo de comprobación de duplicados varía en el caso de otros módulos. Para obtener más información, consulte en la siguiente dirección: https://www.zoho.com/crm/help/api/insertrecords.html#Duplicate_Check_Field 
  • Ahora, los desarrolladores pueden identificar fácilmente el ID del registro, debido a que la información del registro en la respuesta se proporciona de la misma forma que las solicitudes de usuario en los datos xml.
  • Si no ingresa la versión, se ejecutará la funcionalidad predeterminada.
  • Debe ingresar el valor version=4 en la URL del parámetro para comprobar duplicados en varios registros.

Share this post : FacebookTwitter

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

Escríbenos: support@zohocrm.com