Importação de Dados - CSVBOX

IMPORTAÇÃO DE DADOS COM CSVBOX: UM GUIA PASSO A PASSO

Este guia prático foi criado para fornecer um passo a passo detalhado sobre como utilizar o CSVBox de maneira eficiente e eficaz, permitindo que você importe dados em massa com facilidade e precisão.

O que é CSVBox?

CSVBox é uma ferramenta que permite a importação de dados em massa para o TOTVS CRM. Ele facilita a carga de dados a partir de arquivos CSV, oferecendo uma maneira eficiente de trazer informações para o sistema, seja para clientes, leads ou outros registros relevantes.

Acessando o CSVBox

Faça login na sua conta do TOTVS CRM
No menu, clique em Sheets
Escolha o template desejado e clique em Copy
Em seguida, selecione a opção Create a new sheet

Configurando a Planilha

Ao criar uma nova planilha, clique em Editpara editá-la.
Nomeie o arquivo conforme necessário, utilizando um nome descritivo que identifique os dados a serem importados.
Na aba "Destination" (Destino), clique em Add Custom Headers
Insira o token de autorização na linha "Authorization". O token deve seguir o formato "Bearer [seu_token_aqui]".
Após concluir a configuração na aba "Code", clique em Test Importe.
Baixe o modelo de arquivo disponibilizado.
Abra o modelo de arquivo baixado no Excel.
Inclua os campos que você deseja importar e preencha os dados correspondentes.
Para os campos que exigem IDs de cadastro, localize esses IDs na barra de endereços do TOTVS CRM.

Recomendações:

Excel (xls, xlsx): Utilize apenas colunas como separadores
CSV: Utilize vírgula, ponto e vírgula ou aspas como separadores e codifique em UTF-8
Células Mescladas: Não são suportadas
Caracteres por Campo: Máximo de 250 caracteres
Limite de Linhas: Até 9.999 linhas por arquivo
Formatação das Células: Mantenha a mesma formatação das células do modelo fornecido

Importando os Dados

Salve a planilha ou tabela no formato CSV.
Faça o upload do arquivo CSV no CSVBox.
Selecione a linha de cabeçalho na interface do CSVBox e clique no botão Próximo.
Mapeie as colunas do arquivo CSV com os campos correspondentes no TOTVS CRM.
Clique no botão Próximo para prosseguir.
Valide todos os campos e certifique-se de que os dados estão corretos.
Por fim, clique no botão Enviar para concluir a importação dos dados.

Usuários

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
ID do Usuário (externalId)	Texto	Número de identificação utilizado para identificar uma fonte externa, como um número de um sistema ERP. Pode ser atribuído qualquer número para facilitar a identificação.	Sim
Usuário Ativo (active)	Texto	Indica se um usuário está ativo ("true") ou inativo ("false"). Afeta o acesso e as permissões do usuário no sistema.	Sim
Nome (name)	Texto	Campo utilizado para armazenar o nome completo do usuário. Fundamental para identificação no TOTVS CRM e outras comunicações.	Sim
Nome de Usuário (username)	Texto	Endereço de e-mail do usuário usado para acesso e autenticação no sistema. Deve ser um e-mail exclusivo em formato padrão ([email protected]).	Sim
ID Perfil de Acesso (profile.id)	Código do ID	Define as ações e funcionalidades disponíveis no sistema. Representado por um código de ID que deve ser obtido no cadastro de perfis de acesso.	Sim
ID Empresa (companyIds[0])	Código do ID	Indica a empresa ou filial à qual o usuário está associado. Insira o código de ID correspondente. Pode-se vincular várias empresas a um usuário adicionando colunas "companyIds[1]", "companyIds[2]", etc., com o ID de cada empresa.	Sim
Código do Cadastro (code)	Texto	O campo "Código do cadastro" é usado para definir a numeração do cadastro do usuário. Pode ser um número aleatório ou um código de referência de outros sistemas. Deve ser único para evitar duplicações.	Não
ID País (countryId)	Código do ID	Utilizado para determinar o país de origem do usuário. O código de ID é um valor padrão do sistema e para obtê-lo, consulte a tabela de campos padrões.	Não
ID Estado (stateId)	Código do ID	Define o estado do endereço do usuário. O ID é um valor padrão do sistema e para encontrar o código correto, consulte a tabela de campos padrões.	Não
ID Cidade (cityId)	Código do ID	Para o campo "ID Cidade", que identifica a cidade do endereço do usuário, use o valor padrão do sistema. O código de ID é obtido na tabela de campos padrões.	Não
País (country)	Texto	Insira o nome completo do país no campo "País". Evite abreviações ou códigos para assegurar a correta identificação.	Não
Estado (state)	Texto	Insira o nome completo do estado no campo "estado", sem abreviações ou códigos. Isso assegura identificação e associação corretas ao registro.	Não
Cidade (city)	Texto	Use o nome completo da cidade no campo "cidade", sem abreviações ou códigos. Garante a identificação correta da cidade e sua associação ao registro.	Não
Endereço (address)	Texto	O campo "endereço" deve conter o nome da rua e número, preenchido em texto sem abreviações ou caracteres especiais.	Não
Complemento (complement)	Texto	Inclua informações adicionais do local no campo "complemento", como bloco, lote, sala, em formato de texto.	Não
CEP (postalCode)	Texto	Informe o CEP no formato 00000-000, garantindo o reconhecimento correto pelo TOTVS CRM.	Não
E-mail de Contato (userEmail[0].email)	Texto	Insira o e-mail do usuário no formato "[email protected]". Para mais e-mails, use colunas adicionais como "userEmail[1].email".	Não
ID Tipo de E-mail (userEmail[0].emailTypeId)	Código do ID	Insira o código ID que identifica o tipo de e-mail. Para múltiplos e-mails, adicione colunas como "userEmail[1].emailTypeId".	Não
Telefone (userPhoneNumber[0].phoneNumber)	Texto	Insira o número de telefone no formato "55(45) 99999-9999", com códigos país e área adequados.	Não
ID do Documento (userIdentificationDocument[0].identificationDocumentId)	Código do ID	Insira o ID do documento. Para mais documentos, use "userIdentificationDocument[1].identificationDocumentId".	Não
Nº do Documento (userIdentificationDocument[0].numberDocument)	Texto	Insira o número do documento associado ao ID. Para múltiplos documentos, adicione "userIdentificationDocument[1].numberDocument".	Não
ID do Papel do Usuário (roleId)	Código do ID	O campo "ID do papel do usuário" identifica a função do usuário dentro do sistema. Insira o ID correspondente.	Sim

