Kobana

Seu financeiro disponível via API

10 recursos REST com autenticação JWT, escopos por operação, paginação por cursor e idempotência em escritas. As mesmas regras de negócio da UI — sem backdoor, sem lógica paralela.

API Pública
Ver documentação da APIAgendar demonstração
API Pública do Financeiro Inteligente
10
recursos disponíveis
OpenAPI 3
spec disponível
Cursor
paginação
JWT + escopos
autenticação

10 recursos, cobertura completa do back-office

Contas Financeiras
accounts

Liste e consulte contas financeiras. Saldo calculado em tempo real retornado na resposta.

Categorias
categories

Leia o plano de contas completo (3 níveis). Integre com seu ERP para manter categorias sincronizadas.

Centros de Custo
cost_centers

Liste centros de custo para populamento de formulários em sistemas externos.

Empresas
companies

Liste as empresas do workspace. Útil para integrar relatórios multi-empresa em dashboards externos.

Pessoas
people

CRUD completo de fornecedores e clientes com validação de CPF/CNPJ.

Impostos
taxes

Liste e consulte impostos de retenção configurados no workspace.

Contas a Pagar
payables

CRUD completo. Crie, leia, atualize e liste com filtros por status, vencimento, fornecedor e categoria.

Contas a Receber
receivables

CRUD completo. Mesma estrutura de payables para consistência de integração.

Transações
transactions

Liste e consulte transações de contas financeiras com filtros de data e valor.

Anexos
attachments

Upload, download e listagem de arquivos. Download via streaming seguro com autenticação.

API construída para integração de produção

Autenticação Bearer JWT
Token JWT no header Authorization: Bearer. Escopos granulares por recurso e operação (finance.payables, finance.payables.write).
  • Escopos independentes por recurso
  • Separação read/write
  • Mesma validação de tenant da UI
Paginação por Cursor
Paginação estável para grandes volumes de dados. O cursor garante resultados consistentes mesmo com dados sendo criados durante a iteração.
  • cursor e per_page nos parâmetros
  • next_cursor na resposta
  • Sem pulos ou duplicatas
Idempotência em Escritas
Envie o header Idempotency-Key em operações de criação. Re-envios com a mesma chave retornam o resultado original sem criar duplicatas.
  • Header Idempotency-Key nas mutações
  • Seguro para retry em falhas de rede
  • Resultado cacheado por 24h
Multi-tenant Nativo
O JWT determina o workspace. Impossível acessar dados de outro tenant. Todas as queries são escopadas pelo workspace_id do token.
  • Isolamento total por workspace
  • Sem parâmetro de tenant no path
  • Mesma segurança da UI
Mesmas Regras de Negócio
A API usa os mesmos serviços, validações e regras automáticas da interface. Criar um lançamento via API dispara as mesmas regras de classificação.
  • Validação de CPF/CNPJ
  • Regras automáticas disparam
  • Sem lógica paralela ou backdoor
OpenAPI 3 Disponível
Especificação completa em /public/openapi-v1.yaml. Viewer interativo com Scalar em /docs. Importe direto no Postman, Insomnia ou qualquer cliente REST.
  • Schemas completos por recurso
  • Exemplos de request/response
  • Testável diretamente no browser

Integre em minutos

Exemplo de criação de conta a pagar via API:

curl -X POST https://app.finance.kobana.com.br/api/v1/payables \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "description": "Fornecedor ABC - NF 1234",
    "amount": 5000.00,
    "due_date": "2026-07-15",
    "person_id": "per_abc123",
    "category_id": "cat_xyz456",
    "company_id": "cmp_def789"
  }'

Perguntas frequentes

Integre seu ERP ou sistema legado

A API REST permite que seu sistema continue sendo o sistema de record — e o Financeiro Inteligente entra como camada de automação e pagamentos.

Ver documentação da APIVer todas as funcionalidades
Agendar