Método InsertRecords

Propósito

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

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

Solicitar Parâmetros

ParâmetroTipo de dadosDescrição
authtoken *CordaCadeia alfanumérica criptografada para autenticar suas credenciais do Zoho.
escopo*CordaEspecifique o escopo como crmapi
xmlData *XMLEsta é uma string XML e o formato deve ser o mesmo que o formato getRecords em XML dos registros buscados.
wfTriggerboleanoDefinir valor como true para acionar a regra de fluxo de trabalho ao inserir o registro na conta do CRM. Por padrão, esse parâmetro é falso .
duplicateCheckInteiroDefinir valor como “1” para verificar os registros duplicados e lançar uma resposta de erro ou ” 2 ” para verificar os registros duplicados, se existir, atualizar o mesmo.
isApprovalboleanoPor padrão, os registros são inseridos diretamente. Para manter os registros no modo de aprovação, defina o valor como true . Você pode usar esses parâmetros para o módulo Leads, Contacts e Cases.
newFormatInteironewFormat = 1 : para excluir campos com valores “nulos” ao inserir dados da sua conta do CRM.
newFormat = 2 : para incluir campos com valores “nulos” ao inserir dados da sua conta do CRM.
versãoInteiroversion = 1: (Valor padrão) Isso buscará respostas com base na implementação anterior da API, isto é, antes dos aprimoramentos feitos.
version = 2: isso buscará respostas com base na implementação da API mais recente.
version = 4: Isso acionará a funcionalidade de verificação duplicada para vários registros.

* – parâmetro obrigatório

Nota:

  • Consulte a página Notas da Versão  para saber mais sobre os aprimoramentos feitos na implementação da API.

Campos de verificação duplicados

nome do móduloCampo de Verificação Duplicado
ConduzO email
ContatosO email
ContasNome da conta
PotenciaisNome Potencial
CampanhasNome da campanha
CasosSujeito
ProdutosNome do Produto
VendedoresNome do vendedor
citaçõesSujeito
Ordens de vendaSujeito
Ordens de compraSujeito
FaturasSujeito
CustomModuleNome do CustomModule

Notas Adicionais

  • Ao inserir dados em sua conta Zoho CRM, a segurança baseada em funções (Funções, Perfis, Segurança em nível de campo e Regras de compartilhamento de dados) é aplicada. Portanto, use o ID do usuário com a função mais alta (Ex: CEO) e o perfil (Ex: Administrator). Além disso, verifique se todos os campos estão habilitados nas configurações de segurança no nível do campo. Para configurações de segurança baseadas em função, consulte Administração de segurança  ao gerar o token de autenticação.
  • Ao inserir dados, verifique se a data e a hora estão nos formatos MM / dd / aaaa e  aaaa-MM-dd HH: mm: ssrespectivamente

Exemplos

Inserir registros no Zoho CRM de aplicativos de terceiros

Formato de URL:
https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken= Token de autenticação & scope = crmapi & xmlData = Seus dados XML

Pedido de amostra:

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

<Leads>
<row no = “1”>
<FL val = “Fonte de chumbo”> Download da Web </ FL>
<FL val = “Companhia”> Sua empresa </ FL>
<FL val = “Nome”> Hannah </ FL>
<FL val = “Sobrenome”> Smith </ FL>
<FL val = “E-mail”> testing@testing.com </ FL>
<FL val = “Title”> Gerente </ FL>
<FL val = “Telefone”> 1234567890 </ FL>
<FL val = “Telefone residencial”> 0987654321 </ FL>
<FL val = “Outro telefone”> 1212211212 </ FL>
<FL val = “Fax”> 02927272626 </ FL>
<FL val = “Celular”> 292827622 </ FL>
</ row>
</ Leads>

Exemplo de XMLDATA de lead

