Documentación de la API

Workflow 04-fichas-alta. Devuelve la lista completa de fichas. El portal lo usa también como verificador de sesión en el login.

Aliases en config.js

ENDPOINTS.login · ENDPOINTS.altas

Respuesta 200

{
  "clientes": [
    {
      "id": "uuid",
      "denominacion": "Test SL",
      "cif": "B40597437",
      "email": "contacto@test.es",
      "tipo_cliente": "planes",
      "estado": "rellenado | completada",
      "grabado_a3": false,
      "grabado_a3_at": 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.

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": []
}

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",
  "Comercial": "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 }

Workflow 08-solicitudes. Lista solicitudes que no estén en estado completado (las completadas se mueven a la pestaña "Rellenado cliente").

Respuesta 200

{
  "solicitudes": [
    {
      "id": "uuid",
      "access_token": "...",
      "ID Solicitud": 5,
      "Nombre Sociedad": "...",
      "Email": "...",
      "Estado": "pendiente",
      "Fecha": "2026-04-17T..."
    }
  ]
}

Workflow 09-rellenado-cliente. Lista solicitudes con estado=eq.completada (= clientes que ya rellenaron su parte y esperan que el comercial las complete).

Respuesta 200

{
  "items": [{ "id": "uuid", "Nombre Sociedad": "...", "Email": "...", "Comercial": "..." }]
}

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 comercial 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 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 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 }

Mueve una tarea entre secciones (drag & drop kanban).

Body

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

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 11-auxiliares. getDrive devuelve la URL de la carpeta Drive de una ficha; docsSubidos consulta si hay documentos subidos.

Query

?id=<ficha_uuid>

Workflow 07-calendar-asana. Proxy a la API de Asana para evitar exponer credenciales en el frontend. Devuelve tareas de un proyecto o historias (comentarios) de una tarea.

Crea un evento en Google Calendar (sesiones de implementación).

Body

{ "summary": "...", "start": "ISO", "end": "ISO", "attendees": [...] }