IDTIPOPESSOAMOB - Tipo de Pessoa para Clientes Mobile

Tela de configuração: REC001 - Parâmetros de Recapadora Localização: Cadastro → Parâmetros → Aba Geral Tabela: PARAMRECAP.IDTIPOPESSOAMOB Tipo: INTEGER (FK para TIPOPESSOA.CD_TIPOPESSOA) Valor padrão: Nulo (não obrigatório)

Descrição Geral

Define o tipo de pessoa padrão atribuído automaticamente ao cadastro de clientes criados via aplicativo móvel (palm). Quando um novo cliente é inserido pelo aplicativo, o sistema utiliza este parâmetro para preencher o campo IDTIPOPESSOA do cadastro, garantindo que o cliente mobile tenha um tipo de pessoa válido e consistente com as regras comerciais da empresa.

O campo funciona como uma chave estrangeira para a tabela TIPOPESSOA, permitindo que o usuário selecione qualquer tipo de pessoa cadastrado no sistema.

Telas impactadas

Tela	Impacto
REC001	Tela de configuração onde o parâmetro é definido.
Aplicativo móvel (palm)	Utiliza o valor para criar cadastros de clientes com o tipo de pessoa correto.

Campos envolvidos

Campo	Tabela	Descrição
`IDTIPOPESSOAMOB`	`PARAMRECAP`	Código do tipo de pessoa para clientes mobile (FK → `TIPOPESSOA.CD_TIPOPESSOA`)
`DS_TIPOPESSOA`	`TIPOPESSOA`	Descrição do tipo de pessoa (exibida no formulário)
`CD_TIPOPESSOA`	`TIPOPESSOA`	Chave primária da tabela de tipos de pessoa
`TP_TIPOPESSOA`	`TIPOPESSOA`	Tipo (F=Física, J=Jurídica) — auxilia na validação
`CD_TABPRECO`	`TIPOPESSOA`	Tabela de preço vinculada ao tipo de pessoa

Opções disponíveis

O campo não possui valores fixos (como S/N/E). O valor é um código inteiro que referencia qualquer registro existente na tabela TIPOPESSOA. Os tipos de pessoa disponíveis dependem do cadastro da empresa.

O que faz	Detalhe
Tipo do campo	INTEIRO, editável, campo oculto na grid principal (`Visible = False`)
Lookup	Pressione `<F9>` para buscar tipos de pessoa cadastrados
Validação	O código digitado deve existir em `TIPOPESSOA.CD_TIPOPESSOA`; caso contrário, o sistema exibe erro `W-0000`
Obrigatório	Não — pode ficar em branco

Simulação passo a passo

Acesse REC001 — Parâmetros de Recapadora.
Localize o campo Tipo Pessoa (rótulo: "Tipo Pessoa").
Pressione <F9> para abrir a tela de busca de tipos de pessoa.
Selecione o tipo de pessoa desejado (ex: "Cliente Revenda", "Cliente Consumidor Final").
O sistema preenche automaticamente o campo com o código e exibe a descrição.
Salve o registro.

Resultado esperado: O tipo de pessoa selecionado será utilizado como padrão para novos cadastros de clientes criados pelo aplicativo móvel (palm). Quando o palm enviar um novo cadastro de cliente, o sistema aplicará este tipo de pessoa automaticamente.

Excecao / Importante: Se o campo ficar em branco (nulo), os clientes criados via palm não terão tipo de pessoa definido automaticamente, podendo gerar inconsistências no cadastro.

Regra de Validação

A validação ocorre no evento qryCadastroIDTIPOPESSOAMOBValidate:

procedure TdmREC001.qryCadastroIDTIPOPESSOAMOBValidate(Sender: TField);

Comportamento:

Se o campo não estiver vazio: consulta TIPOPESSOA pelo código informado.
- Encontrado: preenche o campo DS_TIPOPESSOA com a descrição do tipo de pessoa.
- Não encontrado: limpa DS_TIPOPESSOA e dispara exceção W-0000 — "Tipo de Pessoa não encontrada!".
Se o campo estiver vazio: limpa DS_TIPOPESSOA.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Evidência
`TdmREC001.qryCadastroIDTIPOPESSOAMOBValidate`	`source/REC001/UdmREC001.pas:403`	Validação do campo — consulta `TIPOPESSOA` e preenche descrição
`TdmREC001.qryCadastroBeforePost`	`source/REC001/UdmREC001.pas:1142`	Inclui o valor no INSERT via `Nulo()`
`TframeREC001.editTipoPessoaMobKeyDown`	`source/REC001/UframeREC001.pas:936`	Lookup via `<F9>` na tabela `TIPOPESSOA`

Referências SQL diretas ao campo em Scripts/

Procedure	Arquivo	Uso
`ATUALIZA_TIPOPESSOARECAP`	`Scripts/ATUALIZA_TIPOPESSOARECAP.sql:15`	Consulta `PARAMRECAP` para verificar existência de configuração, mas não lê `IDTIPOPESSOAMOB` diretamente

Candidatas por uso da tabela `PARAMRECAP`

As seguintes procedures referenciam a tabela PARAMRECAP, mas não citam o campo IDTIPOPESSOAMOB diretamente. Verificar impacto funcional antes de afirmar:

Procedure	Arquivo
`ATUALIZA_PEDIDONOTA`	`Scripts/ATUALIZA_PEDIDONOTA.sql:132`
`ATUALIZA_PREVISAOORDEMPROD`	`Scripts/ATUALIZA_PREVISAOORDEMPROD.sql:95`
`ATUALIZA_STFATURAAUTO`	`Scripts/ATUALIZA_STFATURAAUTO.sql:24`
`CANCELA_ESTOQUERECAP`	`Scripts/CANCELA_ESTOQUERECAP.sql:49`
`CANCELA_NOTAFISCAL`	`Scripts/CANCELA_NOTAFISCAL.sql:754`
`GERA_NOTAPEDIDO`	`Scripts/GERA_NOTAPEDIDO.sql:62`
`GERA_ORDEMPRODUCAORECAP`	`Scripts/GERA_ORDEMPRODUCAORECAP.sql:263`
`GERA_PEDIDOENTRADACARCACA`	`Scripts/GERA_PEDIDOENTRADACARCACA.sql:79`
`GERA_PEDIDOSAIDACARCACA`	`Scripts/GERA_PEDIDOSAIDACARCACA.sql:45`
`FECHA_ORDEMPRODUCAORECAP`	`Scripts/FECHA_ORDEMPRODUCAORECAP.sql:321`
`FECHA_ORDEMPRODUCAORECAPNOTA`	`Scripts/FECHA_ORDEMPRODUCAORECAPNOTA.sql:148`

Observação: Nenhuma das procedures SQL acima referencia IDTIPOPESSOAMOB literalmente. O impacto é indireto — essas procedures leem outros campos de PARAMRECAP e não dependem diretamente do valor de IDTIPOPESSOAMOB.

Parâmetros Relacionados

Parâmetro	Descrição	Relação
`IDCONDFISMOB`	Condição fiscal para clientes mobile	Complementar — ambos definem o cadastro padrão do cliente via palm

IDCONDFISMOB é configurado na mesma tela REC001 — Parâmetros de Recapadora.

Descrição Geral​

Telas impactadas​

Campos envolvidos​

Opções disponíveis​

Simulação passo a passo​

Regra de Validação​

Procedures impactadas​

Rotinas Delphi com referência direta ao campo​

Referências SQL diretas ao campo em Scripts/​

Candidatas por uso da tabela PARAMRECAP​

Parâmetros Relacionados​