Projectes i tasques

Factuarea ara gestiona també la feina, no només les factures, i tot el mòdul de tasques és al contracte v1: projectes amb un tauler de columnes, tasques vinculades a les teves factures, pressupostos i contactes, temps imputat i facturat, una agenda i els esdeveniments per seguir-ho tot. Són 80 endpoints nous sota set recursos, inclosos en tots els plans. Comença per la guia de projectes i tasques.

• Set recursos — /v1/projects (22 endpoints: projectes, columnes del tauler, camps personalitzats, l'exportació i importació de tasques en JSON, el resum de temps i la factura de les hores facturables), /v1/tasks i els seus subrecursos (45: cerca, posició al tauler, comentaris, relacions, etiquetes, vincles, adjunts, enllaços de pujada, imputacions de temps, el temporitzador i el registre d'activitat), /v1/task-labels (5), /v1/task-timers (2), /v1/users (2), /v1/notifications (3) i /v1/agenda (1). Tots els endpoints es llisten més avall.
• 9 scopes nous — projects:read|write|delete, tasks:read|write|delete, users:read i notifications:read|write. projects:* i tasks:* pertanyen al mòdul tasks: una key amb aquests scopes per a una empresa sense ell es rebutja amb scope_not_allowed_by_plan. users:read i notifications:* són transversals. Els scopes projects:delete i tasks:delete són només d'API key: un consentiment OAuth mai no els concedeix. Hi ha nou operacions irreversibles i totes exigeixen una Idempotency-Key; consulta Scopes i operacions irreversibles.
• Esborrar una columna amb tasques — DELETE /v1/projects/{project}/columns/{column} admet un paràmetre de query move_to_column_id: la columna del mateix projecte que rep les tasques, en el seu ordre, a la mateixa transacció. Sense ell, una columna amb tasques retorna 409 column_has_tasks.
• Una tasca que neix ja vinculada — POST /v1/tasks accepta un entity_link amb el type i l'id d'una factura, un pressupost, un contacte o qualsevol altra entitat vinculable, i la vincula a la mateixa transacció. Si l'entitat no existeix o és d'una altra empresa, la crida retorna 404 linked_entity_not_found i la tasca no es crea.
• tasks_count a les etiquetes de tasca — cada etiqueta del catàleg indica quantes tasques la porten, incloses les arxivades.
• Claus de tasca — DEV-12 es resol amb POST /v1/tasks/find-by-key, i una clau continua funcionant després que la tasca passi a un altre projecte o que el seu projecte canviï de clau.
• El temps imputat no és el registre de jornada — un task_time_entry és temps dedicat a una tasca, amb els seus propis scopes tasks:* i esdeveniments task_time_entry.*. Mai no apareix al registre del control horari (/v1/time-entries). Consulta Temps imputat a tasques.
• 21 esdeveniments nous — task.* (created, updated, deleted, status_changed, completed, assigned, unassigned, moved, due_soon i overdue), task_comment.*, task_time_entry.* i project.*. Completar una tasca emet task.status_changed i task.completed, i aquest últim és un subconjunt del primer. Consulta Esdeveniments.
• 80 tools MCP noves — 22 de projectes, 52 de tasques, 2 d'usuaris, 3 de notificacions i 1 de l'agenda, al ritme de l'API. El catàleg té ara 552 tools; les d'esborrat són només API key. Consulta el catàleg de tools.
• CLI — factuarea projects, tasks, task-labels, task-timers, users, notifications i agenda, amb els seus scopes i confirmacions. Consulta la guia del CLI.
• Automatitzacions — els 21 esdeveniments són activadors nous, i quatre accions noves creen i canvien tasques: create_task, change_task_status, assign_task i add_task_comment. En una regla de cartera (cartera), d'elles només s'admet create_task. Consulta Automatitzacions.
• Codis d'error — 46 codis nous al grup Tasks, cadascun amb la seva causa i què fer, i 18 a Task Integrations per als fluxos que viuen a l'app. Consulta Codis d'error de Tasques.
• Disponibilitat — el mòdul tasks està inclòs en tots els plans. Les integracions de tasques amb forges de codi i eines de xat, els feeds iCal i el tauler públic existeixen només a l'app; les integracions necessiten el pla Empresario o Enterprise.