Atividades

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
Descrição (description)	Texto	Insira uma descrição resumida da atividade para ajudar na identificação e categorização das atividades.	Sim
Data de Início (startDate)	Texto	Para preencher o campo "Data de início", insira a data no formato ISO 8601, como "2023-02-16T07:00Z".	Sim
Data Final (endDate)	Texto	Para preencher o campo "Data final", insira a data no formato ISO 8601, como "2023-02-18T01:00Z".	Sim
ID Externo (externalId)	Texto	O ID do usuário é um número de identificação que pode ser utilizado para identificar uma fonte externa, como o número de um sistema terceiro. Caso não tenha acesso a esse número, pode atribuir qualquer outro número que facilite a identificação.	Sim
Dia Todo (allDay)	Texto	O campo "Dia todo" determina se a atividade ocorrerá durante todo o dia ("true") ou em um horário específico ("false"). Se "false", os horários de início e término devem ser especificados.	Sim
ID do Usuário (userId)	Código do ID	Utilizado para associar a atividade a um usuário específico. Encontre o ID do usuário no final do URL de sua página de cadastro no navegador.	Sim
Prioridade (priority)	Texto	Determina a importância das atividades, com opções como "urgent", "high", "medium", "low".	Sim
ID Cliente (customerId)	Código do ID	Indica a qual cliente a atividade se refere. Encontre o ID do cliente na página de cadastro no navegador. O preenchimento é opcional se a atividade se refere a um lead.	Não
ID Lead (leadId)	Código do ID	Usado para indicar a qual lead a atividade se refere. O ID do lead pode ser encontrado na página de cadastro ou edição do lead no navegador. Preenchimento opcional se a atividade se refere a um cliente.	Não
ID Tipo de Atividade (ActivityTypeId)	Código do ID	Indica o tipo de atividade, como ligação, e-mail, reunião, etc. O ID pode ser encontrado no cadastro de tipos de atividade no sistema TOTVS CRM.	Sim
Nome do Local (locationName)	Texto	Informe o local onde a atividade será realizada. Preenchimento em texto; opcional se a atividade não exigir um local específico.	Não
ID Plano de Ação (actionPlanId)	Código do ID	Indica se a atividade está ligada a um plano de ação. O ID do plano de ação pode ser encontrado no cadastro correspondente no sistema TOTVS CRM. Campo opcional.	Não
Status (status)	Texto	O campo deve ser preenchido com "open" para importações, pois não há opções para importar atividades concluídas ou canceladas. O status pode ser alterado manualmente após a importação.	Sim
Observação (note)	Texto	Inclui notas ou observações sobre a atividade. O preenchimento é opcional e deve conter informações úteis que auxiliam na execução da atividade.	Não

