A Kobana chegou ao n8n, uma plataforma de automação de fluxo que pode ajudar muito na sua gestão financeira.
A n8n é uma das ferramentas mais poderosas do mercado, permitindo integrações entre diferentes sistemas, de forma simples e intuitiva, através dos “nodes”, ou nódulos, que conectam as ações feitas entre um mesmo sistema, ou entre diferentes sistemas.
Nesse artigo, vamos mostrar como instalar e como integrar a API da Kobana ao n8n.
Como instalar a Kobana no n8n?
A forma mais simples de instalar a Kobana no n8n é pelo próprio app da plataforma. Para isso, acesse a sua conta no n8n, clique no botão com três pontinhos ao lado do seu nome, e na opção Settings no menu do lado esquerdo da tela.
Nas configurações, acesse Community Nodes e clique no botão Install a community node. Na tela seguinte, preencha o npm Package Name com n8n-nodes-kobana, clique na verificação para aceitar a instalação e finalize com o botão Install. Reinicie o n8n para que o novo node seja instalado.
Atenção! Apenas o dono da instância do n8n pode fazer a instalação. O dono da instância é a pessoa responsável por configurar e gerenciar os usuários.
Como configurar a autenticação da Kobana no n8n?
Para usar a Kobana pelo n8n é preciso usar o token de autenticação de API na sua conta da Kobana.
Você encontra essa informação em Integrações > API (na aba do seu sistema para a Kobana) > Token de API. Lembrando que o token de API da Kobana aparece em tela apenas quando é gerado ou renovado. Você deve ter essa informação anotada em algum lugar seguro, caso já tenha configurado alguma configuração com a API da Koban.
Com o seu token de API em mãos, volte ao n8n e clique em Create Credential, no canto superior direito:
Selecione a API da Kobana da lista de APIs disponíveis.
Preencha o token de API, selecione se o ambiente é sandbox (testes) ou produção e clique em Save para criar a credencial. Após preencher as informações o sistema da n8n vai automaticamente testar a conexão.
Como usar a Kobana no n8n?
Com tudo configurado é hora de testar a Kobana no n8n. Crie um novo workflow, ou use um workflow já existente, dependendo do seu uso da plataforma. Para usar a Kobana, basta acrescentar um novo nódulo usando o botão (+) e procurar pela Kobana.
Nos detalhes do node, é possível ver todas as operações disponíveis pela plataforma. No nosso exemplo, vamos pegar as informações de um boleto selecionando o comando Get a Bank Slip.
Assim, o sistema vai pegar as informações do boleto usando o ID dele na Kobana. Confira no exemplo abaixo como é a resposta da API.
Essa resposta pode ser usada na continuidade do fluxo para outra ação.
O que é possível fazer com a Kobana no n8n?
A integração com a API da Kobana pelo n8n dá acesso para os usuários a 175 endpoints, tanto na V1 quanto na V2, para o gerenciamento de boletos e de carteiras de recebimento. Esses endpoints são organizados por nome e recursos. Além disso, existem duas formas de chamar a Kobana:
Kobana Node - uma versão user-friendly, projetada para as operações mais comuns e com uma configuração por campos de preenchimento;
Kobana Complete Node - a versão completa, com acesso total a API da Kobana, com todos os 175 endpoints.
Lista completa de endpoints disponíveis na API da Kobana
Recursos na V1 da API
Bank Billets - 9 operations
Bank Billet Accounts - 7 operations
Bank Billet Batches - 8 operations
Bank Billet Discharges - 2 operations
Bank Billet Payments - 3 operations
Bank Billet Registrations - 2 operations
Bank Billet Remittances - 5 operations
Customers - 6 operations
Customer Subscriptions - 6 operations
Discharges - 5 operations
Email Deliveries - 3 operations
Events - 2 operations
Imports - 3 operations
Installments - 5 operations
Remittances - 6 operations
Reports - 1 operation
SMS Deliveries - 3 operations
User Info - 1 operation
Webhook Deliveries - 3 operations
Webhooks - 5 operations
Recursos na V2 da API
Admin Namespace (12 operations)
User management (create, list, get, update, delete)
Connection management
Certificate management
Subaccount management
Charge Namespace (12 operations)
PIX charge creation and management
PIX account management
Command tracking
Data Namespace (1 operation)
Bank billet queries
EDI Namespace (2 operations)
EDI box management
Financial Namespace (11 operations)
Financial account management
Balance tracking
Statement transactions
Transaction imports and sync
Provider management
Payment Namespace (16 operations)
Bank billet payments
PIX payments
DARF payments
Utility payments
Batch operations for all payment types
Transfer Namespace (13 operations)
Internal transfers
PIX transfers
TED transfers
Batch transfers
Transfer approval/rejection
Confira a documentação de API da Kobana para ver as informações completas de todos os endpoints.