<Leads>
<row não = “1”>
<FL val = “SMOWNERID”> 2000000016714 </ FL>
<FL val = “Proprietário do lead”> Scott@zohotest.com </ FL>
<FL val = “Company”> Zoho </ FL>
<FL val = “Nome”> Peter </ FL>
<FL val = “Sobrenome”> John </ FL>
<FL val = “Designação”> CEO </ FL>
<FL val = “E-mail”> john@test.com </ FL>
<FL val = “Telefone”> 04422334455 </ FL>
<FL val = “Fax”> 98889 </ FL>
<FL val = “Celular”> 09999999999 </ FL>
<FL val = “Site”> www.sample.com </ FL>
<FL val = “Fonte de chumbo”>Referência Externa </ FL>
<FL val = “Estado do Líder”> Contatada </ FL>
<FL val = “Indústria”> Serviços Financeiros </ FL>
<FL val = “Número de Empregados”> 100 </ FL>
< FL val = “Receita anual”> 100,0 </ FL>
<FL val = “Desativar E-mail”> true </ FL>
<FL val = “ID Skype”> peter </ FL>
<FL val = “Saudação”> Senhor </ FL>
<FL val = “Street” > Rua Um </ FL>
<FL val = “Cidade”> Chennai </ FL>
<FL val = “Estado”> Tamil Nadu </ FL>
<FL val = “CEP”> 6000001 </ FL>
<FL val = “País”> Índia </ FL>
<FL val = “Descrição”> Descrição de amostra. </ FL>
</ row>
</ Leads>

Exemplo de XMLDATA de Tarefa com pesquisa de lead

<Tarefas>
<linha não = “1”>
<FL val = “SMOWNERID”> 2000000016714 </ FL>
<FL val = “Proprietário da tarefa”> Scott@zohotest.com </ FL>
<FL val = “Assunto”> Chamada de demonstração </ FL>
<FL val = “Data de vencimento”> 23/11/2009 </ FL>
<FL val = “SEID”> 2000000018003 </ FL>
<FL val = “SEMODULE”> Leads </ FL>
<FL val = “Status”> Em andamento </ FL>
<FL val = “Priority”> Mais alto </ FL>
<FL val = “Enviar email de notificação”> false </ FL>
<FL val = “Description”> Amostra Desc </ FL>
</ row>
</ Tasks>

Exemplo de XMLDATA de Tarefa com Pesquisa de Contato e Conta

<Tarefas>
<linha não = “1”>
<FL val = “SMOWNERID”> 2000000016714 </ FL>
<FL val = “Proprietário da tarefa”> Scott@zohotest.com </ FL>
<FL val = “Assunto”> Chamada Demo </ FL>
<FL val = “Data de Vencimento”> 11/23/2009 </ FL>
<FL val = “CONTACTID”> 2000000018443 </ FL>
<FL val = “SEID”> 2000022218013 </ FL>
<FL val = “SEMODULE”> Contas </ FL>
<FL val = “Status”> Em andamento </ FL>
<FL val = “Prioridade”> Maior </ FL>
<FL val = “Enviar e-mail de notificação”> false </ FL>
<FL val = “Descrição”> Desc. de amostra </ FL>
</ row>
</ Tasks>

Inserir notas e relacionar ao módulo principal

Formato XML:

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

<Notas> 
<row no = “1”> 
<FL val = ” entityId “> 2000000078001 </ FL> 
<FL val = ” Título da nota “> Nota de amostra do Zoho CRM </ FL> 
<FL val = ” Conteúdo da nota” > Este é um conteúdo de amostra para testar a Zoho CRM API </ FL> 
</ row> 
</ Notes>

Aqui, o entityID é o ID exclusivo do registro primário (lead, conta, contato etc.)

Atribuir o proprietário ao registro

Ao inserir um registro por meio da API, verifique se você está especificando o endereço de e-mail ou o ID do usuário 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 xmlData.

Nota:

  • Nos exemplos a seguir, substitua os valores de ‘authotoken’ e ‘scope’ por aqueles gerados por você.

Casos

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

<Casos>
<row no = “1”>
<FL val = “Origem do caso”> Telefone </ FL>
<FL val = “Status”> Escalonado </ FL>
<FL val = “Assunto”> Novo caso </ FL> FL>
<FL val = “Nome da Conta”> Conta para Casos </ FL>
<FL val = “WHOID”> 508020014316189251 </ FL>
</ row>
</ Casos>

Nota:

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

