NooviChat NooviFlow

NooviChat NooviFlow

NooviFlow API Reference

Referencia completa da API NooviFlow — 117 endpoints para gestao financeira, CRM, transacoes, faturas, metas, projecoes e administracao multi-tenant.

Visao Geral

Base URL

https://flow.seudominio.com

Versao

v1.0.0OpenAPI 3.1.0

Autenticacao

Todas as rotas (exceto auth) requerem o header Authorization: Bearer TOKEN com um JWT valido.

Ver guia completo de autenticacao

Auth

Login, registro, reset de senha e gerenciamento de perfil.

/api/auth/login

Login com email e senha

/api/auth/register

Registrar novo usuario

/api/auth/forgot-password

Solicitar reset de senha

/api/auth/profile

Obter perfil do usuario

Clientes

Gerenciamento de clientes, notas, documentos e contratos.

Listar clientes

Criar cliente

/api/clients/{id}

Obter cliente

/api/clients/{id}

Atualizar cliente

/api/clients/{id}

Deletar cliente

Transacoes

Gerenciar transacoes financeiras (receitas e despesas).

/api/transactions

Listar transacoes

/api/transactions

Criar transacao

/api/transactions/{id}

Obter transacao

/api/transactions/{id}

Atualizar transacao

/api/transactions/{id}

Deletar transacao

KPIs e Dashboard

Dashboard analytics, metricas de receita, despesas, clientes e LTV.

KPIs principais do dashboard

/api/kpis/chart

Grafico receita vs despesas

/api/kpis/top-clients

Top clientes por receita

/api/kpis/ltv

Lifetime Value

Contas a Pagar/Receber

Gestao de contas a pagar e receber com fluxo de caixa.

/api/accounts

Listar contas

/api/accounts

Criar conta

/api/accounts/{id}/pay

Marcar como paga

/api/accounts/cash-flow

Fluxo de caixa

Faturas Recorrentes

Faturas recorrentes com geracao de pagamentos e anexos.

Listar faturas

Criar fatura recorrente

/api/bills/{id}/generate

Gerar pagamento

/api/bills/payments/{id}/pay

Marcar pagamento como pago

Despesas

Despesas pessoais e da empresa com resumos por categoria.

/api/expenses/personal

Listar despesas pessoais

/api/expenses/personal

Criar despesa pessoal

/api/expenses/company

Listar despesas empresa

/api/expenses/company

Criar despesa empresa

Metas Financeiras

Metas com valor alvo, prazo, contribuicoes e progresso.

Listar metas

Criar meta

/api/goals/{id}/contribute

Adicionar contribuicao

/api/goals/summary

Resumo de metas

Projecoes

Projecoes financeiras com cenarios otimista, realista e pessimista.

/api/projections

Listar projecoes

/api/projections

Criar projecao

/api/projections/next-12-months

Proximos 12 meses

/api/projections/generate

Gerar automaticamente

Chat IA

Assistente de IA com contexto financeiro completo.

/api/chat/messages

Historico de mensagens

/api/chat/messages

Enviar mensagem para IA

/api/chat/messages

Limpar historico

Notificacoes

Alertas de vencimento, pagamentos e preferencias.

/api/notifications

Listar notificacoes

/api/notifications/{id}/read

Marcar como lida

/api/notifications/read-all

Marcar todas como lidas

/api/notifications/preferences

Configurar preferencias

Email

Configuracao SMTP e envio de relatorios para contador.

/api/email/smtp

Obter config SMTP

/api/email/smtp

Salvar config SMTP

/api/email/smtp/test

Testar SMTP

/api/email/accountant/send

Enviar para contador

Equipe

Gerenciamento de membros, convites e papeis.

Listar membros

/api/team/invite

Convidar membro

/api/team/{id}/role

Alterar papel

/api/team/{id}

Remover membro

Super Admin

Gerenciamento global de contas, usuarios e KPIs do sistema.

/api/superadmin/accounts

Listar contas

/api/superadmin/users

Listar usuarios

/api/superadmin/stats

Estatisticas do sistema

/api/superadmin/kpis/overview

KPIs overview