CD_ASSOCIADOSPC — Código de Associado (SCPC/SERASA)

Tela de configuração: FNC001 — Parâmetros Financeiros
Localização: Aba SCPC/SERASA
Tabela: PARMFINANC.CD_ASSOCIADOSPC
Tipo SQL: DOM_VARCHAR10 (VARCHAR(10))
Componente: edtCD_ASSOCIADOSPC (TDBEdit)
Campo companion: SN_ASSOCIADOSPC (senha do associado)
Valor padrão: não definido

---

Telas impactadas

Tela	Descrição	Impacto
FNC001	Parâmetros Financeiros	Exibe/oculta o campo conforme TP_CONSULTASCPC
ConsultaSCPC (UConsultaSCPC.pas)	Consulta ao SCPC/SERASA	Usa CD_ASSOCIADOSPC para montar protocolo TAN quando TP_CONSULTASCPC = 'T'

Campos envolvidos

Campo	Tabela	Tipo	Papel
CD_ASSOCIADOSPC	PARMFINANC	VARCHAR(10)	Código de associação ao SCPC (TAN)
SN_ASSOCIADOSPC	PARMFINANC	VARCHAR(10)	Senha da associação ao SCPC
TP_CONSULTASCPC	PARMFINANC	CHAR(1)	Tipo de consulta SCPC — controla visibilidade
NR_HOSTSPC	PARMFINANC	VARCHAR(250)	Endereço do servidor SCPC
NR_PORTASPC	PARMFINANC	INTEGER	Porta do servidor SCPC
NR_ENTIDADESPC	PARMFINANC	VARCHAR(10)	Código da entidade SCPC

---

Opções disponíveis

O comportamento do campo CD_ASSOCIADOSPC depende do valor de TP_CONSULTASCPC (configurado na aba SCPC/SERASA da FNC001, mesmo registro). As opções de TP_CONSULTASCPC são:

Valor	Significado	CD_ASSOCIADOSPC visível?
T	Consulta via protocolo TAN	Sim
S	Consulta via serviço Web/Online	Não (usa CD_USUARIOSPC / SN_USUARIOSPC)
L	Consulta via conexão direta (Linhas/Local)	Não
B	Consulta via Base local	Não
W	Consulta via Web Service/API	Não

T — Consulta via protocolo TAN

O que faz	Detalhe
Campo editável	Sim
Exige SN_ASSOCIADOSPC	Sim — obrigatório no envio da consulta
Exibe também	NR_HOSTSPC, NR_PORTASPC, NR_ENTIDADESPC
Restrição	TP_CONSULTASCPC deve estar com valor 'T'

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba SCPC/SERASA.
3. No campo Tipo de Consulta SCPC (TP_CONSULTASCPC), selecione a opção T (TAN).
4. Preencha o campo Código de Associado (CD_ASSOCIADOSPC) com o código fornecido pela SCPC (ex: 123456).
5. Preencha a Senha de Associado (SN_ASSOCIADOSPC) correspondente.
6. Preencha também Host, Porta e Entidade SCPC.
7. Salve o registro.
8. Consulte o SCPC de um cliente pela tela de ConsultaSCPC.

Resultado esperado: O sistema utiliza o código de associado + senha para montar o protocolo TAN de comunicação com o SCPC/SERASA. Caso CD_ASSOCIADOSPC esteja vazio, a consulta bloqueia com a mensagem: "Código de Associado Não Cadastrado! [FNC001]". Caso SN_ASSOCIADOSPC esteja vazio: "Senha de Associado Não Cadastrada! [FNC001]".

Exceção / Importante: Os valores de CD_ASSOCIADOSPC e SN_ASSOCIADOSPC são lidos diretamente de PARMFINANC na rotina TfrmConsultaSCPC.GeraArq (UConsultaSCPC.pas, linha ~1225). Se o campo estiver em branco no momento da consulta, a exceção é levantada antes de qualquer tentativa de conexão.

---

S — Consulta via serviço Web/Online

O que faz	Detalhe
Campo editável	Não (oculto)
Autenticação usada	CD_USUARIOSPC / SN_USUARIOSPC

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba SCPC/SERASA.
3. No campo Tipo de Consulta SCPC, selecione a opção S (Online/Serviço).
4. Observe que o campo Código de Associado (CD_ASSOCIADOSPC) fica oculto automaticamente.
5. Preencha os campos Usuário SCPC (CD_USUARIOSPC) e Senha SCPC (SN_USUARIOSPC).
6. Preencha o Host SCPC (NR_HOSTSPC).
7. Salve o registro.

Resultado esperado: O campo CD_ASSOCIADOSPC não é utilizado neste modo. A autenticação na SCPC usa CD_USUARIOSPC e SN_USUARIOSPC.

---

L — Consulta via conexão direta (Local)