tarefas

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

<Tarefas>
<row no = “1”>
<FL val = “Assunto”> Chamada </ FL>
<FL val = “Data de Vencimento”> 2009-04-20 </ FL>
<FL val = “Status”> Diferido </ 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 =

<Eventos>
<row no = “1”>
<FL val = “Assunto”> Conferência </ FL>
<FL val = “Data / Hora inicial”> 2009-08-04 01:00:00 </ FL>
<FL val = “End DateTime”> 2009-08-05 01:00:00 </ FL>
<FL val = “Local”> Estados Unidos </ FL>
<FL val = “Enviar email de notificação”> Verdadeiro </ FL>
< / row>
</ Events>

Eventos com contatos e mapeamento de casos

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

<Eventos>
<row no = “1”>
<FL val = “Assunto”> Conferência </ FL>
<FL val = “Data / Hora inicial”> 2009-09-24 01:00:00 </ FL>
<FL val = “End DateTime”> 2009-09-25 01:00:00 </ FL>
<FL val = “Local”> Chennai </ FL>
<FL val = “CONTACTID”> 2000000055003 </ FL>
<FL val = “SEID”> 2000000055007 </ FL>
<FL val = “SEMODULE”> Casos </ FL>
</ row>
</ Eventos>

Contas

https://crm.zoho.com/crm/private/xml/Accounts/insertRecords?authtoken= Token de autenticação & scope = crmapi
& newFormat = 1
& xmlData =

<Contas>
<row no = “1”>
<FL val = “Nome da conta”> Zillum </ FL>
<FL val = “Site”> www.zillum.com </ FL>
<FL val = “Empregados”> 200 </ FL>
<FL val = “Propriedade”> Particular </ FL>
<FL val = “Indústria”> Bens imóveis </ FL>
<FL val = “Fax”> 99999999 </ FL>
<FL val = ” Receita Anual “> 20000000 </ FL>
</ row>
</ Contas>

Contatos

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

<Contatos>
<row no = “1”>
<FL val = “Nome”> Scott </ FL>
<FL val = “Sobrenome”> James </ FL>
<FL val = “Email”> teste @ teste .com </ FL>
<FL val = “Departamento”> CG </ FL>
<FL val = “Telefone”> 999999999 </ FL>
<FL val = “Fax”> 99999999 </ FL>
<FL val = ” Celular “> 99989989 </ FL>
<FL val =” Assistente “> 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 = “Assunto”> Zillium – SO </ FL>
<FL val = “Data de Vencimento”> 2009-03-10 </ FL>
<FL val = “Sub Total “> 48000.0 </ FL>
<FL val =” IVA “> 0.0 </ FL>
<FL val =” Ajuste “> 0.0 </ FL>
<FL val =” Total geral “> 48000.0 </ FL>
<FL val = “Rua de faturamento”> teste </ FL>
<FL val = “Rua de expedição”> teste </ FL>
<FL val = “Cidade de cobrança”> teste </ FL>
<FL val = “Cidade de expedição”> teste </ FL>
<FL val = “Estado de faturamento”> teste </ FL>
<FL val = “Estado de envio”> teste </ FL>
<FL val = “Código de Faturamento”> 223 </ FL>
<FL val = “Código de Remessa”> 223 </ FL>
<FL val = “País de Faturamento”> teste </ FL>
<FL val = ” País de remessa “> teste </ FL>
<FL val =” Detalhes do produto “>
<product no = “1”>
<FL val = “ID do Produto”> 2000000017001 </ FL>
<FL val = “Preço unitário”> 10.0 </ FL>
<FL val = “Quantidade”> 1.0 </ FL>
< FL val = “Total”> 123.0 </ FL>
<FL val = “Desconto”> 1.23 </ FL>
<FL val = “Total após desconto”> 121.77 </ FL>
<FL val = “Preço de lista”> 123.0 </ FL>
<FL val = “Total Líquido”> 121.77 </ FL>
</ product>
</ FL>
<FL val = “Termos e Condições”> Testar por Zoho </ FL>
<FL val = “Descrição” > Teste por Zoho </ FL>
</ row>
</ SalesOrders>

