CRM Help

Método updateRecords

Finalidad

Puede utilizar el método updateRecords para actualizar o modificar los registros de Zoho CRM.

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

URL de la solicitud

Formato XML

Para actualizar el único registro dentro de un módulo en una única llamada de API:

https://crm.zoho.com/crm/private/xml/Leads/updateRecords?authtoken=Auth  Token&scope=crmapi&id=Record ID&xmlData=XML Data

Para actualizar varios registros dentro de un módulo en una única llamada de API:

https://crm.zoho.com/crm/private/xml/Leads/updateRecords?authtoken=Auth  Token&scope=crmapi&version=4&xmlData=XML Data

Haga clic en Actualizaciones de varios registros  para ver el ejemplo de xmlData y de respuesta en el caso de la comprobación de duplicados de varios registros.

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
id*CadenaEspecificar el ID único del registro
xmlData*XMLEspecificar los campos y valores correspondientes
wfTriggerBooleanoEstablezca el valor como true para activar la regla de flujo de trabajo mientras actualiza el registro en la cuenta de CRM. De manera predeterminada, este parámetro es false.
newFormatEntero (1 o 2)newFormat=1: para excluir campos con valores "null" mientras actualiza datos en su cuenta de CRM.
newFormat=2: para incluir campos con valores "null" mientras actualiza 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: para actualizar varios registros en una única llamada del método de API.

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

Notas adicionales

  • Mientras actualiza los 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 ticket de API.
  • Mientras actualice datos, asegúrese de que la fecha y la hora estén en los formatos MM/dd/aaaa y  aaaa-MM-dd HH:mm:ss, respectivamente

Actualizar propietario del registro

Mientras actualice 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.

Ejemplos

Para actualizar registros en Zoho CRM, realice las siguientes acciones:

  1. La dirección URL debe ingresarse como se indica a continuación:
    https://crm.zoho.com/crm/private/xml/Leads/updateRecords
  2. Los parámetros deben ingresarse como se indica a continuación:
    • authtoken: token de autenticación
    • scope: especificar el valor como crmapi.
    • xmlData: corresponde a una cadena XML; su formato debe ser el mismo que el de how get records en formato XML durante su API de captura.
    • id: ID del registro que se debe actualizar

Formato de datos XML:
https://crm.zoho.com/crm/private/xml/Leads/updateRecords?newFormat=1&authtoken=token de autenticación&scope=crmapi&xmlData=XMLDATA

  • authtoken=xy4gr1554712345fg
  • scope=crmapi
  • xmlData= as mentioned below
  • id = 1000000019001

<Leads>
<row no="1">
<FL val="Lead Source">Web Download</FL>
<FL val="First Name">contacto 1</FL>
<FL val="Last Name">apellido</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>

Tareas con asignación de contactos

https://crm.zoho.com/crm/private/xml/Tasks/updateRecords?authtoken=AuthToken&scope=crmapi
&newFormat=1
&id=2000000017022
&xmlData=

<Tasks>
<row no="1">
<FL val="Subject">Meeting Hall</FL>
<FL val="Due Date">2009-04-22</FL>
<FL val="Status">Completed</FL>
<FL val="CONTACTID">2000000017027</FL>
</row>
</Tasks>

Eventos

https://crm.zoho.com/crm/private/xml/Events/updateRecords?authtoken=AuthToken&scope=crmapi
&newFormat=1
&id=2000000017023
&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">Plaza</FL>
<FL val="Send Notification Email">false</FL>
</row>
</Events>

Contactos

https://crm.zoho.com/crm/private/xml/Contacts/updateRecords?authtoken=AuthToken&scope=crmapi
&newFormat=1
&id=2000000017024
&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">989898988</FL>
<FL val="Fax">99999999</FL>
<FL val="Mobile">99989989</FL>
<FL val="Assistant">John</FL>
</row>
</Contacts>

Cotizaciones

Nota:

  • Es obligatorio ingresar un valor en "ID del producto".
  • Puede especificar el nombre del producto si no tiene un ID de producto válido.

https://crm.zoho.com/crm/private/xml/Quotes/updateRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&id=2000000017025
&xmlData=<Quotes>

<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>
</Quotes>

SalesOrders

Nota:

  • Es obligatorio ingresar un valor en "ID del producto".
  • Puede especificar el nombre del producto si no tiene un ID de producto válido.

https://crm.zoho.com/crm/private/xml/SalesOrders/updateRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&id=2000000017026
&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>

Productos

https://crm.zoho.com/crm/private/xml/Products/updateRecords?authtoken=491e5e3374b0132324lqs2f1scb18cd0&
newFormat=1&scope=crmapi&id=508020000000366001&xmlData=

<Products>
<row no="1">
<FL val="Product Owner">manishp@zillum.com</FL>
<FL val="Product Name">Product Test</FL>
<FL val="Product Code">098732</FL>
<FL val="VENDORID">508020000000038476</FL>
<FL val="Product Active">true</FL>
<FL val="Manufacturer">AltvetPet Inc.</FL>
<FL val="Product Category">CRM App</FL>
<FL val="Sales Start Date">11/09/2012</FL>
<FL val="Sales End Date">11/11/2012</FL>
<FL val="Support Start Date">11/16/2012</FL>
<FL val="Support Expiry Date">11/18/2012</FL>
<FL val="Amount">100</FL>
<FL val="Probability">2</FL>
<FL val="Expected Revenue">200</FL>
<FL val="Unit Price">200</FL>
<FL val="Commission Rate">2</FL>
<FL val="Tax">Sales Tax;asdf</FL>
<FL val="Taxable">true</FL>
<FL val="Usage Unit">Dozen</FL>
<FL val="Qty Ordered">500000</FL>
<FL val="Qty in Stock">200000</FL>
<FL val="Reorder Level">10000</FL>
<FL val="Qty in Demand">10</FL>
<FL val="Handler">508020000000210005</FL>
<FL val="Description">Description Added for the product</FL>
</row>
</Products>

Nota:

  • El valor del controlador debe ser SMOWNERID.

Programa de prueba

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

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

Haga clic aquí para descargar el programa.

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/updateRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&id=50000000216189251

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 "&"

Actualizaciones de varios registros

Finalidad

Puede utilizar el método updateRecords para actualizar varios registros en un solo método updateRecords de API. Tenga en cuenta que version=4 es un parámetro obligatorio.

Ingresamos un nuevo código que representará el estado de resultado de la API de cada registro. El código corresponde al que se indica a continuación:

2001 = Registro actualizado correctamente

Formato de URL:

https://crm.zoho.com/crm/private/xml/Leads/updateRecords?authtoken=Auth  Token&scope=crmapi&version=4&xmlData=

Ejemplo de datos XML

<Leads>
  <row no="1">
<FL val="Id">2000000178701</FL>
<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="Id">2000000178702</FL>
<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

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">2000000178701</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">2000000178702</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">2000000178701</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>

Nota:

  • Si utiliza el valor version=4, tendrá que proporcionar el ID dentro de xmlData.
  • 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.
  • Puede actualizar un máximo de 100 registros en una única llamada de API.

Share this post : FacebookTwitter

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

Escríbenos: support@zohocrm.com