CD_EMPRFILIAL — Empresa Filial para Movimentos de Entrada

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: Aba Operação 2 → campo Movimentos e Operações Padrão Tabela: PARMFATUR.CD_EMPRFILIAL (INTEGER, FK → EMPRESA.CD_EMPRESA) Controle: edtCD_EMPRFILIAL (TDBEdit, editável) Valor padrão: definido via consulta EMPRESAUSUARIO ao pressionar <F9>

Telas impactadas

Tela	Contexto	Efeito
MFA001 — Parâmetros de Faturamento	Configuração	Cadastro e validação do código da empresa filial
MNF002 — Nota Fiscal	Geração de pedidos na confirmação da NF	Utiliza CD_EMPRFILIAL como empresa destino dos pedidos de entrada e saída gerados automaticamente (modo MPD077)

Campos envolvidos

Campo	Tabela	Descrição
CD_EMPRFILIAL	PARMFATUR	Código da empresa filial
NM_EMPRESAFILIAL	PARMFATUR (virtual/lookup)	Nome da empresa filial (preenchido pelo Validate)
CD_EMPRESA	EMPRESA	Tabela referenciada pela FK RPARMFATUR_EMPRFILIAL

Comportamento

Define qual empresa (filial) será usada como proprietária dos pedidos gerados automaticamente durante a confirmação de uma Nota Fiscal no modo de pedido de filial (MPD077). O campo aceita apenas códigos de empresas cadastradas e liberadas para o usuário logado.

Validação ao preencher

Ao digitar um código e sair do campo, a rotina tabPARMFATURCD_EMPRFILIALValidate executa:

1. Verifica se o código existe na tabela EMPRESA. Se não existir, exibe: "Empresa não Cadastrada! Verifique[ADM002]!".
2. Verifica se o usuário logado tem acesso à empresa (USUARIOEMPRESA). Se não tiver, exibe: "A empresa não está liberada para o usuario X! Verifique[ADM001]!".
3. Preenche automaticamente o campo NM_EMPRESAFILIAL com o nome da empresa.

Busca (<F9>)

Ao pressionar <F9> no campo, é aberta a consulta EMPRESAUSUARIO, que lista apenas as empresas liberadas para o usuário logado. O valor selecionado é atribuído ao campo.

Opções disponíveis

O que faz	Detalhe
Código da empresa filial	Campo editável — aceita digitação direta ou seleção via <F9>. Exige que a empresa exista e esteja liberada para o usuário.

Simulação passo a passo

1. Acesse a tela MFA001 — Parâmetros de Faturamento.
2. Abra a aba Operação 2.
3. Posicione o cursor no campo Movimentos e Operações Padrão (empresa filial).
4. Digite o código da empresa filial (ex.: 5) ou pressione <F9> para abrir a consulta de empresas disponíveis.
5. Selecione a empresa desejada na lista.
6. Salve os parâmetros (Ctrl+S ou botão Salvar).

Resultado esperado: O campo CD_EMPRFILIAL fica preenchido com o código da empresa filial. Durante a confirmação de notas fiscais no modo filial (MNF002), os pedidos de entrada e saída serão gerados com CD_EMPRESA igual ao valor deste parâmetro.

Exceção / Importante:

• Se o código digitado não existir na tabela EMPRESA, a validação bloqueia com erro.
• Se o código existir mas o usuário não tiver permissão em USUARIOEMPRESA, a validação bloqueia com erro.
• O campo pode ficar vazio; nesse caso, os pedidos de filial em MNF002 não terão empresa filial definida, o que pode causar falha na geração.

Impacto funcional — Geração de Pedidos na Nota Fiscal (MNF002)

Quando uma Nota Fiscal é confirmada no modo de pedido de filial (MPD077), o sistema gera dois pedidos automaticamente usando CD_EMPRFILIAL:

Pedido	Tipo	Empresa (CD_EMPRESA)	Sequência
Pedido de Entrada	E	CD_EMPRFILIAL	SEQ_PEDIDOCOMPRA
Pedido de Saída	S	CD_EMPRFILIAL	SEQ_PEDIDOVENDA

Os itens da nota são replicados para os itens de cada pedido. A pessoa (CD_PESSOA) e o endereço do pedido são obtidos da empresa matriz (empresa logada).

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TfrmMFA001.edtCD_EMPRFILIALKeyDown	UMFA001.pas	Busca empresa via <F9> (consulta EMPRESAUSUARIO)
TdmMFA001.tabPARMFATURCD_EMPRFILIALValidate	UdmMFA001.pas	Valida existência e permissão do usuário sobre a empresa
TfrmMNF002.iniciar	UMNF002.pas	Passa CD_EMPRFILIAL como parâmetro ao abrir pedido de filial
TfrmMNF002.btnSalvarClick	UMNF002.pas	Gera pedidos de entrada/saída na empresa filial durante confirmação da NF
TdmMCO006.BuscaParametros_MCO006	UdmMCO006.pas	Carrega o campo na lista de parâmetros
TdmMNF002.BuscaParametros_MNF002	UdmMNF002.pas	Carrega o campo na lista de parâmetros
TdmMNF008.BuscaParametros_MNF008	UdmMNF008.pas	Carrega o campo na lista de parâmetros

Referências SQL diretas ao campo

Não foi encontrada referência direta ao campo CD_EMPRFILIAL em scripts SQL (Scripts/). O uso é exclusivamente via Delphi, com o valor carregado em ParmFatur.Values['CD_EMPRFILIAL'] e utilizado em instruções SQL montadas dinamicamente.

Candidatas por uso da tabela PARMFATUR

As procedures/views abaixo referenciam a tabela PARMFATUR mas não utilizam diretamente o campo CD_EMPRFILIAL. Validar individualmente antes de afirmar impacto:

• ATUALIZA_PESSOA, ATUALIZA_PRECOVENDA, BUSCAPRECORECAP, CALCULA_CENTRORESULT, CALCULA_CENTRORESULTITEM, CALCULA_COMISSAO, CALCULA_COMISSAO_V2, CALCULA_JUROVENDA, CALCULA_MAQUINA, CALCULA_MAQUINAFICHA, CANCELA_MESTRA, CANCELA_NOTAFISCAL, CONFIRMA_ORDEMSERVICO, CONFIRMA_ORDEMSERVICOMETAL, CONSOME_LOTEMATERIAPRIMA, CREDITOPERIODICO_AI0, CREDITOPERIODICOGRUPO_AI0, EXPORTACAO_ALLABOR, EXPORTACAO_DOMINIOCADASTROS, EXPORTACAO_DOMINIOCUPOM.