citaçõ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 =

<Frases>
<row no = “1”>
<FL val = “Assunto”> Zillium – Cotação </ FL>
<FL val = “Data de Vencimento”> 2009-03-10 </ FL>
<FL val = “Sub Total “> 48000.0 </ FL>
<FL val =” IVA “> 0.0 </ FL>
<FL val =” Ajuste “> 0.0 </ FL>
<FL val =” Total geral “> 48000.0 </ FL>
<FL val = “Rua de faturamento”> teste </ FL>
<FL val = “Rua de expedição”> teste </ FL>
<FL val = “Cidade de cobrança”> teste </ FL>
<FL val = “Cidade de expedição”> teste </ FL>
<FL val = “Estado de faturamento”> teste </ FL>
<FL val = “Estado de envio”> teste </ FL>
<FL val = “Código de Faturamento”> 223 </ FL>
<FL val = “Código de Remessa”> 223 </ FL>
<FL val = “País de Faturamento”> teste </ FL>
<FL val = ” País de remessa “> teste </ FL>
<FL val =” Detalhes do produto “>
<product no = “1”>
<FL val = “ID do Produto”> 2000000017001 </ FL>
<FL val = “Preço unitário”> 10.0 </ FL>
<FL val = “Quantidade”> 1.0 </ FL>
< FL val = “Total”> 123.0 </ FL>
<FL val = “Desconto”> 1.23 </ FL>
<FL val = “Total após desconto”> 121.77 </ FL>
<FL val = “Preço de lista”> 123.0 </ FL>
<FL val = “Total Líquido”> 121.77 </ FL>
</ product>
</ FL>
<FL val = “Termos e Condições”> Testar por Zoho </ FL>
<FL val = “Descrição” > Teste por 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 =

<Frases>
<row no = “1”>
<FL val = “Assunto”> TESTE </ FL>
<FL val = “Estágio de cotação”> Rascunho </ FL>
<FL val = “Transportadora”> FedEX </ FL >
<FL val = “ACCOUNTID”> 269840000000150037 </ FL>
<FL val = “Nome da conta”> conta telefônica11 21h </ FL>
<FL val = “SMOWNERID”> 269840000000034003 </ FL>
<FL val = “Citar proprietário “> TESTE </ FL>
<FL val =” SMCREATORID “> 269840000000034003 </ FL>
<FL val =” Criado por “> TESTE </ FL>
<FL val =” MODIFICADO “> 269840000000034003 </ FL>
<FL val = “Modificado por”> TEST </ FL>
<FL val = “Tempo Criado”> 2010-10-19 16:16:41 </ FL>
<FL val = “Tempo Modificado”> 2010-10-19 16:16:56 </ FL>
<FL val = ” Sub Total “> 23.0 </ FL>
<FL val =” Impostos “> 0.0 </ FL>
<FL val =” Ajuste “> 0.0 </ FL>
<FL val = “Total geral”> 23.0 </ FL>
<FL val = “Detalhes do produto”>
<product no = “1”>
<FL val = “ID do produto”> 269840000000136287 </ FL>
<FL val = ” Nome do produto “> prd1 </ FL>
<FL val =” Preço unitário “> 0.0 </ FL>
<FL val =” Quantidade “> 1.0 </ FL>
<FL val =” Quantidade em estoque “> 0.0 </ FL >
<FL val = “Total”> 23.0 </ FL>
<FL val = “Desconto”> 0.0 </ FL>
<FL val = “Total após desconto”> 23.0 </ FL>
<FL val = “Preço de tabela” > 23.0 </ FL>
<FL val = “Total Líquido”> 23.0 </ FL>
<FL val = “Impostos”> 0.0 </ FL>
</ product>
<product no = “2”>
<FL val = “ID do Produto”> 269840000000128149 </ FL>
<FL val = “Nome do Produto”> prd2 </ FL>
<FL val = “Preço unitário”> 0.0 </ FL>
<FL val = “Quantidade”> 1.0 </ FL>
<FL val = “Quantidade em estoque”> 0.0 </ FL>
<FL val = “Total”> 23.0 </ FL>
<FL val = “Desconto”> 0.0 </ FL>
<FL val = “Total após o desconto” > 23.0 </ FL>
<FL val = “Preço de lista”> 23.0 </ FL>
<FL val = “Total líquido”> 23.0 </ FL>
<FL val = “imposto”> 0.0 </ FL>
</ produto >
</ FL>
<FL val = “Termos e Condições”> Teste de Zoho </ FL>
<FL val = “Desconto”> 0.0 </ FL>
<FL val = “Campo de Data”> 07/21/2010 < / FL>
</ row>
</ Quotes>

