Pessoas

PESSOAS

Descrição

Sistema para cadastro de pessoas, endereços, documentos. Cadastros de todos os tipos de pessoas utilizados no sistema: clientes, fornecedores, colaboradores, vendedores, motoristas, entre outros.

Procedimentos

Interfaces

Sub-sistemas relacionados

Dúvidas frequentes

Configurações

PESSOAS.ATUALIZACOES_GIS.COTA_DIARIA

Número de atualizações diarias

Número de atualizações diárias para consulta ao WebService do Google Geo.

Tipo: INTEGER

Valor padrão: 2500

PESSOAS.CAD_PESSOAS.ENDERECO_NAO_INFORMADO

Endereço não informad

Define qual será o endereço padrão caso não esteja informado na interface

Tipo: TEXT

PESSOAS.CAD_PESSOAS.EXIBE_MAPA

Define se deve apresentar uma mapa (Google Maps) com a localização do endereço da pessoa.

Tipo: TEXT

Valor padrão: S

PESSOAS.CAD_PESSOAS.FILTROS_CONFIGURAVEIS

Apresenta os filtros configuráveis

Apresenta os filtros configuráveis na interface

Tipo: TEXT

Valor padrão: Clientes:query.id=(SELECT id from clientes WHERE id=query.id) Fornecedores:query.id=(SELECT id from fornecedores WHERE id=query.id) Motoristas:query.id=(SELECT id from motoristas WHERE id=query.id) Transportadores:EXISTS (SELECT 1 from transportadores transp WHERE transp.id=query.id and transp.ativo = 'S') Vendedores:query.id=(SELECT vend.id from vendedores vend WHERE vend.id=query.id and vend.tipo = 'V' and vend.situacao = 'A') Representantes:query.id=(SELECT vend.id from vendedores vend WHERE vend.id=query.id and vend.tipo = 'R' and vend.situacao = 'A') Televendas:query.id=(SELECT vend.id from vendedores vend WHERE vend.id=query.id and vend.tipo = 'T' and vend.situacao = 'A') Colaboradores:query.id=(SELECT id from colaboradores WHERE id=query.id and ativo = 'S') Portos:query.id=(SELECT id from portos WHERE id=query.id) Bancos:query.id=(SELECT id from bancos WHERE id=query.id) Seguradoras:query.id=(SELECT segur.id from seguradoras segur WHERE segur.id=query.id and segur.ativo = 'S') Ensino:query.id in (SELECT instituicao_ensino_id from cursos_instituicoes_ensino WHERE instituicao_ensino_id=query.id) Empresa:query.id in (SELECT empresa_id from registros_empresariais WHERE empresa_id=query.id) Profissional:query.id in (SELECT profissional_id from registros_profissionais WHERE profissional_id=query.id) Contêm IE:query.id=(select dp.pessoa_id from documentos_pessoas dp join tipos_documentos_pessoas td on td.id = dp.tipo_documento_id where dp.pessoa_id = query.id and td.tipo_documento = 'IE') Não contêm IE:query.id=(SELECT distinct dp.pessoa_id FROM documentos_pessoas dp JOIN tipos_documentos_pessoas td ON td.id = dp.tipo_documento_id WHERE dp.pessoa_id NOT IN ( SELECT dp2.pessoa_id FROM documentos_pessoas dp2 JOIN tipos_documentos_pessoas td2 ON td2.id = dp2.tipo_documento_id WHERE td2.tipo_documento = 'IE') and dp.pessoa_id = query.id) Outros:query.id not in (SELECT id from clientes WHERE id=query.id) and query.id not in (SELECT id from fornecedores WHERE id=query.id) and query.id not in (SELECT id from transportadores WHERE id=query.id) and query.id not in (SELECT id from motoristas WHERE id=query.id) and query.id not in (SELECT id from vendedores WHERE id=query.id) and query.id not in (SELECT id from colaboradores WHERE id=query.id)

PESSOAS.CAD_PESSOAS.MOSTRAR_DADOS_SALDOS

