n8n-nodes-holded

Este es un nodo personalizado de n8n para integrar la API de Holded.

Instalación

Instalación en n8n (Community Node)

1. Ve a Settings > Community Nodes en tu instancia de n8n
2. Selecciona Install
3. Ingresa n8n-nodes-holded en el cuadro de instalación
4. Acepta los riesgos y selecciona Install

Después de la instalación, el nodo Holded estará disponible en tu paleta de nodos.

Instalación manual (desarrollo local)

# Clona el repositorio
git clone https://github.com/yourusername/n8n-nodes-holded.git
cd n8n-nodes-holded

# Instala dependencias
npm install

# Compila el nodo
npm run build

# Enlaza el nodo localmente
npm link

# En tu carpeta de n8n
cd ~/.n8n/custom
npm link n8n-nodes-holded

Configuración

Obtener tu API Key de Holded

1. Inicia sesión en tu cuenta de Holded
2. Ve a Configuración (barra superior) -> API
3. Copia tu API Key

Configurar credenciales en n8n

1. En n8n, crea una nueva credencial de tipo Holded API
2. Pega tu API Key
3. Guarda las credenciales

Recursos soportados

Employee (Empleados)

El nodo actualmente soporta las siguientes operaciones con empleados:

Get Many (Obtener múltiples)

Obtiene una lista de todos los empleados.

Parámetros:

• Return All: Si se debe devolver todos los resultados o limitar
• Limit: Número máximo de resultados (cuando Return All está desactivado)

Get (Obtener uno)

Obtiene un empleado específico por su ID.

Parámetros:

• Employee ID: El ID del empleado

Create (Crear)

Crea un nuevo empleado.

Campos opcionales:

• Name (Nombre)
• Email (Correo electrónico)
• Phone (Teléfono)
• Position (Posición)
• Department (Departamento)

Update (Actualizar)

Actualiza un empleado existente.

Parámetros:

• Employee ID: El ID del empleado a actualizar

Campos opcionales:

• Name (Nombre)
• Email (Correo electrónico)
• Phone (Teléfono)
• Position (Posición)
• Department (Departamento)

Delete (Eliminar)

Elimina un empleado.

Parámetros:

• Employee ID: El ID del empleado a eliminar

Estructura del proyecto

n8n-nodes-holded/
├── credentials/
│   └── HoldedApi.credentials.ts
├── nodes/
│   └── Holded/
│       ├── Holded.node.ts
│       └── holded.svg (icono del nodo)
├── package.json
├── tsconfig.json
└── README.md

Desarrollo

# Instalar dependencias
npm install

# Compilar en modo watch
npm run dev

# Compilar para producción
npm run build

# Verificar código
npm run lint

# Formatear código
npm run format

Roadmap

• [x] Integración con Employee API
• [ ] Integración con Contacts API
• [ ] Integración con Invoices API
• [ ] Integración con Products API
• [ ] Integración con Projects API

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Haz fork del repositorio
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Licencia

MIT

Recursos

• Documentación de Holded API
• Documentación de n8n
• Crear nodos personalizados en n8n

Soporte

Si encuentras algún problema o tienes sugerencias, por favor abre un issue en el repositorio de GitHub.