Inserir chamadas com contatos e pesquisa de contas

<Chamadas>
<fileira não = “1”>
<FL val = “SMOWNERID”> 2000000018005 </ FL>
<FL val = “Assunto”> Suporte ao produto </ FL>
<FL val = “Tipo de chamada”> Entrada </ FL>
<FL val = “Finalidade da chamada”> Prospecção </ FL>
<FL val = “CONTACTID”> 2000000018001 </ FL>
<FL val = “SEID”> 2000000018003 </ FL>
<FL val = “SEMODULE”> Contas </ FL>
<FL val = “Hora de início da chamada”> 2011-06-10 22:10:00 </ FL>
<FL val = “Duração da chamada”> 60:00 </ FL>
<FL val = ” Descrição “> Demonstração de produto necessária </ FL>
<FL val =” Faturável “> true </ FL>
<FL val = “Resultado da chamada”> Bem-sucedido </ FL>
</ row>
</ Calls>

Inserir chamadas com pesquisa de leads

<Chamadas>
<row no = “1”>
<FL val = “SMOWNERID”> 2000000018005 </ FL>
<FL val = “Assunto”> Demo </ FL>
<FL val = “Tipo de chamada”> Entrada </ FL >
<FL val = “Finalidade da chamada”> Prospecção </ FL>
<FL val = “SEID”> 2000000017201 </ FL>
<FL val = “SEMODULAR”> Leads </ FL>
<FL val = “Hora de início da chamada” > 2011-06-10 22:10:00 </ FL>
<FL val = “Duração da chamada”> 60:00 </ FL>
<FL val = “Descrição”> Chamada de demonstração </ FL>
<FL val = ” Faturável “> verdadeiro </ FL>
<FL val =” Resultado da chamada “> Bem-sucedido </ FL>
</ row>
</ Calls>

Uso de ‘CDATA’

Objetivo: Considerar Caracteres Especiais como texto simples e NOT XML Data

Formato de URL:
https://crm.zoho.com/crm/private/xml/Contacts/insertRecords?newFormat=1&authtoken= Token de autenticação & scope = crmapi & xmlData = Seus dados XML

Dados XML de amostra:

como POST:

<Contatos>
<row no = “1”>
<FL val = “Nome”> Amy </ FL>
<FL val = “Sobrenome”> Dawson </ FL>
<FL val = “E-mail”> testing @ testing .com </ FL>
<FL val = “Título”> Gerente </ FL>
<FL val = “Telefone”> 1234567890 </ FL>
<FL val = “Celular”> 292827622 </ FL>
<FL val = ” Nome da conta “> <! [CDATA [” A & A “]]> </ FL>
</ row>
</ Contacts>

como GET:

<Contatos>
<row no = “1”>
<FL val = “Nome”> Amy </ FL>
<FL val = “Sobrenome”> Dawson </ FL>
<FL val = “E-mail”> testing @ testing .com </ FL>
<FL val = “Título”> Gerente </ FL>
<FL val = “Telefone”> 1234567890 </ FL>
<FL val = “Celular”> 292827622 </ FL>
<FL val = ” Nome da conta “> <! [CDATA [” A % 26 A “]]> </ FL>
</ row>
</ Contacts>

Nota:

  • “% 26” será considerado como “&”

Inserir vários registros

Formato de URL: https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken= Token de autenticação& scope = crmapi & xmlData = Seus dados XML

Amostra XMLDATA:

