Feed iCal

Un feed iCal publica tareas como un calendario de solo lectura al que puede suscribirse cualquier app de calendario. Las tareas con fecha de inicio o de vencimiento aparecen como eventos de día completo, y tu calendario los mantiene al día por su cuenta.

Los feeds se gestionan solo en la app, en la pestaña Compartir de los ajustes del proyecto, donde viven los feeds del proyecto y tus feeds personales. No tienen operación en la API ni tool MCP, porque la URL secreta es un secreto personal que no debe viajar por integraciones. Los feeds de proyecto los crean, rotan y revocan los roles owner y admin; los roles owner, admin, member y user gestionan sus propios feeds personales, y el rol employee no puede crear ninguno.

Dos tipos de feed

Feed	Qué publica	Filtro
De proyecto	Las tareas de un proyecto	Opcionalmente hasta 100 etiquetas de tarea: una tarea aparece si lleva cualquiera de ellas
Personal (mis tareas)	Las tareas que tienes asignadas en cualquier proyecto de la empresa	Ninguno

Cada feed tiene una zona horaria (un identificador IANA como Europe/Madrid; la app propone la de tu navegador). Decide el día que se usa para retirar las tareas completadas hace tiempo, como se describe más abajo.

La URL secreta

El feed se sirve sin sesión en una URL con la forma /api/public/task-feeds/<token>.ics, para que una app de calendario pueda descargarlo. El token son 32 bytes aleatorios; Factuarea guarda solo su hash SHA-256.

La URL se muestra una sola vez, al crear o rotar el feed, con un botón de copiar. Ningún listado ni detalle posterior vuelve a mostrar el token ni la URL.
Si la pierdes, rota el feed. No hay forma de recuperarla.
Trátala como una contraseña. Quien tenga la URL puede leer las tareas que incluye el feed, sin iniciar sesión. No la pegues en una incidencia pública ni en un documento compartido.

Suscribirse lleva tres pasos:

Crea el feed en la app

Elige el alcance (proyecto o personal), las etiquetas si quieres filtrar y la zona horaria.

Copia la URL

Cópiala cuando se muestre: no volverá a mostrarse.

Añádela a tu app de calendario

Usa la opción de añadir o suscribirse a un calendario desde una URL en Google Calendar, Outlook, Calendario de Apple o cualquier otra app de calendario, y pégala. La app decide cada cuánto se actualiza, así que un cambio en una tarea aparece en su siguiente actualización.

Rotar y revocar

Rotar crea un token nuevo, que se muestra una vez, y conserva el alcance, el proyecto, las etiquetas y la zona horaria. La URL anterior deja de funcionar al instante y responde 404, así que las suscripciones existentes se rompen hasta que pegues la URL nueva. La app pide confirmación.
Revocar es irreversible: la URL responde 404 y el feed sale de la lista de feeds activos. La app pide confirmación.

Un feed también responde 404, sin más detalle, cuando el token es desconocido o tiene un formato inválido, cuando se borró su proyecto, cuando la persona propietaria de un feed personal ya no es miembro de la empresa o cuando la empresa ya no tiene el módulo tasks.

Qué incluye el feed

Solo aparecen las tareas con fecha de inicio o de vencimiento.

Un feed de proyecto incluye las tareas del proyecto y, si filtra por etiquetas, solo las que llevan alguna de ellas, comparando con las etiquetas que tiene ahora la tarea. Renombrar una etiqueta conserva el filtro; si se borran todas las etiquetas del filtro, el feed queda vacío y nunca se amplía a todo el proyecto.
Un feed personal incluye las tareas asignadas a su propietaria o propietario en cualquier proyecto de la empresa, y solo de esa empresa: quien pertenece a varias empresas recibe un feed distinto para cada una.
Se incluyen las tareas del backlog (planned) y las activas. Se dejan fuera las tareas archivadas y las completadas hace más de 30 días, contando los días en la zona horaria del feed.

Cada tarea es un evento de día completo. La fecha de fin de un evento de día completo de iCal es exclusiva, mientras que la fecha de vencimiento es inclusiva, así que el evento termina el día siguiente:

La tarea tiene	`DTSTART`	`DTEND`
Solo vencimiento, 2026-10-15	`20261015`	`20261016`
Inicio 2026-10-13 y vencimiento 2026-10-15	`20261013`	`20261016`
Solo inicio, 2026-10-13	`20261013`	`20261014`

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Factuarea//Tareas//ES
CALSCALE:GREGORIAN
X-WR-CALNAME:Web redesign
BEGIN:VEVENT
UID:0193a4f2-8f53-7d44-8e85-7a9b1c3d5f16@factuarea
DTSTAMP:20260928T082044Z
LAST-MODIFIED:20260928T082044Z
CREATED:20260928T082044Z
DTSTART;VALUE=DATE:20261013
DTEND;VALUE=DATE:20261016
SUMMARY:Call the customer about the checkout demo
TRANSP:TRANSPARENT
END:VEVENT
END:VCALENDAR

El UID de un evento es el id de la tarea más @factuarea, así que se mantiene igual cada vez que se sirve el feed y tu calendario actualiza el evento en lugar de duplicarlo. Los eventos son transparentes: no te marcan como ocupado. La DESCRIPTION aparece solo cuando la tarea la tiene, como texto plano (las menciones pasan a ser el nombre de la persona, y las etiquetas internas del editor y el HTML se eliminan), y los títulos y descripciones largos se cortan a 1024 y 4096 caracteres.

Privacidad

Un feed solo lee las tareas de la empresa a la que pertenece. Un feed personal nunca muestra tareas de tus otras empresas.
Los eventos llevan el título, las fechas y la descripción en texto plano de cada tarea. No llevan persona asignada, etiquetas, estado, comentarios, adjuntos ni enlace de vuelta a la tarea.
La respuesta se envía con Cache-Control: private, no-store, y cada acceso actualiza el último acceso del feed, que la app muestra junto a él.
Si la URL se filtra, rota el feed. Si ya no lo necesitas, revócalo.

Siguientes pasos

Proyectos y tareas

proyectos, tablero, tareas, etiquetas y fechas.

Tiempo imputado a tareas

entradas manuales, el temporizador y borradores de factura a partir de las horas facturables.

Agenda

las mismas fechas a través de la API, junto con vencimientos de documentos, plazos fiscales y ausencias.