O que faz	Detalhe
Campo editável	Não (oculto)
Campos visíveis	NR_ENTIDADESPC e NR_HOSTSPC

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba SCPC/SERASA.
3. Selecione L no Tipo de Consulta SCPC.
4. Observe que CD_ASSOCIADOSPC, SN_ASSOCIADOSPC e NR_PORTASPC ficam ocultos.
5. Preencha NR_ENTIDADESPC e NR_HOSTSPC.
6. Salve o registro.

Resultado esperado: O código de associado não é utilizado neste modo de consulta.

---

B — Consulta via Base local

O que faz	Detalhe
Campo editável	Não (oculto)
Campos visíveis	Apenas NR_HOSTSPC

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba SCPC/SERASA.
3. Selecione B no Tipo de Consulta SCPC.
4. Observe que CD_ASSOCIADOSPC e demais campos ficam ocultos.
5. Preencha NR_HOSTSPC.
6. Salve o registro.

Resultado esperado: O código de associado não é utilizado neste modo.

---

W — Consulta via Web Service/API

O que faz	Detalhe
Campo editável	Não (oculto)
Campos visíveis	Nenhum campo de conexão (endpoints embutidos no componente ConsultaSCPC)

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba SCPC/SERASA.
3. Selecione W no Tipo de Consulta SCPC.
4. Observe que todos os campos de SCPC (CD_ASSOCIADOSPC, NR_HOSTSPC, NR_PORTASPC, etc.) ficam ocultos.
5. Salve o registro.

Resultado esperado: O código de associado não é utilizado neste modo. Os endpoints de homologação e produção estão definidos internamente no componente ConsultaSCPC.

---

Regra de Visibilidade

O campo CD_ASSOCIADOSPC é exibido somente quando TP_CONSULTASCPC = 'T' (protocolo TAN). A lógica está no evento OnChange do combo box TP_CONSULTASCPC (UFNC001.pas, linha ~1072):

edtCD_ASSOCIADOSPC.Visible := (cmbTP_CONSULTASCPC.Value[1] in ['T']);

Para qualquer outro valor ('B', 'L', 'S', 'W'), o campo e seu rótulo são ocultados, e o campo NR_ENTIDADESPC passa a ocupar a posição visual do formulário (posicionamento via .Top).

---

Procedures impactadas

Referências diretas ao campo em Delphi (uso funcional confirmado)

Rotina	Arquivo	Uso
TfrmFNC001.cmbTP_CONSULTASCPCChange	source/FNC001/UFNC001.pas	Controla visibilidade do edtCD_ASSOCIADOSPC conforme TP_CONSULTASCPC
TfrmConsultaSCPC.GeraArq	source/jSCPC/UConsultaSCPC.pas	Lê CD_ASSOCIADOSPC de PARMFINANC e valida preenchimento quando TP_CONSULTASCPC = 'T'

Referências diretas ao campo em SQL (Scripts/)

Nenhuma referência direta ao campo CD_ASSOCIADOSPC foi encontrada nos scripts SQL.

Candidatas por uso da tabela PARMFINANC

Estas rotinas usam PARMFINANC, mas não referenciam o campo CD_ASSOCIADOSPC literalmente. São candidatas que podem depender do parâmetro de forma indireta.

Procedure/View	Arquivo
CALCULA_CAPITAL	Scripts/CALCULA_CAPITAL.sql
CALCULA_JURO	Scripts/CALCULA_JURO.sql
CALCULA_JUROMORA	Scripts/CALCULA_JUROMORA.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/GRAF_MOVTOCONTABIL.sql
GRAVA_CHEQUECARTAO	Scripts/GRAVA_CHEQUECARTAO.sql
GRAVA_CONTAS	Scripts/GRAVA_CONTAS.sql
GRAVA_MOVTOCAIXA	Scripts/GRAF_MOVTOCAIXA.sql
GRAVA_MOVTOCAIXAINDIVIDUAL	Scripts/GRA_MOVTOCAIXAINDIVIDUAL.sql
GRAVA_MOVTOPROCESSO	Scripts/GRAF_MOVTOPROCESSO.sql
GRAVA_PROCESSOSMART	Scripts/GRA_PROCESSOSMART.sql
PROCESSA_FATURA	Scripts/PROCESSA_FATURA.sql

---

Tabela comparativa resumida

Valor de TP_CONSULTASCPC	CD_ASSOCIADOSPC usado?	Campos de autenticação	Host/Porta visíveis?
T — TAN	Sim	CD_ASSOCIADOSPC + SN_ASSOCIADOSPC	Sim (Host + Porta + Entidade)
S — Online/Web	Não	CD_USUARIOSPC + SN_USUARIOSPC	Sim (apenas Host)
L — Local	Não	NR_ENTIDADESPC + Host	Sim (Host + Entidade)
B — Base local	Não	—	Sim (apenas Host)
W — API/WS	Não	Endpoints embutidos	Não