GF - Como Fazer - Conciliação de Cartões - Integração VAN Conciliadora

Integração API Conciliadora e CIGAM

Para que serve?

A integração CIGAM e Conciliadora busca uniformizar e importar todas as movimentações de cartões de crédito, débito e PIX realizadas via TEF ou POS realizadas pelo Cliente CIGAM através das diversas Adquirentes contratadas. Assim, independentemente da forma com que cada adquirente envia as informações e da quantidade de adquirentes existentes, o Cliente CIGAM precisa realizar apenas uma conciliação.

Como funciona?

Ao contratar os serviços da VAN Conciliadora e disponibilizar o acesso aos seus dados através do seu canal seguro. O Cliente CIGAM passa a contar com o recebimento on line de todas as suas movimentações de crédito, débito e PIX no CIGAM de forma automática, através da API Conciliadora. O escopo de serviços da Conciliadora é um dos mais completos do país, atendendo às maiores adquirentes do mercado e também às adquirentes regionais, normalmente não abrangidas pelas demais VANs disponíveis.

Parametrizações

O uso do módulo Conciliação de Cartões se mantém o mesmo com a integração via Conciliadora, o que muda aqui é apenas a forma de recepção dos dados, neste manual será abordado apenas o que é necessário para ativar a integração. O processo de parametrização de tarifas e geração de lançamentos se mantém o mesmo¹ e pode ser encontrado na documentação do módulo.

¹ A exceção a esta afirmação fica por conta dos cadastros de Adquirentes, Bandeiras e Produtos, que agora são criados no momento da localização destes cadastros no momento da importação dos movimentos conforme será visto neste documento.

Parâmetros API Conciliadora

Nesta tela devem ser informados os dados passados pela Conciliadora na sua contratação:

Menu: Finanças > Conciliação de Cartões > Parâmetros > Parâmetros API Conciliadora

A passagem dos dados é feita por e-mail e eles se encontram em um excell anexo conforme:

Detalhamento de campos

• Empresa Matriz: informe a empresa correspondente ao CNPJ contratado.

• Estabelecimentos: Neste botão, apenas clique em “credenciais” e informe os campos “RefoID” e “senha” (conforme e-mail da conciliadora).

É importante mencionar que mesmo que haja mais unidades de negócios (estabelecimentos) na sua base de dados, a Conciliadora elege um CNPJ “Pai” para concentrar os movimentos de um grupo de empresas. Este CNPJ “Pai” será o único utilizado nas parametrizações e, quando da importação dos movimentos, haverá a distinção de movimentos abertos por estabelecimento. Ainda assim, é possível que exista mais de um CNPJ “Pai” que pode concentrar um determinado número de empresas. Esta estrutura é definida na Conciliadora junto com o Cliente.

Após o preenchimento das credenciais retorne a tela inicial de parâmetros e continue a configuração.

• API KEY: insira o dado API KEY recebido da conciliadora.

• Testar Conexão: por fim, clique em "testar conexão", caso o ícone verde apareça, a sua parametrização foi concluída com sucesso!

Sequencia de implementação

Com o uso da integração pela Conciliadora, existe uma mudança na sequencia de cadastros necessários para a implementação do módulo Conciliação de Cartões. Normalmente, antes de iniciar as importações dos movimentos de conciliação, eram cadastrados, manualmente, os Produtos, Bandeiras e Adquirentes utilizados no cliente. Isso era necessário para que se pudesse realizar a importação dos movimentos e houvessem cadastros condizentes com o recebido nos arquivos.

Ocorre que agora, com o uso da integração via API, o CIGAM criou um facilitador, onde ao localizar tais cadastros nos movimentos importados, eles são automaticamente criados no CIGAM, facilitando esta etapa de parametrização. Quando um cadastro é criado desta forma, ele recebe o prefixo “CONC_#” conforme o exemplo abaixo:

Dessa forma, os modelos de lançamento informados no botão “Complemento” do cadastro “Adquirentes da bandeira e seus produtos, serão apontados somente após a primeira importação realizada, que é onde os cadastros já terão sido criados pela integração.

Importante: Cabe ao cliente e o consultor que estiver auxiliando no processo de implementação, avaliarem quantos dias de importação serão suficientes para cobrir todo o escopo de bandeiras/adquirentes/ produtos existem no universo de movimentos para garantir que todas as combinações tenham sido importadas e tenham recebido seus modelos de lançamento.

Importação dos Movimentos

A importação dos movimentos de conciliação na metodologia de integração via VAN Conciliadora é feita diretamente pela rotina "Exibe dados de Conciliação – API Conciliadora" e não precisa ser rodado por uma rotina externa como era feito nas demais integrações.

