Importação e migração de dados

Índice

Importação de pessoas

IMPDADOS.IMP_PESSOAS

Descrição

Migração (importação) de dados de pessoas.

Ver:

Esta interface pode ser acessada pelo menu:


Campos:

Código de identificação da pessoa
Indica a situação do processamento da carga deste registro.
  • Erro - Houve uma tentativa de importação (ou validação) sem sucesso. Veja o campo "Mensagens de erro" para maiores informações sobre o que ocorreu.
  • Importado - O registro já foi importado.
  • Pendente - O registro ainda não foi importado e nem validado.
  • Válido - O registro foi validado com sucesso mas ainda não foi importado para o sistema.
  • Existente - O registro já existe no cadastro (mesmo CPF, CNPJ ou código) e está válido, mas as informações do mesmo não acrescentadas ao cadastro do Eligo.
Mensagens de erro que ocorreram no processo de validação ou importação dos dados. Este campo é atualizado pelos processos de validação/importação dos dados.
Código (único) de identificação da pessoa (física ou jurídica).
Código da pessoa para registro de legado (código da pessoa no sistema utilizando anteriormente). Quando informado será registrado como um documento da pessoa.
Tipo de pessoa. Aceita os termos "J", "Jurídica", "Jur", "F", "Física" ou "Fis". Ignora caixa alta/baixa e acentos.
Nome completo ou razão social da pessoa
Nome fantasia (nome comercial, nome de fachada) é a designação utilizada por uma instituição (empresa, associação etc), seja pública ou privada, sob a qual ela se torna conhecida do público. Esta denominação opõe-se à razão social, que é o nome utilizado perante os órgãos públicos de registro das pessoas jurídicas.

O nome fantasia pode ser formado a partir de palavras ou expressões oriundas da razão social, bem como pode ser criado a partir da criatividade do empresário e de sua assessoria de marketing. Igualmente, o nome fantasia pode ser a fonte para a elaboração da razão social.

De acordo com as regras de direito comercial, o registro de um nome fantasia é feito perante os órgãos de registro de marcas e patentes, sendo resguardado o direito à sua utilização ao primeiro que o registra. O impacto do nome fantasia junto ao mercado consumidor justifica os altos investimentos que são feitos pelas grandes empresas. Muitos nomes, inclusive, conseguem virar sinômino do produto que vendem ou serviço que prestam, figura de linguagem conhecida como metonímia (marca pelo produto), tal como ocorre, por exemplo, na canção de "Gita (eu sou)", de Raul Seixas e Paulo Coelho, em que há referência aos "pegue e pague do mundo" para dizer "supermercado".

A utilização do nome de fantasia se dá em diversos momentos, desde a sua colocação na fachada do estabelecimento comercial até a sua aposição nos produtos fabricados, passando pela veiculação em material de publicidade.
Para pessoas físicas, indica a data de nascimento (composto por dia de aniversário + mês de aniversário + ano de nascimento).
Para pessoas jurídicas, indica a data de sua fundação.
Observações para sobre a pessoa
Grupo no qual a pessoa a ser migrada está associada.

É importante lembrar que este o tipo de vínculo é definido no tipo de pessoa.

Deve ser informado o código da pessoa ou o código legado, conforme configurado na preferência IMPDADOS.DADOS_PESSOAS.FORMA_UTILIZACAO_GRUPO.
Ramo de atividade que a pessoa se enquadra. Seu cadastro é feito pela interface Ramos de atividade
Endereço principal para a pessoa.
Número do endereço no logradouro.
Complemento de endereço
Nome do Bairro.
Código do Cep.
Nome da cidade do endereço principal
Nome do estado do endereço principal. O sistema aceita tanto pelo nome como pela sigla.
País do endereço principal
Finalidades que o endereço possui. Caso não informado nenhuma será considerado igual a todas.
As opções apresentadas dependem do que estiver registrado em Tipos de finalidades de endereços.
Site associado à pessoa.
Principal e-mail de contato com a pessoa.
E-mail para uso no envio da NFE
Número de telefone para horário comercial
Fone para contato 2
Domínio primitivo para representar/implementar atributos do tipo texto.

Propriedades (format)


text-transform

  • uppercase: Transforma o texto para letras maiusculas
  • lowercase: Transforma o texto para letras minúsculas
  • capitalize: Primeiras letras em maiúscula
  • ascii7: Ajusta acentos, cedilhas e outros caracteres especiais para caracteres básicos
  • trim: Remove espaços extras no início e no fim do texto.

ellipsis-in

Indica que deve apresentar apenas "N" primeiros caracteres. Se existir um quarto caractere, será apresentado "..." e se o usuário passar o mouse sobre o campo, o valor completo será apresentado

ellipsis-at

Indica que deve apresentar todos os caracteres até o caractere incluído como parâmetro. Se o caractere informado não for encontrado, então mostra todo o conteúdo. Se ocorrer algum caractere depois, será apresentado "..." e se o usuário passar o mouse sobre o campo, o valor completo será apresentado.

OBS: Se ambas propriedades forem utilizadas ao mesmo tempo, apresenta até o caractere "X" limitando a "N" caracteres.

validações

  • accept-digit:S/N = define se aceita ou não digitos
  • accept-alpha:S/N = define se aceita caracteres alfabeticos
  • accept-special:S/N = define se aceita caracteres especiais
  • min-length: = define a quantidade minima de caracteres
  • max-length: = define a quantidade maxima de caracteres
CPF do cliente pessoa física.
RG da pessoa física
CNPJ para cliente pessoa jurídica.
Inscrição estadual
Domínio primitivo para representar/implementar atributos do tipo texto.

Propriedades (format)


