CD_TIPOCONTA - Complemento por Tipo de Conta

Tela de configuração: TFC007 — Parâmetros de Complemento de Caixa Tabela: PARMCOMPLCAIXA.CD_TIPOCONTA (DOM_INTEGER) Valor padrão: preenchido com o código selecionado via pesquisa (Resultado[1]) Chave estrangeira: TIPOCONTA (CD_TIPOCONTA)

Objetivo

Define para qual Tipo de Conta (Boleto, Cheque, Provisão, Cartão etc.) a regra de complemento se aplica. Quando preenchido, o complemento só será sugerido para contas desse tipo. Quando vazio, a regra funciona como genérica (aplica-se a qualquer tipo de conta).

Telas impactadas

Tela	Contexto
TFC007 — Parâmetros de Complemento de Caixa	Cadastro e edição do campo
CFC001 — Contas a Pagar/Receber	Geração do complemento automático nas baixas (via RETORNA_COMPLEMENTO)

Campos envolvidos

Campo	Tabela	Descrição
CD_TIPOCONTA	PARMCOMPLCAIXA	Código do tipo de conta (FK para TIPOCONTA)
DS_TIPOCONTA	PARMCOMPLCAIXA	Descrição do tipo de conta (somente leitura, preenchida automaticamente)
TP_DOCUMENTO	PARMCOMPLCAIXA	Tipo de documento (filtro complementar)
TP_BAIXA	PARMCOMPLCAIXA	Tipo de baixa (filtro complementar)
TP_PROCESSO	PARMCOMPLCAIXA	Tipo de processo (filtro complementar)
DS_COMPLEMENTO	PARMCOMPLCAIXA	Texto do complemento que será aplicado

Opções disponíveis

O que faz	Detalhe
Preenchido com um tipo de conta específico	A regra de complemento só se aplica a contas daquele tipo (ex.: só Boletos)
Vazio (NULL)	A regra de complemento é genérica — aplica-se a qualquer tipo de conta

Preenchido — Regra específica por Tipo de Conta

Simulação passo a passo

1. Acesse TFC007 — Parâmetros de Complemento de Caixa.
2. Posicione o cursor no campo Complemento por Tipo de Conta.
3. Pressione <F9> para abrir a janela de pesquisa Lista de Tipos de Conta.
4. Selecione um tipo de conta, por exemplo "Boleto" (código 2).
5. O campo será preenchido com o código e a descrição aparecerá ao lado.
6. Preencha os demais filtros (Tipo de Documento, Tipo de Baixa, Tipo de Processo) e o campo Complemento.
7. Salve o registro.

Resultado esperado: Ao baixar uma conta cujo tipo seja "Boleto", o sistema utilizará esta regra para gerar o complemento automaticamente. Contas de outros tipos não serão afetadas por esta regra.

Exceção / Importante: A procedure RETORNA_PARMCOMPLEMENTOCAIXA utiliza uma hierarquia de fallback. Se não existir regra com CD_TIPOCONTA preenchido para a combinação exata dos filtros, o sistema busca regras mais genéricas (com CD_TIPOCONTA = NULL) até encontrar um complemento aplicável.

Vazio (NULL) — Regra genérica

Simulação passo a passo

1. Acesse TFC007 — Parâmetros de Complemento de Caixa.
2. Deixe o campo Complemento por Tipo de Conta vazio (não pressione <F9>).
3. Preencha os demais filtros conforme necessário e o campo Complemento.
4. Salve o registro.

Resultado esperado: Esta regra servirá como fallback para qualquer tipo de conta que não possuir uma regra específica. A procedure percorre 15 níveis de especificidade, e as regras com CD_TIPOCONTA = NULL são usadas quando nenhuma regra com tipo de conta específico é encontrada.

Regra de fallback (hierarquia de busca)

A procedure RETORNA_PARMCOMPLEMENTOCAIXA busca o complemento na seguinte ordem, do mais específico ao mais genérico:

Prioridade	CD_TIPOCONTA	TP_DOCUMENTO	TP_BAIXA	TP_PROCESSO
1	✓ preenchido	✓ preenchido	✓ preenchido	✓ preenchido
2	NULL	✓ preenchido	✓ preenchido	✓ preenchido
3	✓ preenchido	NULL	✓ preenchido	✓ preenchido
4	✓ preenchido	✓ preenchido	NULL	✓ preenchido
5	✓ preenchido	✓ preenchido	✓ preenchido	NULL
6–9	2 campos preenchidos	—	—	—
10–13	1 campo preenchido	—	—	—
14	todos NULL	—	—	—

A primeira combinação que encontrar DS_COMPLEMENTO é retornada.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
edtCD_TIPOCONTAKeyDown	source/TFC007/UTFC007.pas	Abre pesquisa <F9> na tabela TIPOCONTA e preenche CD_TIPOCONTA + DS_TIPOCONTA

Scripts SQL com referência direta ao campo da tabela PARMCOMPLCAIXA

Procedure	Arquivo	Descrição
RETORNA_PARMCOMPLEMENTOCAIXA	Scripts/RETORNA_PARMCOMPLEMENTOCAIXA.sql	Recebe I_CD_TIPOCONTA como parâmetro e usa na hierarquia de fallback contra PARMCOMPLCAIXA.CD_TIPOCONTA
RETORNA_COMPLEMENTO	Scripts/RETORNA_COMPLEMENTO.sql	Orquestra a geração do complemento; consulta PARMCOMPLCAIXA via RETORNA_COMPLEMENTOPROCESSO_MX

Nota: CD_TIPOCONTA aparece em dezenas de outras tabelas (CONTAS, CHEQUE, BOLETO etc.) como coluna funcional — essas referências não estão relacionadas ao parâmetro de PARMCOMPLCAIXA e sim ao tipo de conta do lançamento financeiro.

Tabela comparativa resumida

Situação do campo	Escopo da regra	Prioridade na busca
Preenchido (ex.: código 2)	Somente contas do tipo "Boleto"	Alta — verificado primeiro
Vazio (NULL)	Qualquer tipo de conta (genérico)	Baixa — usado como fallback