DS_CODCLIENTE - Código Empresa (Integração Financeira)
Tela de configuração: FNC001 - Parâmetros do Financeiro Localização: Aba Cód. Empresa → campo Código Empresa Tabela:
PARMINTEGRACAOFINANC.DS_CODCLIENTETipo:VARCHAR(20)Valor padrão: Nenhum
Descrição
Campo livre que armazena o código do estabelecimento/empresa junto à operadora de integração financeira (cartões/TEF). O valor digitado aqui é utilizado por MFC028 (Processamento de Cartões) para vincular transações de cartão à empresa correta no JunsoftERP.
Campos envolvidos
| Campo | Tabela | Tipo | Descrição |
|---|---|---|---|
DS_CODCLIENTE | PARMINTEGRACAOFINANC | VARCHAR(20) | Código do estabelecimento na operadora |
CD_EMPRESA | PARMINTEGRACAOFINANC | INTEGER | Empresa do ERP (chave primária parcial) |
CD_INTEGRACAO | PARMINTEGRACAOFINANC | INTEGER | Tipo de integração (chave primária parcial) |
Telas impactadas
| Tela | Uso |
|---|---|
| FNC001 | Tela de cadastro e edição do parâmetro |
| MFC028 (Processamento de Cartões) | Consulta o campo para identificar o estabelecimento ao processar transações Elavon, Fiserv, Sipag e na conciliação |
Regras de preenchimento
- O campo aceita até 20 caracteres alfanuméricos.
- O evento
OnKeyPressconverte automaticamente as letras para maiúsculas (Key := UpCase(Key)). - O campo não é obrigatório, porém, se preenchido, o sistema valida duplicidade no
BeforePost.
Validação de duplicidade (BeforePost)
Ao salvar um registro com DS_CODCLIENTE preenchido e CD_INTEGRACAO > 0, o sistema verifica se o mesmo DS_CODCLIENTE já foi informado para outra empresa com o mesmo CD_INTEGRACAO:
| O que faz | Detalhe |
|---|---|
| Impede duplicidade | Se o código já existir em outra empresa para a mesma integração, exibe erro e bloqueia o salvamento |
| Foco no campo | Em caso de erro, o sistema volta o foco para o campo edtDS_CODCLIENTE na aba SPC |
Simulação passo a passo
- Acesse FNC001 → aba Cód. Empresa.
- Digite um código de estabelecimento no campo Código Empresa, por exemplo
ESTAB12345. - Selecione o tipo de integração.
- Clique em Salvar.
- Se o código
ESTAB12345já estiver cadastrado para outra empresa com o mesmo tipo de integração, o sistema exibe a mensagem: "Código de Integração "[nome integração]" já Informado para a Empresa [nº]! Verifique." e bloqueia a gravação.
Resultado esperado: O código do estabelecimento é salvo sem duplicidade. Em caso de conflito, o sistema impede a gravação e posiciona o cursor no campo para correção.
Utilização no MFC028 (Processamento de Cartões)
O MFC028 utiliza DS_CODCLIENTE em diversas rotinas para buscar parâmetros da operadora vinculada ao estabelecimento:
| Rotina | Finalidade |
|---|---|
iniciar | Carrega o código do estabelecimento ao inicializar o processamento |
ProcessaElavon | Vincula transações Elavon ao estabelecimento correto |
ResumoArray_Add | Monta resumo conciliando pelo código do estabelecimento |
GetEmpresaFiserv | Identifica a empresa ao processar cartões Fiserv |
GetEmpresaSipag | Identifica a empresa ao processar cartões Sipag |
verificaEmpresaConciliadora | Verifica qual empresa concilia as transações do estabelecimento |
RetornaNomeEmpresa | Retorna o nome da empresa a partir do código do estabelecimento |
retornaDescEmpresaCNPJ | Retorna descrição e CNPJ da empresa pelo código do estabelecimento |
Exceção / Importante: Se o campo estiver vazio, as rotinas do MFC028 não conseguirão vincular transações à empresa, podendo causar falha no processamento de cartões. Recomenda-se preencher sempre que houver integração com operadoras de cartão.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Linha |
|---|---|---|
edtDS_CODCLIENTEKeyPress | source/FNC001/UFNC001.pas | 393 |
TfrmFNC001.edtDS_CODCLIENTEKeyPress | source/FNC001/UFNC001.pas | 1270 |
TdmFNC001.tabPARMINTEGRACAOFINANCBeforePost | source/FNC001/UdmFNC001.pas | 941 |
iniciar | source/MFC028/UMFC028.pas | 223 |
TfrmMFC028.ProcessaElavon | source/MFC028/UMFC028.pas | 1940 |
ResumoArray_Add | source/MFC028/UMFC028.pas | 2111 |
GetEmpresaFiserv | source/MFC028/UMFC028.pas | 2776 |
GetEmpresaSipag | source/MFC028/UMFC028.pas | 3231 |
TfrmMFC028.verificaEmpresaConciliadora | source/MFC028/UMFC028.pas | 3694 |
RetornaNomeEmpresa | source/MFC028/UMFC028.pas | 3858 |
retornaDescEmpresaCNPJ | source/MFC028/UMFC028.pas | 4087 |
Referências SQL diretas
Não foram encontradas referências diretas ao campo DS_CODCLIENTE em arquivos .sql do repositório Scripts/. Todas as referências SQL estão embutidas no código Delphi das rotinas listadas acima.
Resumo
| Aspecto | Detalhe |
|---|---|
| O que é | Código do estabelecimento junto à operadora de cartões/TEF |
| Onde se configura | FNC001 → aba Cód. Empresa → campo Código Empresa |
| Tipo / Tamanho | Texto livre, até 20 caracteres, maiúsculas automáticas |
| Obrigatoriedade | Não obrigatório, mas necessário para processamento de cartões |
| Validação | Impede duplicidade do mesmo código para empresas diferentes na mesma integração |
| Impacto principal | MFC028 — processamento de cartões Elavon, Fiserv e Sipag |