CD_LAYPROCESSO — Layout de Processo (Financeiro)

Tela de configuração: FNC001 — Parâmetros Financeiros
Aba: &Layouts/Relatórios
Campo na tela: editCD_LAYPROCESSO (DBEdit, CharCase = ecUpperCase)
Tabela: PARMFINANC.CD_LAYPROCESSO
Tipo / Tamanho: DOM_VARCHAR6 (VARCHAR até 6 caracteres)
Valor padrão: Não definido (campo pode ficar vazio)

---

O que faz

Armazena o código do layout de impressão utilizado para a listagem/impressão de Processos Financeiros (ex.: LPR003). O valor e` usado por rotinas Delphi que buscam o layout de relatório associado ao processo na tela CFC001 (Cobrança) e MFC004 (Mov. Financeiro / Baixa).

Se o campo estiver vazio, o sistema adota o layout padrão LPR003 (conforme fallback em UCFC001).

Telas impactadas

Tela	Nome	Impacto
FNC001	Parâmetros Financeiros	Tela de configuração (cadastro/edição do valor)
CFC001	Cobrança	Botão "Processo" — usa o valor para imprimir/listar o processo
MFC004	Movimentação (Baixa / Filtro)	Usa iCd_LayProcesso para carregar layout do processo no filtro de contas

Campos envolvidos

Campo	Tabela	Tipo
CD_LAYPROCESSO	PARMFINANC	DOM_VARCHAR6

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Uso
TfrmCFC001.btnProcessoClick	source/CFC001/UCFC001.pas	1740	SELECT CD_LAYPROCESSO FROM PARMFINANC WHERE CD_EMPRESA = ? — fallback LPR003 se vazio
iniciar	source/MFC004/UMFC004.pas	341 / 354	Lê CD_LAYPROCESSO (coluna 8 da query) → dmMFC004.iCd_LayProcesso
ContarQuebras	source/MFC004/UMFC004.pas	2155–2163	Se iCd_LayProcesso <> '', monta array de parâmetros e chama CarregaLayout()
ValidaDocumentoFiltro	source/MFC004/UdmMFC004.pas	264	Declaração da variável iCd_LayProcesso no data module

Referências SQL diretas ao campo

Nenhuma referência direta ao campo CD_LAYPROCESSO encontrada em Scripts/.

Candidatas por uso da tabela PARMFINANC (sem referência direta ao campo)

As procedures abaixo usam PARMFINANC, mas não citam CD_LAYPROCESSO literalmente — podem ser impactadas se futuramente o campo for referenciado:

EXECUTA_PROCESSO (linha 80), GRAVA_MOVTOPROCESSO (linha 276), GRAVA_PROCESSOSMART (linha 182), CALCULA_CAPITAL, CALCULA_JURO, CALCULA_JUROMORA, GRAVA_MOVTOCAIXA, GRAVA_MOVTOCAIXAINDIVIDUAL, GERA_DUPLICATAS, PROCESSA_FATURA, CONTROLE_CAIXA, CONTABILIZA_REPARCELAMENTO, entre outras.

---

Opções disponíveis

Como se trata de um campo de texto livre (VARCHAR6), não há opções predefinidas. O valor digitado deve corresponder ao código de um layout de relatório previamente cadastrado no sistema (gerencia de layouts FastReport, via CarregaLayout()).

O que faz	Detalhe
Preencher com código de layout (ex.: LPR003)	Layout será usado ao imprimir/listar processos
Campo vazio	Sistema usa fallback LPR003 (em CFC001) ou simplesmente não carrega layout (em MFC004)

Comportamento por contexto

Impressão de Processo via CFC001 (Cobrança)

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Acesse a aba &Layouts/Relatórios.
3. Localize o campo Layout de Processo (CD_LAYPROCESSO).
4. Digite o código do layout desejado (ex.: LPR003).
5. Clique em Salvar (ou pressione Ctrl+S).
6. Acesse a tela CFC001 (Cobrança).
7. Selecione um processo na grade.
8. Clique no botão Processo (ícone de impressora / btnProcessoClick).

Resultado esperado: O sistema gera o relatório do processo financeiro utilizando o layout informado no parâmetro (ou LPR003 como fallback se o campo estiver vazio).

Exceção / Importante: Se CD_LAYPROCESSO estiver vazio, o código em UCFC001 define automaticamente Layout := 'LPR003' — isto e um fallback **apenas em CFC001**. Em MFC004, o processo não executa o bloco de layout se o valor for vazio (if Trim(iCd_LayProcesso) <> ''`).

Impressão de Processo via MFC004 (Baixa / Filtro)

Simulação passo a passo

1. Acesse FNC001 e preencha o campo Layout de Processo com um código válido (ex.: LPR003). Salve.
2. Abra a tela MFC004 (Movimentação Financeira / Filtro).
3. A rotina iniciar carrega iCd_LayProcesso automaticamente de PARMFINANC.
4. Ao aplicar um filtro que envolva nrProcesso e acionar a ação de contagem (ex.: ContarQuebras), o sistema usa o layout configurado.

Resultado esperado: Se iCd_LayProcesso estiver preenchido, o sistema monta os parâmetros (layout, empresa, processo, path, tipo) e carrega o relatório via CarregaLayout(). Se vazio, o bloco de impressão é pulado.

Exceção / Importante: Em MFC004, TP_PROCESSO e NR_PROCESSO precisariam estar definidos para que o layout seja corretamente acionado. O layout também depende do código existir no gerenciador de relatórios — se inexistente, a exceção é capturada e exibida via msgcodigo('W-0000', [...]).

---

Regra Geral de Uso

• O valor de CD_LAYPROCESSO é lido durante a inicialização de MFC004 e consultado sob demanda em CFC001.
• Não ha` validação de existência do layout no momento do preenchimento (campo DBEdit livre) — a verificação ocorre ao executar o relatório.
• Para alterar o layout de processo, basta editar o valor em FNC001 e salvar; a alteração e` refletida imediatamente nas telas dependentes (sem necessidade de reiniciar o sistema).

Tabela Comparativa Resumida

Situação	CD_LAYPROCESSO	Resultado
Campo preenchido com código válido	LPR003	Relatório usa LPR003 tanto em CFC001 quanto em MFC004
Campo vazio	(vazio)	CFC001 usa LPR003 (fallback); MFC004 não carrega layout
Campo preenchido com código inválido	XXXXXX	Falha de layout ao imprimir (exceção capturada, W-0000)

---

Referências rápidas

Item	Localização
Tabela DDL	docs/schema/tables/PARMFINANC.sql (linha 16)
Formulário	source/FNC001/UFNC001.dfm (linha 4402–4411)
Data Module	source/FNC001/UdmFNC001.dfm (linha 370–374)
Uso CFC001	source/CFC001/UCFC001.pas (linha 1740–1754)
Uso MFC004	source/MFC004/UMFC004.pas (linha 2155–2164)