Banco On-Line – Integração com API bancária

Última atualização: 9 meses atrás Tempo de leitura: 4 minutos

O que é?

A funcionalidade Banco On-Line conecta o sistema Uniplus diretamente às plataformas bancárias homologadas, permitindo o envio automático de remessas, recebimento de retornos e baixa de títulos em tempo real via API.

Com isso, empresas que emitem dezenas ou centenas de boletos por dia, eliminam a necessidade de baixar arquivos manualmente do site do banco ou importar retornos no sistema.

O diferencial está na automação completa: ao emitir um boleto, o sistema envia os dados diretamente para o banco; ao receber o pagamento, o banco notifica o Uniplus, que baixa o título automaticamente.

Essa troca de informações reduz atrasos de baixa, minimiza erros de digitação e libera o time financeiro para focar na gestão financeira da empresa.

Atualmente é possível integrar com plataformas como Asaas ou Sicoob, utilizando a própria chave da API, com suporte a ambientes de homologação e produção.

Essa funcionalidade é especialmente útil em operações descentralizadas, onde várias unidades emitem boletos e precisam centralizar os dados financeiros em tempo real.

Como Funciona no Uniplus?

1. Licenciamento

Para utilizar a integração é necessário que o cliente tenha ativado a licença de boleto e a funcionalidade “Banco On-line” encontrada dentro do módulo cobrança escritural (Ferramentas → Configurador do sistema).

2. Integração ASAAS

O Asaas oferece soluções para automatizar as atividades burocráticas das empresas. A integração com sua API vai auxiliar a ter melhor gestão nas suas cobranças. Com plataforma Asaas é possível configurar o WebHook para que seu sistema seja notificado quando um documento for pago.

Configurações

1º No Uniplus, acesse Financeiro → Outros → Bancos. Cadastre o banco Asaas (Asaas I.P S.A).

image.png

Cadastrar Conta Corrente

2º Acesse Financeiro → Outros → Conta Corrente. Realize o cadastro informando os dados da conta e agencia da conta Asaas, que pode ser realizado através do seguinte link: Criar conta ASAAS.

image.png

Na aba Integrações, informe o campo ambiente e a chave API gerada dentro da plataforma do Asaas.

É possível no campo Ambiente selecionar entre “Homologação” e “Produção”.

image.png

O Webhook gerado no nosso sistema ficará nessa parte destacada em vermelho, dessa forma é possível colocar esse link na configuração de integração no site do banco Asaas:

image.png

A chave API é gerada dentro da plataforma do Asaas. Estando logado, acesse Configurações de conta → Aba integração → Gerar API Key.

image.png

Envio de Remessa

No Uniplus acesse Financeiro → Remessa para Cobrança e filtre pelos documentos gerados.

Selecione os documentos e no campo Conta Corrente informe a conta corrente Asaas.

image.png

Realizando essa ação os arquivos não aparecerão mais na tela, com esses documentos sendo enviados para a plataforma do Asaas.

  • Se for preciso fazer algum ajuste de informação após o registro da remessa, será necessário modificar o documento correspondente. Essa modificação pode ser realizada seguindo o caminho Financeiro → Contas a Receber. Quando se ajusta o documento em campos como desconto, acréscimo ou prorrogação/alteração de vencimento, as informações atualizadas são sincronizadas automaticamente na plataforma Asaas, sem a necessidade de qualquer intervenção manual.

OBS: A operação de emissão de boletos deve ser executada dentro da plataforma do Asaas.

Caso tenha problema com alguma remessa a mesma pode ser consultada em Financeiro > Cobrança escritural > Consulta de remessa. Nessa tela poderá ser transmitido novamente a remessa, ou cancelar a mesma.

image.png

Retorno de Cobrança

Se caso esteja com WebHook configurado, ele vai trabalhar nesse momento, recendo as notificações de baixa do Asaas e baixando automaticamente os documentos.

Caso não tenha configurado o WebHook, esse processo poderá ser manual, basta ir em: Financeiro > Retorno de cobrança, selecione a conta corrente do Asaas, o período de pagamento dos documentos e clique em “Filtrar”. Os documentos recebidos no período filtrado serão carregados. Para finalizar clique em “Processar retorno” para fazer a baixa dos documentos.

image.png

3. Integração Banco Sicoob

A integração com o Banco Sicoob oferece soluções para automatizar as atividades burocráticas das empresas. A integração com sua API vai auxiliar a ter melhor gestão nas suas cobranças.

Configurações

Para fazer a integração do Uniplus com a API do banco Sicoob, será necessário criar um aplicativo no próprio ambiente do banco, disponível neste link.

Na página, certifique-se de fazer login. Caso não tenha um cadastro, é possível criar um ao clicar no menu “Cadastro“, na barra superior. Feito o login, a opção “Meus aplicativos” será visível.

image.png

Ao clicar no menu “Meus aplicativos“, será notificado que é necessário ser um cooperado para continuar com o procedimento:

image.png

Após solicitar os dados da conta, será solicitado um código de verificação enviado ao aplicativo Sicoob. Informe o código e clique em “Autorizar

image.png

As telas seguintes são para a criação do aplicativo. Acompanhe os 5 estágios:

1 – Informações: preencha os campos fornecendo informações básicas, como o nome do aplicativo, sua descrição, dados de conta corrente e nome do cooperado.

image.png

2 – Segurança: marque a primeira opção em “Não” e insira um certificado digital (.cer) válido para prosseguir.

image.png

Exemplo: pode exportar o certificado da empresa caso ainda não tenha sido feito:

image.png

3 – APIs: escolha os itens a serem usados pelo Uniplus: “Cobrança Bancária“, “Cobrança Bancária Pagamentos” e “Conta Corrente“, conforme a imagem abaixo:

image.png

4 — Confirmação: faça a confirmação dos dados informados.

5 — Aplicativo: apenas confirme a criação do aplicativo.

Feito a criação, o status fica como Pendente, e a pessoa responsável pela conta deverá autorizá-la. Depois de ativado o aplicativo, ele estará disponível para uso.

image.png

Clicando nele, abrirá a seguinte página com os dados principais do aplicativo.

image.png

Copie o conteúdo do “Client ID” e insira no campo Chave da API do cadastro da conta corrente no Uniplus (Financeiro → Outros → Contas correntes), na aba Integração:

image.png

Saiba mais

  • Veja as respostas para perguntas comuns sobre a gestão Financeira.

_