Documentación de la API

Workflow WF16. Valida credenciales contra la tabla usuarios y, si son correctas, emite el token de sesión firmado (HMAC) que el resto de la API exige.

Body

{ "username": "consultor@yurest.com", "password": "..." }

Respuesta 200 (éxito)

{
  "success": true,
  "user": {
    "id": "uuid",
    "username": "consultor@yurest.com",
    "nombre": "Ana García",
    "email": "consultor@yurest.com",
    "rol": "admin | user",
    "token": "<userId>|<exp>.<hmac>",
    "permisos": { "read": [...], "write": [...], "delete": [...] }
  }
}

Verifica que la sesión sigue viva (chequeo periódico del portal). Un 401/403 fuerza logout.

Gestión de usuarios y roles (Administración → admin.html). auth/usuarios lista/crea/edita/borra usuarios y sus permisos; auth/roles gestiona los roles base. Acciones vía action en el body. El rol se calcula como base + deltas granulares { read, write, delete }.

Workflow 04-fichas-alta. Devuelve la lista completa de fichas (con su cs_estado del Kanban CS). Alias en config.js: ENDPOINTS.login · ENDPOINTS.altas.

Respuesta 200

{
  "clientes": [
    {
      "id": "uuid",
      "denominacion": "Test SL",
      "cif": "B40597437",
      "email": "contacto@test.es",
      "tipo_cliente": "lite | planes | corporate",
      "estado": "rellenado | completada",
      "cs_estado": "en_implementacion | post_primer_mes | ...",
      "grabado_a3": false,
      "grabado_a3_at": null,
      "introducido_yurest": false,
      "promocion_id": null,
      "fecha_solicitud": "2026-04-17T...",
      "fecha_rellenado": "2026-04-17T...",
      "fecha_completado": "2026-04-17T...",
      "sepa_mandato": { ... },
      "adjuntos": [ ... ],
      "paquetes_carrito": { ... },
      "deleted_at": null
      // ... resto de columnas
    }
  ]
}

El workflow excluye filas con deleted_at != NULL. Devuelve todas las columnas, incluidas las vacías como "".

Workflow 04-fichas-alta. Crea una ficha nueva (sin id) o actualiza una existente (con id). En modo edición solo actualiza los campos enviados — no destruye los demás.

Body (todos opcionales en edición)

Respuesta 200 (éxito)

{ "id": "uuid-de-la-ficha", "success": true }

Respuesta 200 (error en INSERT Locales)

{ "error": "..." }

El nodo INSERT Locales tiene continueOnFail: true, así que un fallo en locales no rompe el INSERT/UPDATE de la ficha principal pero sí aparece en el body.

Workflow 12-completar-ficha. Devuelve los datos de una ficha o solicitud para precargar el formulario. Acepta tres formas de identificación.

Query params

Respuesta 200 (encontrado)

{
  "found": true,
  "id": "uuid",
  "ID Solicitud": 5,
  "Nombre Sociedad": "Test SL",
  "Email": "contacto@test.es",
  "Tipo Cliente": "planes",
  "SEPA": { "iban": "ES...", "deudor": {...}, "firma_base64": "..." },
  // ... resto de campos
}

Respuesta 200 (no encontrado)

{ "found": false, "error": "Solicitud no encontrada" }

Workflow 10-eliminar. Soft-delete (UPDATE deleted_at = NOW()) en fichas_alta y solicitudes. Como los UUIDs son únicos entre tablas, sólo afecta a la que contiene el ID.

Body

{
  "action": "delete",
  "entity": "ficha" | "solicitud",
  "id": "uuid",
  "row_number": "uuid"   // alias por compat
}

Respuesta 200

{
  "success": true,
  "entity": "ficha",
  "id": "uuid",
  "ficha_count": 1,
  "sol_count": 0,
  "errores": []
}

Acciones puntuales sobre una ficha ya creada (no re-guardan la ficha entera). Todas reciben { ficha_id } y devuelven { ok, ... }.

Modal «Ver cliente» (clientes.html): notas internas, movimiento en el Kanban CS y asignación de promoción.

Workflow 08-solicitudes. Inserta solicitud en estado pendiente y envía email al cliente con la URL del formulario.

Body

