🔗 Sobre a API Líber

A Líber Connect é uma API robusta do tipo REST, desenvolvida para integrar e automatizar operações de Risco Sacado, facilitando a gestão e a troca de informações entre o Sacado e a Liber, com segurança e eficiência.

Utilizamos o método de autenticação OAuth 2.0, conhecido e recomendado no mercado, além de ser amplamente utilizado para permitir o acesso de recursos protegidos sem a necessidade de armazenar credenciais do usuário — ou seja, através de tokens temporários.

É importante mencionar que o Connect possui ambientes distintos entre Staging e Produção, de forma que poderão ser utilizados dados fictícios para testes em Homologação (Staging).

Contate o nosso time de implantação para liberação de acesso em homologação e, quando finalizados os testes, serão geradas novas credenciais para o ambiente de Produção.

API REST

No modelo de API REST (Liber Connect), a comunicação ocorre através de um conjunto de funções entre cliente e servidor, utilizando requisições HTTPs que contém os parâmetros POST, PUT, GET e DEL.

GET - Recuperação/Busca de informações
POST - Criação/Envio de novos recursos
PUT - Atualização de recursos já existentes
DEL - Remoção de recursos

Benefícios da Integração

✅ Troca de informações de forma segura: Implementação de padrões de autenticação OAuth 2.0, garantindo que apenas usuários autorizados possuam acesso ao Connect.
✅ Utilização do método OpenAPI, reduzindo erros na implementação e garantindo padronização dos dados.
✅ Redução de processos manuais, devido à integração com o ERP.
✅ Processamento ágil: atualização das informações em real time¹
✅ Monitoramento e suporte especializados.

Funcionalidades disponíveis

Métodos de consulta

Para retorno/atualização no ERP das informações enviadas para a Líber, temos disponíveis dois métodos de consultas: Polling e Webhook (opcional)

Polling: São realizadas requisições periódicas no sistema parceiro (GET) para o servidor Líber, para consulta de atualizações nos documentos enviados à Líber.
OBS: Pode ser realizada a consulta de apenas um documento específico (através do número de referência do título) ou da base completa, com 20 itens por página.

Webhooks (Recomendado): Técnica baseada em eventos, utilizada para verificar atualizações no servidor. Ou seja, sempre que um documento, fornecedores e outras entidades gerenciadas pela Plataforma sofre atualizações na Líber, o sistema parceiro recebe uma notificação via Webhooks de forma automatizada e em tempo real (Assim que finalizado o processamento do evento), atualizando o título no ERP do parceiro sem a necessidade de consultas periódicas.

Fluxo Operacional

1. Sacado realiza o envio dos títulos através da Integração API;
2. Liber recepciona os títulos e retorna com o status da inserção;
   1. Inserted or not inserted;
3. Sacado realiza a consulta da situação do título;
   1. Deve ser realizado o Bloqueio no ERP para títulos inseridos com sucesso (Inserted);
4. Fornecedor realiza o pedido e a assinatura das operações;
5. Liber envia o pedido de antecipação ao Investidor.
6. Título é atualizado na API (update);
   1. Status “SOLD” e “PROCESSING”, e campo “last trade completed at” preenchido com o horário e data de assinatura da operação.
7. Investidor realiza o envio do retorno com a crítica da operação.
8. Operação concluída:
   1. Status do título: SOLD
   2. Status da venda: COMPLETED;
   3. Disbursed_At: Preenchido com a data e hora de conclusão da operação;
9. Operação recusada:
   1. Título retorna ao status anterior “VERIFIED”;
10. Sacado realiza a consulta da situação do título na API;
    1. Se Operação Concluída: Sistema ERP do Sacado deverá realizar a baixa do título do fornecedor e a alteração da carteira (Fornecedor ➡️ Investidor)
11. Sacado realiza o pagamento do título antecipado, diretamente ao Investidor na data de vencimento.
12. Liber realiza a reposição do limite em D+1 aos vencimentos.

Em casos de títulos não operados dentro do prazo mínimo estabelecido:

1. Título é atualizado automaticamente com status “EXPIRED” (Vencido)
2. Sacado realiza a consulta na API;
3. O Título deverá ser desbloqueado no ERP do Sacado para pagamento ao Fornecedor na data de vencimento.