CD_PARMSCANNTECH — Código do Parâmetro Scanntech
Tela de configuração: MFA015 — Parâmetros de Faturamento Tabela:
PARMSCANNTECH.CD_PARMSCANNTECHTipo:DOM_INTEGER NOT NULLValor padrão:1(atribuído automaticamente no eventoAfterInsert)
Descrição
CD_PARMSCANNTECH é a chave primária da tabela PARMSCANNTECH, que armazena a configuração global da integração com o Scanntech. O sistema sempre mantém um único registro (SELECT FIRST 1), portanto o campo recebe automaticamente o valor 1 e não é editável pelo usuário.
Esse código funciona como chave estrangeira de ligação para todas as tabelas filhas da integração Scanntech, garantindo que empresas, perfis, movimentações e séries estejam vinculados à mesma configuração:
| Tabela filha | PK composta | Relação |
|---|---|---|
EMPRESASCANNTECH | (CD_PARMSCANNTECH, CD_EMPRESA) | Empresas integradas |
PERFILSCANNTECH | (CD_PARMSCANNTECH, CD_PERFIL) | Perfis autorizados |
MOVIMENTACAOSCANNTECH | (CD_PARMSCANNTECH, CD_MOVIMENTACAO) | Movimentações monitoradas |
SERIESCANNTECH | (CD_PARMSCANNTECH, CD_SERIE) | Séries de nota vinculadas |
Telas impactadas
| Tela | Contexto |
|---|---|
| MFA015 | Aba Scanntech — cadastro e manutenção do parâmetro e grids filhos |
Módulo JunsoftIntegracao (UdmIntegracaoScanntech) | Sincronização de vendas, reenvio de fechamento/vendas, preenchimento de notas e itens |
Campos envolvidos
| Campo | Tabela | Tipo | Observação |
|---|---|---|---|
CD_PARMSCANNTECH | PARMSCANNTECH | INTEGER | PK, valor fixo 1 |
DS_USUARIO | PARMSCANNTECH | VARCHAR(100) | Obrigatório — credencial Scanntech |
DS_SENHA | PARMSCANNTECH | VARCHAR(100) | Obrigatório — credencial Scanntech |
CD_EMPRESA | PARMSCANNTECH | INTEGER | Obrigatório — empresa padrão |
DS_URL | PARMSCANNTECH | VARCHAR(100) | Obrigatório — URL do serviço |
HR_FREQUENCIA | PARMSCANNTECH | TIME | Default 01:00:00 — frequência de sincronização |
TP_REENVIO | PARMSCANNTECH | INTEGER | Default 12 — tipo de reenvio |
Opções disponíveis
1 — Registro Único Global (valor fixo, não editável)
| O que faz | Detalhe |
|---|---|
| Identifica a configuração Scanntech | Valor 1 atribuído automaticamente |
| Não pode ser alterado pelo usuário | Evento AfterInsert define CD_PARMSCANNTECH = 1 |
| Único registro permitido | Query pai usa SELECT FIRST 1 |
Simulação passo a passo
- Acesse a tela MFA015 — Parâmetros de Faturamento.
- Selecione a aba Scanntech.
- Clique em Inserir para criar a configuração.
- O sistema atribui automaticamente
CD_PARMSCANNTECH = 1,HR_FREQUENCIA = 01:00:00eTP_REENVIO = 12. - Preencha os campos obrigatórios: Usuário, Senha, Empresa e URL.
- Adicione nos grids filhos as empresas, perfis, movimentações e séries desejadas.
- Salve o registro.
Resultado esperado: Uma única configuração Scanntech fica cadastrada com CD_PARMSCANNTECH = 1. Todos os grids filhos (empresas, perfis, movimentações, séries) são filtrados e vinculados a esse código.
Exceção / Importante:
- Campos obrigatórios no
BeforePostde PARMSCANNTECH:DS_USUARIO,DS_SENHA,CD_EMPRESAeHR_FREQUENCIA. Se algum estiver vazio, o sistema exibe erro com foco no campo faltante.- Ao abrir a aba Scanntech, o evento
AfterOpenrecarrega automaticamente todos os grids filhos com oCD_PARMSCANNTECHdo registro atual.- Cada grid filho copia o
CD_PARMSCANNTECHdo pai no seuBeforePost, garantindo a integridade da FK.
Regra de integração com notas
A procedure SQL GRAVA_NOTAENVIOSCANNTECH utiliza CD_PARMSCANNTECH para:
- Buscar a configuração Scanntech (
SELECT FIRST 1 CD_PARMSCANNTECH FROM PARMSCANNTECH). - Relacionar séries, movimentações e empresas configuradas com as notas geradas.
- Marcar as notas que devem ser enviadas ao Scanntech com base nos parâmetros cadastrados.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Descrição |
|---|---|---|
TdmIntegracaoScanntech.actSincVendasExecute | UdmIntegracaoScanntech.pas | Repassa CD_PARMSCANNTECH para filtrar empresas na sincronização de vendas |
TdmIntegracaoScanntech.preencheDadosNota | UdmIntegracaoScanntech.pas | Preenche parâmetro nas notas para envio |
TdmIntegracaoScanntech.preencheItensNota | UdmIntegracaoScanntech.pas | Preenche parâmetro nos itens de nota |
TdmIntegracaoScanntech.reenvioFechamento | UdmIntegracaoScanntech.pas | Filtra empresas no reenvio de fechamento |
TdmIntegracaoScanntech.reenvioVendas | UdmIntegracaoScanntech.pas | Filtra empresas no reenvio de vendas |
TdmPrincipal.IntegracaoScanntech | UdmPrincipal.pas | Busca SELECT FIRST 1 CD_PARMSCANNTECH para iniciar integração |
TfrmMFA015.abreParmScanntech | UMFA015.pas | Abre a tabela de parâmetros Scanntech |
TdmMFA015.tabPARMSCANNTECHAfterInsert | UdmMFA015.pas | Atribui CD_PARMSCANNTECH = 1 ao inserir novo registro |
TdmMFA015.tabPARMSCANNTECHAfterOpen | UdmMFA015.pas | Ao abrir, repassa CD_PARMSCANNTECH para todos os datasets filhos |
TdmMFA015.tabEMPRESASCANNTECHBeforePost | UdmMFA015.pas | Copia FK do pai |
TdmMFA015.tabPERFILSCANNTECHBeforePost | UdmMFA015.pas | Copia FK do pai |
TdmMFA015.tabSERIESCANNTECHBeforePost | UdmMFA015.pas | Copia FK do pai |
TdmMFA015.tabMOVIMENTACAOSCANNTECHBeforePost | UdmMFA015.pas | Copia FK do pai |
TdmMFA015.tabEMPRESASCANNTECHCD_EMPRESAValidate | UdmMFA015.pas | Valida unicidade da empresa |
TdmMFA015.tabPERFILSCANNTECHCD_PERFILValidate | UdmMFA015.pas | Valida unicidade do perfil |
TdmMFA015.tabMOVIMENTACAOSCANNTECHCD_MOVIMENTACAOValidate | UdmMFA015.pas | Valida unicidade da movimentação |
Scripts SQL com referência direta ao campo
| Procedure/View | Arquivo | Descrição |
|---|---|---|
GRAVA_NOTAENVIOSCANNTECH | Scripts/GRAVA_NOTAENVIOSCANNTECH.sql | Utiliza CD_PARMSCANNTECH para filtrar séries, movimentações e empresas na gravação de notas enviadas ao Scanntech |
Tabela Comparativa Resumida
| Aspecto | Comportamento |
|---|---|
| Valor | Sempre 1 |
| Editável | Não (atribuído automaticamente) |
| Registros permitidos | 1 (único global) |
| FK nos filhos | Copiada automaticamente no BeforePost de cada grid filho |
| Obrigatoriedade dos campos pai | DS_USUARIO, DS_SENHA, CD_EMPRESA, HR_FREQUENCIA |