CD_HISTORICO - Histórico Padrão (Movimentos e Operações)
Tela de configuração: MFA001 - Parâmetros de Faturamento
Localização: Aba Operação 1 → campo "Movimentos e Operações Padrão"
Tabela: PARMFATUR.CD_HISTORICO (DOM_INTEGER)
Valor padrão: Nenhum (campo opcional)
Componente: edtCD_HISTORICO (TDBEdit) com lookup <F9> para a tabela HISTORICO
Descrição
Define o código de histórico padrão utilizado nas movimentações de caixa automáticas geradas pelo faturamento da empresa (trocas, vendas à vista, etc.). Quando preenchido, o sistema utiliza esse histórico ao chamar GRAVA_MOVTOCAIXA para registrar o movimento financeiro.
O campo é um edit simples que aceita o código numérico de um registro ativo na tabela HISTORICO. O valor ao lado (DS_HISTORICO) é apenas leitura e exibe a descrição correspondente.
Telas impactadas
| Tela | Contexto |
|---|
| MFA001 / PARMFATUR | Configuração do parâmetro |
| MNF009 (Troca) | Na confirmação de troca à vista: se CD_HISTORICO estiver preenchido, chama GRAVA_MOVTOCAIXA com tipo 'AV'; caso contrário, abre a tela de caixa via AbreCaixa (shared jCaixa) |
| CPD009 | Consulta de parâmetros — exibe PARMFATUR.CD_HISTORICO com JOIN em HISTORICO |
| RCA006 | Consulta de parâmetros — mesmo padrão do CPD009 |
| MPD011 | Carrega PF.CD_HISTORICO ao gerar nota fiscal automática |
Campos envolvidos
| Campo | Tabela | Tipo | Descrição |
|---|
CD_HISTORICO | PARMFATUR | DOM_INTEGER | Código do histórico padrão configurado |
DS_HISTORICO | HISTORICO | DOM_VARCHAR60 | Descrição do histórico (somente leitura, via JOIN) |
Regra de funcionamento
| O que faz | Detalhe |
|---|
| Campo livre (edit) | Aceita qualquer código de HISTORICO ativo (ST_ATIVO = 'S') |
| Opcional | Pode ficar vazio — nesse caso, telas como MNF009 abrem o caixa manual |
Lookup <F9> | Abre lista de históricos cadastrados |
| Sem validação rígida | Não há validação OnValidate específica para este campo no data module do MFA001 |
Simulação passo a passo
- Acesse a tela MFA001 - Parâmetros de Faturamento.
- Selecione a aba Operação 1.
- Posicione o cursor no campo Movimentos e Operações Padrão.
- Tecle
<F9> para abrir a lista de históricos, ou digite diretamente o código numérico.
- Selecione o histórico desejado (ex.: histórico
5 - Venda de Produtos).
- Confirme a seleção — a descrição aparecerá ao lado.
- Salve os parâmetros (
<F6>).
Resultado esperado: O histórico informado passa a ser utilizado como padrão nas movimentações de caixa geradas automaticamente pelo faturamento desta empresa. Na tela de Troca (MNF009), ao confirmar uma troca à vista, o sistema grava o movimento de caixa diretamente via GRAVA_MOVTOCAIXA usando este histórico, sem necessidade de abrir a tela de caixa manual.
Exceção / Importante: Se o campo ficar vazio, o comportamento muda: na confirmação de trocas à vista (MNF009), o sistema abre a tela de caixa (AbreCaixa via shared jCaixa) para que o operador registre manualmente o movimento. Isso dá flexibilidade, mas exige intervenção do usuário.
Procedures impactadas
| Rotina | Arquivo | Observação |
|---|
edtCD_HISTORICO2KeyDown | source/MFA001/UMFA001.dfm / .pas | Handler do campo na tela de parâmetros |
GRAVA_MOVTOCAIXA(..., I_CD_HISTORICO, ...) | Scripts/GRAVA_MOVTOCAIXA.sql | Recebe o código como parâmetro I_CD_HISTORICO para gravar movimentação de caixa |
| Rotina | Arquivo | Observação |
|---|
dmMFA001 (SELECT PARMFATUR) | source/MFA001/UdmMFA001.dfm | LEFT JOIN HISTORICO H1 ON (PARMFATUR.CD_HISTORICO = H1.CD_HISTORICO) — exibe descrição |
dmCPD009 (SELECT PARMFATUR) | source/CPD009/UdmCPD009.dfm | Mesmo padrão de JOIN |
dmRCA006 (SELECT PARMFATUR) | source/RCA006/UdmRCA006.dfm | Mesmo padrão de JOIN |
UdmMPD011.RetornaParamsFatur | source/MPD011/UdmMPD011.pas | Carrega PF.CD_HISTORICO junto com outros parâmetros de faturamento |
Candidatas por uso da tabela PARMFATUR (sem referência direta ao campo)
As procedures abaixo acessam PARMFATUR mas não referenciam CD_HISTORICO literalmente em seus scripts. O impacto é indireto, pois o campo pode ser lido via SELECT * ou por colunas dinâmicas.
| Procedure | Arquivo |
|---|
ATUALIZA_PESSOA | Scripts/ATUALIZA_PESSOA.sql |
ATUALIZA_PRECOVENDA | Scripts/ATUALIZA_PRECOVENDA.sql |
CALCULA_COMISSAO | Scripts/CALCULA_COMISSAO.sql |
CANCELA_MESTRA | Scripts/CANCELA_MESTRA.sql |
CANCELA_NOTAFISCAL | Scripts/CANCELA_NOTAFISCAL.sql |
GERA_CONTROLEENTREGA | Scripts/GERA_CONTROLEENTREGA.sql |
GERA_CONTROLEENTREGAPEDIDO | Scripts/GERA_CONTROLEENTREGAPEDIDO.sql |
EXPORTACAO_SOVIS | Scripts/EXPORTACAO_SOVIS.sql |
Tabela relacionada
| Tabela | Chave | Descrição |
|---|
HISTORICO | CD_HISTORICO | Plano de Contas Gerencial — categoriza entradas e saídas por tipo de gasto ou receita |