Define se apresenta os valores financeiros relacionados à pessoa na tela de visualização.

Tipo: FLAG

Valor padrão: S

PESSOAS.CAD_PESSOAS.NOME_COMPLETO_OBRIGATORIO

Nome completo é obrigatório na inclusão da pessoa

Quando a sequencia de pessoas não for utilizada, por padrão o nome completo/razão social, é opcional; caso marcado o nome completo será obrigatório

Tipo: FLAG

Valor padrão: N

PESSOAS.CAD_PESSOAS.PESQUISA_CNPJ

Fazer pesquisa do CNPJ

Caso essa preferência estiver ativa (com valor "S"), o sistema fará uma pesquisa dos CNPJs que forem informados nos web-services que estiverem configurados e irá preencher o formulário com as informações obtidas.

Tipo: FLAG

PESSOAS.CAD_PESSOAS.PESQUISA_CNPJ_CAMPOS

Indica quais campos devem ser preenchidos a partir do resultado da pesquisa do CNPJ.
Por padrão considera: NOME, FANTASIA, ABERTURA, BAIRRO, LOGRADOURO, NUMERO, COMPLEMENTO, CEP, MUNICIPIO, TELEFONE, EMAIL

Tipo: UPPER

PESSOAS.CAD_PESSOAS.PESQUISA_RAPIDA_DOCUMENTO

Configura a pesquisa rápida de um documento

Habilita/desabilita a pesquisa rápida pelo número do documento.

  • Habilitado = é necessário digitar sempre o documento com caracteres de separação, por exemplo "ponto", ou CPF ou CNPJ completos sem separador.
  • Desabilitado = permite a pesquisa de qualquer parte de qualquer documento, a rotina remove automaticamente os caracteres de separação, por exemplo "ponto", "barra", "hífen". Cuidado ao desativar a "pesquisa rápida", o sistema não utilizará índices.

Tipo: FLAG

PESSOAS.CAD_PESSOAS.PESS.CAD_PESS.TIPO_PESSOA_DEFAULT

Define o tipo de pessoa padrão para apresentação de dados nas telas de inclusão de cadastro de nova pessoa.
Valores permitidos:
Física
Jurídica

Tipo: TEXT

Valor padrão: Jurídica

PESSOAS.CAD_PESSOAS.PESSOAS.CAD_PESSOAS.ETIQUETA_FINALIDADE_ENDERECO

Finalidades de endereços para filtrar os endereços que devem ser listados nas etiquetas.

Valor padrão: CORRESP

PESSOAS.CAD_PESSOAS.QTD_REGISTROS_ATUALIZAR

Define quantos N registros de pessoas deverão ser atualizados ao executar a rotina "Atualizar situação CNPJs antigos".
Caso não configurada, considera por padrão 3 registros, pois é o limite de consultas por minuto que a API aceita é 3.

Tipo: TEXT

PESSOAS.CAD_PESSOAS.RESTRINGIR_TIPO_PESSOA

Define que o tipo de pessoa será especificado pelo parâmetro P_TIPO_PESSOA informado na chamada da interface pelo menu.
Para restringir a interface somente para o cadastro de pessoas físicas deve ser definido no campo "Parâmetros" da opção de menu o valor P_TIPO_PESSOA=Física.
Não será a feita restrição caso o parâmetro não seja especificado no menu.

Tipo: TEXT

Valor padrão: N

PESSOAS.CAD_PESSOAS.SITUACOES_ATUALIZACAO_CNPJ

Indica para qual situação deve ser atualizada a pessoa de acordo com a situação no SEFAZ, se a situação SEFAZ não constar na configuração da preferência, não faz nada.

Deve ser informado uma situação SEFAZ por linha no formato:
ATRIBUTO=VALOR

Por padrão considera:
ATIVA=A
SUSPENSA=I
INAPTA=I
BAIXADA=I
NULA=I
INATIVA=I

Na configuração padrão, se a situação SEFAZ for SUSPENSO, por exemplo, o cadastro da pessoa irá passar para inativo.

Tipo: TEXT_LONG

