Entidade PESSOAS

PESSOA.PESSOAS

Descrição

Esta entidade representa uma pessoa de forma ampla, independente de sua relação com o sistema.
Essa pessoa poderá ser uma pessoa física, uma empresa, um grupo de empresas, uma equipe, um cargo, etc.
O contexto onde cada pessoa pode ser usada no sistema depende de regras estebelecidas para o respectivo tipo de pessoa.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK FK Id
Referência para VENDEDORES
PESSOAUPPERRqd UK Pessoa:
Código de identificação da pessoa. Este é um código único (gerado pelo sistema ou informado pelo usuário).
Ver preferencia PESS.SEQ_PESSOAS para maiores detalhes de como este código é gerado.
NOME_COMPLETOUPPERRqd AK Nome completo:
Nome completo da pessoa. Pode existir duas pessoas com o mesmo nome.
  • Para pessoa físicas é a junção de seu primeiro nome + segundo nome + sobrenome + sufixo.
  • Para pessoas jurídicas é a sua razão social. Razão social é o nome devidamente registrado sob o qual uma pessoa jurídica se individualiza e exerce suas atividades. A razão social diferencia-se do nome dado a um estabelecimento ou do nome comercial com que a empresa pode ser reconhecida junto ao público, o qual é conhecido como nome fantasia.
DATA_NASCIMENTODATEData de nascimento:
Para pessoas físicas, indica a data de nascimento.
Para pessoas jurídicas, indica a data de sua fundação.
APELIDOUPPERUK Nome resumido:
Apelido da pessoa.
PRONOME_TRATAMENTO_IDID(18)FK Pronome de tratamento:
Pronome de tratamento da pessoa física.

Referência para PRONOMES_TRATAMENTO
DATA_CADASTRO_PESSOADATEData de cadastro da pessoa:
Data que está pessoa foi cadastrada no sistema.

Valor padrão = [SYSDATE]
DATA_ULTIMA_ATUALIZACAODATE_TIMEData da última atualização:
Data da última atualização para o produto
FONETICA_NOMEUPPERRqd Fonética nome:
Campo com o nome completo da pessoa utilizando a fonética
DATA_FALECIMENTODATEData de falecimento:
Data que a pessoa faleceu (PF) ou encerrou (PJ)
ORIGEM_CADASTROUPPERRqd Origem do cadastro:
Origem do cadastro da pessoa, por exemplo Manualmente, importação, etc.

Valor padrão = MANUAL
USUARIO_CADASTRO_IDID(18)FK Usuário cadastro:
Pessoa que realizou o cadastro da pessoa

Referência para PESSOAS
USUARIO_ULTIMA_ALTERACAO_IDID(18)FK Usuário última alteração:
Usuário que realizou a última alteração do cadastro

Referência para PESSOAS
E_MAIL_1E_MAIL(100)E-Mail:
Principal e-mail de contato da pessoa.
USUARIO_INCLUSAO_IDID(18)Rqd FK Usuário inclusão:
Usuário que incluiu o registro da pessoa.

Valor padrão = [USER_ID]
Referência para USUARIOS
DATA_INCLUSAODATE_TIMERqd Data de inclusão:
Data de inclusão do registro de pessoas.

Valor padrão = [SYSDATE]
USUARIO_ALTERACAO_IDID(18)Rqd FK Usuário alteração:
Usuário da última alteração do registro de pessoas.

Valor padrão = [USER_ID]
Referência para USUARIOS
DATA_ALTERACAODATE_TIMERqd Data de alteração:
Data da última alteração do registro

Valor padrão = [SYSDATE]
IMAGEMATTACHED_IMAGE(250,100)Foto/Imagem:
Quando tipo de pessoa for física assume como sua foto, quando for jurídica assume como seu logotipo
ENDERECO_PRINCIPAL_IDID(18)FK Endereço:
Endereço principal do cliente que é considerado como o primeiro endereço ativo indiferente de tipo

Referência para ENDERECOS
ANO_NASCIMENTOINTEGERAno de nascimento:
Ano de nascimento da pessoa física e que combinado com o dia e mês de aniversário (nascimento) é possível calcular sua idade.
DESCRICAOTEXT_LONGDescrição:
Campo livre para descrição da pessoa.
DIA_ANIVERSARIOINTEGERDia de aniversário:
Dia do mês em que a pessoa física nasceu e que combinado com o mês de nascimento comemora-se anualmente seu aniversário.
MES_ANIVERSARIOMES(2)Mês de aniversário:
Mês do ano em que a pessoa física nasceu e que combinado com o dia de nascimento comemora-se anualmente seu aniversário.
NOME_FANTASIAUPPERNome fantasia:
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.
PRIMEIRO_NOMEUPPERNome:
Primeiro nome da pessoa física.
SEGUNDO_NOMEUPPERSegundo nome:
Segundo nome da pessoa física.
SITUACAOOPCAO(30)Rqd Situação:
Indica a situação da pessoa perante ao sistema.