<Leads>
<row no = “1”> <FL val = “Sobrenome”> testando </ FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<row no = “2”> <FL val = “Sobrenome”> testando </ FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<linha no = “3”> <FL val = “Sobrenome”> teste < / FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<linha no = “4”> <FL val = “Sobrenome”> teste </ FL> <FL val = “Companhia”> ZOHO </ FL> </ row>
<row não = “5”> <FL val = “Sobrenome”> testando </ FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<row não = “6”><FL val = “Sobrenome”> testando </ FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<linha no = “7”> <FL val = “Sobrenome”> teste < / FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
<linha no = “8”> <FL val = “Sobrenome”> teste </ FL> <FL val = “Companhia”> ZOHO </ FL> </ row></ row></ row>
<fileira no = “9”> <FL val = “Sobrenome”> testando </ FL> <FL val = “Companhia”> ZOHO </ FL> </ row>
<fileira no = “10”> <FL val = “Last Name”> teste </ FL> <FL val = “Companhia”> ZOHO </ FL> </ row>
:
:
:

<row no = “100”> <FL val = “Last Name”> teste < / FL> <FL val = “Empresa”> ZOHO </ FL> </ row>
</ Leads>

Notas:

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

  • A Verificação Duplicada não funcionará. No entanto, suportamos verificação duplicada para vários registros  na versão 4
  • As regras de fluxo de trabalho não serão acionadas para registros que atendam aos critérios
  • Múltiplos registros não podem ser inseridos nos módulos Quotes, SalesOrders, Invoices e PurchaseOrders.
  • Somente os primeiros 100 registros serão considerados ao inserir vários registros.

Verificação Duplicada para Vários Registros

Propósito

Você pode usar insertRecords para acionar a funcionalidade de verificação duplicada para vários registros. Por favor, note que version = 4 é um parâmetro obrigatório.

Introduzimos três novos códigos que representarão o status do resultado da API para cada registro. Os códigos são os seguintes:

2000 = Record Adicionado com Sucesso
2001 = Record Updated Successfully
2002 = Record Já Existe

Formato de URL:

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

Amostra de dados XML

<Leads>
<row no = “1”>
<FL val = “Empresa”> Company1 </ FL>
<FL val = “Sobrenome”> Sobrenome1 </ FL>
<FL val = “E-mail”> automation @ crm .com  1 </ FL>
</ row>
<row no = “2”>
<FL val = “Companhia”> Empresa2 </ FL>
<FL val = “Sobrenome”> Sobrenome2 </ FL>
<FL val = “E-mail”> automation@crm.com  2 </ FL>
</ row>
</ Leads>

Resposta da Amostra

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

<resposta uri = / crm / private / xml / Leads / insertRecords>
<resultado>
<row no = 1>
<sucesso>
<code> 2000 </ code>
<details>
<valor de FL = Id> 2000000120006 </ FL>
< FL val = Tempo de criação> 2013-02-11 17:55:04 </ FL>
<FL val = Tempo de modificação> 2013-02-11 17:55:04 </ FL>
<FL val = Criado por>
<! [CDATA [aghil123]]>
</ FL>
<Val val = modificado por>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = 2>
<sucesso>
<code> 2002 </ code>
<details>
<VALL de FL = Id > 2000000120007 </ FL>
<FL val = Hora de criação> 2013-02-11 17:55:04 </ FL>
<FL val = Hora modificada> 2013-02-11 17:55:04 </ FL>
<FL val = Criado por>
<! [CDATA [aghil123]]>
</ FL>
<FL val = Modificado por>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ resultado>
</ response>

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

<resposta uri = / crm / private / xml / Leads / insertRecords>
<resultado>
<row no = 1>
<sucesso>
<code> 2000 </ code>
<details>
<valor de FL = Id> 2000000120006 </ FL>
< FL val = Tempo de criação> 2013-02-11 17:55:04 </ FL>
<FL val = Tempo de modificação> 2013-02-11 17:55:04 </ FL>
<FL val = Criado por>
<! [CDATA [aghil123]]>
</ FL>
<Val val = modificado por>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = 2>
<sucesso>
<code> 2000 </ code>
<details>
<val val = id > 2000000120007 </ FL>
<FL val = Hora de criação> 2013-02-11 17:55:04 </ FL>
<FL val = Hora modificada> 2013-02-11 17:55:04 </ FL>
<FL val = Criado por>
<! [CDATA [aghil123]]>
</ FL>
<FL val = Modificado por>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ resultado>
</ response>

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

