n8n-nodes-acelera

Integración oficial de Acelera para n8n.
Permite autenticar con una API Key, obtener un access_token y consumir endpoints de Acelera (colaboradores, equipos, OKRs, KPIs y planes). Incluye selects dinámicos (equipos y períodos) cargados desde la API.

Estado: Alpha / Community Node

✨ Funcionalidades

• Autenticación vía API Key → POST /auth/login → access_token.
• Selects dinámicos con loadOptions:
  • Team (GET /team)
  • Periods (GET /basic-plan)
• Operaciones incluidas:
  • Collaborators: listar, crear, eliminar
  • Teams: listar
  • OKRs: listar por plan, actualizar avance de KR
  • KPIs: listar grupos, listar por grupo, actualizar avance
  • Plans: obtener detalle del plan (por teamId + idBasicPlan)

🔐 Credenciales

En Credentials de n8n:

• Acelera OAuth2 API (en realidad usa API Key simple)
  • API Key: tu API Key de Acelera

El nodo internamente llama a POST /auth/login con la API Key y cachea el access_token en el static data del nodo hasta su expiración.

🧩 Uso

1. Instala el paquete (ver instalación).
2. Crea la credencial Acelera OAuth2 API y pega tu API Key.
3. Añade el nodo Acelera en tu workflow.
4. Elige Resource y Operation:
   • Collaborators → Get All / Create / Delete
   • Teams → Get all
   • OKRs → Get all (by plan) / Add advance
   • KPIs → Get all groups / Get all by group / Add advance
   • Plans → Get Detail plan (requiere Team + Period)

Los parámetros (p. ej., idTeam, idBasicPlan, idKr, year, month, etc.) se muestran según la operación y se envían como parte de la URL o body según corresponda.

⚙️ Endpoints (mapeo rápido)

• Collaborators
  • GET /collaborator
  • POST /collaborator
  • DELETE /collaborator
• Teams
  • GET /team
• OKRs
  • GET /okr/plans/{idPlan}
  • POST /kr-history-result
• KPIs
  • GET /okr/kpis/{idTeam}
  • GET /kr/okr/{idGroupKPI}
  • PATCH /kr-month/{idKr}/{year}/{month}
• Plans
  • GET /plan/search/{idTeam}/{idBasicPlan}

Los selects dinámicos usan:

• GET /team
• GET /basic-plan

🧪 Ejemplo rápido

• Plans → Get Detail plan
  1. Selecciona Resource: Plans
  2. Operation: Get Detail plan
  3. Team: usa el selector dinámico (carga de /team)
  4. Periods: usa el selector dinámico (carga de /basic-plan)
  5. Ejecuta: realiza GET /plan/search/{idTeam}/{idBasicPlan} con Bearer access_token.

📦 Instalación

Desde n8n (Community Nodes)

1. Settings → Community Nodes → Install.
2. Busca n8n-nodes-acelera y confirma.

Local dev (clonado)

npm i
npm run build
# copia o monta la carpeta 'dist/' en tu directorio de custom nodes de n8n
# (o publica en npm y usa Community Nodes)