NRCNPJMATRIZ - CNPJ Matriz para Exportação RQG

Tela de configuração: REC001 - Parâmetros da Recapadora Localização: Painel pnl6 (lado direito inferior da aba Cadastro) Tabela: PARAMRECAP.NRCNPJMATRIZ Tipo: VARCHAR(22) — campo de texto livre Valor padrão: vazio (não obrigatório)

---

Descrição

Armazena o CNPJ da empresa matriz que será utilizado na exportação do arquivo RQG da Vipal pela tela RRC006 (Relatório de Recapagem). Este CNPJ é gravado no primeiro campo do arquivo RQG exportado, identificando a matriz da empresa perante a Vipal.

Tooltip exibido na tela (mousemove):

"Esta informação indica qual CNPJ será utilizado na exportação RQG da Vipal (RRC006). Este CNPJ vai no primeiro campo do arquivo RQG (CNPJ da Matriz)."

---

Telas impactadas

Tela	Função
REC001	Tela de configuração — onde o parâmetro é cadastrado/editado
RRC006	Relatório de Recapagem — utiliza o CNPJ para gerar o arquivo RQG exportado à Vipal

---

Campos envolvidos

Campo	Tabela	Tipo	Descrição
NRCNPJMATRIZ	PARAMRECAP	VARCHAR(22)	CNPJ da matriz usado na exportação RQG

---

Comportamento

Aspecto	Detalhe
Editável?	Sim — campo de texto livre (TDBEdit)
Obrigatório?	Não — pode ficar vazio sem bloqueio
Validação ao sair do campo (OnExit)	1) Mínimo de 14 dígitos; 2) Validação de dígito verificador via VerificaCnpjCpf
Formatação	O valor validado é armazenado com formatação aplicada por VerificaCnpjCpf
Impacto funcional	O CNPJ é lido pela tela RRC006 e escrito no primeiro campo do arquivo RQG exportado

---

Simulação passo a passo

Configuração do CNPJ Matriz

1. Acesse a tela REC001 (Parâmetros da Recapadora).
2. Na aba Cadastro, localize o painel inferior direito (pnl6) com o campo "Nr. Cnpj Matriz".
3. Clique no campo de edição (edtNRCNPJMATRIZ).
4. Digite o CNPJ da empresa matriz (ex: 12.345.678/0001-90 ou 12345678000190).
5. Pressione Tab ou clique em outro campo para disparar a validação.
   • Se o CNPJ tiver menos de 14 dígitos: o foco retorna ao campo e uma mensagem é exibida: "O CNPJ deve conter no mínimo 14 dígitos!".
   • Se o CNPJ for inválido (dígito verificador incorreto): uma exceção é lançada com a mensagem: "CNPJ Inválido!" e o valor não é salvo.
   • Se o CNPJ for válido: o valor formatado é atribuído ao campo.
6. Salve o registro.

Resultado esperado: O CNPJ da matriz fica gravado em PARAMRECAP.NRCNPJMATRIZ e passa a ser utilizado pela tela RRC006 ao exportar o arquivo RQG para a Vipal, sendo posicionado no primeiro campo do arquivo.

---

Uso na exportação RQG (RRC006)

1. Acesse a tela RRC006 (Relatório de Recapagem).
2. Gere o relatório/planilha com os dados de recapagem.
3. Ao exportar o arquivo RQG, o sistema lê o valor de PARAMRECAP.NRCNPJMATRIZ da empresa corrente.
4. O CNPJ é convertido para VARCHAR(18) e posicionado como CNPJ_MATRIZ no primeiro campo do registro exportado.

Resultado esperado: O arquivo RQG gerado contém o CNPJ da matriz no primeiro campo de cada linha, conforme layout da Vipal.

---

Exceção / Importante:

• O campo só é utilizado pela exportação RQG na tela RRC006. Se o campo estiver vazio, o arquivo RQG exportará o primeiro campo vazio ou nulo.
• A validação de CNPJ é feita exclusivamente no evento OnExit do campo na tela REC001. Alterações diretas no banco de dados não passam por esta validação.

---

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TframeREC001.edtNRCNPJMATRIZExit	source/REC001/UframeREC001.pas:1291	Validação do CNPJ ao sair do campo (mínimo 14 dígitos + dígito verificador)
TframeREC001.pnl6MouseMove	source/REC001/UframeREC001.pas:1336	Exibe tooltip explicativo sobre o campo

Referências SQL diretas ao campo

Rotina	Arquivo	Linha	Evidência
TfrmRRC006.btnProcurarClick	source/RRC006/URRC006.pas	541	CAST(PR.NRCNPJMATRIZ AS VARCHAR(18)) CNPJ_MATRIZ — campo é selecionado para compor o dataset do relatório/exportação RQG

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

As procedures/views abaixo acessam a tabela PARAMRECAP mas não citam o campo NRCNPJMATRIZ literalmente. Não há impacto funcional direto identificado sobre este campo.

Procedure/View	Arquivo
ATUALIZA_PEDIDONOTA	Scripts/ATUALIZA_PEDIDONOTA.sql
ATUALIZA_PREVISAOORDEMPROD	Scripts/ATUALIZA_PREVISAOORDEMPROD.sql
ATUALIZA_STFATURAAUTO	Scripts/ATUALIZA_STFATURAAUTO.sql
CANCELA_ESTOQUERECAP	Scripts/CANCELA_ESTOQUERECAP.sql
FECHA_ORDEMPRODUCAORECAP	Scripts/FECHA_ORDEMPRODUCAORECAP.sql
GERA_NOTAPEDIDO	Scripts/GERA_NOTAPEDIDO.sql
GERA_ORDEMPRODUCAORECAP	Scripts/GERA_ORDEMPRODUCAORECAP.sql
(entre outras 15+ procedures listadas no inventário)	—

---

Schema da tabela

-- Trecho relevante de PARAMRECAP
NRCNPJMATRIZ  DOM_VARCHAR22   -- CNPJ da matriz para exportação RQG (Vipal)