Clientes

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
Ativo (active)	Texto	O campo "Cliente Ativo" indica se um cliente está ativo ("true") ou inativo ("false").	Não
Nome (name)	Texto	Este campo é responsável por representar o nome do cliente no TOTVS CRM.	Sim
Nome Fantasia (tradingName)	Texto	O campo "Nome Fantasia" é destinado a receber o apelido ou nome comercial do cliente.	Não
ID Externo (externalId)	Texto	O ID externo é um número de identificação que pode ser utilizado para identificar uma fonte externa, como o número de um sistema terceiro.	Sim
Código (code)	Texto	O campo "Código" pode ser preenchido com números aleatórios ou sequenciais, de acordo com a sua preferência. É crucial que os códigos sejam únicos para evitar duplicidade.	Não
ID Tipo de Pessoa (customerPersonType.id)	Código do ID	Indica se o cliente é uma pessoa física ou jurídica. Informe o número do ID correspondente ao tipo de pessoa, que pode ser encontrado no cadastro do Tipo de Pessoa.	Sim
ID Externo Documentos (customerIdentificationDocuments[0].externalId)	Texto	Permite informar um número de identificação para um documento, usado para integrar diferentes fontes de informação.	Não
ID Documentos de Identificação (customerIdentificationDocuments[0].identificationDocumentId)	Código do ID	Define o tipo de documento do cliente, como CPF ou CNPJ. É crucial informar o número correto do ID encontrado no cadastro de Documentos de Identificação.	Sim
Nº do Documento (customerIdentificationDocuments[0].documentNumber)	Texto	O número do documento deve ser preenchido sem pontuação, ajustado automaticamente pelo sistema. Essencial para a gestão correta das informações.	Sim
Data de Nascimento (birthday)	Texto	Para pessoa física, preencha com a data de nascimento; para jurídica, com a data de fundação. Use o formato "AAAA-MM-DD", como "2023-01-01".	Não
ID da Conta Pai (parentAccount.id)	Código do ID	O campo "ID da Conta Pai" refere-se à conta principal de um conjunto de empresas que possuem uma relação hierárquica. Localize o ID acessando o cadastro da empresa matriz e copiando o código da barra de endereço do navegador.	Sim
ID Contato (contacts[0].id)	Código do ID	Vincula um contato interno da empresa cliente que atua como influenciador ou decisor. O ID pode ser obtido no cadastro do contato. Para adicionar mais contatos, use campos adicionais como (contacts[1].id).	Sim
ID Empresa (companies[0].id)	Código do ID	Indica qual empresa dentro de sua organização é responsável pelo cliente. Encontre o ID acessando o cadastro da empresa correspondente e copiando o código da barra de endereço do navegador.	Sim
ID do Profissional (professionalId)	Código do ID	Indica qual profissional é responsável pela conta do cliente. Encontre o ID do profissional no cadastro correspondente e copie o código da barra de endereço do navegador.	Sim
Nome do Profissional (professionalName)	Texto	Insira o nome do profissional exatamente como registrado no sistema, assegurando a correta identificação do responsável pela conta do cliente.	Sim
ID Externo Telefone (phones[0].externalId)	Texto	Permite a identificação de um telefone usando um número externo, como um ID de sistema terceiro. Se não disponível, um número alternativo pode ser usado para facilitar a identificação.	Não
Telefone Padrão (phones[0].standard)	Texto	Define se o telefone é o padrão. Preencha com "true" para definir como padrão e "false" para não padrão.	Não
ID Tipo de Telefone (phones[0].phoneTypeId)	Código do ID	Especifica o tipo de telefone (profissional, pessoal, etc.). O ID deve ser obtido da tabela de padrões de tipos de telefone.	Sim
Número de Telefone (phones[0].number)	Texto	Insira um número de telefone válido no formato "55(45) 99999-9999", incluindo o código internacional e o código de área local.	Sim
ID Externo Email (emails[0].externalId)	Texto	Permite a identificação de um e-mail usando um número externo, similar ao campo ID Externo Telefone.	Não
ID Tipo de Email (emails[0].emailTypeId)	Código do ID	Insira o código ID correspondente ao tipo de e-mail. Para múltiplos e-mails, use colunas adicionais como "(emails[1].emailTypeId)".	Sim
Email (emails[0].email)	Texto	Insira o e-mail do cliente no formato "[email protected]". Para adicionar mais e-mails, use colunas adicionais como "(emails[1].email)".	Sim
Facebook (facebook)	Texto	Informe o link do perfil do cliente no Facebook, incluindo "https://www." para assegurar a correção do link.	Não
Instagram (instagram)	Texto	Informe o link do perfil do cliente no Instagram, incluindo "https://www." para garantir o acesso correto ao perfil.	Não
Twitter (twitter)	Texto	Informe o link do perfil do cliente no Twitter, assegurando que o link esteja completo com "https://www." para acesso direto.	Não
LinkedIn (linkedin)	Texto	Forneça o link do perfil do cliente no LinkedIn, começando com "https://www." para evitar problemas de direcionamento.	Não
Site (website)	Texto	Informe o link do site do cliente, assegurando que o link esteja completo com "https://www." para acesso correto.	Não
ID Origem (leadOrigin.id)	Código do ID	O campo "Origem" indica como o cliente foi adquirido. Encontre o ID no cadastro de Origens e copie o código da barra de endereço do navegador.	Sim
ID Ramo de Atividade (locationBusinessLines[0].id)	Código do ID	Indica o segmento de mercado da empresa. O ID pode ser obtido no cadastro de Ramos de Atividade no navegador.	Sim
ID Grupo (customerGroups[0].id)	Código do ID	Identifica os grupos aos quais o cliente pertence. Encontre o ID no cadastro de Grupos e, se necessário, use colunas adicionais para múltiplos grupos.	Sim
ID Classificação (customerClassification.id)	Código do ID	Usado para categorizar clientes de acordo com critérios como potencial de compra. O ID pode ser encontrado no cadastro de Classificações.	Sim
Observação (note)	Texto	O campo "Observação" serve para adicionar informações adicionais relevantes ou complementares que podem ser úteis para a equipe de vendas.	Não
ID Externo Endereço (addresses[0].externalId)	Texto	Identificação de uma fonte externa para o endereço, como um número de um sistema terceiro. Caso não tenha acesso, atribua um número que facilite a identificação.	Não
Endereço Padrão (addresses[0].standard)	Texto	Define qual endereço será considerado padrão. Preencha com "true" para definir como padrão e "false" para não. Recomendado selecionar o endereço mais utilizado.	Não
Descrição Endereço (addresses[0].description)	Texto	Fornece uma descrição clara e objetiva para diferenciar os endereços do cliente.	Não
ID Tipo de Endereço (addresses[0].addressType.id)	Código do ID	Indica o tipo de endereço, como cobrança ou entrega. Encontre o ID correspondente no cadastro de Tipos de Endereço e copie o código da barra de endereço do navegador.	Sim
Ativo (addresses[0].active)	Texto	Indica se o cadastro do cliente está ativo ou inativo. "true" para ativo, "false" para inativo.	Não
Código Endereço (addresses[0].code)	Texto	O campo "Código do endereço" pode ser preenchido com números aleatórios ou sequenciais, garantindo que os códigos sejam únicos para evitar duplicidade.	Não
ID Cidade (addresses[0].cityId)	Código do ID	Utilizado para identificar a cidade do endereço do cliente. O código de ID deve ser obtido da seção de padrões do sistema.	Sim
Nome Cidade (addresses[0].cityName)	Texto	Insira o nome completo da cidade, evitando abreviações ou códigos, para garantir a correta identificação no sistema.	Não
ID Estado (addresses[0].stateId)	Código do ID	Indica o estado do endereço do cliente. O código de ID é um valor padrão do sistema, acessível através da tabela de padrões.	Sim
Nome Estado (addresses[0].stateName)	Texto	Insira o nome completo do estado, sem abreviações ou códigos, para assegurar a correta identificação no registro.	Não
ID País (addresses[0].countryId)	Código do ID	Utilizado para determinar o país do endereço do cliente. O código de ID deve ser obtido da seção de padrões do sistema.	Sim
Nome País (addresses[0].countryName)	Texto	Insira o nome completo do país, sem abreviações ou códigos, para garantir a correta identificação no sistema.	Não
CEP (addresses[0].postalCode)	Texto	Informe o número do CEP no formato "00000-000", essencial para o reconhecimento e processamento correto do endereço pelo TOTVS CRM.	Não
Região (addresses[0].region)	Texto	Indica a região geográfica do endereço, como província, departamento, município ou vila.	Não
Zona (addresses[0].zone)	Texto	Utilizado para especificar áreas dentro de uma cidade, como distritos ou zonas comerciais.	Não
Bairro (addresses[0].neighborhood)	Texto	Descreve a área específica dentro de uma cidade onde o endereço está localizado, ajudando a identificar o local exato.	Não
Endereço (addresses[0].address)	Texto	Informe o nome da rua e número do endereço do cliente, sem usar abreviações ou caracteres especiais, para assegurar a precisão no registro das informações.	Sim
Número do Endereço (addresses[0].number)	Texto	Indica o número específico do prédio ou sala associado ao endereço do cliente.	Sim
Complemento (addresses[0].complement)	Texto	Permite adicionar informações adicionais ao endereço, como bloco, lote, andar, entre outros, para ajudar na identificação precisa do local.	Não

