Saltar al contenido principal

n8n

Disponible

Conectar n8n y crear webhooks requiere el plan Premium.

Conecta Frihet a n8n para automatizar flujos de trabajo: recordatorios automáticos, sincronización con CRM, notificaciones personalizadas, y más.

¿Para qué sirve?​

Con n8n integrado:

  • Recordatorios automáticos — Envía emails cuando una factura vence
  • Sincronización CRM — Nuevos clientes se crean en Salesforce, Pipedrive, etc.
  • Notificaciones personalizadas — Slack, email, Telegram, webhook personalizado
  • Flujos complejos — Condicionales, loops, ramificaciones lógicas
  • Webhook endpoints — Otros sistemas disparan acciones en Frihet

Nodo de comunidad oficial​

Frihet publica un nodo de comunidad oficial en npm: n8n-nodes-frihet.

Instálalo directamente desde n8n sin configurar HTTP requests manuales:

  1. En n8n: Settings → Community Nodes → Install
  2. Introduce: n8n-nodes-frihet
  3. Confirma la instalación

O vía CLI en instancias self-hosted:

npm install n8n-nodes-frihet

El nodo aparece en tu paleta de n8n, se autentica con una API key de Frihet y da acceso a estos recursos:

RecursoOperaciones
InvoiceCreate, Get, List, Update, Delete, Send, Mark Paid
QuoteCreate, Get, List, Update, Delete, Send
ExpenseCreate, Get, List, Update, Delete
ClientCreate, Get, List, Update, Delete
ProductCreate, Get, List, Update, Delete
VendorCreate, Get, List, Update, Delete

Las operaciones List paginan por cursor. Los campos fiscales cubren IVA, IGIC, IPSI e IRPF.

Requisitos​

Obtener credenciales de Frihet​

En el menú principal, entra en Integraciones. La página tiene cuatro pestañas: Integraciones, Webhooks, API Keys y n8n.

  1. Abre la pestaña API Keys y haz clic en "Crear API Key"
  2. Copia la clave (empieza por fri_); solo se muestra una vez
  3. Si quieres recibir eventos en n8n, abre la pestaña Webhooks, haz clic en "Crear Webhook" y pega la URL del nodo Webhook de n8n

Guarda la clave en lugar seguro.

La pestaña n8n​