PESSOAS.CAD_PESSOAS.SQL_DEBITOS_PESSOA

SQL para apresentação dos debitos da pessoa

Permite definir um SQL a ser utilizado para apresentar as informações do campo "Valor de débitos" (títulos a receber) da pessoa.

Macros:
  • ${id}: ID do registro da pessoa (não é o código da pessoa).
  • ${usuario_id}: ID do usuário logado que está acessando o cadastro da pessoa.
  • ${estabelecimento_id}: Estabelecimento padrão do usuário logado que está acessando o cadastro da pessoa.

Tipo: SOURCE_CODE

PESSOAS.CAD_PESSOAS.SQL_ENDERECOS_MEIOS_CONTATOS

SQL para apresentar os endereços da pessoa

SQL utilizado para apresentar os endereços eletrônicos da pessoa em forma de tabela para apresentação nas telas de list e view. Caso não informado, assume o seguinte script:

item contato text;
item forma text_html;
item obs text;
set heading off;
select te.titulo as contato
, case when te.dominio = 'ADSRT.E_MAIL'
then ''|| e.endereco || '
'
else e.endereco || '
' end as forma
, e.observacoes as obs
from enderecos e
join tipos_enderecos te on e.tipo_endereco_id = te.id
where e.pessoa_id = ${pessoa_id}
and te.tipo_enderecamento = 'E'
order by te.tipo_endereco, e.sequencia

Tipo: SOURCE_CODE

PESSOAS.CAD_PESSOAS.SQL_INFORMACOES_ADICIONAIS

Apresentar informações adicionais

SQL utilizado para apresentar informações adicionais da pessoa. É utilizado o sql abaixo como padrão:

select tp.tipo_pedido as \"Tipo de pedido\"
, count(p.id) as \"Qtd. pedidos em aberto\"
, sum(quantidade_pendente*preco) as \"Total\"
from itens_pedidos it
inner join pedidos p on p.id = it.pedido_id
inner join tipos_pedidos tp on tp.id = p.tipo_pedido_id
inner join produtos prod on prod.id = it.produto_id
where
it.situacao = 'P'
and p.cliente_id = " + rec.valueOfId()
and p.situacao not in ('C','E','A')
group by tp.tipo_pedido

Tipo: SOURCE_CODE

PESSOAS.CAD_PESSOAS.SQL_SUGESTAO_ESTABELECIMENTOS

Sql sugestão de estabelecimento

Apresenta o sql que será utilizado como sugestão de estabelecimento

Tipo: TEXT

PESSOAS.CAD_PESSOAS.TIPO_ENDERECO_EMAIL_NFE_ID

Tipo de endereço a ser utilizado para EMAIL_NFE na importação

Configura o ID do tipo de endereço a ser utilizado nos e-mails informados no campo E_MAIL presenta na operação de importação.

A operação de importação de pessoas não utiliza os tipos de endereços definidos por configuração para o tipo de pessoa.

Caso não configurado, assume o ID do primeiro tipo de endereço que contem as palavras EMAIL e NFE.

Tipo: ID

PESSOAS.CAD_PESSOAS.TIPO_ENDERECO_EMAIL_PROFISSIONAL_ID

Tipo de endereço a ser utilizado para EMAIL_PROFISSIONAL na importação

Configura o ID do tipo de endereço a ser utilizado nos e-mails informados no campo EMAIL_PROFISSIONAL presente na operação de importação.

A operação de importação de pessoas não utiliza os tipos de endereços definidos por configuração para o tipo de pessoa.

Caso não configurado, assume o ID do primeiro tipo de endereço que contem as palavras EMAIL e PROFISSIONAL.

Tipo: ID

PESSOAS.DOCUMENTOS_PESSOAS.VALIDAR_INSCRICAO_ESTADUAL

Validar inscrições estaduais

Define se as inscrições estaduais informadas no cadastro de pessoas deverá passar por um teste de validação ou não.

Tipo: FLAG

PESSOAS.ENDERECOS.ADICIONAR_FILA_GIS

