DS_USUARIOSERASA - Usuario de Integracao SERASA/SCPC

Tela de configuracao: FNC001 — Parametros Financeiros
Localizacao: Aba "SCPC/SERASA"
Tabela: PARMFINANC.DS_USUARIOSERASA
Tipo: VARCHAR(60) (DOM_VARCHAR60)
Componente: edtUsuarioSERASA (campo de edicao de texto livre)
Valor padrao: Nao informado (campo vazio)

Telas impactadas

Tela	Descricao	Como e usada
FNC001	Parametros Financeiros	Tela de configuracao do parametro
jSCPC — UConsultaSCPC	Consulta SCPC/SERASA	Le o usuario para autenticacao na consulta SERASA

Campos envolvidos

Campo	Tabela	Tipo	Descricao
DS_USUARIOSERASA	PARMFINANC	VARCHAR(60)	Codigo/nome do usuario para integracao SERASA
SN_SENHASERASA	PARMFINANC	VARCHAR(20)	Senha correspondente ao usuario SERASA
CD_USUARIOSPC	PARMFINANC	VARCHAR(20)	Usuario do SCPC (servico relacionado)
SN_USUARIOSPC	PARMFINANC	VARCHAR(40)	Senha do usuario SCPC
NR_HOSTSPC	PARMFINANC	VARCHAR(250)	Endereco do host para conexao SCPC/SERASA
ST_SCPC	PARMUSUARIO	CHAR(1)	Controle de acesso do usuario a consulta SCPC (configurado em ADM012 — Parametros do Usuario)

Opcoes disponiveis

Texto livre — Codigo do usuario SERASA

O que faz	Detalhe
Armazena o login de usuario	Texto livre ate 60 caracteres informado pelo fornecedor do servico SERASA/SCPC
Editavel na FNC001	Campo habilitado na aba "SCPC/SERASA" para edicao pelo usuario com acesso a tela
Usado na autenticacao	Lido durante a abertura da consulta SCPC (UConsultaSCPC.pas)
Pode ser sobrescrito	Se a rotina receber Parametros[6] preenchido, esse valor tem prioridade sobre o parametro salvo

Simulacao passo a passo

1. Acesse a tela FNC001 — Parametros Financeiros.
2. Abra a aba "SCPC/SERASA".
3. Localize o campo "Usuario SERASA" (label: "Integracao com SCPC/SERASA").
4. Digite o codigo de usuario fornecido pelo servico SERASA (ex: EMP12345).
5. Informe a senha correspondente no campo "Senha SERASA" (SN_SENHASERASA).
6. Preencha tambem o campo "Host SPC" (NR_HOSTSPC) com o endereco de conexao.
7. Salve o registro.

Resultado esperado: O usuario SERASA fica configurado para a empresa. Ao abrir a consulta SCPC/SERASA, o sistema utiliza esse login para autenticar a consulta junto ao servico SERASA. Quando o campo esta vazio, a rotina usa Parametros[6] (valor passado pela chamada); se ambos estiverem vazios, a consulta pode falhar por falta de credenciais.

Excecao / Importante:

• Acesso a consulta: O usuario do sistema precisa ter ST_SCPC = 'S' na tabela PARMUSUARIO (configurado em ADM012 — Parametros do Usuario) para poder acessar a tela de consulta SCPC. Caso contrario, recebe a mensagem: "Este Usuario nao possui Acesso a Consulta de SCPC. Verifique!".
• Validacao obrigatoria: Se CD_USUARIOSPC ou SN_USUARIOSPC estiverem vazios, o sistema exibe respectivamente: "Usuario do SCPC nao informado!" ou "Senha do SCPC nao informado!".
• Sobrescrita por parametro: A rotina CarregarConsultaSCPC aceita um array de parametros. Se Parametros[6] (indice 6) estiver preenchido, ele prioriza esse valor sobre o DS_USUARIOSERASA salvo no banco. O mesmo padrao vale para a senha (Parametros[7] vs SN_SENHASERASA). Isso permite que chamadas programaticas da consulta usem credenciais diferentes das configuradas na FNC001.