Menu: Finanças > Conciliação de Cartões > Movimentos > Exibe dados de Conciliação – API Conciliadora

Sincronizar período: Este botão é independente dos demais filtros da tela, ou seja, nenhum dos filtros disponíveis diz respeito a ele. Para iniciar o processo de importação, clique em “Sincronizar período” e na tela de filtro, preencha a(s) data(s) que deseja importar.

Sincronismo: é importante destacar, que os dados disponibilizados pela Conciliadora, por serem on line, sempre irão enviar os dados disponíveis até o momento da importação. Isso pode resultar no incremento da movimentação de um dia, caso alguma adquirente ainda não tenha disponibilizado seus dados em uma execução anterior. Isso pode ser mais recorrente caso a execução ocorra no meio de um dia que ainda não havia sido totalmente disponibilizado. Estas janelas de tempo podem ser consultadas com cada adquirente.

Depois de executar o sincronismo de um período, será possível executar a consulta através dos filtros da tela.

Detalhamento: na tela de detalhamento existirá uma linha para cada dia com movimentos aberta por estabelecimento. Existem também colunas com contadores indicando a quantidade de registros do dia, divididos por conciliados e não conciliados. Os botões “Zoom” e “Excluir” possuem as mesmas características apresentadas nas versões via arquivo da conciliação e, por fim, o botão “Conciliar” nos leva para a tela de conciliação, também conforme o padrão do módulo.

Considerar para identificação dos lançamentos apenas a U.N. informada: Ao marcar este checkbox somente serão considerados lançamentos financeiros da unidade de negócio informada ao comparar com os dados importados dos adquirentes.

Antecipações: A partir da versão 250505 a rotina de Conciliação de Cartões foi aprimorada para oferecer ainda mais integridade e confiabilidade no controle das transações com cartões. Anteriormente, essa rotina confrontava apenas os valores informados no sistema com os valores fornecidos pela adquirente, desconsiderando possíveis antecipações. A partir desta versão, o sistema passa a considerar também os valores de antecipações de vendas unitárias no processo de conferência, integrando automaticamente os lançamentos correspondentes. Assim como ocorre com as tarifas da adquirente, as tarifas de antecipação também terão lançamentos financeiros gerados para compor as liquidações. Para isso, será necessário cadastrar um modelo de lançamento de liquidação para antecipações no cadastro de Informações para Conciliação.

Importando Débitos e Créditos

No módulo Conciliação de Cartões, ao utilizar a integração com a VAN Conciliadora, geramos as movimentações de débitos e créditos referentes, principalmente, a lotes de tarifas de antecipação. Estes registros podem referir-se também a outros débitos como tarifas de maquinetas, entre outros, que podem também ser enviados juntamente com as vendas e liquidações.

Os registros de Débitos e Créditos são importantes para que o valor depositado no extrato bancário seja condizente com o resultado dos movimentos apurados na conciliação de cartões do Cigam, deixando para o usuário responsável pela conciliação quais os registros serão importados e tratados pela rotina.

Operacionalizando a importação de Débitos e Créditos

Os registros de débitos e créditos na API são identificados através do campo “tipo transação” nos códigos 4, 6 ou 7, conforme:

A opção pela importação dos registros inicia do momento da parametrização das credenciais, sendo ela opcional e selecionável. No módulo Conciliação de Cartões >> Parâmetros >> Parâmetros API Conciliadora, temos o combo Transações a Conciliar, sendo: 1 – Apenas Vendas e 2 – Vendas + Débitos e Crédito adicionais.

A opção 1 manterá o formato padrão de importação e a opção 2 trata de incrementar os demais registros na importação.

Cadastro “Tipos de Transação” dos Débitos e Créditos

Como dito anteriormente, esta nova funcionalidade visa a entrega do controle e registro das antecipações feitas por lote nas adquirentes que trabalham com esta metodologia. Porém, dentro do escopo de débitos e créditos advindos das adquirentes, poderemos ter os mais diversos registros sendo enviados; todos podendo impactar no valor depositado ao cliente no final do dia, portanto a solução desenvolvida visa reconhecer qualquer registro passível de importação que o cliente entenda que precisa ser importado.

Os registros de débito, crédito e demais itens advindos da integração não possuem códigos adicionais (além do tipo de transação) para referência, desta forma, eles precisarão ser identificados pelo seu descritivo e código de adquirente.

Para isso, foi disponibilizados um cadastro para indicar: Adquirente, Descrição do Débito/Crédito ou outro tipo de registro, o modelo de lançamento e portador a ser utilizado;

Conciliação de Cartões >> Parâmetros >> Parâmetros de Débitos e Créditos;