Leads

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
Ativo (active)	Texto	O campo "Lead Ativo" indica se um lead está ativo ("true") ou inativo ("false").	Não
Nome (name)	Texto	Representa o nome do lead no TOTVS CRM.	Sim
Nome Fantasia (tradingName)	Texto	O campo "Nome Fantasia" é utilizado para receber o apelido ou nome comercial do lead, assegurando sua correta identificação na solução.	Não
ID Externo (externalId)	Texto	O ID externo é um número de identificação que pode ser usado para identificar uma fonte externa, como o número de um sistema terceiro. Caso não tenha acesso, pode atribuir outro número que facilite a identificação.	Sim
Código (code)	Texto	Preencha com números aleatórios ou sequenciais. Importante que os códigos sejam únicos para evitar duplicidade no TOTVS CRM.	Não
ID Tipo de Pessoa (customerPersonType.id)	Código do ID	Indica se o lead é pessoa física ou jurídica. Informe o ID encontrado no cadastro do Tipo de Pessoa no navegador.	Sim
ID Externo Documentos (customerIdentificationDocuments[0].externalId)	Texto	Informe um número de identificação para um documento, podendo ser um número externo ou outro número que facilite a identificação.	Não
ID Documentos de Identificação (customerIdentificationDocuments[0].identificationDocumentId)	Código do ID	Determina o tipo de documento do lead, como CPF ou CNPJ. Informe o ID correspondente encontrado no cadastro de Documentos de Identificação.	Sim
Número do Documento (customerIdentificationDocuments[0].documentNumber)	Texto	Preencha o número do documento sem pontuação, ajustado automaticamente pelo sistema, como "04246339000123".	Sim
Data de Nascimento (birthday)	Texto	Para pessoa física, preencha com a data de nascimento; para jurídica, com a data de fundação. Use o formato "AAAA-MM-DD".	Não
ID Contato (contacts[0].id)	Código do ID	Vincula um contato chave dentro da empresa do lead. O ID pode ser obtido no cadastro do contato. Para mais contatos, adicione colunas adicionais como "contacts[1].id".	Sim
ID Empresa (companies[0].id)	Código do ID	Vincula o lead a uma empresa específica dentro da sua organização. O ID da empresa pode ser obtido no cadastro da empresa no navegador. Para adicionar mais de uma empresa, utilize colunas adicionais como "companies[1].id".	Sim
ID do Profissional (professionalId)	Código do ID	Indica qual profissional é responsável pelo lead. Encontre o ID do profissional no cadastro e copie o código da barra de endereço do navegador.	Sim
Nome do Profissional (professionalName)	Texto	Insira o nome do profissional conforme registrado, garantindo a identificação correta no sistema.	Sim
ID Externo Telefone (phones[0].externalId)	Texto	Permite informar um número de identificação externa para um telefone. Utilize este campo se o número provém de uma fonte externa ou atribua outro número para facilitar a identificação.	Não
Telefone Padrão (phones[0].standard)	Texto	Define qual número de telefone é considerado padrão. Preencha com "true" para padrão e "false" para não padrão.	Não
ID Tipo de Telefone (phones[0].phoneTypeId)	Código do ID	Especifica o tipo de telefone, como profissional ou pessoal. Encontre o ID do tipo de telefone na tabela de padrões do sistema.	Sim
Número de Telefone (phones[0].number)	Texto	Insira um número de telefone válido no formato "55(45) 99999-9999", que inclui o código internacional e o código de área local.	Sim
ID Externo Email (emails[0].externalId)	Texto	Permite informar um número de identificação para um e-mail, que pode ser uma fonte externa ou facilitar a identificação do e-mail em questão.	Não
ID Tipo de Email (emails[0].emailTypeId)	Código do ID	Insira o código ID correspondente ao tipo de e-mail. Adicione colunas adicionais para múltiplos e-mails, como "emails[1].emailTypeId".	Sim
Email (emails[0].email)	Texto	Insira o e-mail do lead no formato "[email protected]". Para mais e-mails, adicione colunas adicionais como "emails[1].email".	Sim
Facebook (facebook)	Texto	Informe o link do perfil do lead no Facebook, garantindo que o link esteja completo com "https://www." para evitar erros de direcionamento.	Não
Instagram (instagram)	Texto	Informe o link do perfil do lead no Instagram, assegurando que o link esteja completo com "https://www." para acesso correto.	Não
Twitter (twitter)	Texto	Informe o link do perfil do lead no Twitter, incluindo "https://www." para garantir que o link esteja correto.	Não
LinkedIn (linkedin)	Texto	Informe o link do perfil do lead no LinkedIn, garantindo que o link esteja completo com "https://www." para evitar erros de direcionamento.	Não
Site (website)	Texto	Informe o link do site do lead, assegurando que o link esteja completo com "https://www." para acesso correto.	Não
ID Origem (leadOrigin.id)	Código do ID	Indica como o lead foi adquirido (por exemplo, prospecção, eventos, indicação). O ID deve ser obtido no cadastro de Origens.	Sim
ID Tipo de Lead (leadSituation.id)	Código do ID	Categoriza os leads conforme a jornada de compra (suspect, prospect, etc.). Encontre o ID no cadastro de Situações de Lead.	Sim
ID Etapa (leadStage.id)	Código do ID	Corresponde às fases do processo de vendas do lead. O ID pode ser encontrado no cadastro de Etapas de Lead.	Sim
ID Ramo de Atividade (locationBusinessLines[0].id)	Código do ID	Indica o segmento de mercado do lead. O ID deve ser obtido no cadastro de Ramos de Atividade.	Sim
ID Grupo (customerGroups[0].id)	Código do ID	Indica a quais grupos o lead pertence. O ID pode ser obtido no cadastro de Grupos. Para múltiplos grupos, adicione colunas adicionais como "customerGroups[1].id".	Sim
ID Classificação (customerClassification.id)	Código do ID	Categoriza os leads de acordo com critérios como potencial de compra. Encontre o ID no cadastro de Classificações.	Sim
Observação (note)	Texto	Adiciona informações complementares úteis para a equipe de vendas, como detalhes específicos sobre o lead ou interações anteriores.	Não
Convertido (converted)	Texto	Indica se o lead foi convertido em cliente. Preencha com "true" para convertido e "false" para não convertido.	Não
ID Externo Endereço (addresses[0].externalId)	Texto	Permite informar um número de identificação externa para um endereço, utilizado para integrar informações de fontes externas.	Não
Endereço Padrão (addresses[0].standard)	Texto	Define qual endereço será o padrão. Preencha com "true" para padrão e "false" para não padrão. Recomenda-se usar o endereço mais utilizado como padrão.	Não
Descrição Endereço (addresses[0].description)	Texto	Fornece uma descrição clara e objetiva do endereço para diferenciar facilmente os endereços do lead.	Não
ID Tipo de Endereço (addresses[0].addressType.id)	Código do ID	Indica o tipo de endereço do lead, como endereço de cobrança, principal, ou de entrega. Localize o ID no cadastro de Tipos de Endereço.	Sim
Ativo (addresses[0].active)	Texto	Indica se o endereço do lead está ativo ou inativo. Use "true" para ativo e "false" para inativo.	Não
Código Endereço (addresses[0].code)	Texto	O código do endereço pode ser aleatório ou sequencial, mas deve ser único para evitar duplicidade.	Não
ID Cidade (addresses[0].cityId)	Código do ID	Identifica a cidade do endereço do lead. O código ID deve ser obtido na seção de campos padrões ou tabelas de cidade.	Sim
Nome Cidade (addresses[0].cityName)	Texto	Insira o nome completo da cidade do endereço do lead, sem abreviações ou códigos de dois dígitos, para garantir uma identificação precisa.	Não
ID Estado (addresses[0].stateId)	Código do ID	Utilizado para identificar o estado do endereço do lead. O ID é obtido através da seção de padrões, acessível mediante download.	Sim
Nome Estado (addresses[0].stateName)	Texto	Insira o nome completo do estado, sem abreviações ou códigos de dois dígitos, para uma correta associação ao endereço do lead.	Não
ID País (addresses[0].countryId)	Código do ID	Indica o país do endereço do lead. O código de ID deve ser encontrado na seção de padrões após realizar o download da tabela correspondente.	Sim
Nome País (addresses[0].countryName)	Texto	Informe o nome completo do país para garantir a correta identificação e associação ao endereço do lead.	Não
CEP (addresses[0].postalCode)	Texto	Insira o CEP no formato "00000-000", assegurando que o CRM reconheça e processe o endereço corretamente.	Não
Região (addresses[0].region)	Texto	Descreva a região geográfica do endereço, como província, departamento, município ou vila, para fornecer detalhes adicionais sobre a localização.	Não
Zona (addresses[0].zone)	Texto	Indica áreas específicas dentro de uma cidade, como zonas comerciais ou residenciais.	Não
Bairro (addresses[0].neighborhood)	Texto	Descreve a identificação de áreas específicas dentro de uma cidade, ajudando na localização exata do lead.	Não
Endereço (addresses[0].address)	Texto	Informe o nome da rua e o número sem abreviações ou caracteres especiais, garantindo a precisão no registro das informações.	Sim
Número do Endereço (addresses[0].number)	Texto	Indica o número específico do prédio ou sala, essencial para a identificação precisa do local do lead.	Sim
Complemento (addresses[0].complement)	Texto	Permite adicionar informações adicionais ao endereço, como bloco, lote, andar, entre outros, para ajudar na identificação precisa do local.	Não

