CD_INTEGRACAO - Modelo de Integração Financeira
Tela de configuração: FNC001 - Parâmetros do Financeiro Localização: Aba Cód. Empresa → campo Modelo (
cmbTP_MODELO) Tabela:PARMINTEGRACAOFINANC.CD_INTEGRACAOTipo:DOM_INTEGER NOT NULLValor padrão:0(Selecione) Chave primária:(CD_EMPRESA, CD_INTEGRACAO)
Descrição
Define qual adquirente/plataforma de captura será utilizada na integração financeira da empresa. Cada empresa pode ter vários registros de integração, mas cada combinação de empresa + modelo deve ser única.
Telas impactadas
| Tela | Contexto |
|---|---|
| FNC001 - Parâmetros do Financeiro | Configuração do modelo de integração (aba Cód. Empresa) |
Campos envolvidos
| Campo | Tabela | Descrição |
|---|---|---|
CD_INTEGRACAO | PARMINTEGRACAOFINANC | Código do modelo de integração (chave) |
DS_INTEGRACAO | PARMINTEGRACAOFINANC | Descrição textual, preenchida automaticamente pela validação |
DS_CODCLIENTE | PARMINTEGRACAOFINANC | Código do cliente na plataforma (informado pelo usuário) |
CD_EMPRESA | PARMINTEGRACAOFINANC | Empresa vinculada à integração |
Opções disponíveis
0 - Selecione (Indefinido)
| O que faz | Detalhe |
|---|---|
| Valor padrão ao incluir novo registro | Não permite salvar com este valor |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- O campo Modelo será exibido com "Selecione".
- Mantenha o valor "Selecione" e clique em Salvar.
- O sistema exibirá a mensagem: "Modelo de Integração deve ser Informado! Verifique."
Resultado esperado: O registro não é salvo. O foco retorna ao campo Modelo.
1 - Fiserv
| O que faz | Detalhe |
|---|---|
| Integração com adquirente Fiserv | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione Fiserv.
- O campo descrição será preenchido automaticamente com "FISERV".
- Informe o Código do Cliente (código na plataforma Fiserv).
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 1 vinculado à empresa selecionada.
2 - PagBank
| O que faz | Detalhe |
|---|---|
| Integração com adquirente PagBank | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione PagBank.
- O campo descrição será preenchido automaticamente com "PAGBANK".
- Informe o Código do Cliente na plataforma PagBank.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 2 vinculado à empresa selecionada.
3 - GetNet
| O que faz | Detalhe |
|---|---|
| Integração com adquirente GetNet | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione GetNet.
- O campo descrição será preenchido automaticamente com "GETNET".
- Informe o Código do Cliente na plataforma GetNet.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 3 vinculado à empresa selecionada.
4 - Rede
| O que faz | Detalhe |
|---|---|
| Integração com adquirente Rede | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione Rede.
- O campo descrição será preenchido automaticamente com "REDE".
- Informe o Código do Cliente na plataforma Rede.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 4 vinculado à empresa selecionada.
5 - Cielo
| O que faz | Detalhe |
|---|---|
| Integração com adquirente Cielo | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione Cielo.
- O campo descrição será preenchido automaticamente com "CIELO".
- Informe o Código do Cliente na plataforma Cielo.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 5 vinculado à empresa selecionada.
6 - Elavon
| O que faz | Detalhe |
|---|---|
| Integração com adquirente Elavon | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione Elavon.
- O campo descrição será preenchido automaticamente com "ELAVON".
- Informe o Código do Cliente na plataforma Elavon.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 6 vinculado à empresa selecionada.
7 - Sipag 2.0
| O que faz | Detalhe |
|---|---|
| Integração com adquirente Sipag 2.0 | Requer preenchimento de DS_CODCLIENTE |
Simulação passo a passo
- Acesse a tela FNC001 e selecione a aba Cód. Empresa.
- Clique em Incluir para adicionar uma nova integração.
- No campo Modelo, selecione Sipag 2.0.
- O campo descrição será preenchido automaticamente com "SIPAG 2.0".
- Informe o Código do Cliente na plataforma Sipag 2.0.
- Clique em Salvar.
Resultado esperado: O registro é gravado com CD_INTEGRACAO = 7 vinculado à empresa selecionada.
Regras Gerais
Duplicidade por Empresa + Modelo
O sistema impede que a mesma empresa tenha dois registros com o mesmo modelo de integração. Ao tentar salvar um modelo já cadastrado para a empresa, será exibida a mensagem:
"Código de Integração "X" já Cadastrado para a Empresa! Verifique."
Código do Cliente compartilhado entre empresas
Se o campo DS_CODCLIENTE estiver preenchido, o sistema verifica se outra empresa já utiliza o mesmo código de cliente para o mesmo modelo de integração. Essa validação ocorre no evento BeforePost da tabela PARMINTEGRACAOFINANC.
Exceção / Importante: O preenchimento de
DS_CODCLIENTEé opcional. Se deixado em branco, a validação de compartilhamento entre empresas é ignorada.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Descrição |
|---|---|---|
tabPARMINTEGRACAOFINANCAfterInsert | UdmFNC001.pas | Inicializa CD_INTEGRACAO com 0 ao incluir novo registro |
tabPARMINTEGRACAOFINANCCD_INTEGRACAOValidate | UdmFNC001.pas | Preenche automaticamente DS_INTEGRACAO conforme o modelo selecionado |
tabPARMINTEGRACAOFINANCBeforePost | UdmFNC001.pas | Valida modelo obrigatório (<> 0), duplicidade e compartilhamento de DS_CODCLIENTE |
Referências SQL
Não foi encontrada referência direta ao campo PARMINTEGRACAOFINANC.CD_INTEGRACAO em scripts SQL (Scripts/). As ocorrências de CD_INTEGRACAO em procedures referem-se a campos homônimos em outras tabelas (ex: ITEMPEDIDOEZ.CD_INTEGRACAO, ITEM.CD_INTEGRACAO1/2/3), que servem a integrações de e-commerce/PDV e não ao cadastro de modelos financeiros.
Tabela Comparativa Resumida
| Valor | Modelo | Descrição Automática |
|---|---|---|
| 0 | Selecione | INDEFINIDO (não permite salvar) |
| 1 | Fiserv | FISERV |
| 2 | PagBank | PAGBANK |
| 3 | GetNet | GETNET |
| 4 | Rede | REDE |
| 5 | Cielo | CIELO |
| 6 | Elavon | ELAVON |
| 7 | Sipag 2.0 | SIPAG 2.0 |