Esta tela é exibida automaticamente para o usuário sempre que a rotina de importação identifica um novo registro de Débito e Crédito que ainda não está cadastrado, por exemplo, quando executada pela primeira vez a importação, esta tela será exibida, neste momento o usuário terá duas possibilidades:

1°- Marcar o “Ativo” e completar o cadastro com os dados necessários e desejados para representar o registro. Exemplo: Um registro do tipo “Débito referente a aluguel de maquineta”, poderia ser complementado com um modelo Pagar/Aberto para posterior liquidação ou um modelo Saída/Liquidada para representar uma saída direta naquele dia. O tipo de lançamento a ser criado fica totalmente a critério do usuário conciliador.

2°- Não marcar a opção “Ativo”. Esta ação implica na não importação dos registros do respectivo Tipo nas próximas execuções da rotina de sincronismo. Exemplo: Um registro de “Débito referente a gravame” identificado pelo descritivo e código de adquirente, não será considerado nas importações para fins de conciliação. O movimento nunca será exibido na aba “Outros Débitos e Créditos adicionais”. Caso o usuário mude de ideia e queira começar a importar este registro, basta marcar a opção “Ativo”, complementar os cadastros e realizar a importação novamente.

Os campos disponíveis na tela são:

Ativo – No momento da exibição da tela automaticamente na importação, ou após a importação, o usuário pode entrar no cadastro, marcar a opção “ativo” (ela virá desmarcada para que um usuário que não queira realizar estes controles não tenha este volume de movimentos importados desnecessariamente), o modelo de lançamento e portador, caso queira diferenciá-lo do utilizado no modelo;

Código adquirente – Será apresentado conforme o cadastro de adquirentes do módulo;

Descrição do Débito/Crédito – Será o descritivo tal e qual apresentado nos registros da API para que se identifique qual o modelo de lançamento utilizar;

Tipo – Este campo combo possuirá as três possibilidades de registros 4, 6 e 7;

Modelo de lançamento – Aqui devem ser apontados os modelos de lançamento a serem utilizados para este tipo de registro;

Portador – Um portador que, quando informado será utilizado prioritariamente ao portador informado no modelo de lançamento, isso ajudará a manter um número reduzido de modelos que, do contrário, exigiriam mais de um modelo por conta da variação apenas deste campo. Caso este portador esteja em branco, deve ser usado o do modelo;

“...” – O registro original deste cadastro servirá para qualquer unidade de negócios, ele é o equivalente à UN em branco. Caso o cliente queira variar o modelo de lançamento ou portador de determinada Unidade de negócio, ele poderá clicar neste botão e informar conforme a necessidade. Dentro deste botão deve-se exigir a informação de uma UN para gravar o registro;

Mostrar apenas ativos – esta opção filtra apenas registros ativos;

Esta tela de cadastro, além de apresentada de maneira automática aos usuários no momento da importação quando encontrado um novo registro, pode também ser acessada a qualquer momento através do Menu: Conciliação de Cartões >> Parâmetros >> Parâmetros de Débitos e Créditos; lembrando que este cadastro é válido apenas para usuários com as credências cadastradas da API Conciliadora.

Importação dos movimentos

Seguindo o mesmo formato e sequência de importação de registros da integração via VAN Conciliadora já disponível, agora passamos a ter uma nova seção na conciliação de Liquidações, sendo ela denominada “Outros débitos e créditos”;

Nesta nova sessão serão criados todos os registros encontrados na integração e que tiveram seu descritivo parametrizado e ativado conforme a tela de cadastro “Tipos de Transação Conciliadora”. Estes registros serão contabilizados juntamente com os valores de liquidação da sessão “Identificados” das Liquidações.

Importante mencionar que o filtro de “Estabelecimento” utilizado para Liquidações e Vendas também é válido para a nova sessão “Outros Débitos e Créditos”.

Antes desta evolução, um cliente que possuísse débitos e créditos interferindo em seu valor de depósito tinha um resultado da conciliação conforme a imagem abaixo (Valor de liquidações diferente do valor depositado):

Com esta evolução o Cigam possibilita a importação dos valores de débitos e créditos, podendo chegar a um valor de extrato igual aos conciliados:

Exemplos de importação de débitos e créditos com antecipação em lote:

Contemplar a antecipação de vendas em lote foi o objetivo principal desta evolução, este tipo de antecipação ocorre quando a adquirente não realiza a cobrança da antecipação de vendas unitariamente (venda a venda), e sim através de um lote de vendas elaborado de acordo com suas regras internas. As informações fornecidas são apenas o Valor Bruto, Valor Líquido e Valor da Taxa de Antecipação. Abaixo um exemplo real conciliando no Cigam:

Print do aplicativo da Adquirente no momento que o usuário realizou a antecipação.