Oportunidades

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
ID Externo (externalId)	Texto	O ID externo é um número que pode ser usado para identificar uma fonte externa, como o número de um sistema terceiro. Pode ser outro número que facilite a identificação se o específico não estiver disponível.	Sim
Situação (status)	Texto	Indica o status da oportunidade, com valores como "PROGRESS", "WON", "LOST", "DISCARDED".	Sim
Descrição (description)	Texto	Fornece uma breve descrição da oportunidade para fornecer contexto e facilitar a identificação e classificação.	Sim
ID Tipo de Oportunidade (opportunityTypeId)	Código do ID	Identifica o tipo de oportunidade. O ID pode ser obtido no cadastro do tipo de oportunidade, visualizado no endereço do navegador.	Sim
ID Motivo Ganho/Perda (winLossReasonId)	Código do ID	Registra os motivos pelos quais a oportunidade foi ganha ou perdida. O ID pode ser encontrado no cadastro do motivo no navegador.	Não
ID Pipeline (pipelineId)	Código do ID	Indica a qual pipeline a oportunidade está vinculada. O ID pode ser obtido acessando o cadastro do pipeline desejado.	Sim
ID Etapa da Pipeline (stageId)	Código do ID	Mostra em qual etapa do pipeline a oportunidade se encontra. Encontre o ID no cadastro da etapa específica.	Sim
ID Responsável (userId)	Código do ID	Associa a oportunidade ao usuário responsável. O ID pode ser encontrado no cadastro do usuário, ao final do URL de sua página.	Sim
Tipo de Conta (accountType)	Texto	Indica se a oportunidade se refere a um cliente ("Customer") ou a um lead ("Lead").	Sim
ID Cliente (customerId)	Código do ID	Usado para indicar a qual cliente a oportunidade se refere. O ID do cliente pode ser encontrado na página de cadastro ou edição do cliente. Preenchimento opcional se a oportunidade estiver ligada a um lead.	Não
ID Lead (leadId)	Código do ID	Indica a qual lead a oportunidade se refere. O ID pode ser encontrado na página de cadastro ou edição do lead no sistema.	Não
Data Prevista (expectedAt)	Texto	Refere-se à previsão de conclusão da oportunidade, importante para o planejamento e acompanhamento. Formato: "AAAA-MM-DD".	Sim
Probabilidade (probalityPercentage)	Texto	Indica o percentual de chance de sucesso da oportunidade. Por exemplo, "60" para 60% de probabilidade.	Sim
Valor Recorrente Total (totalRecurrentValue)	Texto	Refere-se ao valor total que será pago regularmente pelo cliente. Formato de valor, exemplo: "2500.00".	Sim
Valor Único Total (totalSingleValue)	Texto	Valor total da transação única na oportunidade. Formato de valor, exemplo: "2500.00".	Sim
Valor Total (totalValue)	Texto	Refere-se ao valor total da oportunidade, combinando pagamentos únicos e recorrentes. Formato de valor, exemplo: "2500.00".	Sim
Observação (note)	Texto	Inclui notas ou observações relevantes sobre a oportunidade, úteis para detalhamento ou especificações adicionais.	Não
Data da Criação (startedAt)	Texto	Indica a data e hora da criação da oportunidade no formato ISO 8601. Exemplo: "2022-10-31T19:25:28.928Z".	Sim
Data de Conclusão (completedAt)	Texto	Refere-se à data e hora em que a oportunidade foi concluída. Formato ISO 8601, exemplo: "2022-10-31T19:25:28.928Z".	Não
Contato (contacts[0].id)	Código do ID	Vincula uma pessoa chave dentro da empresa do cliente ou lead que atua como influenciador ou decisor. O ID pode ser obtido no cadastro do contato.	Sim
Empresa (companyId)	Código do ID	Associa a oportunidade à empresa responsável, seja uma filial ou a matriz. O ID é encontrado no cadastro da empresa.	Sim

