INTEGRACIÓN
Registro de cambios
Qué ha cambiado en la API en cada versión (cabecera X-API-Version).
La cabecera X-API-Version lleva mayor.menor: el menor sube con cada ampliación compatible (campos y rutas nuevos, siempre opcionales) y el mayor solo si algo se rompe. Programa contra codigo en los errores, no contra su texto. Versión actual: 1.12.
1.12 — 2026-11-17
| Tipo | Cambio |
| Nuevo | POST /ia/valoraciones: valora la última respuesta del asistente (util: verdadero o falso y, si no sirvió, motivo: dato_incorrecto, no_entendio, incompleta u otra). Solo se guarda el sí o el no y el motivo, nunca el texto. |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.11 — 2026-10-27
| Tipo | Cambio |
| Nuevo | POST /ia/adjuntos: sube un archivo de texto o CSV (UTF-8, hasta 1 MB) para que el asistente lo lea; el mensaje empieza por [Adjunto #id: nombre]. |
| Mejora | Los mensajes del asistente (GET /ia/mensajes y el flujo en directo) traen fuentes_json: las tareas, notas, correos y clientes de donde salen sus datos. |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.10 — 2026-10-27
| Tipo | Cambio |
| Nuevo | /papelera/tarea_outlook/{id}/restaurar y .../eliminar-definitivamente: las tareas de la lista también se recuperan o se eliminan para siempre desde la papelera. |
| Mejora | GET /papelera trae el título de las notas que lo tienen y describe todos sus campos. Restaurar o eliminar para siempre solo actúa sobre lo que está en tu papelera (404 si no). |
| Compatibilidad | Ningún campo ni ruta existente cambia. |
1.9 — 2026-10-27
| Tipo | Cambio |
| Nuevo | Notas compartidas: GET /notas/{id}/participantes, POST /notas/{id}/compartir (usuario_id, rol) y DELETE /notas/{id}/compartir/{usuario_id}. |
| Mejora | Notas: GET /notas?compartidas=incluir|solo y rol, n_participantes y n_adjuntos en cada una; GET /notas/{id} también para quien la tiene compartida, con participantes y los asuntos vinculados; POST/PUT /notas aceptan titulo, fijada y cliente_fiscal_id, y un colaborador puede editar texto y título. |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.8 — 2026-10-27
| Tipo | Cambio |
| Nuevo | POST /notificaciones/{id}/leida: marca como leída una sola notificación. |
| Mejora | GET /buscar: filtro tipo, hasta 40 resultados y los campos titulo, fragmento y fecha; sin el servicio de vectores busca por palabra clave en vez de no devolver nada. |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.7 — 2026-10-26
| Tipo | Cambio |
| Mejora | GET /mi-dia y GET /tareas-outlook/tablero traen en cada tarea los mismos indicadores que la lista (vencida, n_comentarios, checklist_hechas, checklist_total, bloqueos, rol, asignada_nombre, creador_nombre). /mi-dia documenta sus cinco secciones (vencidas, hoy, en_progreso, asignadas, compartidas). |
| Nuevo | GET /tareas-outlook/tablero?recientes=15: de las completadas, solo las N más recientes, como el tablero de la web. Sin el parámetro, todo como siempre. |
| Mejora | GET /tareas-outlook/carga devuelve los dias como fechas YYYY-MM-DD (antes salían con el formato de fecha HTTP, «Mon, 26 Oct 2026 00:00:00 GMT», que ningún cliente esperaba). |
| Nuevo | GET /tareas-outlook/calendario?vista=mes|semana|semana_laboral|dia&fecha=: el calendario unificado de la web (tareas, vencimientos fiscales, citas y horas fichadas, día a día). |
| Nuevo | GET /tareas-outlook/{id}/tiempo trae además mio_segundos, equipo_segundos, ahora (hora del servidor) y cronometro (el tuyo, en marcha o en pausa sobre la tarea, o null). |
| Nuevo | PUT /tareas-outlook/{id} admite estimacion (texto como en la web: «1h30», «45 min», «2» = horas; vacío la quita) y el servidor lo interpreta (400 estimacion_invalida). |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.6 — 2026-10-26
| Tipo | Cambio |
| Nuevo | GET /tareas-outlook admite completadas (0 oculta las completadas salvo que se pida un estado, 1 las incluye; sin él, todo como siempre) y trae en cada fila n_comentarios, checklist_hechas, checklist_total y bloqueos, para pintar la lista como la web sin más llamadas. |
| Nuevo | POST /tareas-outlook admite texto_libre (el asunto se interpreta como en el cuadro de alta de la web: «viernes 10h pedir extractos @luis !alta #IVA»; la respuesta trae sin_resolver con lo que no se pudo entender) y los campos explícitos categoria_id (proyecto), asignada_a y cliente_fiscal_id. |
| Nuevo | GET /tareas-outlook/categorias-outlook: las categorías (estilo Outlook) que usan tus tareas, para el filtro categoria. |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.5 — 2026-10-24
| Tipo | Cambio |
| Nuevo | GET /auth/me amplía su respuesta para la app móvil: despachos (los de la persona, con el principal y lo que es en cada uno), despacho_activo, modulos (qué módulos de negocio tiene activos el despacho), permisos, cifrado, apariencia y app (versión mínima y recomendada, enlace de la tienda). La cabecera X-Despacho ya elegía el despacho; ahora la app puede listarlos. |
| Nuevo | 426 actualiza_app: una app que manda X-App-Version menor que la mínima admitida recibe este error, con version_minima y url_tienda. Quien no manda la cabecera (web, integraciones, MCP) no se ve afectado. |
| Nuevo | GET /perfil incluye apariencia (tema, densidad, idioma) y PUT /perfil los acepta: el tema y el idioma de la cuenta son los mismos en la web y en la app. |
| Mejora | GET /tareas-outlook incluye vencida en cada fila (derivada de la fecha y el estado, igual que en el detalle). |
| Nuevo | GET /buscar devuelve en cada resultado su destino ({tipo, id}), no incluye los vectores internos, y su id se documenta como lo que es: «tipo-N» (tarea-12). |
| Mejora | Los 412 version_obsoleta de clientes fiscales y vencimientos incluyen version_actual (como ya hacían los 409 de las tareas), para ofrecer «ver cambios / sobrescribir» sin otra petición. |
| Mejora | El contrato describe con exactitud GET /ia/conversaciones ({activa, conversaciones}) y admite id: null en los atajos de serie de GET /ia/atajos. |
| Nuevo | GET /hoy: la bandeja única de lo que necesita tu atención (tareas, correo, plazos, vencimientos, visitas, traspasos, ausencias, facturas, certificados...) del despacho activo, por urgencia, en una sola llamada. Cada elemento lleva destino ({tipo, id}) y las acciones posibles; los módulos no activos no aparecen. |
| Nuevo | GET /notificaciones devuelve en cada aviso su destino ({tipo, id}) y canal, y admite los filtros tipo, desde y no_leidas. Los push llevan el mismo contrato: data.destino (JSON), destino_tipo, destino_id, despacho_id, notificacion_id y canal (canal de Android por familia de aviso). |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.4 — 2026-10-11
| Tipo | Cambio |
| Nuevo | GET /health: comprobación de vida pública (sin token) para monitores externos; 200 si responde la base de datos, 503 si no. |
| Nuevo | Restricciones de red por token: ips_permitidas (IP o redes CIDR; 403 ip_no_permitida desde otra dirección) y origenes_cors (orígenes web exactos que pueden usar el token desde un navegador). Un token con IPs no sirve por MCP. |
| Nuevo | Límites por tipo de petición: además de 600/min en total, 200 escrituras y 20 operaciones pesadas (IA, exportaciones, importaciones, sincronizar un buzón, enviar correo) por minuto. Cabecera X-RateLimit-Scope y campo cupo en el 429. |
| Mejora | OpenAPI completo (cuerpos, parámetros, respuestas, errores y ejemplos) con clientes de Python y TypeScript y colección de Postman generados de él, y explorador interactivo con «Probar». |
| Compatibilidad | Todo aditivo: ningún campo ni ruta existente cambia. |
1.3 — 2026-10-10
| Tipo | Cambio |
| Nuevo | Errores con codigo estable y request_id (cabecera X-Request-Id). |
| Nuevo | Límite de 600 peticiones por minuto y persona, Idempotency-Key en POST, ETag/304 en lecturas y ?campos= para devolver solo algunos campos. |
| Nuevo | GET /sync incremental con cursor, X-Total-Count y limit/offset uniformes. |
| Nuevo | Tokens con permisos (completo o solo lectura), áreas (notas, tareas, correo, fiscal, fichaje, tiquets, ia, avisos, webhooks), caducidad y registro de uso (GET /tokens/{id}/uso). |
| Nuevo | referencia_externa en notas, tareas y clientes fiscales, con alta o actualización por PUT .../por-referencia/{ref}. |
| Nuevo | Webhooks con cola persistente, reintentos (6) y firma X-Guilda-Signature-V2 con marca de tiempo; eventos cliente.creado y correo.sin_respuesta. |
| Nuevo | Paridad con la web y el MCP: tareas completas (estado con dependencias, comentarios, recordatorios, compartir, lotes, plantillas, recurrentes), calendario fiscal completo, adjuntos de notas, envío de correo con adjuntos y programado, y administración del fichaje. |
Antes de la cabecera de versión — 2026-10-06
| Tipo | Cambio |
| Nuevo | Tokens de solo lectura, paginación y webhooks salientes por despacho; 22 herramientas más en el MCP. |
Antes de la cabecera de versión — 2026-08-19
| Tipo | Cambio |
| Nuevo | Eventos de negocio reales para webhooks y automatizaciones. |
Antes de la cabecera de versión — 2026-08-15
| Tipo | Cambio |
| Nuevo | API del calendario fiscal para la app móvil. |
Antes de la cabecera de versión — 2026-08-04
| Tipo | Cambio |
| Nuevo | Documento OpenAPI (/api/v1/openapi.json), explorador de la API y búsqueda semántica. |
Antes de la cabecera de versión — 2026-07-16
| Tipo | Cambio |
| Nuevo | Primera API REST con tokens por dispositivo para la app móvil. |