<response uri = “/ crm / private / xml / Leads / insertRecords”>
<resultado>
<row no = “1”>
<sucesso>
<code> 2002 </ code>
<details>
<FL val = “Id”> 2000000120006 </ FL>
<FL val = “Tempo de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55:04 </ FL >
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = “2”>
<sucesso>
<code> 2002 </ code>
<detalhes>
<FL val = “Id”> 2000000120007 </ FL>
<FL val = “Hora de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55 : 04 </ FL>
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “Modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ result >
</ response>

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

<response uri = “/ crm / private / xml / Leads / insertRecords”>
<resultado>
<row no = “1”>
<sucesso>
<code> 2000 </ code>
<details>
<FL val = “Id”> 2000000120006 </ FL>
<FL val = “Tempo de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55:04 </ FL >
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = “2”>
<sucesso>
<code> 2000 </ code>
<detalhes>
<FL val = “Id”> 2000000120007 </ FL>
<FL val = “Hora de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55 : 04 </ FL>
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “Modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ result >
</ response>

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

<response uri = “/ crm / private / xml / Leads / insertRecords”>
<resultado>
<row no = “1”>
<sucesso>
<code> 2001 </ code>
<details>
<FL val = “Id”> 2000000120006 </ FL>
<FL val = “Tempo de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55:04 </ FL >
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = “2”>
<sucesso>
<code> 2001 </ code>
<detalhes>
<FL val = “Id”> 2000000120007 </ FL>
<FL val = “Hora de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55 : 04 </ FL>
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “Modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ result >
</ response>

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

<response uri = “/ crm / private / xml / Leads / insertRecords”>
<resultado>
<row no = “1”>
<sucesso>
<code> 2001 </ code>
<details>
<FL val = “Id”> 2000000120006 </ FL>
<FL val = “Tempo de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55:04 </ FL >
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = “2”>
<sucesso>
<code> 2000 </ code>
<detalhes>
<FL val = “Id”> 2000000120007 </ FL>
<FL val = “Hora de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55 : 04 </ FL>
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “Modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ details>
</ success>
</ row>
</ result >
</ response>

Se a versão = 4, alguns registros contiverem erros e outros não, a funcionalidade e a resposta serão as seguintes:

<response uri = “/ crm / private / xml / Leads / insertRecords”>
<resultado>
<row no = “1”>
<sucesso>
<code> 2001 </ code>
<details>
<FL val = “Id”> 2000000120006 </ FL>
<FL val = “Tempo de criação”> 2013-02-11 17:55:04 </ FL>
<FL val = “Hora de modificação”> 2013-02-11 17:55:04 </ FL >
<FL val = “Criado por”>
<! [CDATA [aghil123]]>
</ FL>
<FL val = “modificado por”>
<! [CDATA [aghil123]]>
</ FL>
</ detalhes>
</ success>
</ row>
<row no = “2”>
<erro>
<code> 4832 </ code>
<detalhes> Você deu um valor incorreto para o campo: Receita anual </ details>
</ error>
</ row>
</ result>
</ response>

Inserir dados em módulos personalizados

Pedido de amostra

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

<CustomModule>
<row no = “1”>
<FL val = “Nome do CustomModule1”> Registro-CS1000120160101 </ FL>
</ row>
</ CustomModule>

Nota:

  • Email Address é o campo de verificação duplicado para o módulo Leads. Para outros módulos, o campo de verificação duplicado varia. Para saber mais, leia – https://www.zoho.com/crm/help/api/insertrecords.html#Duplicate_Check_Field 
  • Os desenvolvedores agora podem identificar facilmente o ID do registro, já que o detalhe do registro na resposta é dado da mesma forma que o usuário solicita nos dados xml.
  • Se você não passar a versão, a funcionalidade padrão será executada.
  • Você tem que passar a versão = 4 no URL do parâmetro para verificação duplicada em vários registros.