TP_PROCESSO — Complemento por Tipo de Conta

Tela de configuração: TFC007 — Parâmetros Complementares do Caixa Tabela: PARMCOMPLCAIXA.TP_PROCESSO — CHAR(1) Componente: cmbTP_PROCESSO (combobox) Valor padrão: sem padrão definido

Objetivo

O campo TP_PROCESSO permite filtrar qual texto de complemento (DS_COMPLEMENTO) será usado pelo sistema ao gerar movimentos de caixa, restringindo-o ao tipo de processo financeiro (Pagamento ou Recebimento). Quando preenchido, o complemento só se aplica àquele tipo de processo; quando vazio (Indiferente), serve como regra genérica no mecanismo de fallback.

Campos envolvidos

Campo	Tabela	Tipo	Observação
TP_PROCESSO	PARMCOMPLCAIXA	CHAR(1)	Campo filtrado
CD_TIPOCONTA	PARMCOMPLCAIXA	INTEGER	Tipo de conta (fk → TIPOCONTA)
TP_DOCUMENTO	PARMCOMPLCAIXA	VARCHAR(2)	Tipo de documento
TP_BAIXA	PARMCOMPLCAIXA	CHAR(1)	Tipo de baixa
DS_COMPLEMENTO	PARMCOMPLCAIXA	VARCHAR(240)	Texto do complemento

Telas impactadas

Tela	Contexto
TFC007	Cadastro e edição dos parâmetros
CFC001 — Contas a Pagar/Receber	Reprocessamento de complementos
MFC018 — Movimento de Caixa	Chamada de REPROCESSA_COMPLEMENTOS
MNF017 — Confirmação de Pedido	Chamada de REPROCESSA_COMPLEMENTOS

Opções disponíveis

P — Pagamento

O que faz	Detalhe
Restringe o complemento a processos de pagamento	O texto de DS_COMPLEMENTO só é retornado quando o movimento de caixa pertence a um processo cujo tipo seja P

Simulação passo a passo

1. Acesse TFC007 — Parâmetros Complementares do Caixa.
2. Informe o Tipo de Conta, Tipo de Documento e Tipo de Baixa desejados.
3. No campo Complemento por Tipo de Conta, selecione Pagamento.
4. Preencha o campo Complemento com o texto desejado (ex.: PAGTO FORNECEDOR).
5. Clique em Salvar (<F9>).

Resultado esperado: Ao processar um pagamento (processo com TP_PROCESSO = 'P'), o sistema utilizará o complemento PAGTO FORNECEDOR no histórico do movimento de caixa.

---

R — Recebimento

O que faz	Detalhe
Restringe o complemento a processos de recebimento	O texto de DS_COMPLEMENTO só é retornado quando o movimento de caixa pertence a um processo cujo tipo seja R

Simulação passo a passo

1. Acesse TFC007 — Parâmetros Complementares do Caixa.
2. Informe o Tipo de Conta, Tipo de Documento e Tipo de Baixa desejados.
3. No campo Complemento por Tipo de Conta, selecione Recebimento.
4. Preencha o campo Complemento com o texto desejado (ex.: RECEBTO CLIENTE).
5. Clique em Salvar (<F9>).

Resultado esperado: Ao processar um recebimento (processo com TP_PROCESSO = 'R'), o sistema utilizará o complemento RECEBTO CLIENTE no histórico do movimento de caixa.

---

(vazio) — Indiferente

O que faz	Detalhe
Complemento genérico, sem restrição de tipo de processo	Serve como regra de fallback quando não há registro específico para P ou R

Simulação passo a passo

1. Acesse TFC007 — Parâmetros Complementares do Caixa.
2. Informe o Tipo de Conta, Tipo de Documento e Tipo de Baixa desejados.
3. No campo Complemento por Tipo de Conta, deixe em branco (opção Indiferente).
4. Preencha o campo Complemento com o texto desejado (ex.: MOVTO FINANCEIRO).
5. Clique em Salvar (<F9>).

Resultado esperado: Esse complemento será utilizado como fallback caso não exista regra mais específica para o tipo de processo em questão (Pagamento ou Recebimento).

Exceção / Importante: O sistema utiliza um mecanismo de fallback em cascata. A procedure RETORNA_PARMCOMPLEMENTOCAIXA tenta primeiro a combinação exata de todos os 4 filtros preenchidos (Tipo de Conta, Tipo de Documento, Tipo de Baixa, Tipo de Processo) e vai relaxando um filtro por vez até encontrar um registro. Por isso, um registro com TP_PROCESSO vazio funciona como "coringa" — ele é considerado apenas quando não há correspondência mais específica.