{
  "ID Solicitud": 5,
  "access_token": "32-chars-uuid-sin-guiones",
  "Nombre Sociedad": "Empresa SL",
  "Nombre": "Ana García",
  "Email": "ana@empresa.com",
  "Consultor": "Pedro Martin",
  "Tipo Cliente": "planes",
  "Fecha": "2026-04-17",
  "Estado": "Pendiente",
  "email_to": "ana@empresa.com",
  "email_subject": "Solicitud de creación de ficha de alta",
  "email_body": "Hola Ana, te mando este formulario...",
  "form_url": "https://.../solicitud.html?t=..."
}

Si access_token no viene, el workflow lo genera con crypto.randomUUID().

Respuesta 200

{ "id": "uuid", "success": true }

Listados y utilidades del flujo de solicitudes.

Workflow 11-auxiliares. El cliente envía sus datos desde solicitud.html. Crea la ficha, carpeta Drive, marca solicitud completada y dispara emails + tarea Asana si TPV no integrado.

Body (todos los datos del formulario)

{
  "ID Solicitud": 5,
  "access_token": "...",
  "Estado": "Rellenado cliente",
  "Nombre Sociedad": "...", "CIF/NIF": "...",
  "JP Nombre": "...", "Firmante DNI": "...",
  "TPV": "Revo",
  "TPV No Integrado": "Sí",  // si checkbox marcado
  "TPV NI Nombre": "...", "TPV NI Contacto": "...", "TPV NI Email": "...",
  "SEPA": {
    "iban": "ES91...",
    "swift": "CAIXESBB",
    "deudor": { "nombre": "...", "direccion": "...", ... },
    "tipo_pago": "recurrente",
    "firma_base64": "data:image/png;base64,...",
    "firmado_at": "2026-04-17T..."
  }
}

Efectos

• INSERT en fichas_alta con estado=completada + SEPA persistido.
• Crea carpeta en Google Drive y guarda carpeta_drive en la ficha.
• Email al cliente con enlace al Drive.
• Email al consultor avisando.
• UPDATE solicitudes: estado=completado + ficha_id (dispara trigger que copia fecha_solicitud).
• Si TPV no integrado: tarea en Asana (proyecto Integraciones 1207920061546505) + email a soporte/a.jareno/luis.

Respuesta 200

{ "success": true }

Workflow 30-ofertas. Ofertas generadas por el configurador (departamento Consultor). GET lista con filtros; ?id=<uuid> devuelve una sola.

POST — action

Workflow 55-pasarela (Redsys/BBVA). El cliente, desde la oferta pública, pulsa «Pagar».

POST /pago/iniciar

// Request
{ "token": "<token-oferta>" }

// Respuesta — el front auto-submitea un form a Redsys
{
  "ok": true,
  "redirect": {
    "url": "https://sis.redsys.es/...",
    "Ds_SignatureVersion": "HMAC_SHA256_V1",
    "Ds_MerchantParameters": "<base64>",
    "Ds_Signature": "<firma>"
  }
}

El importe es final_amount × 1,21 (IVA). La firma Redsys (HMAC_SHA256_V1, 3DES en JS puro) y el inserto en payments se hacen server-side. La notificación S2S y las páginas OK/KO las sirve el propio workflow. /pago/enviar-ficha-link reenvía al email del cliente el enlace de su solicitud («Continuar más tarde»).

Ampliaciones contractuales sobre clientes existentes (módulos o locales nuevos). GET lista; POST crea uno en estado pendiente. La aplicación real sobre fichas/locales/SEPA la hace un workflow al confirmar el escalado.

Workflow 13-grabado-a3. Toggle del flag grabado_a3 en una ficha. Trigger SQL setea grabado_a3_at al pasar de FALSE a TRUE.

Body

{ "id": "uuid", "grabado_a3": true | false }

Respuesta 200

{
  "success": true,
  "id": "uuid",
  "grabado_a3": true,
  "affected": 1,
  "errores": []
}

Workflow 39. Lectura de Azure SQL (yurestazure / Info_PowerBI). La página pinta una tabla genérica con auto-detección de columnas; la query se ajusta en n8n (la página no envía SQL).

Respuesta 200