Produtos

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
Descrição (description)	Texto	Fornece o nome ou uma visão geral do produto.	Sim
ID Externo (externalId)	Texto	Um número de identificação usado para referenciar uma fonte externa. Pode ser atribuído qualquer número que facilite a identificação se o específico não estiver disponível.	Sim
Ativo (active)	Texto	Indica se o produto está ativo ("true") ou inativo ("false").	Sim
ID Unidade de Medida (measurementUnitId)	Código do ID	Identifica a unidade de medida do produto, como quilograma, metro, litro, etc. O ID é encontrado no cadastro do produto.	Sim
Descrição da Medida (measurementUnitDescription)	Texto	Descreve textualmente a unidade de medida do produto, como 'quilograma', 'metro', 'litro', etc.	Sim
Sigla da Medida (measurementUnitAcronym)	Texto	Armazena a sigla da unidade de medida do produto, facilitando referências rápidas.	Sim
Venda Fracionada (saleFractioned)	Texto	Define se o produto pode ser vendido em frações de sua unidade de medida. "true" para sim, "false" para não.	Sim
Permitir Recorrência (allowRecurrence)	Texto	Indica se o pagamento do produto pode ser realizado de forma recorrente, como mensalmente. "true" para permitir, "false" para não permitir.	Sim
Código (code)	Texto	Pode ser preenchido com números aleatórios ou sequenciais, importante para a unicidade e evita duplicidade.	Sim
Código Adicional (additionalCode)	Texto	Permite a inclusão de um código secundário para o produto, seguindo as mesmas regras do campo 'Código' principal.	Não
ID Aplicação (applications[0].id)	Código do ID	Refere-se às diferentes aplicações do produto. O ID pode ser encontrado no cadastro do tipo de aplicação.	Sim
ID Marca (brand.id)	Código do ID	Identifica a marca responsável pela fabricação ou distribuição do produto. Encontre o ID no cadastro da marca.	Sim
ID Grupo de Produto (productGroup.id)	Código do ID	Categoriza produtos em diferentes áreas, como eletrônicos, equipamentos, etc. O ID é encontrado no cadastro do grupo de produtos.	Sim
Peso do Produto (weight)	Texto	Indica o peso do produto, preenchido com um valor numérico que represente o peso em uma unidade de medida específica.	Não
ID Empresa (inventories[0].companyId)	Código do ID	Associa o estoque do produto a uma empresa específica. O ID pode ser obtido no cadastro da empresa ou filial.	Sim
ID Fornecedores (suppliers[0].id)	Código do ID	Indica o fornecedor associado ao produto. O ID é encontrado no cadastro do fornecedor.	Sim
ID Fabricante (manufacturer.id)	Código do ID	Identifica o fabricante que produziu o produto. O ID é obtido acessando o cadastro do fabricante e copiando o código do navegador.	Sim
Nota do Fabricante (manufacturerNote)	Texto	Observações ou informações adicionais fornecidas pelo fabricante sobre o produto.	Não
Preço de Custo (costPrice)	Texto	Refere-se ao preço de aquisição do produto, indicando o valor investido para comprar ou fabricar o produto.	Sim
Lançamento de (newSince)	Texto	Data de início do lançamento do produto no mercado. Formato recomendado: "AAAA-MM-DD".	Não
Lançamento até (newUntil)	Texto	Data de encerramento do lançamento do produto no mercado. Formato recomendado: "AAAA-MM-DD".	Não
Preço Oportunidade (opportunitySalePrice)	Texto	Preço de venda especial ou promocional do produto. Deve ser preenchido no formato "2500.00".	Não
Quantidade Estoque (inventories[0].quantity)	Texto	Indica a quantidade atual do produto em estoque. Deve ser um número inteiro representando a quantidade disponível.	Sim
ID Empresa Estoque (inventories[0].companyId)	Código do ID	Identifica a empresa que possui o estoque do produto. O ID é obtido acessando o cadastro da empresa.	Sim
Nome Empresa (inventories[0].companyName)	Texto	Nome da empresa que detém o estoque do produto.	Não
ID Externo Empresa (inventories[0].externalId)	Código do ID	Número de identificação externa associado à empresa no estoque. Pode ser um número de um sistema terceiro ou outro número facilitador.	Não
ID Externo Embalagem (packagings[0].externalId)	Código do ID	ID externo para a embalagem, que pode ser o número de um sistema terceiro ou outro número que facilite a identificação.	Não
Descrição Embalagem (packagings[0].packagingDescription)	Texto	Fornece informações sobre o tipo de embalagem do produto.	Não
Fator de Conversão (packagings[0].conversionFactor)	Texto	Indica o fator usado para converter a quantidade de produto de/para a embalagem. Utilizado para operações de inventário e venda.	Não
Estratégia de Conversão (packagings[0].conversionStrategy)	Texto	Determina a estratégia para calcular a quantidade do produto na embalagem. Pode ser "FROM_UNIT_TO_PACKAGING" ou "FROM_PACKAGING_TO_UNIT".	Não
Embalagem Padrão (packagings[0].standard)	Texto	Indica se esta é a embalagem padrão para o produto. "true" para padrão e "false" para não padrão.	Não

