Integração Conciliadora

Este guia explica o módulo de Integração com a Conciliadora do NuvCar — a conexão automatizada com o serviço externo Conciliadora (parceiro especializado em conciliação de cartões) que busca automaticamente suas vendas, pagamentos e cancelamentos direto das operadoras, sem precisar baixar extrato manualmente.

Feito para o administrativo e financeiro que já usa ou pretende usar a Conciliadora. Sem pré-requisitos técnicos, mas você precisará dos dados de acesso à Conciliadora.

1. Disponibilidade por plano

Este módulo é exclusivo do plano Avançado:

Plano	Este módulo está incluído?
Básico	Não
Profissional	Não
Avançado	Sim

Para habilitar, é preciso fazer upgrade para o plano Avançado. Também é preciso ter uma conta ativa na Conciliadora (parceiro externo).

2. O que é a "Conciliadora"?

A Conciliadora (conciliadora.com.br) é um serviço externo (de uma empresa parceira) que se conecta diretamente às operadoras de cartão (Cielo, Rede, Stone, PagSeguro, etc.) e puxa automaticamente os dados de:

Vendas registradas nas operadoras.
Previsão de pagamentos (quando cada venda será depositada).
Taxas aplicadas.
Cancelamentos e estornos (chargebacks).

Com a integração configurada no NuvCar, esses dados fluem automaticamente para o seu sistema — você não precisa entrar no portal de cada operadora e baixar arquivos manualmente.

Para que serve?

Automação total. Em vez de conciliar mês a mês manualmente, o sistema se mantém atualizado dia após dia.
Redução de erro humano. Sem importação manual, sem arquivo quebrado, sem esquecimento.
Previsão de recebimento. Você vê hoje quanto vai cair amanhã no banco.
Reconhecimento rápido de chargebacks. Se um cliente contestou, o sistema capta rápido.

Quando não usar

Se você não tem conta na Conciliadora — nesse caso, use a Conciliação de Cartões tradicional (ver manual).
Se só opera com uma ou duas operadoras muito simples, talvez o custo da Conciliadora não compense.

3. Pré-requisitos

Plano Avançado ativo na sua empresa NuvCar.
Conta ativa no serviço Conciliadora (conciliadora.com.br — empresa externa, contratada separadamente).
Chave de API da Conciliadora (fornecida por eles).
ID da empresa na Conciliadora (se aplicável — fornecido por eles).

Sem os dois itens finais, não dá para conectar.

4. Permissões necessárias

Quero…	Permissão que preciso
Ver a integração e histórico	Visualizar integração Conciliadora
Configurar ou editar a integração	Gerenciar integração Conciliadora
Disparar sincronização manual	Sincronizar Conciliadora

5. Como acessar

Menu lateral → "Financeiro" → hub → seção "Conciliação" → "Integração Conciliadora" (ícone de conexão/plug).
Se a integração ainda não foi configurada: aparece a tela de cadastro.
Se já configurada: aparece o painel com status, mapeamentos e histórico de sincronização.

6. Configurando pela primeira vez

Na primeira vez, você vê a tela de cadastro da integração.

6.1 Dados obrigatórios

API Key — a chave fornecida pela Conciliadora. Fica criptografada no sistema.
ID da empresa na Conciliadora (quando aplicável) — identifica a sua empresa dentro do serviço.
URL base — normalmente já vem preenchida com o endereço padrão da Conciliadora; não mexa a menos que o suporte indique.

6.2 Sincronização automática

Sincronização ativa — switch que liga/desliga.
Frequência (minutos) — de quantos em quantos minutos o sistema deve buscar atualizações automaticamente.

Sugestão: comece com 60 minutos (uma vez por hora). Você pode reduzir depois se precisar mais atualizações em tempo real.

6.3 Testar a conexão

Botão "Testar Conexão" antes de salvar.
O sistema tenta contactar a Conciliadora com os dados informados.
Se der certo, aparece uma mensagem de sucesso.
Se falhar, você vê o motivo (chave errada, URL inválida, Conciliadora fora do ar).

6.4 Salvar

Clique em "Salvar Configuração".

Pronto — a integração está ativa.

7. Mapeando operadoras / adquirentes

A Conciliadora cobre várias operadoras de cartão (adquirentes). Cada uma delas deposita em uma das suas contas financeiras. O mapeamento diz ao NuvCar: "Vendas da Cielo caem na conta X; vendas da Stone caem na conta Y".

Por que é importante

Sem mapeamento, o sistema puxa os dados mas não sabe em qual conta contabilizar. Você precisa criar um mapeamento para cada adquirente ativa no seu negócio.

Criando um mapeamento

Na aba "Mapeamentos" da tela da integração, clique em "Novo Mapeamento".
Preencha:
- Adquirente — selecione uma das operadoras trazidas pela Conciliadora (lista dinâmica).
- Conta Financeira — a conta do NuvCar onde essa operadora deposita.
- Ativo — switch para ligar/desligar sem apagar.
Confirme.

Lista de mapeamentos

A tabela mostra todos os mapeamentos com operadora, conta, status e ações (editar, excluir).

Dica: se você trabalha com Cielo Débito e Cielo Crédito em contas diferentes, alguns adquirentes aparecem separados. Mapeie cada linha.

8. Sincronização — como funciona

8.1 Automática (recomendado)

Quando ligada:

A cada intervalo de tempo configurado (ex.: 60 minutos), o sistema consulta a Conciliadora.
Baixa as novas vendas, previsões de pagamento e cancelamentos.
Registra no histórico o resultado.

