SN_ASSOCIADOSPC - Senha do Associado SCPC

Tela de configuração: FNC001 — Parâmetros Financeiros

Tabela: PARMFINANC.SN_ASSOCIADOSPC

Tipo: VARCHAR(10)

Valor padrão: NULL (vazio)

Campo pareado: CD_ASSOCIADOSPC (código do associado) e TP_CONSULTASCPC (tipo de consulta)

Resumo

SN_ASSOCIADOSPC armazena a senha do associado utilizada para consultas ao serviço de proteção ao crédito (SCPC/ACPR — Serasa). Esse campo só é exibido e utilizado quando o parâmetro TP_CONSULTASCPC está configurado como T (consulta via Tan/Serac).

Exceção / Importante: Se TP_CONSULTASCPC for L (Serasa), B (Boa Vista) ou W (Web/SCPCMix), os campos CD_ASSOCIADOSPC e SN_ASSOCIADOSPC ficam ocultos e não são usados. Cada tipo de consulta utiliza credenciais próprias.

Telas impactadas

Tela	Descrição	Impacto
FNC001	Parâmetros Financeiros	Campo editável para a senha do associado SCPC
Tela interna de consulta SCPC	Consulta Serasa/ACPR	Usa a senha para montar mensagem de consulta ao SCPC

Campos envolvidos

Campo	Tabela	Tipo	Finalidade
SN_ASSOCIADOSPC	PARMFINANC	VARCHAR(10)	Senha do associado SCPC
CD_ASSOCIADOSPC	PARMFINANC	VARCHAR(10)	Código do associado SCPC
TP_CONSULTASCPC	PARMFINANC	CHAR(1)	Tipo de consulta SCPC (T, L, B, W, S)

Opções disponíveis

O que faz	Detalhe
Visível e editável	Quando TP_CONSULTASCPC = 'T' (configurado em FNC001 — Parâmetros Financeiros, campo TP_CONSULTASCPC).
Oculto/bloqueado	Quando TP_CONSULTASCPC for L, B, W ou S.
Exigido em runtime	A rotina de consulta SCPC valida SN_ASSOCIADOSPC <> vazio; caso vazio, lança exceção: "Senha de Associado Não Cadastrado! [FNC001]".

Comportamento quando TP_CONSULTASCPC = T

Simulação passo a passo

1. Acesse a tela FNC001 — Parâmetros Financeiros.
2. Localize o campo Tipo Consulta SCPC (TP_CONSULTASCPC) e selecione T (Tan/Serac).
3. Observe que os campos Código do Associado (CD_ASSOCIADOSPC) e Senha do Associado (SN_ASSOCIADOSPC) tornam-se visíveis.
4. Digite no campo Senha do Associado a senha fornecida pela ACPR (ex: SENHA123).
5. Salve os parâmetros.

Resultado esperado: A senha é gravada em PARMFINANC.SN_ASSOCIADOSPC e estará disponível para as consultas SCPC.

Excecao / Importante: Se a senha estiver vazia ao executar uma consulta SCPC (tipo T), o sistema exibe o erro: "Senha de Associado Não Cadastrado! [FNC001]". O mesmo ocorre se o código do associado (CD_ASSOCIADOSPC) estiver vazio.

Comportamento quando TP_CONSULTASCPC = L, B, W ou S

Simulação passo a passo

1. Acesse a tela FNC001 — Parâmetros Financeiros.
2. Altere o campo Tipo Consulta SCPC para qualquer valor diferente de T (ex: L — Serasa, B — Boa Vista, W — Web).
3. Observe que os campos Código do Associado e Senha do Associado ficam ocultos.
4. Salve os parâmetros.

Resultado esperado: SN_ASSOCIADOSPC e CD_ASSOCIADOSPC permanecem ocultos na tela. O valor eventualmente gravado no banco não é utilizado por essas modalidades de consulta, que possuem mecanismos de autenticação próprios.

Excecao / Importante: Para TP_CONSULTASCPC = W (Web/SCPCMix), os endpoints de homologação e produção estão fixos na rotina ConsultaSCPC, e os campos de host/porta também ficam ocultos.

Regra de validação em runtime

Quando o tipo de consulta é T (Tan/Serac), a rotina TfrmConsultaSCPC.GeraArq (source/jSCPC/UConsultaSCPC.pas):

1. Consulta PARMFINANC buscando CD_ASSOCIADOSPC e SN_ASSOCIADOSPC da empresa ativa.
2. Se CD_ASSOCIADOSPC estiver vazio → erro: "Código de Associado Não Cadastrado! [FNC001]".
3. Se SN_ASSOCIADOSPC estiver vazio → erro: "Senha de Associado Não Cadastrado! [FNC001]".
4. Ambos preenchidos → a senha é incluída na posição 05 da mensagem SCPC (formato CSR10R).

Tabela comparativa resumida

TP_CONSULTASCPC	SN_ASSOCIADOSPC visível?	SN_ASSOCIADOSPC usado?	Autenticação alternativa
T (Tan/Serac)	Sim	Sim	Código + Senha do associado
L (Serasa)	Não	Não	CD_USUARIOSPC / SN_USUARIOSPC
B (Boa Vista)	Não	Não	Credenciais próprias
W (Web/SCPCMix)	Não	Não	Endpoints fixos na rotina
S (Sem consulta)	Não	Não	N/A

Procedures impactadas

Rotinas Delphi com referencia direta ao campo

Rotina	Arquivo	Uso
TfrmFNC001.cmbTP_CONSULTASCPCChange	source/FNC001/UFNC001.pas:1073	Controla visibilidade do campo na tela FNC001 conforme TP_CONSULTASCPC
TfrmConsultaSCPC.GeraArq	source/jSCPC/UConsultaSCPC.pas:1225	Seleciona SN_ASSOCIADOSPC do banco e usa na montagem da mensagem SCPC

Candidatas por uso da tabela PARMFINANC

Não foi encontrada referencia direta ao campo SN_ASSOCIADOSPC em Scripts/. As rotinas SQL listadas abaixo usam a tabela PARMFINANC, mas ** nao referenciam este campo literalmente** — impacto funcional direto nao confirmado:

CALCULA_CAPITAL, CALCULA_JURO, CALCULA_JUROMORA, CALCULA_JUROMORA_RFC019, CANCELA_CONTAS, CONTABILIZA_REPARCELAMENTO, CONTROLE_CAIXA, ESTORNA_MOVTOCAIXA, EXECUTA_PROCESSO, GERA_DUPLICATAS, GERA_INTEGRACAO, GERA_INTEGRACAOFISCAL, GERA_MOVTOCONTABIL, GRAVA_CHEQUECARTAO, GRAVA_CONTAS, GRAVA_MOVTOCAIXA, GRAVA_MOVTOCAIXAINDIVIDUAL, GRAVA_MOVTOPROCESSO, GRAVA_PROCESSOSMART, PROCESSA_FATURA.