TFA001 — Pessoas Físicas / Jurídicas
Fonte
- Form:
source/TFA001/UTFA001.pas - DataModule:
source/TFA001/UdmTFA001.pas - Arquivos auxiliares:
UDirTFA001Arquivo.pas,UIMPORTACAOCNPJCPF.pas,URelTFA001.pas
Objetivo
Cadastro central de Pessoas Físicas e Jurídicas do ERP, funcionando como entidade-raiz para clientes, fornecedores, transportadores, vendedores e qualquer outro papel que uma pessoa desempenhe no sistema. Mantém dados gerais (PESSOA), endereços (ENDERECOPESSOA), dados físicos (PESSOAFISICA), contas bancárias (CONTACORPESSOA), sócios (PESSOASOCIO), referências comerciais (REFERENCIAPESSOA), documentos (PESSOADOCUMENTO), condições de pagamento liberadas (PESSOACONDPAGTO), formas de pagamento (PESSOAFORMAPAGTO), inscrições estaduais substitutas (PESSOAINSCRICAO), perfis (PESSOAPERFIL), vendedores vinculados (PESSOAVENDEDOR), séries de NF por empresa (PESSOASERIENF) e regiões/áreas comerciais. Integra validação automática de CEP via jViaCep e importação de dados cadastrais via CNPJ/CPF.
Funcionalidades
- Cadastro de Dados Básicos da Pessoa
- Gerenciamento de Endereços
- Dados de Pessoa Física
- Referências Comerciais/Pessoais
- Vendedores/Representantes
- Bens da Pessoa
- Contas Bancárias
- Sócios
- Observações
- Inscrições Estaduais Substitutas
- Condições de Pagamento
- Formas de Pagamento
- Documentos
- Perfis
- Imagem/Foto
- Representante/Preposto
- Dados Adicionais
- Dados Recapadora
Descricao de cada campo
| Campo | Label UI | Tipo | Obrigatório | Regra / Default |
|---|---|---|---|---|
| CD_PESSOA | Código | Identificador único da pessoa no sistema | ||
| NR_CNPJCPF | CNPJ/CPF | Documento de identificação fiscal - obrigatório, validado automaticamente | ||
| NM_PESSOA | Nome | Razão social ou nome completo - obrigatório | ||
| NM_FANTASIA | Nome Fantasia | Nome comercial ou apelido | ||
| CD_TIPOPESSOA | Tipo Pessoa | Classificação (Cliente, Fornecedor, Funcionário, etc.) - F9 para buscar | ||
| ST_ATIVA | Status Ativa | S=Ativa, N=Inativa | ||
| DS_EMAIL | Endereço eletrônico - validado formato | |||
| DS_SITE | Site | Endereço do website | ||
| DT_CADASTRO | Data Cadastro | Data de inclusão no sistema - obrigatório | ||
| DT_NASCIMENTO | Data Nascimento/Abertura | Para pessoa física = nascimento, jurídica = abertura | ||
| PC_COMISSAOVISTA | Comissão Vista | Percentual de comissão para vendas à vista | ||
| PC_COMISSAOPRAZO | Comissão Prazo | Percentual de comissão para vendas a prazo | ||
| ST_REVENDAIPI | Revenda IPI | Indica se é revendedor para fins de IPI | ||
| ST_SCPC | SCPC | Status de consulta ao SCPC | ||
| CD_ENDERECO | Código Endereço | Sequencial do endereço para a pessoa | ||
| NR_CEP | CEP | Código de endereçamento postal | ||
| CD_MUNICIPIO | Município | Código IBGE do município - F9 para buscar | ||
| DS_ENDERECO | Endereço | Logradouro completo | ||
| NR_ENDERECO | Número | Número do endereço | ||
| DS_COMPLEMENTO | Complemento | Informações adicionais | ||
| DS_BAIRRO | Bairro | Nome do bairro | ||
| TP_ENDERECO | Tipo Endereço | C=Comercial, R=Residencial, E=Entrega, B=Cobrança | ||
| NR_INSCEST | Inscrição Estadual | Número da IE ou ISENTO | ||
| CD_CONDFISCAL | Condição Fiscal | Regime tributário - F9 para buscar [TFI001] | ||
| ST_CONTRIBUINTE | Contribuinte | 1=Contribuinte, 2=Isento, 9=Não Contribuinte | ||
| CD_VENDEDOR | Vendedor | Vendedor responsável - F9 para buscar | ||
| CD_REGIAOCOMERCIAL | Região Comercial | Área de atuação comercial | ||
| CD_CONDPAGTO | Condição Pagamento | Condição padrão - F9 para buscar | ||
| CD_FORMAPAGTO | Forma Pagamento | Forma padrão - F9 para buscar | ||
| CD_TRANSPORTADOR | Transportador | Transportadora padrão | ||
| NR_TELEFONE | Telefone | Número de telefone fixo | ||
| NR_CELULAR | Celular | Número de celular | ||
| NR_FAX | Fax | Número de fax | ||
| NR_DISTANCIA | Distância | Distância em km da empresa | ||
| DS_CONTATO | Contato | Informações de contato | ||
| NR_INCRA | INCRA | Número do INCRA para produtores rurais | ||
| NR_SUFRAMA | SUFRAMA | Número SUFRAMA para Zona Franca | ||
| NR_INSCMUN | Inscrição Municipal | Número da inscrição municipal | ||
| NR_INSCPRODUTOR | Inscrição Produtor | Inscrição de produtor rural | ||
| NR_RENASEM | RENASEM | Registro de sementes | ||
| NR_RG | RG | Número do documento de identidade | ||
| DT_EMISSAORG | Data Emissão RG | Data de emissão do RG | ||
| SG_ESTADORG | Estado RG | UF de emissão do RG | ||
| NR_CARTEIRA | Carteira Trabalho | Número da CTPS | ||
| DT_EMISSAOCARTEIRA | Data Emissão Carteira | Data de emissão da CTPS | ||
| NR_TITULOELEITOR | Título Eleitor | Número do título de eleitor | ||
| NR_CARTEIRAHABILITACAO | CNH | Número da carteira de habilitação | ||
| NR_CPF | CPF | CPF adicional (diferente do principal) | ||
| DS_NATURALIDADE | Naturalidade | Cidade de nascimento | ||
| DS_ESTADOCIVIL | Estado Civil | Situação conjugal | ||
| NM_PAI | Nome do Pai | Filiação paterna | ||
| NM_MAE | Nome da Mãe | Filiação materna | ||
| NR_DEPENDENTES | Dependentes | Quantidade de dependentes | ||
| DS_LOCALTRAB | Local Trabalho | Nome da empresa empregadora | ||
| DS_ENDERTRAB | Endereço Trabalho | Endereço do emprego | ||
| NR_FONETRAB | Telefone Trabalho | Telefone comercial | ||
| DT_ADMISSAO | Data Admissão | Data de início no emprego | ||
| VL_SALARIO | Salário | Valor do salário atual | ||
| DS_FUNCAO | Função | Cargo ou função | ||
| DS_HORARIOTRABALHO | Horário Trabalho | Horário de expediente | ||
| NR_PLANOSAUDE | Plano Saúde | Número do plano de saúde | ||
| DT_VENCTOPLANOSAUDE | Vencto Plano Saúde | Validade do plano | ||
| NM_CONJUGE | Nome Cônjuge | Nome completo | ||
| DT_NASCONJUGE | Data Nascimento | Data de nascimento | ||
| NR_RGCONJ | RG Cônjuge | Documento de identidade | ||
| NR_CARTEIRACONJ | Carteira Cônjuge | CTPS do cônjuge | ||
| DS_LOCTRABCONJ | Local Trabalho | Emprego do cônjuge | ||
| DT_ADMISCONJ | Admissão Cônjuge | Data de admissão | ||
| VL_SALCONJ | Salário Cônjuge | Remuneração | ||
| DS_ENDCONJ | Endereço Trabalho | Endereço do trabalho | ||
| NR_FONECONJ | Telefone Cônjuge | Telefone de contato | ||
| NR_REFERENCIA | Número Referência | Sequencial da referência | ||
| TP_REFERENCIA | Tipo Referência | C=Comercial, B=Bancária, P=Pessoal | ||
| DS_REFERENCIA | Descrição | Detalhamento da referência | ||
| NM_REFERENCIA | Nome Referência | Nome do contato ou empresa | ||
| DS_ENDREFER | Endereço | Endereço da referência | ||
| CD_MUNICREFER | Município | Cidade da referência - F9 para buscar | ||
| NR_FONEREFER | Telefone | Número para contato | ||
| NR_IERG | IE/RG | Inscrição estadual ou RG | ||
| DS_INFORMACOES | Informações | Observações adicionais | ||
| DT_NASCIMENTO_REF | Data Nascimento | Data de nascimento da referência | ||
| MES_REFE | Mês Referência | Mês de aniversário | ||
| NM_VENDEDOR | Nome Vendedor | Nome do vendedor (preenchido automaticamente) | ||
| CD_TIPO | Tipo | Classificação do vendedor | ||
| CD_BEM | Código Bem | Identificador sequencial | ||
| DS_BEM | Descrição | Descrição detalhada do bem | ||
| NR_CEPBEM | CEP | CEP da localização do bem | ||
| DS_ENDERECOBEM | Endereço | Endereço onde se encontra | ||
| NR_ENDERECOBEM | Número | Número do endereço | ||
| DS_BAIRROBEM | Bairro | Bairro da localização | ||
| CD_MUNICIPIOBEM | Município | Cidade do bem - F9 para buscar | ||
| ST_LIVREONUS | Livre de Ônus | S=Sim, N=Não - indica se está livre de dívidas | ||
| ST_NOMECLIENTE | Nome do Cliente | S=Sim, N=Não - se está no nome do titular | ||
| CD_BANCO | Banco | Código do banco - F9 para buscar | ||
| DG_BANCO | Dígito Banco | Dígito verificador | ||
| CD_AGENCIA | Agência | Número da agência - F9 para buscar (requer banco informado) | ||
| DG_AGENCIA | Dígito Agência | Dígito verificador | ||
| NR_CONTACOR | Conta Corrente | Número da conta | ||
| DG_CONTACOR | Dígito Conta | Dígito verificador | ||
| ST_FOLHAPAGAMENTO | Folha Pagamento | Se é conta para folha | ||
| ST_CONTAPAGTO | Conta Pagamento | Se é conta para pagamentos | ||
| TP_CHAVEPIX | Tipo Chave PIX | Tipo da chave (CPF, CNPJ, Email, Telefone, Aleatória) | ||
| DS_CHAVEPIX | Chave PIX | Valor da chave PIX | ||
| CD_PESSOATITULAR | Pessoa Titular | Titular da conta se diferente | ||
| CD_PESSOASOCIO | Pessoa Sócio | Código da pessoa sócia - F9 para buscar | ||
| CD_TIPOSOCIO | Tipo Sócio | Classificação do sócio | ||
| PC_CAPITALSOCIAL | Capital Social | Percentual de participação | ||
| VL_CAPITALSOCIAL | Valor Capital | Valor em reais do capital | ||
| ST_RESPONSAVEL | Responsável | Se é o responsável legal | ||
| DT_ENTRADA | Data Entrada | Data de ingresso na sociedade | ||
| DT_SAIDA | Data Saída | Data de desligamento (se aplicável) | ||
| DS_OBSERVACAO | Observação Geral | Texto livre para anotações gerais | ||
| DS_OBSFINANCEIRO | Observação Financeira | Notas sobre situação financeira | ||
| ST_PRECO | Tabela de Preço | Política de preço especial | ||
| CD_EMPRCADASTRO | Empresa Cadastro | Empresa que fez o cadastro | ||
| NR_LICENSA | Licença | Número da licença | ||
| DT_VALLICENSA | Validade Licença | Data de validade | ||
| NR_PROTOCOLO | Protocolo | Número do protocolo | ||
| DT_VALPROTOCOLO | Validade Protocolo | Data de validade do protocolo | ||
| SG_ESTADO | Estado | Sigla da UF - validado automaticamente | ||
| DS_ESTADO | Descrição Estado | Nome do estado (preenchido automaticamente) | ||
| DS_CONDPAGTO | Descrição | Nome da condição (preenchido automaticamente) | ||
| DS_FORMAPAGTO | Descrição | Nome da forma (preenchido automaticamente) | ||
| NR_SEQUENCIA | Sequência | Número sequencial do documento | ||
| NM_DOCUMENTO | Nome Documento | Nome/descrição do arquivo | ||
| BI_DOCUMENTO | Documento | Arquivo binário armazenado | ||
| DS_DOCUMENTO | Descrição | Observações sobre o documento | ||
| CD_PERFIL | Perfil | Código do perfil - F9 para buscar | ||
| DS_PERFIL | Descrição | Nome do perfil (preenchido automaticamente) | ||
| BI_FOTO | Foto | Imagem armazenada | ||
| DS_IMAGEMEXTENSAO | Extensão | Formato do arquivo | ||
| CD_REPRESENTANTE | Representante | Código do representante - F9 para buscar | ||
| CD_PREPOSTO | Preposto | Código do preposto - F9 para buscar | ||
| CD_MARCA | Marca | Marcas representadas - F9 para buscar no grid | ||
| CD_USUARIOCAD | Usuário Cadastro | Quem cadastrou | ||
| DT_ULTIMAAVALIACAO | Data Última Avaliação | Quando foi avaliado | ||
| DT_PROXIMAAVALIACAO | Data Próxima Avaliação | Próxima revisão | ||
| VL_ULTIMAAVALIACAO | Valor Última Avaliação | Score/valor anterior | ||
| VL_PENULTIMAAVALIACAO | Valor Avaliação Atual | Score/valor atual | ||
| TP_PEDFATURRECAP | Tipo Ped/Fatur | S=Serviço, P=Produto, X=Misto | ||
| TP_SERVICOCONSERTO | Tipo Serviço Conserto | P=Pneu, S=Serviço | ||
| ST_ETIQUETA | Etiqueta | Se usa etiqueta especial | ||
| SG_UNIDMEDFATRECAP | Unid. Medida Fatur | Unidade para faturamento | ||
| PC_PRODUTOFATRECAP | % Produto Fatur | Percentual para faturamento misto | ||
| ST_QTFATPRODUTORECAP | Qt Fatur Produto | F=Fixo, V=Variável | ||
| NR_LIMITEMANCHAORECAP | Limite Manchão | Limite de manchões | ||
| ST_EMITECTERECAP | Emite CT-e | Se emite conhecimento de transporte | ||
| TP_BLOQORCAMENTORECAP | Bloq. Orçamento | Tipo de bloqueio | ||
| ST_FATURACARCACAAUTO | Fatura Carcaça Auto | Se fatura automaticamente | ||
| DS_OBSERVACAOPRODRECAP | Observação Produção | Notas para produção | ||
| CD_RAMOATIVIDADE | Ramo Atividade | Segmento do cliente | ||
| ST_TROCADESENHO | Troca Desenho | Configuração de troca de desenho |
Perguntas Frequentes
Perguntas Gerais
P: Qual é a finalidade da tela TFA001? R: A tela TFA001 é o Cadastro de Pessoa do sistema. Nela é possível registrar e gerenciar informações completas de clientes, fornecedores e prestadores de serviço, incluindo dados pessoais, endereços, informações financeiras, referências comerciais, contas bancárias, sócios, bens, perfis, documentos e observações. A tela centraliza todo o gerenciamento do cadastro de pessoas utilizado nos demais módulos do sistema.
P: Como cadastrar uma nova Pessoa no sistema? R: Para cadastrar uma nova Pessoa, acesse a tela TFA001 e clique no botão de inclusão (Novo). Preencha os campos obrigatórios, tais como: Tipo da Pessoa, CPF/CNPJ, Nome/Razão Social, ao menos dois Endereços, ao menos um Vendedor, ao menos um Perfil, ao menos um Documento e a Condição de Pagamento. Após preencher todos os dados necessários nas diversas abas disponíveis (Endereço, Pessoa Física/Jurídica, Referências, Contas Correntes, Sócios, Bens, Perfis, Documentos, entre outras), clique em Salvar para gravar o registro.
P: Como utilizar a integração com SPC/SEPROC? R: A integração com SPC/SEPROC permite consultar a situação cadastral e de crédito da pessoa diretamente pelo sistema. Para utilizá-la, acesse o cadastro da pessoa desejada na tela TFA001 e utilize a funcionalidade de consulta SPC/SEPROC disponível na interface. O sistema realizará a comunicação com o serviço externo e retornará as informações de crédito e pendências financeiras associadas ao CPF ou CNPJ informado. Certifique-se de que os parâmetros de conexão com o serviço estejam devidamente configurados.
P: Quais são os atalhos de teclado disponíveis na tela TFA001? R: A tela TFA001 disponibiliza os seguintes atalhos de teclado para agilizar a operação:
- F2 - Novo registro / Inclusão
- F3 - Alterar registro
- F4 - Excluir registro
- F5 - Salvar registro
- F6 - Cancelar operação
- F7 - Consultar / Pesquisar
- F8 - Imprimir
- F9 - Primeiro registro
- F10 - Registro anterior
- F11 - Próximo registro
- F12 - Último registro
Mensagens de Confirmação
P: O que significa a mensagem "Deseja Salvar as Alterações Antes de Sair?" (A-1640)? R: Esta mensagem de confirmação é exibida quando o usuário tenta fechar a tela do Cadastro de Pessoa e existem alterações pendentes que ainda não foram salvas. Clique em "Sim" para salvar as alterações antes de sair, ou em "Não" para descartar as modificações realizadas.
P: O que significa a mensagem "Deseja Excluir o Registro?" (C-0045)? R: Esta mensagem de confirmação é exibida quando o usuário solicita a exclusão de um registro de Pessoa. Ao confirmar clicando em "Sim", o registro será removido permanentemente do banco de dados. Caso não deseje excluir, clique em "Não" para cancelar a operação.
P: O que significa a mensagem "Deseja Realmente Excluir a Imagem?" (C-1615)? R: Esta mensagem de confirmação é exibida quando o usuário solicita a remoção da imagem (foto) associada ao cadastro da Pessoa. Ao confirmar, a imagem será removida do registro. Clique em "Não" caso deseje manter a imagem.
Mensagens de Validação e Erros
P: O sistema apresenta erro informando que não possuo permissão para acessar determinada funcionalidade. Como resolver? R: Este tipo de erro ocorre quando o usuário não possui as permissões necessárias configuradas no módulo de Permissões de Acesso (TFA008). As permissões são controladas individualmente para cada funcionalidade do Cadastro de Pessoa, incluindo: Pessoa, Endereço, Pessoa Física, Referência, Vendedor, Bem, Conta Corrente, Sócio, Observação, Observação Financeira, Inscrição Substituta, Condição de Pagamento, Documento, Perfil, Marca Representada e Forma de Pagamento. Solicite ao administrador do sistema que verifique e conceda as permissões adequadas na tela TFA008.
P: O que significa a mensagem "O Cadastro da Pessoa precisa ter mais do que um Endereço!"? R: Esta mensagem indica que o cadastro da Pessoa requer no mínimo dois endereços cadastrados. Acesse a aba de Endereços e inclua ao menos dois registros de endereço distintos para a pessoa antes de salvar o cadastro.
P: O que significa a mensagem "Esta Pessoa está com o Cadastro Bloqueado! Verifique [TFA049]"? R: Esta mensagem indica que a pessoa consultada está com o cadastro bloqueado no sistema. Não é possível realizar alterações enquanto o bloqueio estiver ativo. Para verificar o motivo do bloqueio e eventualmente removê-lo, acesse a tela de Bloqueio de Cadastro (TFA049) ou entre em contato com o responsável pela administração dos cadastros.
P: O sistema apresenta erro de validação de e-mail. Quais são as regras de validação? R: O sistema aplica diversas regras de validação ao campo de E-mail para garantir que o endereço eletrônico informado seja válido. As principais verificações incluem: presença do caractere "@", domínio válido após o "@", ausência de espaços em branco, ausência de caracteres especiais não permitidos, formato correto do nome de usuário, extensão de domínio válida, entre outras. Certifique-se de informar um endereço de e-mail completo e no formato correto (exemplo: usuario@dominio.com.br).
P: O sistema apresenta erro de validação de CPF/CNPJ. O que devo fazer? R: O campo CPF/CNPJ é obrigatório e possui as seguintes validações: o número deve ser informado, deve estar no formato correto (CPF com 11 dígitos ou CNPJ com 14 dígitos), deve ser um número válido conforme o algoritmo de verificação e não pode estar duplicado no sistema (ou seja, já cadastrado para outra pessoa). Verifique se o número foi digitado corretamente e se já não existe outro cadastro utilizando o mesmo CPF/CNPJ.
P: O que significa a mensagem "É Obrigatório Informar o Tipo da Pessoa!"? R: Esta mensagem é exibida quando o campo Tipo da Pessoa não foi preenchido. O Tipo da Pessoa é um campo obrigatório que classifica o cadastro (por exemplo: Cliente, Fornecedor, Transportadora, etc.). Selecione um tipo válido no campo correspondente antes de salvar o registro. Os tipos disponíveis são configurados na tela Tipo de Pessoa (TFA005).
P: O que significa a mensagem "O Tipo de Pessoa não está Cadastrado [TFA005]!"? R: Esta mensagem indica que o código informado no campo Tipo da Pessoa não corresponde a nenhum tipo cadastrado no sistema. Verifique se o código está correto ou acesse a tela Tipo de Pessoa (TFA005) para consultar os tipos disponíveis ou cadastrar um novo tipo.
P: O que significa a mensagem "O Município não está Cadastrado [TFA003]!"? R: Esta mensagem indica que o código de município informado no endereço não está cadastrado no sistema. Verifique se o código está correto ou acesse a tela Município (TFA003) para consultar os municípios disponíveis ou cadastrar um novo município.
P: O que significa a mensagem "A Condição Fiscal não está Cadastrada [TFI001]!"? R: Esta mensagem indica que a condição fiscal informada no cadastro da pessoa não corresponde a nenhum registro válido. Verifique se o código está correto ou acesse a tela Condição Fiscal (TFI001) para consultar as condições disponíveis ou cadastrar uma nova condição fiscal.
P: O que significa a mensagem "É Obrigatório Informar a Condição de Pagamento.[TFA001/ADM010]"? R: Esta mensagem indica que o campo Condição de Pagamento não foi preenchido e é obrigatório para o cadastro da pessoa. Informe uma condição de pagamento válida no campo correspondente. As condições de pagamento podem ser consultadas ou cadastradas nas telas TFA001 ou ADM010.
P: O que significa a mensagem "É Obrigatório Informar Pelo Menos um Vendedor!"? R: Esta mensagem indica que é necessário associar ao menos um vendedor ao cadastro da pessoa. Acesse a aba correspondente e inclua pelo menos um registro de vendedor vinculado à pessoa antes de salvar o cadastro.
P: O que significa a mensagem "A Data da Próxima Avaliação está inferior à Data da Última Avaliação!"? R: Esta mensagem indica que a data informada no campo Data da Próxima Avaliação é anterior à data registrada no campo Data da Última Avaliação. A data da próxima avaliação deve ser sempre igual ou posterior à data da última avaliação. Corrija a data informada e tente salvar novamente.
P: O que significa a mensagem "Para Pessoa com Situação de Contribuinte Isento não pode haver Inscrição Estadual Informada!"? R: Esta mensagem indica uma inconsistência no cadastro: quando a situação do contribuinte está definida como "Isento", o campo Inscrição Estadual deve permanecer vazio. Remova a inscrição estadual informada ou altere a situação do contribuinte para que seja compatível com a presença de uma inscrição estadual.
P: O que significa a mensagem "Não é Permitido Alterar os Dados desta Pessoa, pois ela Pertence a outra Empresa. Verifique!"? R: Esta mensagem indica que o registro da pessoa que está sendo editado pertence a outra empresa do grupo e, portanto, não pode ser alterado a partir da empresa atual. Para realizar alterações neste cadastro, acesse o sistema pela empresa proprietária do registro ou solicite que um usuário com acesso à empresa correspondente realize a modificação.
P: O que significa a mensagem "É Obrigatorio que a pessoa fique com no minimo 1 Perfil!"? R: Esta mensagem indica que é obrigatório que o cadastro da pessoa possua ao menos um perfil associado. Acesse a aba de Perfis e inclua pelo menos um perfil antes de salvar o registro. Não é permitido remover todos os perfis de uma pessoa cadastrada.
P: O que significa a mensagem "O Número de Referência já está Cadastrado!"? R: Esta mensagem indica que o número de referência informado já existe no cadastro da pessoa. Cada referência deve possuir um número único. Informe um número de referência diferente e tente salvar novamente.
P: O que significa a mensagem "O Código do Endereço já está Cadastrado!"? R: Esta mensagem indica que o código de endereço informado já está em uso para esta pessoa. Cada endereço deve possuir um código único dentro do cadastro. Informe um código de endereço diferente e tente salvar novamente.
P: O que significa a mensagem "É obrigatório adicionar ao menos um documento ao cadastro. Verifique!"? R: Esta mensagem indica que o cadastro da pessoa requer ao menos um documento associado. Acesse a aba de Documentos e inclua pelo menos um registro de documento antes de salvar o cadastro da pessoa.
P: O que significa a mensagem "Já existe uma Conta para Pagamento selecionada para essa pessoa. Verifique!"? R: Esta mensagem indica que já existe uma conta corrente marcada como conta para pagamento no cadastro desta pessoa. Cada pessoa pode ter apenas uma conta corrente definida como conta para pagamento. Verifique as contas correntes cadastradas e, se necessário, desmarque a conta atual antes de definir uma nova conta para pagamento.
P: O que significa a mensagem "O Banco deve ser Informado Primeiro!"? R: Esta mensagem indica que, ao cadastrar uma conta corrente para a pessoa, é necessário informar o banco antes de preencher os demais campos da conta. Selecione o banco no campo correspondente e, em seguida, preencha os dados restantes da conta corrente (agência, número da conta, etc.).
Mensagens exibidas
Levantadas de source/TFA001/ pela camada 0 (commit 96fc51e236).
| Código | Tipo | Mensagem |
|---|---|---|
| A-1640 | Confirmação | Deseja Salvar as Alterações Antes de Sair? |
| C-0045 | Confirmação | Deseja Excluir o Registro? |
| C-1615 | Confirmação | Deseja Realmente Excluir a Imagem?' |
| E-0033 | Erro | A Pessoa Física / Jurídica não está Cadastrada [TFA001]! Código.: %s |
| E-0248 | Erro | O Estado não está Cadastrado! Verifique [TFA004] |
| E-0272 | Erro | A Condição de Pagamento Não Está Cadastrada. Verifique! [TFC002] |
| E-0309 | Erro | A Região Comercial não está Cadastrada. Verifique! [TFA014] |
| I-0046 | Informação | Registro Excluído com Sucesso. |
| I-0047 | Informação | Alterações Efetuadas com Sucesso. |
| W-0767 | Aviso | Área Comercial não cadastrada. Verifique! [TFA080] |
| W-0815 | Aviso | CEP "%s" inválido.! |
| W-0842 | Aviso | O usuário não possui acesso a tela Informações de Crédito [TFA002]! |
| W-0996 | Aviso | O Usuário não possui acesso a tela de Cadastro de CEP! [TFA026] |
| W-1611 | Aviso | Você não tem acesso ao cadastro de contatos de pessoas [TFA029] |
| W-1612 | Aviso | O usuário não possui acesso a tela de cadastro de Veículos [TTR001]. Verifique! |
| W-1613 | Aviso | O usuário não possui acesso a tela de Visita Cliente [TFA018]! |
| W-1614 | Aviso | O Usuário não possui Acesso a tela de Bloqueio Pessoa. [TFA049]. |
| W-1818 | Aviso | Para o Tipo Valor Frete igual a "% s/ Faturamento" o valor não pode ser maior que 100%. Verifique! |
Mais 250 mensagens com texto literal no código: TFA001.
Parâmetros lidos
Campos PARM* lidos via values[] em source/TFA001/ (commit 96fc51e236).
Tabelas de Escrita (INSERT/UPDATE/DELETE)
| Tabela | Operacoes |
|---|---|
| AREACOMERCIAL | DELETE, INSERT, SELECT, UPDATE |
| BENSPESSOA | DELETE, INSERT, SELECT, UPDATE |
| CONTACORPESSOA | DELETE, INSERT, SELECT, UPDATE |
| CONTASPESSOA | DELETE, SELECT |
| CREDITO | DELETE, SELECT |
| ENDERECOPESSOA | DELETE, INSERT, SELECT, UPDATE |
| MARCAREPRESENTADA | DELETE, INSERT, SELECT, UPDATE |
| PESSOA | DELETE, INSERT, SELECT, UPDATE |
| PESSOACONDPAGTO | DELETE, INSERT, SELECT, UPDATE |
| PESSOADOCUMENTO | DELETE, INSERT, SELECT, UPDATE |
| PESSOAFISICA | DELETE, INSERT, SELECT, UPDATE |
| PESSOAFORMAPAGTO | DELETE, INSERT, SELECT, UPDATE |
| PESSOAINSCRICAO | DELETE, INSERT, SELECT, UPDATE |
| PESSOAPERFIL | DELETE, INSERT, SELECT, UPDATE |
| PESSOASERIENF | DELETE, INSERT, SELECT, UPDATE |
| PESSOASOCIO | DELETE, INSERT, SELECT, UPDATE |
| PESSOAVENDEDOR | DELETE, INSERT, SELECT, UPDATE |
| REFERENCIAPESSOA | DELETE, INSERT, SELECT, UPDATE |
| REGIAOCOMERCIAL | DELETE, INSERT, SELECT, UPDATE |
| TIPOPESSOA | DELETE, INSERT, SELECT, UPDATE |
| VENDEDOR | SELECT, UPDATE |
Tabelas de Leitura (SELECT)
| Tabela | Operacoes |
|---|---|
| AGENCIA | SELECT |
| AUTORIZADOR | SELECT |
| BANCO | SELECT |
| CEP | SELECT |
| CONDFISCAL | SELECT |
| CONDPAGTO | SELECT |
| CONFIGNFE | SELECT |
| CONTRATO | SELECT |
| EMPRESA | SELECT |
| ESTADO | SELECT |
| FORMAPAGTO | SELECT |
| MARCA | SELECT |
| MUNICIPIO | SELECT |
| NOTA | SELECT |
| ORIGEMCLIENTE | SELECT |
| PAISBACEN | SELECT |
| PARMFATUR | SELECT |
| PARMFINANC | SELECT |
| PARMNOTA | SELECT |
| PARMSISTEMA | SELECT |
| PERFIL | SELECT |
| PRACACOBRANCA | SELECT |
| RAMOATIVIDADE | SELECT |
| RESTAURANTE | SELECT |
| TABPRECO | SELECT |
| TIPOFATURAMENTO | SELECT |
| TIPOSOCIO | SELECT |
| TIPOVENDEDOR | SELECT |
| UNIDMED | SELECT |
Procedures Chamadas
| Procedure | Tabelas Acessadas |
|---|---|
| GERA_SEQUENCIA | SEQUENCIA (SELECT/UPDATE) |
| RETORNA_DADOSCADASTRAIS | AREACOMERCIAL (SELECT), ENDERECOPESSOA (SELECT), ESTADO (SELECT), FORMAPAGTO (SELECT), GRUPOPCP (SELECT), MUNICIPIO (SELECT) +4 |
Tabelas via Procedures (acesso indireto)
| Tabela | Operacoes |
|---|---|
| AREACOMERCIAL | SELECT |
| ENDERECOPESSOA | SELECT |
| ESTADO | SELECT |
| FORMAPAGTO | SELECT |
| GRUPOPCP | SELECT |
| MUNICIPIO | SELECT |
| PAISBACEN | SELECT |
| PESSOA | SELECT |
| PESSOAFISICA | SELECT |
| REGIAOCOMERCIAL | SELECT |
| SEQUENCIA | SELECT, UPDATE |
Dependencias Aferentes (quem alimenta esta tela)
Telas que escrevem em tabelas lidas por esta tela.
| Tela | Título | Tabelas em Comum |
|---|---|---|
| TFA001 | Pessoas Físicas / Jurídicas | PESSOA, ENDERECOPESSOA (self-reference: lookups de representante, preposto, avalista) |
| MNF001 | Recebimento de Notas Fiscais de Compra | EMPRESA, CONDPAGTO, FORMAPAGTO |
| MNF002 | Emissão de Nota Fiscal de Venda | EMPRESA, CONDPAGTO, FORMAPAGTO |
| TFA007 | Vendedores | VENDEDOR |
| TFI001 | Condições Fiscais | CONDFISCAL |
| TFC002 | Condições de Pagamento | CONDPAGTO |
| TFC001 | Formas de Pagamento | FORMAPAGTO |
| TPO002 | Marcas | MARCA |
| TFA003 | Municípios | MUNICIPIO |
| TFA005 | Tipos de Pessoa | TIPOPESSOA |
| ADM010 | Parâmetros do Sistema | PARMSISTEMA, PARMFATUR |
Dependencias Eferentes (quem consome dados desta tela)
Telas que leem tabelas escritas por esta tela.
| Tela | Título | Tabelas em Comum |
|---|---|---|
| MPD002 | Emissão de Pedidos de Venda | PESSOA, ENDERECOPESSOA, PESSOAFISICA, PESSOACONDPAGTO, PESSOAFORMAPAGTO |
| MNF002 | Emissão de Nota Fiscal de Venda | PESSOA, ENDERECOPESSOA, PESSOAFISICA |
| MNF001 | Recebimento de Notas Fiscais de Compra | PESSOA, ENDERECOPESSOA |
| MFC004 | Baixa de Contas a Receber/Pagar | PESSOA, ENDERECOPESSOA, CONTACORPESSOA |
| LPD001 | Listagem de Pedidos | PESSOA, ENDERECOPESSOA |
| CPD001 | Consulta de Pedidos | PESSOA, ENDERECOPESSOA |
| TFA007 | Vendedores | PESSOA, PESSOAVENDEDOR |
| MFC019 | Reparcelamento de Contas | PESSOA, PESSOACONDPAGTO |
| MNF017 | Venda Balcão | PESSOA, ENDERECOPESSOA |
| ... | +200 telas (PESSOA é referenciada em quase todos os módulos) |
Regras de Negocio
- CPF/CNPJ obrigatorio e unico: tabPESSOANR_CNPJCPFValidate valida formato e verifica duplicidade por empresa (lanca JException se ja existe).
- Nome obrigatorio: tabPESSOABeforePost exige NM_PESSOA nao vazio; se parametro ADM010 ativo, tambem obriga NM_FANTASIA, DT_NASCIMENTO e E-mail.
- Tipo de pessoa obrigatorio: BeforePost exige CD_TIPOPESSOA preenchido e cadastrado.
- Data de cadastro obrigatorio: BeforePost exige DT_CADASTRO nao nula.
- Inativacao controlada: ao marcar ST_ATIVA='N', o sistema executa
UPDATE PESSOA SET ST_ATIVA='N'eUPDATE VENDEDOR SET ST_ATIVO='N'em cascata, podendo ser bloqueada por perfil de usuario. - PESSOAFISICA gerenciada por AfterPost: tabPESSOAAfterPost verifica se registro ja existe em PESSOAFISICA e executa INSERT ou UPDATE conforme o caso.
- PESSOAVENDEDOR gerenciada automaticamente: tabPESSOAAfterPost insere/atualiza registro em PESSOAVENDEDOR conforme parametro ST_VARIOSVENDEDORES e ST_ENDERECOVENDEDOR.
- PESSOACONDPAGTO gerenciada automaticamente: AfterPost insere em PESSOACONDPAGTO quando parametro ST_CONDPAGTOLIBERADAS estiver ativo.
- Endereco principal: tabENDERECOPESSOABeforeDelete impede exclusao do endereco principal; tabENDERECOPESSOABeforePost valida municipio, condicao fiscal, vendedor, cobrador.
- Conta corrente com PIX: tabCONTACORPESSOATP_CHAVEPIXValidate valida tipo e valor da chave PIX.
- Numero de referencia unico: tabREFERENCIAPESSOANR_REFERENCIAValidate verifica duplicidade de NR_REFERENCIA por pessoa.
- Importacao CNPJ/CPF: módulo UIMPORTACAOCNPJCPF.pas permite importar dados cadastrais de consulta externa.
- Sequencia gerada por GERA_SEQUENCIA: AfterInsert usa
SELECT V_NR_SEQUENCIA FROM GERA_SEQUENCIA(NULL,'SEQ_PESSOA')para obter CD_PESSOA. - Verificacao de bloqueio: procedure VerificaBloqueio consulta autorizadores e regras de bloqueio por situacao financeira.
- Permissao de alteracao por empresa: se CD_EMPRCADASTRO diferente da empresa logada, BeforePost bloqueia alteracao de dados da pessoa.
Datasets e SQL
| Dataset | Tabela Principal | Tipo | Descricao |
|---|---|---|---|
tabPESSOA | PESSOA | TFDQuery | Query mestre com JOIN em ENDERECOPESSOA, MUNICIPIO, TIPOPESSOA, TIPOFATURAMENTO, RAMOATIVIDADE, ORIGEMCLIENTE; filtro dinamico por tipo/filtro |
tabENDERECOPESSOA | ENDERECOPESSOA | TFDQuery | Detail de enderecos da pessoa; JOIN em MUNICIPIO, CONDFISCAL, REGIAOCOMERCIAL, CONDPAGTO, FORMAPAGTO, PESSOA (vendedor/cobrador/transportador) |
tabPESSOAFISICA | PESSOAFISICA | TFDQuery | Dados fisicos (RG, CPF separado, mae/pai, conjuge, trabalho, plano saude) |
tabREFERENCIAPESSOA | REFERENCIAPESSOA | TFDQuery | Referencias comerciais da pessoa; JOIN em MUNICIPIO |
tabCONTACORPESSOA | CONTACORPESSOA | TFDQuery | Contas bancarias; JOIN em BANCO, AGENCIA |
tabPESSOASOCIO | PESSOASOCIO | TFDQuery | Socios da empresa; JOIN em PESSOA, TIPOSOCIO |
tabBENSPESSOA | BENSPESSOA | TFDQuery | Bens patrimoniais; JOIN em MUNICIPIO |
tabMARCAREPRESENTADA | MARCAREPRESENTADA | TFDQuery | Marcas representadas; JOIN em MARCA |
tabINSCRICAOSUBSTITUTAS | PESSOAINSCRICAO | TFDQuery | Inscricoes estaduais por estado |
tabCONDPAGTO | PESSOACONDPAGTO | TFDQuery | Condicoes de pagamento liberadas; JOIN em CONDPAGTO |
tabDOCUMENTOS | PESSOADOCUMENTO | TFDQuery | Documentos digitalizados (BLOB) |
tabPERFIL | PESSOAPERFIL | TFDQuery | Perfis vinculados; JOIN em PERFIL |
tabVENDEDORES | PESSOAVENDEDOR | TFDQuery | Vendedores vinculados; JOIN em PESSOA, TIPOVENDEDOR |
tabAREACOMERCIAL | AREACOMERCIAL | TFDQuery | Areas comerciais da pessoa |
tabREGIAOCOMERCIAL | REGIAOCOMERCIAL | TFDQuery | Regioes comerciais da pessoa |
tabPESSOASERIENF | PESSOASERIENF | TFDQuery | Series de NF por empresa; JOIN em EMPRESA |
tabFORMAPAGTO | PESSOAFORMAPAGTO | TFDQuery | Formas de pagamento liberadas; JOIN em FORMAPAGTO |
tabTP_PESSOA | TIPOPESSOA | TFDQuery | Lookup de tipos de pessoa para filtro |
tabMUNICIPIO | MUNICIPIO | TFDQuery | Lookup de municipios |
tabIMPORTACAOCNPJCPF | (staging) | TFDQuery | Tabela temporaria para importacao de CNPJ/CPF |