Feed iCal

Un feed iCal publica tasques com un calendari de només lectura al qual es pot subscriure qualsevol app de calendari. Les tasques amb data d'inici o de venciment apareixen com a esdeveniments de dia complet, i el teu calendari els manté al dia pel seu compte.

Els feeds es gestionen només a l'app, a la pestanya Compartir dels ajustos del projecte, on viuen els feeds del projecte i els teus feeds personals. No tenen operació a l'API ni tool MCP, perquè la URL secreta és un secret personal que no ha de viatjar per integracions. Els feeds de projecte els creen, roten i revoquen els rols owner i admin; els rols owner, admin, member i user gestionen els seus propis feeds personals, i el rol employee no en pot crear cap.

Dos tipus de feed

Feed	Què publica	Filtre
De projecte	Les tasques d'un projecte	Opcionalment fins a 100 etiquetes de tasca: una tasca apareix si porta qualsevol d'elles
Personal (les meves tasques)	Les tasques que tens assignades en qualsevol projecte de l'empresa	Cap

Cada feed té una zona horària (un identificador IANA com Europe/Madrid; l'app proposa la del teu navegador). Decideix el dia que es fa servir per retirar les tasques completades fa temps, com es descriu més avall.

La URL secreta

El feed se serveix sense sessió en una URL amb la forma /api/public/task-feeds/<token>.ics, perquè una app de calendari el pugui baixar. El token són 32 bytes aleatoris; Factuarea només en guarda el hash SHA-256.

La URL es mostra una sola vegada, en crear o rotar el feed, amb un botó de copiar. Cap llistat ni detall posterior torna a mostrar el token ni la URL.
Si la perds, rota el feed. No hi ha manera de recuperar-la.
Tracta-la com una contrasenya. Qui tingui la URL pot llegir les tasques que inclou el feed, sense iniciar sessió. No la enganxis en una incidència pública ni en un document compartit.

Subscriure's porta tres passos:

Crea el feed a l'app

Tria l'abast (projecte o personal), les etiquetes si vols filtrar i la zona horària.

Copia la URL

Copia-la quan es mostri: no tornarà a mostrar-se.

Afegeix-la a la teva app de calendari

Fes servir l'opció d'afegir o subscriure's a un calendari des d'una URL a Google Calendar, Outlook, Calendari d'Apple o qualsevol altra app de calendari, i enganxa-la. L'app decideix cada quant s'actualitza, així que un canvi en una tasca apareix en la seva propera actualització.

Rotar i revocar

Rotar crea un token nou, que es mostra un cop, i conserva l'abast, el projecte, les etiquetes i la zona horària. La URL anterior deixa de funcionar a l'instant i respon 404, així que les subscripcions existents es trenquen fins que enganxis la URL nova. L'app demana confirmació.
Revocar és irreversible: la URL respon 404 i el feed surt de la llista de feeds actius. L'app demana confirmació.

Un feed també respon 404, sense més detall, quan el token és desconegut o té un format invàlid, quan s'ha esborrat el seu projecte, quan la persona propietària d'un feed personal ja no és membre de l'empresa o quan l'empresa ja no té el mòdul tasks.

Què inclou el feed

Només apareixen les tasques amb data d'inici o de venciment.

Un feed de projecte inclou les tasques del projecte i, si filtra per etiquetes, només les que en porten alguna, comparant amb les etiquetes que té ara la tasca. Reanomenar una etiqueta conserva el filtre; si s'esborren totes les etiquetes del filtre, el feed queda buit i mai no s'amplia a tot el projecte.
Un feed personal inclou les tasques assignades a la seva persona propietària en qualsevol projecte de l'empresa, i només d'aquesta empresa: qui pertany a diverses empreses rep un feed diferent per a cadascuna.
S'inclouen les tasques del backlog (planned) i les actives. Es deixen fora les tasques arxivades i les completades fa més de 30 dies, comptant els dies a la zona horària del feed.

Cada tasca és un esdeveniment de dia complet. La data de fi d'un esdeveniment de dia complet d'iCal és exclusiva, mentre que la data de venciment és inclusiva, així que l'esdeveniment acaba l'endemà:

La tasca té	`DTSTART`	`DTEND`
Només venciment, 2026-10-15	`20261015`	`20261016`
Inici 2026-10-13 i venciment 2026-10-15	`20261013`	`20261016`
Només inici, 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

L'UID d'un esdeveniment és l'id de la tasca més @factuarea, així que es manté igual cada cop que se serveix el feed i el teu calendari actualitza l'esdeveniment en lloc de duplicar-lo. Els esdeveniments són transparents: no et marquen com a ocupat. La DESCRIPTION apareix només quan la tasca en té, com a text pla (les mencions passen a ser el nom de la persona, i les etiquetes internes de l'editor i l'HTML s'eliminen), i els títols i descripcions llargs es tallen a 1024 i 4096 caràcters.

Privacitat

Un feed només llegeix les tasques de l'empresa a la qual pertany. Un feed personal mai no mostra tasques de les teves altres empreses.
Els esdeveniments porten el títol, les dates i la descripció en text pla de cada tasca. No porten persona assignada, etiquetes, estat, comentaris, adjunts ni enllaç de tornada a la tasca.
La resposta s'envia amb Cache-Control: private, no-store, i cada accés actualitza l'últim accés del feed, que l'app mostra al costat.
Si la URL es filtra, rota el feed. Si ja no el necessites, revoca'l.

Propers passos

Projectes i tasques

projectes, tauler, tasques, etiquetes i dates.

Temps imputat a tasques

entrades manuals, el temporitzador i esborranys de factura a partir de les hores facturables.

Agenda

les mateixes dates a través de l'API, juntament amb venciments de documents, terminis fiscals i absències.