E aí, família! Vim compartilhar algumas dicas de Recursos que são usados no Sienge e como fazer uma autenticação para consumir essa API via fluxo na Plataforma Weni.
Autenticação para consumir Endpoints
Para consumir os recursos do Sienge via webhook é necessário utilizar um Basic Token gerado no Postman usando o usuário e senha de api criado no módulo de Integração no Sienge.
Para gerar o Sienge Token (é como chamamos esse Basic token para usar nos webhooks), faça uma chamada no recurso GET em Customers:
Para a requisição ser bem sucedida é necessário que o usuário utilizado tenha permissão ao recurso + que o BaseURL, usuário e senha esteja correto.
Se o seguinte erro acontecer, provavelmente você está usando a baseURL errada, experimente substituir ou pergunte a correta ao seu Cliente:
Se a chamada der erro 403, existe algum erro de permissão ao recurso e todas as permissões recursos devem ser revisadas seguindo a documentação.
Se a chamada apresentar um retorno de acordo com o abaixo, tudo deu certo e seu token estará automaticamente em seus Headers da requisição > hidden > Authorization:
Agora você poderá consumir qualquer recurso da API do Sienge usando esse basic token em suas requisições, passando como parâmetro no Header:
- Authorization - Basic dTMtY3Jpc3RhbDpjR0exemplo
Recursos
Os recursos mais usados pela Weni atualmente são:
- GET em customers usando como parâmetro o CPF ou CNPJ - Para Credenciamento na Cristal
- GET em customer-financial-statements - Para pesquisar parcelas na Cristal
- POST em payment-slip-notification - Para enviar a segunda via da parcela por email na Cristal
- GET em payment-slip-notification - Para obter informações da segunda via, como linha digitável e boleto em PDF na Cristal
- Webhook - Gerenciamento de Webhooks - Para realizar cobrança Ativa na Cristal Ativa.
Para ver todos os recursos disponíveis consulte a api do Sienge através do link.