{ "ok": true, "total": 120, "columnas": [...], "rows": [...], "generated_at": "ISO" }

Workflow 01-proyectos-crud. CRUD de proyectos de implementación.

El POST/PUT acepta asanaProjectId y asanaProjectUrl para vincular un tablero Asana.

Workflow 02-proyectos-tareas. Actualiza una tarea/sección dentro de un proyecto (toggle completada, edición, etc.).

Body

{
  "proyectoId": "uuid",
  "seccionNombre": "Puesta en Marcha / Finalización",
  "tarea": { "id": "...", "completada": true, ... }
}

Respuesta 200

{ "success": true }

Mover una tarea entre secciones (drag & drop kanban) o eliminarla.

Body — mover

{ "proyectoId": "uuid", "tareaId": "...", "seccionOrigen": "...", "seccionDestino": "..." }

Hilo cliente ↔ staff e historial del proyecto (WF01).

Proxy e importadores de Asana (las credenciales viven solo en n8n).

Tandas de implementación (Customer Success): 16 plazas (8 mañana + 8 tarde). Doble proyecto Asana por promoción.

Workflow 07-calendar-asana. Google Calendar del implementador.

Panel de sesiones de implementación (WF52).

Desarrollos a medida por cliente (reemplaza el Excel de Producto).

Workflow WF66. Horas contratadas vs consumidas por cliente. Las contratadas se registran como compras (cantidad + PDF pago + PDF factura); las consumidas se derivan de los presupuestos aceptados/pagados.

Workflow WF57. Lee en vivo el proyecto Asana «Sugerencias optimizaciones clientes» (tareas + secciones + etiquetas + campos, normalizado y paginado).

Base de conocimiento de sprints (gpt-4o). Se pega la URL de un proyecto Asana, se elige un campo enum y sus valores, y se genera un documento markdown de las funcionalidades del sprint.

Workflow WF73. Newsletter de sprint (/updates). Analiza un proyecto Asana, reescribe títulos con IA y arma el email.

Integración HighLevel (CRM). Credenciales (LOCATION_ID + TOKEN) solo en n8n.

Workflow WF76. Clientes Free 3 meses. GET lista clientes_free_3m; /toggle persiste Free(0)/Lite(1); /refresh re-sincroniza contra HighLevel sin esperar al cron de las 6.

Resumen del día para el dashboard del home. GET sin parámetros → { fecha, ofertas, fichas, bajas, escalados } (contadores incrementales de home_kpis_diarios, mantenidos por triggers AFTER INSERT).

Asociación cliente ↔ organización Zendesk (modal «Ver cliente» → Tickets) y registro de errores.

Snapshots diarios (06:00) + refresco manual. Cruce Zendesk × Asana.

Pestaña Formación · proyecto Asana asociado al cliente.

Mini-app «Churn técnico» (iframe). Webhooks autenticados por el Auth Gate HMAC: churnClientes, churnResumenGenerar, churnNiveles, churnResumenBuscar, churnTickets.

Notificaciones automáticas de Integraciones: configuración, grupos de destinatarios e historial de envíos.

Uso del producto Yurest cacheado en Supabase (prod_clientes_snapshot) para evitar la query pesada al MySQL de producción en cada apertura.

Workflow WF91. «Mis contraseñas»: gestor de credenciales de portales externos. El servidor resuelve userId y rol del token; un no-admin solo ve/edita las suyas, el admin todas.

Workflow WF92. «Mi equipo»: inventario por persona. Jerarquía tipo(sección) → catálogo(modelo, coste solo-admin) → unidad(física asignada a un usuario).

Audit log.

Workflow 05-bajas. Gestión de bajas de clientes (registro, edición de campos individuales y borrado).

Workflow 06-distribucion. Asigna un implementador a una ficha.

Body

{ "fichaId": "uuid", "implementador": "Carlos Aparicio" }

Workflow WF78. Distribuidores potenciales: cuando el consultor rellena el TPV de un local y su email de contacto, el workflow saca el dominio y, si no consta como distribuidor conocido, avisa a Pedro Martín y registra la fila.

Workflow 11-auxiliares. getDrive devuelve la URL de la carpeta Drive de una ficha; docsSubidos consulta si hay documentos subidos.

Query

?id=<ficha_uuid>