CRM Help

Método insertRecords

Finalidade

Você pode usar o método insertRecords para inserir registros no módulo Zoho CRM necessário.

Importante: Use o método POST para passar esses parâmetros em vez do método GET.

URL de solicitação

Formato XML:

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

Parâmetros de solicitação

.
ParâmetroTipo de dadosDescrição
authtoken*StringSequências alfanuméricas criptografadas para autenticar suas credenciais do Zoho.
scope*StringEspecifique scope como crmapi
xmlData*XMLEste é um string de XML e o formato deve ser o mesmo de getRecords no formato XML dos registros buscados.
wfTriggerBooleanoDefina o valor como true para acionar a regra de fluxo de trabalho ao inserir registro na conta de CRM Por padrão, esse parâmetro é false.
duplicateCheckNúmero inteiroDefina o valor como "1" para verificar os registros duplicados e emitir uma resposta de erro ou "2" para verificar os registros duplicados, se houver, e atualizá-los.
isApprovalBooleanoPor padrão, os registros são inseridos diretamente. Para manter os registros em modo aprovação, defina o valor como true. Você pode usar esses parâmetros para os módulos leads, contatos e casos.
newFormatNúmero inteiroNewFormat=1: para excluir os campos com valores "null" ao inserir dados de sua conta CRM.
newFormat=2: para incluir campos com valores "null", ao inserir dados de sua conta CRM.
versionNúmero inteiroVersão = 1: (valor padrão) Este irá buscar respostas com base na implementação da API anterior, ou seja, antes dos aprimoramentos feitos.
version = 2: irá buscar respostas com base na implementação API mais recente.
Versão = 4:aciona a funcionalidade de verificação de duplicidades para múltiplos registros.

* – Parâmetro obrigatório

Nota:

  • Consulte a página Notas de versão  para saber mais sobre as melhorias feitas na implementação API.

Campos de verificação de duplicidades

Nome do móduloCampo de verificação de duplicidade
LeadsE-mail
ContatosE-mail
ContasNome da conta
PotenciaisNome do potencial
CampanhasNome da campanha
CasosAssunto
ProdutosNome do produto
FornecedoresNome do fornecedor
CotaçõesAssunto
Ordens de vendaAssunto
Ordens de compraAssunto
FaturasAssunto
Módulo personalizadoNome do Módulo personalizado

Notas adicionais

  • Ao inserir dados em sua conta do Zoho CRM, a segurança baseada em função (Funções, Perfis, Segurança em nível de campo e Regras de compartilhamento de dados) é aplicada. Portanto, use o ID de usuário com função e perfil mais alto (Ex.: CEO) (Ex.: Administrador). Também certifique-se de que todos os campos estão habilitados nas configurações de segurança em nível de campo. Para configurações da segurança baseada em função, consulte Administração de segurança  ao gerar o token de autorização.
  • Ao inserir dados, certifique-se de que data e hora estão no formato MM/dd/aaaa e aaaa-MM-dd HH:mm:ss, respectivamente

Exemplos

Inserir registros no Zoho CRM a partir de aplicativos de terceiros

Formato do 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>

Amostra de lead XMLDATA

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

Amostra de tarefa XMLDATA com pesquisa de lead

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

Amostra de tarefa XMLDATA com pesquisa de contato e de contas

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

Inserir notas e relacionar com o módulo primário

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>

Aqui a entityID é o ID exclusivo do registro primário (Lead, Conta, Contato etc.)

Atribuir proprietário ao registro

Ao inserir um registro por API, certifique-se de especificar o endereço de e-mail ou userID do proprietário do registro. Se você usar o nome do proprietário do registro, o registro será atribuído à credencial de login padrão usada no token de autenticação. Se você quiser usar o userID para especificar o proprietário do registro, adicione a tag <FL val="SMOWNERID">userID</FL> ao seu XmlData.

Nota:

  • Nos exemplos a seguir, substitua os valores para 'authotoken' e 'scope' com aqueles gerados por você.

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:

  • O campo WHOID refere-se ao campo Related to no módulo Casos. Forneça o ID do registro que você deseja associar aos casos como um valor do campo Related To no campo WHOID.

Tarefas

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 com mapeamento de contatos e 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>

Contas

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>

Contatos

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>

Ordens de venda

Nota:

  • Um valor para "Product Id" é obrigatório.

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>

Cotações

Nota:

  • Um valor para "Product Id" é obrigatório.

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>

Exemplo de uma cotação com vários produtos:

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>

Inserir Chamadas com pesquisa de contas e contatos

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

Inserir chamadas com pesquisa de leads

<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'

Finalidade: para considerar caracteres especiais como texto sem formatação e NÃO dados XML

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

Amostra de dados 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" será considerado como "&"

Inserir vários registros

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

Amostra 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:

Ao inserir vários registros com o método insertRecords:

  • Verificar duplicados não funcionará. No entanto, temos suporte para verificação de duplicidades de múltiplos registros  na versão 4
  • As regras de fluxo de trabalho não serão acionadas para registros que atendam aos critérios
  • Registros múltiplos não podem ser inseridos para os módulos Cotações, Ordens de venda, Faturas e Ordens de compra.
  • Somente os 100 primeiros registros serão considerados ao inserir vários registros.

Verificação de duplicidade para múltiplos registros

Finalidade

Você pode usar insertRecords para acionar a funcionalidade de verificação de duplicidade para múltiplos registros. Observe que version=4 é um parâmetro obrigatório.

Apresentamos três novos códigos que representam o status do resultado da API para cada registro. Os códigos são:

2000 = Registro adicionado com sucesso
2001 = Registro atualizado com sucesso
2002 = Registro já existe

Formato do 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

Amostra de dados 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> 

Amostra de resposta

Se duplicateCheck=1, version=4, alguns registros existem com endereço de e-mail e outros não existem, a funcionalidade e a resposta serão as seguintes:

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

Se duplicateCheck=1, version=4, nenhum registro existe com endereço de e-mail, a funcionalidade e a resposta serão as seguintes:

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

Se duplicateCheck=1 , version=4 , registros existem com endereço de e-mail, a funcionalidade e a resposta serão as seguintes:

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

Se duplicateCheck=2, version=4, nenhum registro existe com endereço de e-mail, a funcionalidade e a resposta serão as seguintes:

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

Se duplicateCheck=2 , version=4 , registros existem com endereço de e-mail, a funcionalidade e a resposta serão as seguintes:

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

Se duplicateCheck=2 ,version=4 , alguns registros existem com endereço de e-mail e outros não, a funcionalidade e o registro serão os seguintes:

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

Se version=4, alguns registros contêm erro e alguns não, a funcionalidade e a resposta serão os seguintes:

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

Inserir dados em Módulos personalizados

Amostra de solicitação

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:

  • Endereço de e-mail é o campo de verificação de duplicidade para o módulo Leads. Para outros módulos, o campo de verificação de duplicidade varia. Para saber mais, consulte - https://www.zoho.com/crm/help/api/insertrecords.html#Duplicate_Check_Field 
  • Os desenvolvedores agora podem identificar facilmente o id de registro, pois o detalhe do registro na resposta é fornecido da mesma forma que as solicitações de usuário nos dados xml.
  • Se você não passar a versão, a funcionalidade padrão será executada.
  • Você deve passar version=4 no URL do parâmetro para verificação de duplicidade em múltiplos registros.

Share this post : FacebookTwitter

Ainda não consegue encontrar o que você está procurando?

Escreva para nós: support@zohocrm.com