Proyectos y tareas

Factuarea ahora gestiona también el trabajo, no solo las facturas, y todo el módulo de tareas está en el contrato v1: proyectos con un tablero de columnas, tareas vinculadas a tus facturas, presupuestos y contactos, tiempo imputado y facturado, una agenda y los eventos para seguirlo todo. Son 80 endpoints nuevos bajo siete recursos, incluidos en todos los planes. Empieza por la guía de proyectos y tareas.

• Siete recursos — /v1/projects (22 endpoints: proyectos, columnas del tablero, campos personalizados, la exportación e importación de tareas en JSON, el resumen de tiempo y la factura de las horas facturables), /v1/tasks y sus subrecursos (45: búsqueda, posición en el tablero, comentarios, relaciones, etiquetas, vínculos, adjuntos, enlaces de subida, imputaciones de tiempo, el temporizador y el registro de actividad), /v1/task-labels (5), /v1/task-timers (2), /v1/users (2), /v1/notifications (3) y /v1/agenda (1). Todos los endpoints se listan más abajo.
• Nueve scopes nuevos — projects:read|write|delete, tasks:read|write|delete, users:read y notifications:read|write. projects:* y tasks:* pertenecen al módulo tasks: una key con esos scopes para una empresa sin él se rechaza con scope_not_allowed_by_plan. users:read y notifications:* son transversales. Los scopes projects:delete y tasks:delete son solo de API key: un consentimiento OAuth nunca los concede. Nueve operaciones son irreversibles y exigen una Idempotency-Key; consulta Scopes y operaciones irreversibles.
• Borrar una columna con tareas — DELETE /v1/projects/{project}/columns/{column} admite un parámetro de query move_to_column_id: la columna del mismo proyecto que recibe las tareas, en su orden, en la misma transacción. Sin él, una columna con tareas devuelve 409 column_has_tasks.
• Una tarea que nace ya vinculada — POST /v1/tasks acepta un entity_link con el type y el id de una factura, un presupuesto, un contacto o cualquier otra entidad vinculable, y la vincula en la misma transacción. Si la entidad no existe o es de otra empresa, la llamada devuelve 404 linked_entity_not_found y la tarea no se crea.
• tasks_count en las etiquetas de tarea — cada etiqueta del catálogo indica cuántas tareas la llevan, incluidas las archivadas.
• Claves de tarea — DEV-12 se resuelve con POST /v1/tasks/find-by-key, y una clave sigue funcionando después de que la tarea pase a otro proyecto o de que su proyecto cambie de clave.
• El tiempo imputado no es el registro de jornada — un task_time_entry es tiempo dedicado a una tarea, con sus propios scopes tasks:* y eventos task_time_entry.*. Nunca aparece en el registro del control horario (/v1/time-entries). Consulta Tiempo imputado a tareas.
• 21 eventos nuevos — task.* (created, updated, deleted, status_changed, completed, assigned, unassigned, moved, due_soon y overdue), task_comment.*, task_time_entry.* y project.*. Completar una tarea emite task.status_changed y task.completed, y este último es un subconjunto del primero. Consulta Eventos.
• 80 tools MCP nuevas — 22 de proyectos, 52 de tareas, 2 de usuarios, 3 de notificaciones y 1 de la agenda, al compás de la API. El catálogo tiene ahora 552 tools; las de borrado son solo API key. Consulta el catálogo de tools.
• CLI — factuarea projects, tasks, task-labels, task-timers, users, notifications y agenda, con sus scopes y confirmaciones. Consulta la guía del CLI.
• Automatizaciones — los 21 eventos son disparadores nuevos, y cuatro acciones nuevas crean y cambian tareas: create_task, change_task_status, assign_task y add_task_comment. En una regla de cartera (cartera), de ellas solo se admite create_task. Consulta Automatizaciones.
• Códigos de error — 46 códigos nuevos en el grupo Tasks, cada uno con su causa y qué hacer, y 18 en Task Integrations para los flujos que viven en la app. Consulta Códigos de error de Tareas.
• Disponibilidad — el módulo tasks está incluido en todos los planes. Las integraciones de tareas con forjas de código y herramientas de chat, los feeds iCal y el tablero público existen solo en la app; las integraciones necesitan el plan Empresario o Enterprise.