Read this article in English.

Días laborables en n8n: suma días hábiles y salta los festivos

Tarde o temprano un flujo necesita una fecha que respete los días de trabajo: una factura que vence 10 días laborables después de emitirse, una entrega prometida en 3 días hábiles, un recordatorio que no debe salir en un festivo, un informe que solo debe ejecutarse cuando la oficina está abierta. Sumar días es fácil. Saltar fines de semana y festivos, en el país correcto, es lo difícil.

Una aclaración por delante, porque la gente la busca: n8n no trae un nodo de días laborables ni de festivos. El nodo Date & Time ofrece siete operaciones: Add to a Date, Extract Part of a Date, Format a Date, Get Current Date, Get Time Between Dates, Round a Date y Subtract From a Date (documentación de n8n, en inglés). Sumar 10 días con él cuenta todos los sábados, domingos y festivos, y no encontramos ningún otro nodo incluido que sume días laborables o consulte festivos (comprobado en el código fuente de n8n el 19 de octubre de 2026). La forma habitual es preguntar a una API que conozca el calendario: un nodo HTTP Request, que es lo que hace esta guía con la API de Cofferdock.

Qué obtienes

Un solo endpoint con cuatro acciones. Mandas el país (un código de dos letras como ES, US, GB o MX) y, si quieres los festivos de una comunidad o región, su código:

• check: ¿es laborable esta fecha? Te dice si es fin de semana o festivo (y cuál), y el día laborable anterior y el siguiente.
• add: suma (o resta, con un número negativo) N días laborables a una fecha. El día de partida no cuenta: un viernes más 1 es el lunes.
• between: cuántos días laborables hay entre dos fechas, las dos incluidas, como NETWORKDAYS de Excel.
• list: los festivos de un año de un país o de una región.

El cálculo se hace en los servidores de Cofferdock con los festivos incluidos. No llama a ningún servicio de terceros, así que responde en milisegundos.

Qué necesitas

• Una cuenta de Cofferdock. El plan gratis trae 50 créditos al mes sin tarjeta, de sobra para probar.
• Tu API key, que creas en tu panel con "+ Crear llave". Solo se enseña una vez: cópiala y guárdala.
• Un nodo HTTP Request en tu flujo de n8n.

Paso a paso: sumar días laborables a una fecha

• Method: POST
• URL: https://api.cofferdock.com/business-days
• Send Headers: activado, con dos cabeceras: x-api-key con tu llave y Content-Type con el valor application/json.
• Send Body: activado → Body Content Type JSON → Specify Body Using JSON:

{ "country": "ES", "date": "2026-12-23", "days": 5 }

La respuesta trae la fecha que buscas en result:

{ "success": true, "action": "add", "country": "ES", "date": "2026-12-23", "days": 5,
  "result": "2026-12-31", "result_weekday": "Thursday",
  "skipped": { "weekend_days": 2, "holidays": [ { "date": "2026-12-25", "name": "Christmas Day", "type": "public" } ] } }

Cinco días laborables después del 23 de diciembre de 2026 en España es el 31 de diciembre, porque saltó el fin de semana y el día de Navidad. El campo skipped te dice qué días saltó, útil para explicarle una fecha a un cliente.

Ejemplo 1: factura que vence 10 días laborables después de emitirse

1. Un disparador con los datos de la factura (un webhook de tu tienda, una fila nueva en Google Sheets).
2. Un nodo HTTP Request como el de arriba, con el campo JSON en modo Expression para que pueda usar valores del nodo anterior:

{ "country": "ES", "region": "CT", "date": "{{ $json.fecha_factura }}", "days": 10 }

1. Un nodo siguiente que use {{ $json.result }} como fecha de vencimiento: en el PDF de la factura, en un correo o en tu programa de contabilidad.

Si fecha_factura viene con hora (2026-12-23T18:00:00Z) también funciona: solo se usa la parte de la fecha, tal como está escrita, sin cambiar de zona horaria.

Ejemplo 2: ejecutar solo en días laborables

1. Un Schedule Trigger cada mañana.
2. Un nodo HTTP Request con el cuerpo { "country": "US", "date": "{{ $now.toFormat('yyyy-LL-dd') }}" } (la acción se deduce: con solo una fecha, es check).
3. Un nodo IF sobre {{ $json.is_business_day }}: la rama verdadera sigue con tu informe diario; la falsa termina la ejecución en fines de semana y festivos.

Recuerda que $now usa la zona horaria de tu flujo de n8n.

Ejemplo 3: ¿cuántos días de trabajo han pasado?

Con { "country": "GB", "region": "ENG", "from": "2026-04-01", "to": "2026-04-30" } obtienes business_days, weekend_days y holiday_days, y los festivos que cayeron en días de trabajo de ese rango. Las dos fechas cuentan.

Que se ajuste a tu empresa

¿Qué tan fiables son los festivos?

Los festivos vienen de un conjunto de datos abierto mantenido por la comunidad (date-holidays, con licencia CC BY-SA 3.0) que cubre 207 países y territorios. Comprobamos las listas nacionales de 2026 de España, Inglaterra y Estados Unidos contra las fuentes oficiales (el BOE, gov.uk y la Oficina federal de Personal de EE. UU.) y coinciden en todos los festivos que caen entre semana. La calidad varía de un país a otro, y un festivo de un solo año anunciado tarde puede faltar: el festivo bancario del 15 de junio de 2026 en Escocia por el Mundial está en la lista de gov.uk pero no en los datos. Para eso existe extra_holidays. Para plazos legales, nóminas o contratos, confirma la fecha con la fuente oficial.

Errores típicos y cómo arreglarlos

Ningún error 400 se cobra.

¿Prefieres verlo en código?

curl -X POST "https://api.cofferdock.com/business-days" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{ "country": "ES", "date": "2026-12-23", "days": 5 }'

¿Cuánto cuesta?

Cada llamada gasta 1 crédito, sea cual sea la acción. Para ahorrar créditos en un bucle, pide una sola vez lo que necesitas: una llamada list devuelve todos los festivos de un año y una llamada between cuenta un rango entero. Todas las herramientas de Cofferdock tiran del mismo bote de créditos.

Preguntas frecuentes

¿n8n tiene un nodo nativo de días laborables o festivos? No. El nodo Date & Time puede sumar y restar tiempo, pero no conoce los fines de semana ni los festivos. Se hace con el nodo HTTP Request llamando a la API de Cofferdock.

¿Sirve para mi país? Cubre 207 países y territorios. Mira la lista en la página de la herramienta, y las regiones con el mensaje de error de una region equivocada.

¿Y si mi empresa trabaja los sábados o cierra por su aniversario? Usa weekend para tu semana de trabajo y extra_holidays para tus propios días de cierre.

¿Llama a otro servicio cada vez? No. Los festivos están incluidos en nuestro servidor, así que no hay un tercero que pueda caerse ni que te frene.

Guías relacionadas

• HTML a PDF en n8n: pon la fecha de vencimiento en una factura
• URL a PDF en n8n: guarda una página web como PDF

Referencia completa con todas las opciones: API de días laborables y festivos. ¿Aún sin cuenta? Crea una gratis y calcula tu primera fecha de vencimiento hoy mismo.