8.2 Manual (sob demanda)

Clique em "Sincronizar Agora" no topo da tela para disparar uma sincronização imediata, sem esperar o ciclo automático.

8.3 Dados importados

A Conciliadora traz três tipos de informação:

Tipo	Para quê
Vendas	Cada venda registrada nas operadoras, com bruto, taxa e líquido.
Previsões de pagamento	Data em que cada venda vai ser depositada.
Cancelamentos/Chargebacks	Estornos e contestações.

9. Acompanhando o status

9.1 Status da última sincronização

Na tela principal, você vê:

Última sincronização em — data/hora da última execução.
Status — Sucesso, Parcial ou Erro.
Se teve erro, mensagem de erro aparece.

9.2 Histórico completo

Aba "Histórico" com lista de todas as sincronizações:

Coluna	O que mostra
Data/Hora	Quando rodou.
Tipo	Manual ou Automático.
Status	Sucesso, Erro, Parcial.
Vendas importadas	Quantas novas vendas entraram.
Pagamentos importados	Quantos pagamentos novos.
Cancelamentos	Quantos cancelamentos.
Usuário	Quem disparou (se manual).
Mensagem de erro	Quando aplicável.

10. Acompanhando recebíveis e cancelamentos

10.1 Aba "Recebíveis"

Lista as vendas/pagamentos trazidos pela Conciliadora, com:

Data da venda.
Adquirente.
Valor bruto, taxa, líquido.
Data prevista de pagamento (quando vai cair na conta).
Status.

10.2 Aba "Cancelamentos"

Lista chargebacks, estornos e cancelamentos:

Data.
Venda original vinculada.
Valor estornado.
Motivo (quando fornecido).

Esses dados alimentam o seu fluxo de caixa projetado — você sabe com precisão quanto vai receber nos próximos dias.

11. Editando a configuração

No topo da tela, botão "Editar Configuração".

Pode alterar:

API Key (útil se a Conciliadora gerou uma nova).
Frequência de sincronização.
Ativar/desativar a sincronização automática.

Não pode alterar:

ID da empresa (se a Conciliadora trocar, talvez precise reconfigurar do zero).

12. Desativando a integração

Se você quer pausar:

Edite a configuração e desligue o switch "Sincronização ativa".
O histórico e mapeamentos ficam preservados; só não roda mais automaticamente.

Se você quer encerrar:

Peça ao suporte para remover a configuração completamente.
Dados já importados ficam — só a conexão futura é interrompida.

13. Conciliação de Cartões + Conciliadora juntas

A integração não substitui o módulo de Conciliação de Cartões. Elas trabalham em camadas:

Integração Conciliadora: traz os dados para dentro do NuvCar automaticamente (sem precisar baixar arquivo).
Conciliação de Cartões: onde você efetivamente concilia transações (casar vendas com recebimentos internos).

Com as duas juntas: os extratos aparecem sozinhos, você só precisa revisar conciliações e divergências.

Muitas empresas que começam com Conciliação manual migram para Conciliadora quando o volume aumenta — a integração economiza horas por mês.

14. Dicas e erros comuns

Dicas

Teste a conexão antes de salvar. Evita perder tempo com configuração errada.
Mapeie todos os adquirentes ativos antes de confiar nos dados — sem mapeamento, o sistema não contabiliza na conta certa.
Comece com sincronização de 60 minutos. Se precisar atualizações mais rápidas, reduza (mas não abuse — cada chamada consome cota da sua conta Conciliadora).
Acompanhe o histórico. Se começar a aparecer erros frequentes, algo mudou (chave trocada, URL, plano da Conciliadora).
A Conciliadora paga pela quantidade de adquirentes. Use só as operadoras que você realmente opera.
Use os dados de previsão no fluxo de caixa para planejar desembolsos futuros.

Erros comuns

Problema	Causa provável	Solução
"Falha na conexão"	Chave/ID errados, Conciliadora fora do ar	Verifique dados e estado da Conciliadora.
Sincronização "Parcial"	Algumas operadoras deram erro na origem	Aguarde próximo ciclo; geralmente é temporário.
Venda duplicada no sistema	Venda lançada manualmente e importada	Apague a duplicata; em regime automático, prefira sempre confiar na integração.
Sem dados sendo baixados	Sincronização automática desativada	Reative no switch.
"Adquirente sem conta mapeada"	Falta criar mapeamento	Crie mapeamento na aba Mapeamentos.
Conta financeira não aparece no mapeamento	Conta inativa	Ative em Contas Financeiras.
Histórico cheio de erro	Possível bloqueio do lado da Conciliadora	Contate suporte da Conciliadora.
Valores não batem com o banco	Conciliação ainda não foi feita	Vá para Conciliação de Cartões para casar cada transação.

15. Resumo em uma tela

Financeiro → Integração Conciliadora.
Primeira vez: informe API Key, ID da empresa, URL base → testar conexão → salvar.
Mapeie cada adquirente (Cielo, Rede, Stone…) à sua respectiva conta financeira.
Deixe sincronização automática ligada (sugestão: a cada 60 min).
Dados de vendas, pagamentos e cancelamentos entram sozinhos no NuvCar.
Use o módulo de Conciliação de Cartões para casar transações importadas com os recebimentos internos.

Dúvidas ou comportamento diferente do descrito aqui? Entre em contato com o suporte do NuvCar.

← Anterior: Conciliação de Cartões | Próximo: Fluxo de Caixa →