Serviços

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
Descrição (description)	Texto	Fornece o nome ou uma visão geral do serviço, ajudando a identificar e explicar o serviço oferecido.	Sim
ID Externo (externalId)	Texto	Um número de identificação usado para referenciar uma fonte externa. Pode ser atribuído qualquer número que facilite a identificação se o específico não estiver disponível.	Sim
Ativo (active)	Texto	Indica se o serviço está ativo ("true") ou inativo ("false").	Sim
Código (code)	Texto	Pode ser preenchido com números aleatórios ou sequenciais, importante para a unicidade e evita duplicidade.	Sim
Permitir Vendas Fracionadas (allowFractionedSales)	Texto	Define se um serviço pode ser vendido em frações. "true" para permitir vendas fracionadas, "false" caso contrário.	Sim
ID Grupo de Serviços (serviceGroupId)	Código do ID	Categoriza serviços em grupos como manutenção, consultoria, etc. O ID é obtido no cadastro do grupo de serviços.	Sim
ID Unidade de Medida (measurementUnitId)	Código do ID	Indica a unidade de medida do serviço, como horas ou unidades. O ID pode ser encontrado no cadastro do serviço.	Sim
Descrição da Medida (measurementUnitDescription)	Texto	Descreve textualmente a unidade de medida do serviço, proporcionando clareza sobre como o serviço é quantificado.	Não
Sigla da Medida (measurementUnitAcronym)	Texto	Armazena a sigla da unidade de medida associada ao serviço, facilitando referências rápidas.	Não
Preço Oportunidade (opportunitySalePrice)	Texto	Permite definir um preço de venda para o serviço. Deve ser preenchido no formato "2500.00" com ponto como separador decimal.	Não
Observação (note)	Texto	Inclui notas ou observações relevantes sobre o serviço, úteis para detalhamento ou especificações adicionais.	Não

Contatos

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
ID Externo (externalId)	Texto	Um número de identificação que pode ser utilizado para referenciar uma fonte externa, como o número de um sistema terceiro.	Sim
Ativo (active)	Texto	Indica se o contato está ativo ("true") ou inativo ("false").	Sim
Aniversário (birthday)	Texto	Data de aniversário do contato. Deve ser preenchida no formato "AAAA-MM-DD".	Não
Nome (name)	Texto	Nome do contato como registrado no TOTVS CRM.	Sim
ID Externo Telefone (phones[0].externalId)	Texto	Permite informar um número de identificação para um telefone, usado para identificar uma fonte externa.	Não
ID Tipo de Telefone (phones[0].phoneTypeId)	Código do ID	Usado para especificar o tipo de telefone, como profissional ou pessoal. O ID deve ser obtido da tabela padrão de IDs.	Sim
Número de Telefone (phones[0].number)	Texto	Insira um número de telefone válido no formato específico do país e região, como "55(45) 99999-9999" para Brasil.	Sim
ID Tipo de Email (emails[0].emailTypeId)	Texto	Identifica o tipo de e-mail associado ao contato. O ID deve ser obtido da tabela padrão de IDs.	Sim
ID Externo Email (emails[0].externalId)	Código do ID	Permite informar um número de identificação para um e-mail, usado para identificar uma fonte externa.	Não
Email (emails[0].email)	Texto	Insira o e-mail do contato no formato apropriado, como "[email protected]".	Sim
ID Cliente (customerId)	Código do ID	Indica a qual cliente o contato está relacionado. O ID do cliente pode ser encontrado na página de cadastro ou edição do cliente.	Não
ID Lead (leadId)	Código do ID	Indica a qual lead o contato está relacionado. O ID do lead pode ser encontrado na página de cadastro ou edição do lead.	Não
Cargo (role)	Texto	Indica a posição ou título do contato dentro da empresa do cliente ou lead, como "Gerente de Projetos".	Não
Departamento (department)	Texto	Indica o departamento ou setor da empresa em que o contato trabalha, como 'Vendas' ou 'Suporte Técnico'.	Não
Observação (note)	Texto	Permite inserir informações adicionais relevantes sobre o contato que podem ser úteis para a equipe de vendas ou suporte.	Não
ID Endereço (addresses[0].externalId)	Texto	Identificação externa para um endereço, usada para integrar com sistemas externos. Pode ser um número aleatório ou específico.	Não
Endereço Padrão (addresses[0].standard)	Texto	Define qual endereço é considerado o padrão para o contato. 'true' para padrão e 'false' para não padrão.	Sim
Descrição do Endereço (addresses[0].description)	Texto	Fornece uma descrição detalhada do endereço para ajudar na identificação e diferenciação de outros endereços.	Não
Endereço Ativo (addresses[0].active)	Texto	Indica se o endereço está ativo ('true') ou inativo ('false').	Sim
Código do Endereço (addresses[0].code)	Texto	Pode ser preenchido com números aleatórios ou sequenciais para identificação única do endereço no sistema.	Não
ID Cidade (addresses[0].cityId)	Código do ID	Identifica a cidade do endereço. O ID é obtido do cadastro padrão de cidades na plataforma.	Sim
Nome Cidade (addresses[0].cityName)	Texto	Insira o nome completo da cidade do endereço, sem abreviações ou códigos de dois dígitos, para garantir uma identificação correta.	Sim
ID Estado (addresses[0].stateId)	Código do ID	Utilizado para identificar o estado do endereço do contato. O ID deve ser obtido de um sistema padrão de IDs.	Sim
Nome Estado (addresses[0].stateName)	Texto	Insira o nome completo do estado, sem abreviações ou códigos de dois dígitos, para uma correta associação ao endereço.	Sim
ID País (addresses[0].countryId)	Código do ID	Identifica o país do endereço. O ID deve ser obtido de um sistema padrão de IDs.	Sim
Nome País (addresses[0].countryName)	Texto	Insira o nome completo do país, sem abreviações ou códigos de dois dígitos, para uma correta identificação.	Sim
CEP (addresses[0].postalCode)	Texto	Insira o número do CEP no formato 00000-000 para garantir que o sistema CRM reconheça e processe corretamente o endereço.	Sim
Região (addresses[0].region)	Texto	Indique a região geográfica do endereço, como a província, o departamento, ou o município, para detalhamento adicional.	Não
Zona (addresses[0].zone)	Texto	Indica uma área específica dentro de uma cidade, como uma zona comercial ou residencial.	Não
Bairro (addresses[0].neighborhood)	Texto	Descreve o bairro onde o endereço do contato está localizado.	Não
Endereço (addresses[0].address)	Texto	Fornece o nome da rua e o número do endereço, formatado sem abreviações ou caracteres especiais.	Sim
Número do Endereço (addresses[0].number)	Texto	Indica o número específico do edifício ou da residência no endereço fornecido.	Sim
Complemento (addresses[0].complement)	Texto	Informações adicionais para ajudar na identificação precisa do local, como bloco, lote, andar, etc.	Não
Facebook (facebook)	Texto	Link para o perfil do contato no Facebook. Certifique-se de que o link esteja completo, incluindo "https://www.".	Não
Instagram (instagram)	Texto	Link para o perfil do contato no Instagram. Inclua o "https://www." no início para assegurar o acesso correto.	Não
Twitter (twitter)	Texto	Link para o perfil do contato no Twitter. Certifique-se de que o link esteja completo, incluindo "https://www.".	Não
LinkedIn (linkedin)	Texto	Link para o perfil do contato no LinkedIn. Assegure-se de que o link esteja correto, começando com "https://www.".	Não
Site (website)	Texto	Link para o site pessoal ou da empresa do contato. Deve começar com "https://www." para garantir acesso adequado.	Não