Procedures impactadas

Rotinas Delphi com referencia direta ao campo

Rotina	Arquivo	Evidencia
CarregarConsultaSCPC	source/jSCPC/UConsultaSCPC.pas	Consulta SELECT ... DS_USUARIOSERASA, SN_SENHASERASA FROM PARMFINANC (linha ~243). Le o valor de DS_USUARIOSERASA (indice 4 do resultado) para iUsuarioSerasa, a menos que Parametros[6] (chamada externa) tenha valor.

Referencias SQL diretas ao campo

Nao foram encontradas referencias diretas ao campo DS_USUARIOSERASA em scripts SQL na pasta Scripts/.

Candidatas por uso da tabela PARMFINANC

As rotinas abaixo consultam a tabela PARMFINANC, mas nao citam o campo DS_USUARIOSERASA literalmente. Validar cada uma antes de afirmar impacto funcional.

Procedure/View	Arquivo
CALCULA_CAPITAL	Scripts/CALCULA_CAPITAL.sql
CALCULA_JURO	Scripts/CALCULA_JURO.sql
CALCULA_JUROMORA	Scripts/CALCULA_JUROMORA.sql
CALCULA_JUROMORA_RFC019	Scripts/CALCULA_JUROMORA_RFC019.sql
CANCELA_CONTAS	Scripts/CANCELA_CONTAS.sql
CONTABILIZA_REPARCELAMENTO	Scripts/CONTABILIZA_REPARCELAMENTO.sql
CONTROLE_CAIXA	Scripts/CONTROLE_CAIXA.sql
ESTORNA_MOVTOCAIXA	Scripts/ESTORNA_MOVTOCAIXA.sql
EXECUTA_PROCESSO	Scripts/EXECUTA_PROCESSO.sql
GERA_DUPLICATAS	Scripts/GERA_DUPLICATAS.sql
GERA_INTEGRACAO	Scripts/GERA_INTEGRACAO.sql
GERA_INTEGRACAOFISCAL	Scripts/GERA_INTEGRACAOFISCAL.sql
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql
GRAVA_CHEQUECARTAO	Scripts/GRAVA_CHEQUECARTAO.sql
GRAVA_CONTAS	Scripts/GRAVA_CONTAS.sql
GRAVA_MOVTOCAIXA	Scripts/GRAVA_MOVTOCAIXA.sql
GRAVA_MOVTOCAIXAINDIVIDUAL	Scripts/GRAVA_MOVTOCAIXAINDIVIDUAL.sql
GRAVA_MOVTOPROCESSO	Scripts/GRAVA_MOVTOPROCESSO.sql
GRAVA_PROCESSOSMART	Scripts/GRAVA_PROCESSOSMART.sql
PROCESSA_FATURA	Scripts/PROCESSA_FATURA.sql

Regra geral de autorizacao

Aspecto	Regra
Acesso a tela FNC001	Controle por permissao no modulo de acesso (verificar TFA008)
Acesso a consulta SCPC	Usuario precisa de ST_SCPC = 'S' em PARMUSUARIO
Sobrescrita via parametro	Chamadas programaticas podem passar credenciais alternativas via Parametros[6]/Parametros[7]

Resumo de funcionamento

O campo DS_USUARIOSERASA armazena o login do usuario credenciado junto ao servico SERASA/SCPC. Ele e lido pela rotina de consulta (UConsultaSCPC.pas) no momento em que a tela de consulta SCPC e aberta (CarregarConsultaSCPC). O valor e usado para autenticar as requisicoes ao host do SERASA (indicado por NR_HOSTSPC).

Fluxo de prioridade das credenciais:

1. Se Parametros[6] foi passado na chamada da consulta → usa esse valor para usuario SERASA.
2. Senao, usa DS_USUARIOSERASA da tabela PARMFINANC da empresa logada.
3. Se ambos vazios → a consulta pode falhar ou exibir erro de autenticacao.

O mesmo comportamento se replica para a senha (indices Parametros[7] e campo SN_SENHASERASA).