text-transform

  • uppercase: Transforma o texto para letras maiusculas
  • lowercase: Transforma o texto para letras minúsculas
  • capitalize: Primeiras letras em maiúscula
  • ascii7: Ajusta acentos, cedilhas e outros caracteres especiais para caracteres básicos
  • trim: Remove espaços extras no início e no fim do texto.

ellipsis-in

Indica que deve apresentar apenas "N" primeiros caracteres. Se existir um quarto caractere, será apresentado "..." e se o usuário passar o mouse sobre o campo, o valor completo será apresentado

ellipsis-at

Indica que deve apresentar todos os caracteres até o caractere incluído como parâmetro. Se o caractere informado não for encontrado, então mostra todo o conteúdo. Se ocorrer algum caractere depois, será apresentado "..." e se o usuário passar o mouse sobre o campo, o valor completo será apresentado.

OBS: Se ambas propriedades forem utilizadas ao mesmo tempo, apresenta até o caractere "X" limitando a "N" caracteres.

validações

  • accept-digit:S/N = define se aceita ou não digitos
  • accept-alpha:S/N = define se aceita caracteres alfabeticos
  • accept-special:S/N = define se aceita caracteres especiais
  • min-length: = define a quantidade minima de caracteres
  • max-length: = define a quantidade maxima de caracteres
Código da pessoa que é o representante do cliente.
Indica vendedor do cliente.
Indica a comissão padrão do vendedor
Valor de limite de crédito para compras pelo cliente.
O valor de crédito pode ser considerado como a capacidade de endividamento do cliente junto à empresa, ou o valor máximo a ser devido pelo cliente.
..
Caso o valor seja "zero" ou nulo, o limite de crédito do cliente é ilimitado.
[t]
Valor faturado mensalmente no caso de uma pessoa jurídica ou renda mensal no caso de uma pessoa física.
Percentual de desconto para o cliente.
Indica se a pessoa é um cliente
Indica se a pessoa é um fornecedor.
Indica se é um vendedor
Indica se a pessoa é especializada como representante
Indica o percentual de comissao como representante
Indica se a pessoa é um transportador
Indica a situação da pessoa perante ao sistema.
  • Ativo - A pessoa está ativa e pode ser usada pelo sistema.
  • Inativo - A pessoa não pode ser mais utilizada em novos processos do sistema que exigem pessoas ativas. O registro é mantido para efeito de históricos.
  • Pendente - A situação da empresa ainda não foi avaliada.
Data em que a pessoa foi cadastrada no sistema.
Indica o sexo da pessoa (apenas pessoas físicas).
Deve ser informado apenas F ou M.
Nacionalidade da pessoa
Nome da cidade que a pessoa é natural.
Estado da naturalidade da pessoa
Origem do cadastro, por exemplo: MANUAL, IMPORTAÇÃO, MAILING 2017-10, etc.
Data de início da contratação do colaborador pelo estabelecimento.
Matrícula do colaborador quando a pessoa física for funcionário do estabelecimento.
Usuário que criou o registro da pessoa a ser migrada.

Note que não se trata do usuário que cadastrou ou migrou a pessoa, apenas quem registrou a migração.
Indica o que fazer quando a pessoa já existir (pelo CPF/CNPJ ou código).
  • Atualizar as informações do cadastro agregando as novas informações
  • Não alterar cadastros já existentes
  • Sobrepor as informações com as novas (Não implementado)
Data que foi criado o registro da pessoa a ser migrada.

Note que não se trata da data que a pessoa foi cadastrada ou migrada, apenas quando ela foi registrada na migração.
Ultimo usuário que alterou esta migração.
Data que foi alterado o registro da pessoa a ser migrada.
Define se deve excluir a pessoa que já está importada

Operações

Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Comportamento:Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Comportamento:Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Comportamento:Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Excluir

Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.
Topo

Importar

Funcionalidade que permite importar dados para o bloco desejado.
Comportamento:Topo

Exportar

Funcionalidade que permite exportar os dados de um bloco.
Topo

Migrar

Migra o registro para o Eligo.
Topo

Migrar todos

Migra todos os registros para o telecope
Topo

Alterar todos

A operação "Alterar todos" permite alterar um ou mais campos de vários registros para um valor fixo através de uma única operação. Esta função deve ser usada da seguinte forma:
Topo

Truncar

Limpa todos os dados da base.
Topo

Validar

Valida os dados do registro atual.
Topo

Validar todos

Valida todos os registros selecionados.
Topo

Excluir

Excluir todos os registros selecionados, permitindo excluir também o registro importado.

Configurações

IMPDADOS.IMP_PESSOAS.TAXA_RECONEXAO

Taxa de reconexão

Quando informado, indica que a conexão será fechada e reaberta a cada N registros migrados.
Esta preferência permite aumentar a velocidade da migração em ambientes onde o banco de dados tem perda de performance após sucessivas operações no mesmo objeto de conexão. Para PostgreSQL, sugere-se utilizar o valor 10.
Quando não informado, o sistema não faz a reconexão com o banco.

Tipo: INTEGER

Regras

Ajustar ações conforme contexto

Não é necessário migrar ou validar registros já migrados.
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Alterar"

Apresentar finalidades

Apresentar as finalidades para seleção do usuário.
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Alterar"
  • Antes de apresentar uma tela formulário "Novo"

Preparar caracteristicas

Acrescenta todo os campos de características de pessoa que estão ativos ao formulário especifico.
O usuário deverá ter acesso para edição destas características.
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Alterar"
  • Antes de apresentar uma tela formulário "Importar"
  • Antes de apresentar uma tela formulário "Novo"

Salvar caracteristicas

Eventos que disparam esta regra:
  • Depois de alterar formulário "Alterar"
  • Depois de inserir formulário "Novo"