Email

Configure o servidor SMTP para envio de emails e gerencie o envio automatico de relatorios financeiros para o contador da empresa.

Permissao de Admin

Os endpoints de SMTP requerem permissao de administrador.

Configuracao SMTP

GET/api/email/smtp

Retorna a configuracao SMTP atual.

200Configuracao SMTP

json

{
  "success": true,
  "data": {
    "host": "smtp.gmail.com",
    "port": 587,
    "secure": false,
    "user": "noreply@empresa.com",
    "fromName": "NooviFlow",
    "fromEmail": "noreply@empresa.com"
  }
}

POST/api/email/smtp

Salva a configuracao SMTP (somente admin).

Body

Nome	Tipo	Obrigatorio	Descricao
`host`	`string`	Sim	Servidor SMTP
`port`	`integer`	Sim	Porta (465, 587, etc)
`secure`	`boolean`	Nao	Usar SSL/TLS
`user`	`string`	Sim	Usuario SMTP
`password`	`string`	Sim	Senha SMTP
`fromName`	`string`	Nao	Nome do remetente
`fromEmail`	`string`	Nao	Email do remetente

bash

curl -X POST "https://flow.seudominio.com/api/email/smtp" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "smtp.gmail.com",
    "port": 587,
    "secure": false,
    "user": "noreply@empresa.com",
    "password": "app_password_aqui",
    "fromName": "NooviFlow",
    "fromEmail": "noreply@empresa.com"
  }'

POST/api/email/smtp/test

Testa a configuracao SMTP enviando um email de teste (somente admin).

bash

curl -X POST "https://flow.seudominio.com/api/email/smtp/test" \
  -H "Authorization: Bearer $TOKEN"

200Resultado do teste

json

{
  "success": true,
  "message": "Email de teste enviado com sucesso"
}

DELETE/api/email/smtp

Remove a configuracao SMTP (somente admin).

bash

curl -X DELETE "https://flow.seudominio.com/api/email/smtp" \
  -H "Authorization: Bearer $TOKEN"

Email para Contador

Configure o envio automatico de relatorios financeiros mensais para o contador.

GET/api/email/accountant

Retorna a configuracao de email do contador.

200Configuracao do contador

json

{
  "success": true,
  "data": {
    "email": "contador@escritorio.com.br",
    "name": "Dr. Silva Contabilidade",
    "autoSend": true,
    "sendDay": 5,
    "includeTransactions": true,
    "includeBills": true,
    "includeExpenses": true
  }
}

POST/api/email/accountant

Salva a configuracao de email do contador.

bash

curl -X POST "https://flow.seudominio.com/api/email/accountant" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "contador@escritorio.com.br",
    "name": "Dr. Silva Contabilidade",
    "autoSend": true,
    "sendDay": 5,
    "includeTransactions": true,
    "includeBills": true,
    "includeExpenses": true
  }'

DELETE/api/email/accountant

Remove a configuracao do contador.

POST/api/email/accountant/send

Envia o relatorio financeiro para o contador imediatamente.

Body

Nome	Tipo	Obrigatorio	Descricao
`referenceMonth`	`string`	Sim	Mes de referencia (YYYY-MM)

curl -X POST "https://flow.seudominio.com/api/email/accountant/send" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "referenceMonth": "2026-01" }'

200Email enviado

json

{
  "success": true,
  "message": "Relatorio de Janeiro/2026 enviado para contador@escritorio.com.br"
}