buscar_semantico(texto: str, limite: int = 5) | Busca por SIGNIFICADO (no solo palabra exacta) en notas/tareas/ |
listar_notas(desde: str | None = None, hasta: str | None = None, texto: str | None = None) | Lista notas del log de actividad (fechas 'YYYY-MM-DD', `texto` filtra por coincidencia parcial). |
crear_nota(texto: str, categoria: str | int | None = None) | Crea una nota rápida con el timestamp actual. `categoria` puede ser el nombre o el id del menú. |
editar_nota(nota_id: int, texto: str) | Edita el texto de una nota existente. |
listar_tareas(estado: str | None = None, prioridad: str | None = None, categoria: str | None = None, texto: str | None = None, desde: str | None = None, hasta: str | None = None) | Lista tareas (estilo Outlook). `desde`/`hasta` filtran por fecha de vencimiento (YYYY-MM-DD). |
crear_tarea(asunto: str, prioridad: str = 'normal', fecha_inicio: str | None = None, fecha_vencimiento: str | None = None, categoria: str | None = None, menu: str | int | None = None, cuerpo: str | None = None) | Crea una tarea (estilo Outlook). `prioridad`: baja/normal/alta. |
editar_tarea(tarea_id: int, asunto: str | None = None, cuerpo: str | None = None, estado: str | None = None, prioridad: str | None = None, fecha_inicio: str | None = None, fecha_vencimiento: str | None = None, categoria: str | None = None, menu: str | int | None = None) | Edita los campos indicados de una tarea existente (solo se tocan los |
completar_tarea(tarea_id: int) | Marca una tarea como completada (100%, fecha de finalización = ahora). |
consultar_calendario(desde: str, hasta: str) | Tareas con vencimiento entre `desde` y `hasta` (YYYY-MM-DD, inclusive) — para vistas tipo calendario. |
conectar_cuenta_correo(nombre: str, protocolo: str, host: str, puerto: int, usuario: str, contrasena: str, usa_tls: bool = True, smtp_host: str | None = None, smtp_puerto: int | None = None, smtp_tls: bool = True) | Conecta una cuenta de correo IMAP o POP3 nueva (protocolo: "imap" o |
listar_cuentas_correo() | Lista las cuentas de correo configuradas (sin la contraseña, que vive en keyring). |
sincronizar_correo(cuenta_id: int) | Descarga los mensajes nuevos. En IMAP, de TODAS las carpetas de la |
listar_carpetas_correo(cuenta_id: int) | Carpetas de una cuenta (ej. "INBOX", "[Gmail]/Sent Mail"...). Las |
listar_bandeja_entrada(cuenta_id: int, carpeta: str = 'INBOX', solo_no_leidos: bool = False, texto: str | None = None, limite: int = 20) | Lista mensajes ya descargados de una carpeta de una cuenta (usa |
leer_correo(mensaje_id: int) | Devuelve un mensaje completo (asunto, remitente, destinatarios, Cc, |
marcar_leido_correo(mensaje_id: int, leido: bool = True) | Marca un mensaje como leído (o no leído, con leido=False). |
eliminar_correo(mensaje_id: int) | Borra un mensaje de la caché local (no del servidor). Si sigue en el |
listar_categorias_correo() | Categorías de color propias de Guilda Work para clasificar correos |
crear_categoria_correo(nombre: str, color: str) | Crea una categoría de correo. `color` en formato hexadecimal, ej. "#e0555a". |
eliminar_categoria_correo(categoria_id: int) | Elimina una categoría. Los mensajes que la tuvieran asignada quedan sin categoría. |
asignar_categoria_correo(mensaje_id: int, categoria_id: int | None = None) | Asigna una categoría a un mensaje, o la quita si `categoria_id` es None. |
obtener_firma_correo(cuenta_id: int) | Firma HTML configurada para una cuenta y cuándo se aplica (en nuevos |
configurar_firma_correo(cuenta_id: int, firma_html: str, en_nuevos: bool = True, en_respuestas: bool = True) | Guarda la firma HTML de una cuenta y cuándo debe aplicarse. |
preparar_borrador_correo(cuenta_id: int, destinatarios: str, asunto: str, cuerpo_html: str, cc: str = '', bcc: str = '', en_respuesta_a: str | None = None) | Prepara un borrador de correo para revisar antes de enviarlo. NO envía nada. |
enviar_borrador_correo(borrador_id: str) | Envía de verdad el borrador preparado con preparar_borrador_correo. |
exportar_historial(formato: str = 'json', desde: str | None = None, hasta: str | None = None, categoria: str | None = None) | Exporta notas y tareas con duración. `formato`: json, csv o md. |
importar_historial(contenido: str, formato: str = 'json') | Importa notas y tareas con duración desde un JSON o CSV (mismo formato que exportar_historial). |
exportar_tareas(formato: str = 'ics', desde: str | None = None, hasta: str | None = None) | Exporta tareas estilo Outlook a .ics o .csv, compatibles con Microsoft Outlook. |
importar_tareas(contenido: str, formato: str = 'ics') | Importa tareas desde un archivo .ics o .csv exportado de Outlook (o de Guilda Work). |
webhooks_listar(tenant: str | None = None) | Lista los webhooks configurados (de un tenant, o de ámbito local |
webhooks_crear(url: str, eventos_suscritos: list[str], tenant: str | None = None) | Da de alta un webhook — `eventos_suscritos` de entre |
webhooks_borrar(webhook_id: int) | Borra un webhook (y su historial de entregas) por id. |
leer_adjunto_chat(adjunto_id: int) | Devuelve el texto de un adjunto que el usuario subió al chat del |
listar_tiquets(estado: str | None = None, tipo: str | None = None) | Lista tiquets de soporte (errores/sugerencias sobre Guilda Work). |
crear_tiquet(tipo: str, titulo: str, descripcion: str | None = None) | Crea un tiquet nuevo (tipo: "error" o "sugerencia"), a nombre del |
editar_tiquet(tiquet_id: int, titulo: str | None = None, descripcion: str | None = None, tipo: str | None = None) | Edita un tiquet propio, solo mientras siga "sin_revisar" (una vez |
eliminar_tiquet(tiquet_id: int) | Elimina un tiquet propio, o cualquiera si eres administrador. |
cambiar_estado_tiquet(tiquet_id: int, estado: str) | Mueve un tiquet a otro estado del Kanban (sin_revisar/en_revision/ |
listar_clientes_fiscales(q: str | None = None) | Lista los clientes fiscales de la gestoría del usuario actual. |
crear_cliente_fiscal(nombre: str, nif: str | None = None, notas: str | None = None, modelos_fiscales: list[str] | None = None) | Da de alta un cliente fiscal. `modelos_fiscales` son los códigos de |
listar_vencimientos_fiscales(estado: str | None = None, cliente_id: int | None = None, desde: str | None = None, hasta: str | None = None) | Vencimientos fiscales de la gestoría (modelos 303/390/130/111/115/200). |
generar_vencimientos_fiscales(cliente_id: int, modelos: list[str], anio: int) | Genera e inserta directamente los vencimientos de `cliente_id` para |
marcar_presentado_vencimiento_fiscal(vencimiento_id: int) | Marca un vencimiento fiscal como presentado. |
editar_vencimiento_fiscal(vencimiento_id: int, modelo: str | None = None, periodo: str | None = None, fecha_limite: str | None = None, estado: str | None = None, notas: str | None = None) | Edita los campos indicados (los que se omitan no cambian) de un |
resumen_cliente_fiscal(cliente_id: int) | Resumen agregado de un cliente fiscal: sus vencimientos (con |
listar_plantillas_correo() | Plantillas de respuesta guardadas del usuario actual (ver Correo > |
crear_tarea_recurrente(asunto: str, periodicidad: str, dia: int, categoria_id: int | None = None) | Crea una regla de tarea recurrente (semanal o mensual) que genera |
listar_tareas_recurrentes() | Lista las reglas de tarea recurrente del usuario actual, activas o pausadas. |
listar_facturas_cliente(cliente_id: int, limite: int = 20) | Últimas facturas de FacturaScripts de un cliente fiscal ya vinculado |
crear_factura_cliente(cliente_id: int, concepto: str, importe: float) | Crea una factura de una sola línea en FacturaScripts para un cliente |
fichar(tipo: str) | Marca un fichaje del usuario actual: tipo = "entrada" | "pausa_inicio" |
listar_mis_fichajes(desde: str | None = None, hasta: str | None = None) | Historial de fichajes del usuario actual, opcionalmente filtrado |
listar_papelera() | Lista lo que hay en la papelera del usuario actual (menús, tareas, |
restaurar_de_papelera(origen: str, id: int) | Restaura un elemento de la papelera (lo saca de ahí, vuelve a estar |
estadisticas_por_categoria(desde: str | None = None, hasta: str | None = None) | Tiempo dedicado a tareas con duración ya finalizadas, agrupado por |
estadisticas_por_dia(desde: str | None = None, hasta: str | None = None) | Igual que estadisticas_por_categoria pero agrupado por día (y menú |
backoffice_listar_tenants() | Lista todos los tenants con su número de usuarios asignados. Solo administradores. |
backoffice_listar_usuarios() | Lista todos los usuarios de la plataforma, con su tenant y rol. Solo administradores. |
backoffice_crear_tenant(nombre: str) | Crea un tenant nuevo (sin aprovisionar ningún servicio externo |
backoffice_renombrar_tenant(tenant_id: int, nombre: str) | Renombra un tenant existente. Solo administradores. |
backoffice_guardar_datos_tenant(tenant_id: int, cif: str | None = None, direccion_fiscal: str | None = None) | Guarda el CIF/dirección fiscal de un tenant (identificación de |
backoffice_alternar_herramienta_tenant(tenant_id: int, herramienta_id: str, visible: bool) | Muestra u oculta una herramienta del catálogo para un tenant |
backoffice_crear_usuario(email: str, tenant_id: int | None = None) | Da de alta un usuario nuevo en Guilda Work (vía Kratos) y, si se |
backoffice_asignar_tenant_usuario(usuario_id: int, tenant_id: int | None = None) | Asigna (o quita, con tenant_id=None) el tenant de un usuario. Solo administradores. |
backoffice_cambiar_rol(usuario_id: int, rol: str) | Cambia el rol de un usuario a 'admin' o 'usuario'. No se puede |
backoffice_asignar_gestor_fichajes(usuario_id: int, valor: bool) | Marca o desmarca a un usuario como gestor de fichajes de su propio |
