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 (único) de identificação da pessoa (física ou jurídica).
TIPO_PESSOA_IDID(18)Rqd FK Tipo de pessoa:
Indica o tipo de pessoa relacionado a este registro.

Referência para TIPOS_PESSOAS
NOME_COMPLETOUPPERRqd AK Nome completo:
Nome completo da pessoa física ou razão social da pessoa jurídica. 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.
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.
DATA_NASCIMENTODATEData de nascimento:
Para pessoas físicas, indica a data de nascimento.
Para pessoas jurídicas, indica a data de sua fundação.
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.
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.
NACIONALIDADE_IDID(18)FK Nacionalidade:
Indica o país de nascimento de uma pessoa ou o país onde se adquiriu naturalização. Caso não informado, o sistema irá assumir o país da naturalidade.

Referência para PAISES
NATURALIDADE_IDID(18)FK Naturalidade:
Indica a cidade de onde a pessoa nasceu.

Referência para CIDADES
APELIDOUPPERApelido:
Designação informal para identificar a pessoa. P.ex.: Somente o sobrenome, nome resumido ou apelido (alcunha) da pessoa física.

Exemplos:
  • PAULINHO
  • RIBEIRO
  • PEDRÃO
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 em que esta 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_NOMEUPPERFoné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:
Indica onde este cadastro foi originado. Meramente informativo. Por exemplo: MANUAL, IMPORTAÇÃO, MAILING 2017-10, etc.

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

Valor padrão = [PERSON_ID]
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

Valor padrão = [PERSON_ID]
Referência para PESSOAS
E_MAIL_1E_MAIL(100)E-Mail:
Principal e-mail de contato da pessoa.
USUARIO_INCLUSAO_IDID(18)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)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 físico ativo indiferente de tipo.

Referência para ENDERECOS
MOTIVO_INATIVACAO_IDID(18)FK Motivo da inativação:
Motivo da inativação ou do cancelamento do cadastro da pessoa.

Referência para MOTIVO_CANCELAMENTOS_DEVOLUCOES
DATA_INATIVACAODATEData de inativação:
Data de inativação ou cancelamento do cadastro da pessoa.
REGIME_TRIBUTACAO_IDID(18)FK Regime de tributação:
Regime de tributação em que a pessoa está enquadrada.
P.ex.:
  • GERAL: Para empresas enquadradas no Lucro real, Lucro presumido e Regime especial.
  • SIMPLES: Para empresas enquadradas no Simples Nacional (MEI, ME, etc).

Esta informação poderá ser utilizada em diversos processos do sistema.
P.ex.:
  • Calcular preços de venda.
  • Definir regras tributárias nas operações de venda.

Exemplos:
  • SIMPLES NACIONAL
  • LUCRO REAL
  • LUCRO PRESUMIDO
  • GERAL
  • SIMPLES
  • MEI

Referência para REGIMES_TRIBUTACOES
RAMO_ATIVIDADE_IDID(18)FK Ramo de atividade principal:
Ramo de atividade principal da empresa.

Referência para RAMOS_ATIVIDADES
TODOS_ESTABELECIMENTOSFLAG(1)Rqd Todos estabelecimentos:
Define se o cadastro da pessoa será compartilhado por todos os estabelecimentos ou somente para determinados estabelecimentos.
Caso desmarcado, será necessário indicar quais os estabelecimentos que terão acesso a este cadastro.

Valor padrão = S
DATA_REVISAO_CADASTRODATEData de revisão do cadastro:
Data da última vez em que as informações do cadastro foram revisadas.
DESCRICAOTEXT_LONGObservações:
Campo livre para observações diversas sobre a pessoa.
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(1)Rqd Situação:
Situação do cadastro da pessoa.

Valores permitidos:
  • A - Ativo - A pessoa está ativa e pode ser utilizada em novos processos do sistema.
  • I - Inativo - A pessoa está inativa e não pode ser mais utilizada em novos processos do sistema que exigem pessoas ativas ou pendentes. O registro é mantido para efeito de histórico.
  • P - Pendente - O cadastro da pessoa não foi avaliado e verificado, mas a pessoa pode ser mais utilizada em novos processos do sistema que exigem pessoas ativas ou pendentes.

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.

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.

Sequência automática

(Antes de inserir)
Caso campo PESSOA não seja informado e a preferência PESS.SEQ_PESSOAS - ERROR: Não foi possível encontrar um registro em COMPONENTES onde NOME_GLOBAL = PESS.SEQ_PESSOAS! esteja preenchida com os seguintes valores:
N -> Não utiliza sequência automática (nome completo será utilizado como chave).
S -> Sequência será informada automaticamente utilizando a sequência SEQ_PESSOAS.
MOD10 -> Será utilizado a sequência SEQ_PESSOAS, adicionado no no seu final um MOD10() do mesmo.
MOD11 -> Será utilizado a sequência 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)

Atualizar a situação

(Antes de alterar)
Quando informado a data de inativação para pessoa, deve ser informado a situação como inativa.

Alterar característica(tipo_caracteristica, valor)

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

Alterar 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 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 um formulário com as características da pessoa.

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. Retorna o primeiro e-mail cujo tipo de endereço começa com "EMAIL".

Buscar endereços (tipos)

Retornar o endereço informado no parâmetro. Essa rotina é útil para endereços eletrônicos ou outros formas de contato, diferentes dos endereços físicos, tais como e-mails, telefones, websites, etc.

A pesquisa retorna apenas o primeiro que atende aos tipos de endereços selecionados.

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.

É Consumidor Final

Retorna se a pessoa é o Consumidor Final ou não.
Ver preferência: PESSOA.CONSUMIDOR_FINAL_ID.

Montar formulário

Monta um formulário com todas as informações de contato que uma pessoa pode ter (independente do tipo de pessoa).

Preencher apelido ou nome fantasia conforme o tipo de pessoa

(Antes de inserir, Antes de alterar)

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

Retornar ID

Retorna a identificação padrão da pessoa, formada pelo nome completo seguido de seu código entre parênteses:
FULANO DA SILVA (pessoa 123)

Retornar telefones(is_apresenta_tipo_endereco)

Retorna todos os telefones da pessoa, separados por vírgulas.

Salvar contato(contato, tipo_endereco_id, sequencia)

Permite salvar contatos da pessoa (telefone, e-mail, etc).

uk String

Retornar o valor da chave única formatada