TP_DOCUMENTO — Complemento por Tipo de Conta
Tela de configuração: TFC007 — Parâmetros Complemento Caixa Tabela:
PARMCOMPLCAIXA.TP_DOCUMENTOControle: Combobox (cmbTP_DOCUMENTO) Valor padrão: Sem padrão (nulo = Indiferente)
Telas impactadas
| Tela | Rotina | Impacto |
|---|---|---|
| TFC007 | Configuração do parâmetro | Cadastro de complementos de caixa filtrados por tipo de documento |
| CFC001 | MontaWhere, btnCancContasClick | Usa CONTAS.TP_DOCUMENTO para filtrar/buscar contas |
| CFC002 | btnNovoClick, btnProcurarClick | Filtra MOVTOCAIXA.TP_DOCUMENTO = 'AV' |
| CFC004 | btnProcurarClick, gridCONTASDblClick | Lista contas por TP_DOCUMENTO |
| CFC013 | btnProcurarClick | Exclui TP_DOCUMENTO = 'RP' da consulta |
| CNF001 | ConsultarDuplicatas1Click, gridSALDODblClick | Passa TP_DOCUMENTO = 'NF' como parâmetro ao abrir tela |
| CNF009 | cmbTP_DOCUMENTOChange | Troca de tipo de documento atualiza comportamento da tela |
Campos envolvidos
| Campo | Tabela | Tipo | Descrição |
|---|---|---|---|
TP_DOCUMENTO | PARMCOMPLCAIXA | VARCHAR(2) | Tipo de documento que define o escopo do complemento de caixa |
CD_TIPOCONTA | PARMCOMPLCAIXA | INTEGER | Tipo de conta (FK para TIPOCONTA) |
TP_BAIXA | PARMCOMPLCAIXA | CHAR(1) | Tipo de baixa (P=Parcial, T=Total, B=Baixa) |
TP_PROCESSO | PARMCOMPLCAIXA | CHAR(1) | Tipo de processo (R=Receber, P=Pagar) |
DS_COMPLEMENTO | PARMCOMPLCAIXA | VARCHAR(240) | Texto do complemento a ser retornado |
ST_BLOQUEIO | PARMCOMPLCAIXA | CHAR(1) | Status de bloqueio do complemento |
Opções disponíveis
| O que faz | Detalhe |
|---|---|
| Filtra qual tipo de documento financeiro receberá o complemento configurado | Quando preenchido, o complemento só aparece na baixa de contas do tipo indicado; vazio (Indiferente) aplica a qualquer documento |
NT — Nota Fiscal
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- No campo Complemento por Tipo de Conta, selecione Nota Fiscal (
NT). - Preencha os demais campos (Tipo de Conta, Tipo de Baixa, Tipo de Processo, Complemento).
- Salve o registro.
Resultado esperado: O complemento será exibido apenas ao baixar contas do tipo Nota Fiscal (TP_DOCUMENTO = 'NT') que também satisfaçam os demais filtros informados.
DP — Duplicata Avulsa
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- No campo Complemento por Tipo de Conta, selecione Duplicata Avulsa (
DP). - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas do tipo Duplicata Avulsa (TP_DOCUMENTO = 'DP').
AD — Adiantamento
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Adiantamento (
AD) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas do tipo Adiantamento (TP_DOCUMENTO = 'AD').
CH — Cheque
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Cheque (
CH) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas do tipo Cheque (TP_DOCUMENTO = 'CH').
AG — Contas Agrupado
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Contas Agrupado (
AG) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas agrupadas (TP_DOCUMENTO = 'AG').
OC — Ordem Carregamento
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Ordem Carregamento (
OC) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Ordem de Carregamento (TP_DOCUMENTO = 'OC').
ES — Mensalidade Escola
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Mensalidade Escola (
ES) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Mensalidade Escola (TP_DOCUMENTO = 'ES').
RS — Restaurante
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Restaurante (
RS) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Restaurante (TP_DOCUMENTO = 'RS').
RF — Receita Frete
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Receita Frete (
RF) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Receita Frete (TP_DOCUMENTO = 'RF').
DF — Despesa Viagem
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Despesa Viagem (
DF) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Despesa de Viagem (TP_DOCUMENTO = 'DF').
AF — Adiantamento Viagem
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Adiantamento Viagem (
AF) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Adiantamento de Viagem (TP_DOCUMENTO = 'AF').
CL — Contrato Leite
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Contrato Leite (
CL) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Contrato de Leite (TP_DOCUMENTO = 'CL').
JU — Juro
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Juro (
JU) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Juro (TP_DOCUMENTO = 'JU').
DE — Desconto
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Desconto (
DE) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Desconto (TP_DOCUMENTO = 'DE').
FA — Fatura
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- Selecione Fatura (
FA) no campo Complemento por Tipo de Conta. - Preencha os demais campos e salve.
Resultado esperado: O complemento será exibido apenas ao baixar contas de Fatura (TP_DOCUMENTO = 'FA').
(vazio) — Indiferente
Simulação passo a passo
- Acesse TFC007 — Parâmetros Complemento Caixa.
- No campo Complemento por Tipo de Conta, selecione Indiferente (valor vazio).
- Preencha os demais campos e salve.
Resultado esperado: O complemento se aplica a qualquer tipo de documento, desde que os demais filtros (Tipo de Conta, Tipo de Baixa, Tipo de Processo) sejam satisfeitos. Na lógica de fallback da procedure RETORNA_PARMCOMPLEMENTOCAIXA, o registro com TP_DOCUMENTO nulo funciona como complemento genérico quando não há registro mais específico.
Regra Geral de Resolução (Fallback)
O parâmetro TP_DOCUMENTO atua em conjunto com CD_TIPOCONTA, TP_BAIXA e TP_PROCESSO na procedure RETORNA_PARMCOMPLEMENTOCAIXA. A busca pelo complemento segue uma hierarquia do mais específico (4 campos preenchidos) para o mais genérico (nenhum campo preenchido), parando no primeiro registro encontrado:
- 4 campos preenchidos → 2. 3 campos preenchidos (cada combinação) → 3. 2 campos → 4. 1 campo → 5. Nenhum campo (totalmente genérico)
Isso significa que um registro com TP_DOCUMENTO = 'NT' e CD_TIPOCONTA = 5 tem prioridade sobre um registro com apenas TP_DOCUMENTO = 'NT', que por sua vez tem prioridade sobre um registro com todos os campos nulos (Indiferente).
Tabela Comparativa Resumida
| Valor | Descrição | Restrição |
|---|---|---|
NT | Nota Fiscal | Complemento só aparece na baixa de Notas Fiscais |
DP | Duplicata Avulsa | Complemento só aparece na baixa de Duplicatas Avulsas |
AD | Adiantamento | Complemento só aparece na baixa de Adiantamentos |
CH | Cheque | Complemento só aparece na baixa de Cheques |
AG | Contas Agrupado | Complemento só aparece na baixa de Contas Agrupadas |
OC | Ordem Carregamento | Complemento só aparece na baixa de Ordens de Carregamento |
ES | Mensalidade Escola | Complemento só aparece na baixa de Mensalidades Escola |
RS | Restaurante | Complemento só aparece na baixa de contas de Restaurante |
RF | Receita Frete | Complemento só aparece na baixa de Receitas de Frete |
DF | Despesa Viagem | Complemento só aparece na baixa de Despesas de Viagem |
AF | Adiantamento Viagem | Complemento só aparece na baixa de Adiantamentos de Viagem |
CL | Contrato Leite | Complemento só aparece na baixa de Contratos de Leite |
JU | Juro | Complemento só aparece na baixa de Juros |
DE | Desconto | Complemento só aparece na baixa de Descontos |
FA | Fatura | Complemento só aparece na baixa de Faturas |
| (vazio) | Indiferente | Complemento aplicável a qualquer tipo de documento (fallback genérico) |
Procedures impactadas
Procedures SQL com referência direta ao campo
| Procedure | Arquivo | Descrição |
|---|---|---|
RETORNA_PARMCOMPLEMENTOCAIXA | Scripts/RETORNA_PARMCOMPLEMENTOCAIXA.sql | Busca complemento em PARMCOMPLCAIXA usando TP_DOCUMENTO como filtro hierárquico com fallback |
RETORNA_COMPLEMENTO | Scripts/RETORNA_COMPLEMENTO.sql | Recebe I_TP_DOCUMENTO como parâmetro e repassa à procedure de complemento |
CANCELA_CONTAS | Scripts/CANCELA_CONTAS.sql | Declara V_TP_DOCUMENTO para controle de cancelamento de contas |
CANCELA_NOTAFISCAL | Scripts/CANCELA_NOTAFISCAL.sql | Filtra C.TP_DOCUMENTO = 'NT' no cancelamento |
CANCELA_RECEITAFRETE | Scripts/CANCELA_RECEITAFRETE.sql | Filtra TP_DOCUMENTO = 'RF' no cancelamento |
GRAVA_CONTAS | Scripts/GRAVA_CONTAS.sql | Recebe V_TP_DOCUMENTO como parâmetro de gravação |
GRAVA_MOVTOCAIXA | Scripts/GRAVA_MOVTOCAIXA.sql | Recebe I_TP_DOCUMENTO como parâmetro de gravação |
GRAVA_PROCESSO | Scripts/GRAVA_PROCESSO.sql | Grava TP_DOCUMENTO na tabela PROCESSO |
EXECUTA_PROCESSO | Scripts/EXECUTA_PROCESSO.sql | Declara V_TP_DOCUMENTO para execução de processos |
ESTORNA_MOVTOCAIXA | Scripts/ESTORNA_MOVTOCAIXA.sql | Declara V_TP_DOCUMENTO para estorno de movimentos de caixa |
ESTORNA_PROCESSO | Scripts/ESTORNA_PROCESSO.sql | Declara V_TP_DOCUMENTO para estorno de processos |
GRAVA_CONTASHISTORICO | Scripts/GRAVA_CONTASHISTORICO.sql | Recebe V_TP_DOCUMENTO como parâmetro de gravação de histórico |
Rotinas Delphi com referência direta
| Rotina | Arquivo | Descrição |
|---|---|---|
MontaWhere | source/CFC001/UCFC001.pas | Filtra CONTAS.TP_DOCUMENTO na consulta de contas |
iniciar | source/CFC001/UCFC001.pas | Verifica TP_DOCUMENTO = 'NF' para definir comportamento da tela |
TfrmCFC001.btnCancContasClick | source/CFC001/UCFC001.pas | Verifica TP_DOCUMENTO = 'NT' ao cancelar contas |
TdmCFC002.tabMOVTOCAIXACalcFields | source/CFC002/UdmCFC002.pas | Calcula campos com base em TP_DOCUMENTO = 'NT' |
TfrmCFC004.gridCONTASDblClick | source/CFC004/UCFC004.pas | Verifica TP_DOCUMENTO = 'NT' ao abrir detalhes da conta |
cmbTP_DOCUMENTOChange | source/CNF009/UCNF009.pas | Altera comportamento da tela ao trocar tipo de documento |