Regra geral de resolução (fallback)

A procedure RETORNA_PARMCOMPLEMENTOCAIXA recebe os 4 filtros e busca o complemento na seguinte ordem de prioridade:

Prioridade	CD_TIPOCONTA	TP_DOCUMENTO	TP_BAIXA	TP_PROCESSO
1 (mais específica)	✓ preenchido	✓ preenchido	✓ preenchido	✓ preenchido
2	✗ null	✓ preenchido	✓ preenchido	✓ preenchido
3	✓ preenchido	✗ null	✓ preenchido	✓ preenchido
4	✓ preenchido	✓ preenchido	✗ null	✓ preenchido
5	✓ preenchido	✓ preenchido	✓ preenchido	✗ null
…	…	…	…	…
15 (mais genérica)	✗ null	✗ null	✗ null	✗ null

O primeiro registro encontrado encerra a busca. Isso significa que TP_PROCESSO preenchido tem prioridade sobre vazio, mas apenas quando os demais filtros também coincidem.

Procedures impactadas

Rotinas SQL com referência direta ao campo PARMCOMPLCAIXA.TP_PROCESSO

Procedure / View	Arquivo	Descrição
RETORNA_PARMCOMPLEMENTOCAIXA	Scripts/RETORNA_PARMCOMPLEMENTOCAIXA.sql	Lê TP_PROCESSO diretamente de PARMCOMPLCAIXA como um dos 4 filtros de fallback
RETORNA_COMPLEMENTO	Scripts/RETORNA_COMPLEMENTO.sql	Repassa o tipo de processo para RETORNA_PARMCOMPLEMENTOCAIXA
RETORNA_COMPLEMENTOPROCESSO_MX	Scripts/RETORNA_COMPLEMENTOPROCESSO_MX.sql	Delega para RETORNA_PARMCOMPLEMENTOCAIXA passando O_TP_CONTA como tipo de processo
RETORNA_CONTASALDOBAIXAAD	Scripts/RETORNA_CONTASALDOBAIXAAD.sql	Chama RETORNA_PARMCOMPLEMENTOCAIXA passando NULL para TP_BAIXA e O_TP_CONTA como processo
REPROCESSA_COMPLEMENTOS	Scripts/REPROCESSA_COMPLEMENTOS.sql	Declara V_TP_PROCESSO e utiliza no reprocessamento de complementos de caixa
REPROCESSA_COMPLEMENTOSPROCESSO	Scripts/REPROCESSA_COMPLEMENTOSPROCESSO.sql	Declara V_TP_PROCESSO e reprocessa complementos por processo

Rotinas Delphi com referência ao uso de TP_PROCESSO na tabela PROCESSO

Rotina	Arquivo	Observação
TfrmCFC001.btnProcessoClick	source/CFC001/UCFC001.pas	Passa TP_PROCESSO como parâmetro para layout de impressão
TfrmMFC004.btnNovoClick	source/MFC004/UMFC004.pas	Atribui 'P' ao filtro de processo
TfrmMFC018	source/MFC018/UMFC018.pas	Chama REPROCESSA_COMPLEMENTOS
TfrmMNF017ConfPedido.btnConfirmaClick	source/MNF017/uMNF017ConfPedido.pas	Chama REPROCESSA_COMPLEMENTOS

Nota: As referências a TP_PROCESSO em layouts de impressão (LPR001, LPR002, LPR003, LRC000) e em telas de notas fiscais (MNF001, MNF002, MNF004, MNF007, MNF008, MNF013, MNF017, MNF019, MNF024, MNF026, MNF030, MNF032, MNF033, MPD011, MRC020, MRE005) referem-se ao campo TP_PROCESSO da tabela PROCESSO (tipo do processo financeiro — pagamento ou recebimento), e não ao campo em PARMCOMPLCAIXA. São consumidores do valor que o parâmetro filtra, mas não acessam diretamente a tabela de parâmetros.

Tabela comparativa resumida

Valor	Descrição	Comportamento
P	Pagamento	Complemento restrito a processos de pagamento
R	Recebimento	Complemento restrito a processos de recebimento
(vazio)	Indiferente	Complemento genérico, usado como fallback