n8n-nodes-relif

Nodo personalizado de n8n para interactuar con la API de Relif. Permite crear y gestionar clientes para business units.

Instalación

En n8n Cloud

1. Ve a Settings → Community Nodes
2. Click en "Install a community node"
3. Ingresa: n8n-nodes-relif
4. Click en "Install"

Desarrollo local

cd apps/n8n-nodes-relif
npm install
npm run build
npm link

# En otra terminal, si tienes n8n local:
cd /ruta/a/tu/n8n
npm link n8n-nodes-relif

Configuración de Credenciales

1. En n8n, ve a Credentials → Add Credential
2. Busca "Relif API"
3. Configura:
   • API Base URL:
     • Producción: https://relif-saas-back-yb2ukoflca-tl.a.run.app
     • Local: http://localhost:3003
   • Bearer Token: Tu token de autenticación

Uso

Crear un Cliente

1. Agrega el nodo "Relif" a tu workflow
2. Selecciona:
   • Resource: Client
   • Operation: Create
3. Completa los campos:
   • Business Unit ID (requerido): ID de la business unit
   • Phone (requerido): Número de teléfono del cliente
   • First Name (opcional): Nombre del cliente
   • Last Name (opcional): Apellido del cliente
   • Email (opcional): Email del cliente
   • RUT (opcional): RUT del cliente
   • Source (opcional): Origen del cliente
   • Is Test Client (opcional): Indica si es un cliente de prueba

Endpoint

El nodo utiliza el siguiente endpoint de la API de Relif:

• POST /token/:businessUnitId/clients

Autenticación

El nodo utiliza autenticación Bearer Token. El token debe configurarse en las credenciales de n8n.

Desarrollo

# Instalar dependencias
npm install

# Compilar
npm run build

# Modo desarrollo (watch)
npm run dev

# Linting
npm run lint
npm run lintfix

# Formatear código
npm run format