Entorno de PRE: solo datos de prueba. Los correos solo llegan al equipo y los cobros son de prueba.
Guilda WorkDevelopers

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

TipoCambio
NuevoPOST /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.
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.11 — 2026-10-27

TipoCambio
NuevoPOST /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].
MejoraLos 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.
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.10 — 2026-10-27

TipoCambio
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.
MejoraGET /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).
CompatibilidadNingún campo ni ruta existente cambia.

1.9 — 2026-10-27

TipoCambio
NuevoNotas compartidas: GET /notas/{id}/participantes, POST /notas/{id}/compartir (usuario_id, rol) y DELETE /notas/{id}/compartir/{usuario_id}.
MejoraNotas: 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.
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.8 — 2026-10-27

TipoCambio
NuevoPOST /notificaciones/{id}/leida: marca como leída una sola notificación.
MejoraGET /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.
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.7 — 2026-10-26

TipoCambio
MejoraGET /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).
NuevoGET /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.
MejoraGET /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).
NuevoGET /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).
NuevoGET /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).
NuevoPUT /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).
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.6 — 2026-10-26

TipoCambio
NuevoGET /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.
NuevoPOST /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.
NuevoGET /tareas-outlook/categorias-outlook: las categorías (estilo Outlook) que usan tus tareas, para el filtro categoria.
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.5 — 2026-10-24

TipoCambio
NuevoGET /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.
Nuevo426 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.
NuevoGET /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.
MejoraGET /tareas-outlook incluye vencida en cada fila (derivada de la fecha y el estado, igual que en el detalle).
NuevoGET /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).
MejoraLos 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.
MejoraEl contrato describe con exactitud GET /ia/conversaciones ({activa, conversaciones}) y admite id: null en los atajos de serie de GET /ia/atajos.
NuevoGET /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.
NuevoGET /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).
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.4 — 2026-10-11

TipoCambio
NuevoGET /health: comprobación de vida pública (sin token) para monitores externos; 200 si responde la base de datos, 503 si no.
NuevoRestricciones 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.
NuevoLí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.
MejoraOpenAPI 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».
CompatibilidadTodo aditivo: ningún campo ni ruta existente cambia.

1.3 — 2026-10-10

TipoCambio
NuevoErrores con codigo estable y request_id (cabecera X-Request-Id).
NuevoLímite de 600 peticiones por minuto y persona, Idempotency-Key en POST, ETag/304 en lecturas y ?campos= para devolver solo algunos campos.
NuevoGET /sync incremental con cursor, X-Total-Count y limit/offset uniformes.
NuevoTokens 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).
Nuevoreferencia_externa en notas, tareas y clientes fiscales, con alta o actualización por PUT .../por-referencia/{ref}.
NuevoWebhooks con cola persistente, reintentos (6) y firma X-Guilda-Signature-V2 con marca de tiempo; eventos cliente.creado y correo.sin_respuesta.
NuevoParidad 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

TipoCambio
NuevoTokens 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

TipoCambio
NuevoEventos de negocio reales para webhooks y automatizaciones.

Antes de la cabecera de versión — 2026-08-15

TipoCambio
NuevoAPI del calendario fiscal para la app móvil.

Antes de la cabecera de versión — 2026-08-04

TipoCambio
NuevoDocumento OpenAPI (/api/v1/openapi.json), explorador de la API y búsqueda semántica.

Antes de la cabecera de versión — 2026-07-16

TipoCambio
NuevoPrimera API REST con tokens por dispositivo para la app móvil.