Valores permitidos:
  • A - Ativo - A pessoa está ativa e pode ser usada pelo sistema.
  • I - 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.
  • P - Pendente - A situação da empresa ainda não foi avaliada.

Valor padrão = P
SOBRENOMEUPPERSobrenome:
Sobrenome ou apelido de família é a porção do nome do indivíduo (pessoa física) que está relacionada com a sua ascendência. Está intimamente ligado ao estudo genealógico.


Na maioria das línguas indo-europeias, o prenome precede o sobrenome (apelido de família) na forma de designar as pessoas. Em algumas culturas e idiomas (por exemplo em húngaro, vietnamita, chinês, japonês ou coreano), o apelido de família precede o prenome na ordem do nome completo.
SUFIXOUPPERSufixo:
Sufixo do nome da pessoa. P.ex.: Júnior, Filho, Neto, Sobrinho, etc.
TIPO_PESSOA_IDID(18)Rqd FK Tipo de pessoa:
Indica o tipo de pessoa relacionado a este registro.

Referência para TIPOS_PESSOAS

Regras

Cálculo do dia e mês de aniversário

(Antes de inserir, Antes de alterar)
Inferência direta através da data de nascimento.

Seqüencia automática

(Antes de inserir)
Caso campo PESSOA não seja informado e a preferência "PESS.SEQ_PESSOAS" esteja preenchida com os seguintes valores:
N -> Não utiliza sequencia automática ( Nome completo será utilizado como chave ).
S -> Sequencia será informada pelo banco utilizando "SEQ_PESSOAS".
MOD10 -> Será utilizado a sequencia "SEQ_PESSOAS", adicionado no no seu final um MOD10() do mesmo.
MOD11 -> Será utilizado a sequencia "SEQ_PESSOAS", adicionado no no seu final um MOD11() do mesmo.

Informar usuário e data da última alteração da pessoa

(Antes de alterar, Antes de inserir)
Informar usuário e data da última alteração da pessoa

Preencher a fonética do nome

(Antes de inserir, Antes de alterar)

Informar usuário e data da inclusão da pessoa

(Antes de inserir)
Informar o usuário e senha que realizaram o cadastro da pessoa

Altera categoria(tipo_categoria, valor)

Altera o valor de uma determinada categoria da pessoa. Se o valor informado for nulo, remove a categoria da pessoa.

Alterar característica(tipo_caracteristica, valor)

Permite alterar o valor de uma característica da pessoa.

Alterar documento(tipo_documento, documento)

Altera, inclui ou exclui o número de um documento da pessoa.
Caso o documento seja nulo ou vazio, então exclui o registro.
Se o documento já foi informado, altera para o novo número.

Atualizar o nome completo da pessoa

(Antes de inserir, Antes de alterar)
Atualiza o nome completo da pessoa. Caso sejam informados os nomes parciais (primeiro nome, sobrenome, etc.).

Busca característica(tipo_caracteristica)

Busca o valor de uma determinada característica da pessoa.

Busca categoria(tipo_categoria)

Retorna o valor de uma determinada categoria da pessoa. Caso a pessoa não tenha informação sobre a categoria, retorna nulo.

Busca consumidor final

Busca a pessoa que representa o consumidor final.

Buscar características

Retorna uma formulário com as características da pessoa.

É Consumidor Final

Retorna se a pessoa é o Consumidor Final ou não

Obter endereços conforme tipo de finalidade do endereço(tipo_finalidade)

Obter os endereços da pessoa na entidade FINALIDADES_ENDERECOS conforme o tipo de finalidade solicitada. P.ex. Retorna o endereço de cobrança ou os endereços de entrega da pessoa.

find endereco

Retornar o endereço principal da pessoa.

get categoria(tipo)

Retorna o id da categoria se a pessoa está liberada para a mesma.

get documento(tipo_documento)

Retornar o documento especificado da pessoa

get E Isento

Retorna se a pessoa é isenta ou não para a receita estadual.
São isentos:
Pessoas físicas e pessoas jurídicas sem inscrição estadual.

get e_mail

Realiza a busca do e-mail

get Endereço(tipos)

Retornar o endereço pesquisado.

Idade

Retorna a idade atual da pessoa (hoje).

Idade em uma determinada data(data)

Retorna a idade da pessoa em uma determinada data qualquer.
A idade é calculada pela diferença dos anos e subtraído 1 no caso do aniversário ainda não ter ocorrido.

É colaborador?

Indica se a pessoa é um colaborador ativo ou não.

Preencher nome curto quando não informado

(Antes de inserir, Antes de alterar)
Quando não for informado um nome curto para a pessoa, o sistema assume o nome completo.

Retorna nome da pessoa

Retorna o nome da pessoa, baseado em uma preferencia PESSOA.TIPO_NOME_RETORNO, esse pode ser apelido/nome fantasia ou nome completo/razão soscial