Método InsertRecords
Índice
- Propósito
- URL de solicitação
- Solicitar Parâmetros
- Campos de verificação duplicados
- Exemplos
- Inserir registros no Zoho CRM de aplicativos de terceiros
- Inserir notas e relacionar ao módulo principal
- Atribuir o proprietário ao registro
- Casos
- tarefas
- Eventos
- Eventos com contatos e mapeamento de casos
- Contas
- Contatos
- Ordens de venda
- citações
- Inserir chamadas com contatos e pesquisa de contas
- Inserir chamadas com pesquisa de leads
- Uso de ‘CDATA’
- Inserir vários registros
- Verificação Duplicada para Vários Registros
- Inserir dados em módulos personalizados
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:
Solicitar Parâmetros
Parâmetro | Tipo de dados | Descrição |
authtoken * | Corda | Cadeia alfanumérica criptografada para autenticar suas credenciais do Zoho. |
escopo* | Corda | Especifique o escopo como crmapi |
xmlData * | XML | Esta é uma string XML e o formato deve ser o mesmo que o formato getRecords em XML dos registros buscados. |
wfTrigger | boleano | Definir 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 . |
duplicateCheck | Inteiro | Definir 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. |
isApproval | boleano | Por 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. |
newFormat | Inteiro | newFormat = 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ão | Inteiro | version = 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:
Campos de verificação duplicados
nome do módulo | Campo de Verificação Duplicado |
Conduz | O email |
Contatos | O email |
Contas | Nome da conta |
Potenciais | Nome Potencial |
Campanhas | Nome da campanha |
Casos | Sujeito |
Produtos | Nome do Produto |
Vendedores | Nome do vendedor |
citações | Sujeito |
Ordens de venda | Sujeito |
Ordens de compra | Sujeito |
Faturas | Sujeito |
CustomModule | Nome 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.