DS_URL - Endereço da API Scanntech
Tela de configuração: MFA015 - Parâmetros de Faturamento
Localização: Aba CRM Zen → Seção Scanntech
Tabela: PARMSCANNTECH.DS_URL
Tipo: DOM_VARCHAR100 NOT NULL
Valor padrão: Nenhum
Descrição
Campo de texto livre que armazena a URL base (endpoint) da API Scanntech. Essa URL é consumida pelo módulo JunsoftIntegracao para autenticar e enviar dados de notas fiscais para a plataforma Scanntech.
Campos envolvidos
| Campo | Tabela | Tipo | Obrigatório |
|---|
| DS_URL | PARMSCANNTECH | VARCHAR(100) | Sim |
Parâmetros relacionados na mesma tabela
| Parâmetro | Tipo | Descrição |
|---|
DS_USUARIO | VARCHAR(100) | Usuário de autenticação Scanntech |
DS_SENHA | VARCHAR(100) | Senha de autenticação Scanntech |
CD_EMPRESA | INTEGER | Empresa vinculada à configuração |
HR_FREQUENCIA | TIME | Frequência de sincronização (padrão: 01:00:00) |
TP_REENVIO | INTEGER | Tipo de reenvio (padrão: 12) |
Comportamento
| O que faz | Detalhe |
|---|
| Armazena URL do endpoint Scanntech | Texto livre, até 100 caracteres |
| Campo obrigatório | NOT NULL no banco de dados |
| Utilizado em tempo de integração | Atribuído como UrlBase no módulo dmAPIScanntech |
Simulação passo a passo
- Acesse a tela MFA015 - Parâmetros de Faturamento.
- Navegue até a aba CRM Zen.
- Localize a seção Scanntech.
- No campo Endereço, digite a URL base da API Scanntech (ex.:
https://api.scanntech.com.br/v1).
- Certifique-se de que
DS_USUARIO e DS_SENHA também estejam preenchidos com as credenciais válidas.
- Salve a configuração.
Resultado esperado: A URL informada será utilizada como endpoint base pelo JunsoftIntegracao ao executar a rotina de integração Scanntech. Todas as requisições HTTP (autenticação, envio de notas, consultas) serão direcionadas para este endereço.
Exceção / Importante: Se a URL estiver incorreta ou o serviço estiver indisponível, a integração falhará ao tentar conectar. O campo é NOT NULL, portanto não é possível salvar com valor vazio. A URL deve incluir o protocolo (http:// ou https://) e o caminho base da API.
Telas impactadas
| Tela | Impacto |
|---|
| MFA015 | Tela onde o parâmetro é configurado |
| JunsoftIntegracao (módulo Scanntech) | Consome DS_URL como UrlBase para todas as requisições à API Scanntech |
Procedures impactadas
| Rotina | Arquivo | Descrição |
|---|
TdmIntegracaoScanntech.StartScanntech | source/JunsoftIntegracao/IntegracaoScanntech/DataModule/UdmIntegracaoScanntech.pas | Lê tabPARMSCANNTECHDS_URL e atribui como dmAPIScanntech.UrlBase |
TdmAPIScanntech.LogGeralEnvio | source/JunsoftIntegracao/IntegracaoScanntech/DataModule/UdmAPIScanntech.pas | Registra a URL utilizada no log geral de envio |
Nenhuma procedure ou view SQL com referência direta ao campo PARMSCANNTECH.DS_URL foi encontrada em Scripts/.
Candidatas por uso da tabela
| Procedure/View | Arquivo | Observação |
|---|
GRAVA_NOTAENVIOSCANNTECH | Scripts/GRAVA_NOTAENVIOSCANNTECH.sql | Declara variável V_CD_PARMSCANNTECH mas não referencia DS_URL diretamente. Validar se indiretamente utiliza a configuração de URL |