Na imagem abaixo apresentamos o detalhamento da conciliação que ocorrerá no Cigam a partir dos movimentos importados e identificados por Adquirente, Motivo Ajuste e Tipo Transação:

A seguir apresentamos os movimentos que contemplam a antecipação em lote. Neste exemplo os movimentos da antecipação são apresentados conforme a Adquirente, Motivo do Ajuste e Tipo Transação. Nestes registros são apresentados os modelos de lançamento e portador conforme o cadastro de Tipo de Transação e que serão utilizados para criar os movimentos de conciliação.

Note que para os valores creditados por lote de antecipação também é possível que haja incidência de taxa de antecipação, ela será considerada no valor final creditado, conforme imagem abaixo:

Abaixo exemplo de cadastro do Tipo de Transação de crédito por antecipação em lote, contendo modelo de lançamento para a própria transação, lançamento de tarifa e tarifa de antecipação:

Os valores apresentados acima serão conciliados juntamente com os movimentos de liquidação de venda (selecionando registros do grupo Liquidações), conforme abaixo:

Ao efetivar a conciliação será apresentada a tela padrão, conforme abaixo. Importante mencionar que os dados inseridos nela são validos para os lançamentos de liquidação das vendas, e não são utilizados para os lançamentos da sessão Outros Débitos e Créditos.

Na tela de lançamentos gerados pela conciliação serão apresentados tanto os lançamentos gerados referente ao recebimento de vendas, conforme combinação de Bandeira, Adquirente e Produto:

Seguido pelos registros de Débitos e Créditos separados, além de Bandeira, Adquirente e Produto, também pelos seus Motivos de Ajuste:

Os totalizadores apresentados representam o valor Bruto/Líquido de todo o conjunto da operação que resultará no valor deposito no extrato bancário do cliente:

Exemplos de importação de débitos e créditos:

Na movimentação de uma adquirente é comum serem realizados movimentos de débito na Conta Corrente “A” para a Conta Corrente “B” estes movimentos representam a movimentação financeira das adquirentes com os recursos originados das vendas do cliente. Estes valores tendem a se anular, pois representam débitos e créditos de vendas passadas que foram antecipadas. Caso o cliente queira contabilizar estes movimentos, ele poderá ativar tais tipos de débitos e créditos utilizando modelos de lançamentos configurados para tal contabilização, mesmo que eles não influenciem no valor final do extrato bancário.

Abaixo exemplificamos este processo ao rodar a rotina de conciliação no Cigam, onde todos os registros identificados das adquirentes referem-se a Tipos de Transação configurados com modelos de lançamentos e ativos (inativos desconsiderados, tanto na importação quanto na apresentação). No exemplo abaixo vemos registros de débitos e créditos que se anulam, sem impactar nos valores recebidos em conta pelo cliente. Este é um caso onde o cliente optou por importar a fim de contabilizar os movimentos transacionais, outra opção poderia seria a não ativação desses Tipos de Transação, por exemplo, para um cliente onde estes movimentos são contabilmente irrelevantes.

Exemplos de importação de débitos e créditos com outros tipos de despesas:

Abaixo temos um exemplo da adquirente Vero que enviou apenas registros chamados “tarifas de antecipação”. Este serão conciliados também juntamente com os Identificados por Liquidação de Vendas:

Sessão “Identificados” conforme filtro de adquirente “Vero”:

Nesta tela, a tarifa de antecipação não é considerada no grid de lançamentos do CIGAM pois ela não é previsível no momento da venda, uma vez que ela tem percentual variável conforme a avaliação contratada pelo cliente na adquirente e só será gerada quando da antecipação de uma venda. Outra característica é que esta tarifa também não é considerada dentro da faixa de tolerância da configuração 2558, uma vez que ela tornaria este lançamento não identificável devido à alteração do valor final da venda.

Sessão “Outros Débitos e Créditos” conforme filtro de adquirente “Vero”:

Abaixo o cadastro que identifica os movimentos de “Tarifa Antecipação” da Vero.

Na tela abaixo são apresentados os lançamentos gerados a partir da conciliação conforme o agrupamento de Adquirente, Bandeira e Produto.

Na tela abaixo são apresentados os lançamentos gerados a partir da conciliação conforme o agrupamento de Adquirente, Motivo do Ajuste e Modelo de Lançamento.

Escopo de Adquirentes simulados

As definições de modelos para "Tipo de Transação" apresentadas nesta função devem ser suficientes para o atendimento de qualquer registro enviado pelos Adquirentes no âmbito de Débitos e Créditos. Durante as execuções dos testes e homologação em clientes piloto foram conciliados movimentos de:

Rede
Cielo
Vero
Stone
Caixa Pagamento
GetNet

Documentos Relacionados

• Sala Flex - Conciliação de Cartões