La pestaña n8n conecta tu instancia de n8n con Frihet. Te pide la URL de n8n (por ejemplo https://n8n.tudominio.com), una API key de n8n (se genera en la sección API de los ajustes de n8n) y, opcionalmente, el ID del workflow. Si indicas un workflow, Frihet crea por su cuenta un webhook hacia él. No es el sitio donde se crean las claves de Frihet: esas están en la pestaña API Keys.

Conectar Frihet a n8n​

Paso 1: Crea workflow en n8n​

  1. Ve a n8n.io
  2. Nuevo workflow
  3. Añade nodo: Frihet (búscalo)

Paso 2: Configura credenciales​

  1. En el nodo de Frihet, ve a Credenciales
  2. Haz clic en "Crear nueva credencial"
  3. Pega la API Key de Frihet
  4. Guarda

Paso 3: Elige acción​

En el nodo, elige qué hacer:

  • Crear factura
  • Crear gasto
  • Crear cliente
  • Obtener listado de clientes
  • Obtener listado de facturas
  • Marcar factura como pagada

Casos de uso común​

Recordatorio de vencimiento​

Cuando: Cada mañana a las 9am Qué hace: Busca facturas vencidas y envía email al cliente

n8n workflow:
1. Trigger: Cada día a las 09:00
2. Nodo Frihet: Obtener facturas vencidas
3. Loop: Para cada factura
4. Nodo Email: Enviar email de recordatorio
5. Actualizar en Frihet: Marcar "Recordatorio enviado"

Nuevo cliente → CRM​

Cuando: Se crea cliente en Frihet Qué hace: Automáticamente lo añade a Salesforce/Pipedrive

n8n workflow:
1. Trigger: Webhook de Frihet (nuevo cliente)
2. Nodo Frihet: Obtener datos del cliente
3. Nodo Salesforce: Crear contacto
4. Nodo Email: Notificar al equipo

Factura pagada → Notificación Slack​

Cuando: Se marca una factura como pagada Qué hace: Envía notificación a Slack con detalles

n8n workflow:
1. Trigger: Webhook de Frihet (factura pagada)
2. Nodo Frihet: Obtener detalles de factura
3. Nodo Slack: Enviar mensaje formateado
4. Nodo Sheet: Registrar en Google Sheets (opcional)

Crear factura desde form​

Cuando: Alguien completa un formulario Qué hace: Automáticamente crea factura en Frihet

n8n workflow:
1. Trigger: Webhook de formulario (TypeForm, Typebot, etc.)
2. Node: Procesar datos del formulario
3. Nodo Frihet: Crear factura
4. Nodo Email: Confirmar al cliente

Templates preconfigurados​

n8n y Frihet ofrecen templates listos:

  1. En n8n, ve a Community → Templates
  2. Busca "Frihet"
  3. Elige un template
  4. Haz clic en "Use this template"
  5. Solo configura credenciales

Templates disponibles​

  • "Recordatorio de facturas vencidas"
  • "Sincronizar clientes a Airtable"
  • "Notificaciones de pagos en Slack"
  • "Crear facturas desde Typeform"
  • "Backup diario a Google Drive"

Úsalos como base y personaliza.

Webhook de Frihet​

Frihet envía eventos automáticamente a n8n. Consulta la documentación completa de webhooks para detalles sobre firma HMAC-SHA256, reintentos y todos los tipos de evento.

Eventos que disparan webhook​

EventoDatos enviados
Factura creadaID, cliente, monto, vencimiento
Factura pagadaID, cliente, monto, fecha pago
Factura vencidaID, cliente, monto, días vencida
Cliente creadoID, nombre, email, teléfono
Gasto creadoID, categoría, monto, fecha
Pago recibidoID factura, cliente, monto

Configurar webhook en Frihet​

  1. En Integraciones, abre la pestaña Webhooks
  2. Haz clic en "Crear Webhook"
  3. Elige qué eventos disparar (recomendado: todos)
  4. Pega la URL de un nodo "Webhook" de n8n configurado como trigger

Acciones disponibles en Frihet​

Crear factura​

Entrada:
- Cliente ID (o crear nuevo)
- Concepto
- Monto
- Vencimiento
- IVA

Salida:
- ID de factura creada
- Número de documento
- Estado

Crear gasto​

Entrada:
- Categoría
- Monto
- Fecha
- Proveedor (opcional)

Salida:
- ID de gasto
- Confirmación

Obtener listado​

Entrada:
- Filtro (fecha, cliente, estado)
- Límite de resultados

Salida:
- Array de facturas/gastos/clientes

Marcar como pagada​

Entrada:
- ID factura
- Monto (opcional)
- Método de pago (opcional)

Salida:
- Confirmación
- Fecha de actualización

Ejemplo completo: Recordatorio diario​

Objetivo​

Cada mañana a las 8am, si hay facturas vencidas, envía email al cliente.

Workflow en n8n​

Paso 1: Trigger

Scheduler: Todos los días a las 08:00
Timezone: Europe/Madrid

Paso 2: Obtener facturas vencidas

Nodo: Frihet
Acción: Get Invoices
Filtro: State = "unpaid" AND Due Date < Today

Paso 3: Loop sobre cada factura

Loop Node: Para cada factura en el resultado
  - Obtener email del cliente
  - Calcular días vencida

Paso 4: Enviar email

Nodo: Gmail / SendGrid
Para: email del cliente
Asunto: "Factura #{{$node.Frihet.data.number}} por cobrar"
Cuerpo:
  "Tu factura {{id}} de {{monto}} euros
   está vencida desde hace {{días_vencida}} días.
   Por favor, realiza el pago cuanto antes.
   [Enlace de pago]"

Paso 5: Actualizar en Frihet

Nodo: Frihet
Acción: Update Invoice
Actualizar: reminder_sent = true
Actualizar: reminder_date = today

Sincronización bidireccional con CRM​

Crear cliente en Frihet → Salesforce​

1. Trigger: Webhook Frihet (cliente creado)
2. Frihet: Obtener datos del cliente
3. Salesforce: Crear Account
4. Salesforce: Crear Contact
5. Frihet: Guardar Salesforce ID en cliente

Crear deal en Salesforce → Factura en Frihet​

1. Trigger: Webhook Salesforce (deal ganado)
2. Salesforce: Obtener datos del deal
3. Frihet: Crear cliente (si es nuevo)
4. Frihet: Crear factura con monto del deal
5. Salesforce: Actualizar deal con link a Frihet

Notificaciones personalizadas​

Opción 1: Email​

Nodo: Gmail / SendGrid
Plantilla personalizada con:
  - Logo de tu empresa
  - Detalles de factura
  - Enlace de pago

Opción 2: Slack​

Nodo: Slack
Mensaje:
  ":moneybag: Factura pagada
   Cliente: {{cliente}}
   Monto: €{{monto}}
   Estado: Pagada ✅"

Opción 3: WhatsApp/Telegram​

Nodo: Telegram / WhatsApp (vía Twilio)
Mensaje:
  "Hola {{nombre}},
   Tu factura #{{id}} vence en 3 días.
   [Paga aquí]"

Opción 4: Webhook personalizado​

Si tienes tu propio sistema:

Nodo: HTTP POST
URL: https://tu-sistema.com/frihet-webhook
Body:
  {
    "event": "invoice_paid",
    "invoice_id": "...",
    "amount": 1200,
    "client": "..."
  }

Tu sistema procesa como necesite.

Condiciones y lógica​

Puedes agregar condiciones:

IF factura vencida MÁS DE 7 DÍAS
  THEN enviar email + crear tarea
ELSE IF vencida MENOS DE 7 DÍAS
  THEN solo enviar email
ELSE
  THEN no hacer nada

O ramificaciones más complejas:

IF cliente es "Premium"
  THEN llamar por teléfono
ELSE IF cliente es "Regular"
  THEN enviar email
ELSE
  THEN ignorar

Testing y debugging​

Ejecutar workflow manualmente​

  1. En n8n, haz clic en "Execute"
  2. Ves resultados paso a paso
  3. Si hay error, lo muestra con detalles
  4. Ajusta y vuelve a ejecutar

Logs y historial​

  1. Ve a Executions en tu workflow
  2. Ves cada ejecución:
    • Cuándo se ejecutó
    • Si fue exitosa
    • Tiempo de ejecución
    • Resultados de cada nodo

Test con datos de prueba​

Antes de activar (schedule), prueba:

  1. Edita el trigger a Manual
  2. Haz clic en "Execute" varias veces
  3. Verifica que cada nodo funciona
  4. Luego cambia a Trigger automático (scheduler)

Límites y costos​

En n8n​

  • Workflow automáticos: Depende de tu plan
  • Ejecuciones: Gratuito hasta cierto límite
  • Nodos: Ilimitados
  • Integraciones: Cientos disponibles

En Frihet​

  • Llamadas a la API: Disponibles en todos los planes
  • Webhooks: Hasta 20 por cuenta
  • Datos: Sin límite especial para n8n

Troubleshooting​

"Webhook no dispara"​

  • Verifica que el webhook está activo en Frihet
  • El evento debe coincidir con la configuración
  • Comprueba logs de n8n: Executions → historial
  • Si hay error HTTP, revisa estado del webhook

"Error: No credentials found"​

  • En n8n, verifica que las credenciales están guardadas
  • Copia nuevamente la API Key de Frihet
  • Recrea la credencial

"¿Cómo debug si algo no funciona?"​

  1. Añade nodo "Log" entre pasos para ver datos intermedios
  2. Ejecuta manualmente paso a paso
  3. Ve Executions → historial completo
  4. Busca el error en los logs

"¿Puedo usar múltiples workflows?"​

Sí. Puedes tener:

  • Workflow 1: Recordatorios diarios
  • Workflow 2: Sincronización CRM
  • Workflow 3: Backups automáticos
  • Todos corriendo en paralelo

Próximos pasos​

Anterior: Revolut Business

Última actualización en