Empresas

Nome do Campo	Tipo de Dado	Descrição	Obrigatório
ID Externo (externalId)	Texto	Número de identificação utilizado para identificar uma fonte externa, como um número de um sistema terceiro.	Sim
Ativo (active)	Texto	Indica se a empresa está ativa ("true") ou inativa ("false").	Sim
Nome (name)	Texto	Nome oficial da empresa como registrado no TOTVS CRM.	Sim
Nome Fantasia (tradingName)	Texto	Nome comercial ou apelido pelo qual a empresa é conhecida, facilitando sua identificação na solução.	Sim
Código (code)	Texto	Números aleatórios ou sequenciais usados para identificar unicamente a empresa, ajudando a evitar duplicidade.	Não
ID Tipo de Telefone (phones[0].phoneTypeId)	Código do ID	Define o tipo de telefone, como principal ou secundário. O ID deve ser obtido do sistema padrão de IDs.	Sim
Número de Telefone (phones[0].number)	Texto	Insira um número de telefone válido, formatado de acordo com as normas locais, exemplo: "55(45) 99999-9999" para o Brasil.	Sim
ID Tipo de Email (emails[0].emailTypeId)	Texto	Identifica o tipo de e-mail. Informe o ID padrão do sistema que descreve se o email é pessoal, profissional, etc.	Sim
Email (emails[0].email)	Texto	Endereço de e-mail corporativo, exemplo: "[email protected]".	Sim
Matriz (headOffice)	Texto	Indica se a empresa é a principal do grupo. "true" para matriz e "false" para filiais.	Sim
Distribuidora (redistributor)	Texto	Define se a empresa atua como distribuidora. "true" para distribuidoras, "false" caso contrário.	Sim
Slogan	Texto	Frase representativa da marca ou da empresa, usada em comunicações de marketing.	Não
ID Tipo de Empresa (companyType.id)	Código do ID	Identificador único para o tipo de empresa, como porte ou atividade econômica. Encontre o ID no cadastro do Tipo de Empresa.	Sim
ID País (countryId)	Código do ID	Identifica o país onde a empresa está localizada. O ID é padrão e obtido de sistemas internos.	Sim
País (country)	Texto	Nome completo do país da empresa, sem abreviações, para assegurar identificação correta.	Sim
ID Cidade (cityId)	Código do ID	Identificador da cidade do endereço da empresa. O código é padrão e pode ser baixado de sistemas internos.	Sim
Cidade (city)	Texto	Nome completo da cidade, assegurando identificação correta e associação ao registro empresarial.	Sim
ID Estado (stateId)	Código do ID	Código identificador do estado. Deve ser obtido de sistemas padrão de identificação.	Sim
Estado (state)	Texto	Nome completo do estado onde a empresa está localizada, para assegurar a identificação correta.	Sim
CEP (postalCode)	Texto	Insira o número do CEP no formato 00000-000 para garantir que o TOTVS CRM possa reconhecer e processar corretamente o seu endereço.	Sim
Endereço (address)	Texto	Fornece o nome da rua e o número do endereço, formatado sem abreviações ou caracteres especiais.	Sim
Complemento (complement)	Texto	Informações adicionais para ajudar na identificação precisa do local, como bloco, lote, andar, etc.	Não
ID Externo Doc. (companyIdentificationDocuments[0].externalId)	Texto	Permite a inserção de um número de identificação externo para um documento, como o número de identificação de um sistema terceiro.	Não
ID Documento (companyIdentificationDocuments[0].identificationDocumentId)	Código do ID	Identifica o tipo de documento utilizado, como CPF ou CNPJ. O número do ID deve ser encontrado no sistema.	Sim
Número Documento (companyIdentificationDocuments[0].documentNumber)	Texto	Insira o número do documento, ajustado automaticamente pela máscara do cadastro, exemplo: CNPJ 04246339000123.	Sim

Configuração de Campos Personalizados Booleanos

Para adicionar e configurar campos booleanos personalizados no TOTVS CRM via CSVBox, siga as orientações que integram as mesmas práticas para campos personalizados com especificidades para campos booleanos. Aqui está uma descrição detalhada do processo:

Configuração Aba Column:

Cada campo personalizado deve ser precedido por um underline (_). Este underline indica que o campo é personalizado e não um campo padrão do sistema.
O nome do campo personalizado deve ser exatamente o mesmo que está cadastrado no TOTVS CRM.

Exemplo de Campos

Nome do Campo	Tipo de Dado
_campoDeTexto	Text
_campoBooleano	Boolean

Configuração Aba Destination:

Clique em Add Custom Headers para adicionar cabeçalhos personalizados
Adicione uma chave Columns-To-Parse-As-Boolean e especifique o nome do campo booleano no campo de valor (Value).