Módulo · Sistema

Integrações Externas

Conecte o Nodus ao ERP/financeiro/emissor de NF da sua empresa, e configure o servidor SMTP próprio. Credenciais sempre criptografadas em repouso (AES-256-CBC). Apenas admin configura.

Onde: Menu ⚙️ Sistema → Integrações Externas
Quem acessa: apenas admin
Cifragem: AES-256-CBC em repouso

Email / SMTP da empresa

Por padrão, emails do Nodus saem dos servidores Nodus. Mas você pode (e deve, pra holerite oficial) configurar o SMTP da sua empresa — assim emails saem como rh@suaempresa.com.br, não como Nodus.

  1. Click ⚙️ Configurar no card "Email / SMTP da empresa".
  2. Vai pra aba SMTP.
  3. Auto-detect: digite o email (ex: rh@empresa.com.br) e o sistema sugere config Gmail/Office365/Resend/SendGrid.
  4. Ou preencha manualmente: host, porta, usuário, senha, TLS/SSL.
  5. Click Testar envio → mande email teste pro próprio endereço.
  6. Click Salvar.

A partir daí: holerites por email, notificações ao colab, alertas, relatórios — tudo sai do seu servidor.

ERPs financeiros

4 integrações ativas. Cada uma com card próprio no painel:

ERPStatusAuthSync automático
📊 OmieConfigurar + testarApp Key + App SecretEm desenvolvimento
🔔 BlingSync completoAPI Key (Bearer)✅ Funcionários ativos viram contatos no Bling
🟢 ContaAzulConfigurar (OAuth)Client ID + SecretEm desenvolvimento (OAuth pendente)
🧾 NFe (Focus)Configurar + testarToken Focus NFeEm desenvolvimento

Bling — sincronização real

Hoje o único com sync funcional. Após configurar a API Key:

  1. Card Bling → click 🔄 Sincronizar.
  2. Confirme — o sistema vai exportar até 100 funcionários ativos por execução.
  3. Pra cada colab cria/atualiza um Contato Pessoa Física no Bling com nome, CPF, email, telefone.
  4. Rate limit: 1 contato a cada 350ms (≈3 req/s, dentro do limite Bling).
  5. Ao fim: resumo "X criados, Y erros".
🔒 Soft-delete respeitado

Colab que exerceu direito de exclusão LGPD (Art. 18 VI) NÃO é exportado pro Bling — o filtro excluido_em IS NULL garante isso. Opt-out efetivo.

Segurança das credenciais

Toda credencial passa por:

  1. Cifragem AES-256-CBC com chave APP_ENCRYPTION_KEY antes de gravar no banco.
  2. Fail-closed: se a cifragem falhar (chave inválida), o sistema rejeita com erro claro (não grava vazio silenciosamente).
  3. SSL VERIFYPEER true em toda chamada outbound — sem MITM.
  4. Audit log: cada conexão / teste / sync / desconexão fica registrado em audit_log com timestamp e user_id.
  5. Apenas admin: defesa em profundidade — Rbac + check inline requireAdmin() em todos os endpoints do controller.

API Tokens & Webhooks (próprios)

Além das integrações listadas, o Nodus expõe uma API REST própria pra você integrar com qualquer sistema:

Detalhes em API & Webhooks.

← Anterior
OKRs
Próximo →
API & Webhooks