Define se novos endereços ou endereços alterados deverão ser incluídos na fila para processamento da sua localização geográfica (coordenadas de longitude e latitude).

Tipo: FLAG

Valor padrão: N

PESSOAS.ENDERECOS.ATUALIZAR_DOCUMENTOS_MANUTENCAO_PENDENTE

Atualizar documentos que estão na situação de manutenção e pendentes

Atualizar documentos que estão na situação de manutenção e pendentes

Tipo: FLAG

Valor padrão: S

PESSOAS.ENDERECOS.BUSCA_CEP_MECANISMOS

Definição da ordem e dos dos mecanismos utilizados para a busca dos CEPs

Define a ordem e os mecanismos de buscas que serão utilizados para buscar o endereço baseado no CEP informado.
Os valores são:

  • CACHE: Usa as pesquisas já realizades, evitando fazer pesquisas desnecessárias.
  • CORREIOS: Usa os servidores dos Correios.
  • VIACEP: Alternativa open source para busca de informações sobre endereço.

Valor padrão CACHE,CORREIOS,VIACEP

Tipo: TEXT

Valor padrão: CACHE,CORREIOS,VIACEP

PESSOAS.ENDERECOS.MECANISMO_BUSCA_CEP

Mecanismo de busca de endereços a partir do CEP informado

Define o mecanismo de busca do CEP, utilizado no cadastro de pessoas.
As opções disponíveis são:

  • ALFRED: Utiliza a library AlfredLibrary.
  • CORREIOS: Utiliza o integrador dos Correios.

Tipo: UPPER

Valor padrão: ALFRED

PESSOAS.ENDERECOS.PERMITE_FRETE_ENDERECO

Permite informar frete por endereço

Caso marcado define que é permitido o frete por endereço. A preferência pode ser por estabelecimento para determinar o uso, mas o campo é apresentado somente caso permitido na preferência padrão

Valores:
  • N: Não permite valor de frete ou tabela de fretes por endereço
  • T: Permite informar tabela de fretes por endereço
  • V: Permite informar valor fretes por endereço
  • S: Permite informar valor ou tabela de fretes por endereço

Tipo: OPTION

Valor padrão: N

PESSOAS.ENDERECOS.VALIDAR_EMAIL_UNICO_USUARIO

Validar endereço de e-mail único para usuários

Define se o mesmo endereço de e-mail poderá estar vinculado a mais de um usuário, simultaneamente.

  • Marcado: Não permite informar o mesmo endereço de e-mail para mais de uma pessoa que seja usuário do sistema, ou seja, não podem existir dois usuários com o mesmo e-mail.
  • Desmarcado: Permite informar o mesmo endereço de e-mail para mais de uma pessoa que seja usuário do sistema.

Tipo: FLAG

Valor padrão: S

PESSOAS.ENDERECOS.VALIDAR_ENDERECOS_JA_CADASTRADOS

Define se deve validar os endereços já cadastrados

DEPRECIADO - VERIFICAR ATRIBUTO "UNICO" NO TIPO DE ENDERECO

Quando marcado, indica que o sistema não irá permitir o cadastramento de 2 endereços iguais para a mesma pessoa. Caso não informada, o sistema assume que fará o bloqueio.

Tipo: FLAG

Valor padrão: S

PESSOAS.PRO_ETIQUETA_PASTA_PESSOA.CATEGORIA_ID

Categoria de pessoa

ID da categoria de pessoa que deverá ser vinculado ao executar a impressão de etiqueta

Tipo: ID

PESSOAS.PRO_ETIQUETA_PASTA_PESSOA.QUANTIDADE_DIGITOS

Quantidade de dígitos no código da pessoa

Quantidade de dígitos utilizado na geração do código da pessoa

Tipo: INTEGER

Valor padrão: 4

PESSOAS.USAR_TIPOS_ENDERECOS_PESSOAS

Usar tipos de endereços por tipo de pessoa

Quando marcado, indica que o sistema deverá utilizar os meios de contato das pessoas conforme definido em Tipos de endereços por tipos de pessoas.

Tipo: FLAG