API

El análisis es un servicio propio con su API. La web es solo uno de sus clientes: todo lo que hace la web se puede hacer desde tu CRM.

Dirección base: https://api.auditalo.es · Autenticación: cabecera x-api-key con una clave creada desde Mi cuenta. Las claves se muestran una sola vez; en el servidor solo queda su huella.

Cómo se cobran las llamadas

Un crédito es una hoja leída. El análisis técnico del fichero recorre todas las hojas sin coste; solo se cobran las que hay que leer. La respuesta incluye creditos_consumidos. Si no hay saldo, la llamada devuelve 402 sin analizar nada y sin cobrar.

GET /v1/salud

Comprueba que el motor responde. No necesita clave.

curl https://api.auditalo.es/v1/salud

{"estado":"ok","forense":true,"lectura_ia":true,"version":"1.0"}

GET /v1/creditos

Saldo de la cuenta.

curl https://api.auditalo.es/v1/creditos \
  -H "x-api-key: adt_live_..."

{"creditos":712,"plan":"profesional","renueva_el":"2026-09-29T..."}

POST /v1/documento

Analiza un documento suelto. Útil para engancharlo al momento en que un comercial adjunta un fichero.

curl -X POST https://api.auditalo.es/v1/documento \
  -H "x-api-key: adt_live_..." \
  -H "content-type: application/json" \
  -d '{
    "tipo_expediente": "luz",
    "referencia": "CONTRATO-88213",
    "comercial": "Juan Pérez",
    "fichero": {
      "nombre": "factura.pdf",
      "mime": "application/pdf",
      "base64": "JVBERi0xLjQK..."
    },
    "declarado": {
      "titular": "CARMEN VILANOVA SEGURA",
      "nif": "46825139Z",
      "cups": "ES0031408259177004JN",
      "iban": "ES0521004185850200051332"
    },
    "sips": { "tarifa": "2.0TD", "potencias_kw": [4.6, 4.6], "consumo_anual_kwh": 3100 }
  }'

declarado y sips son opcionales pero muy recomendables: el cotejo contra lo declarado y contra los datos oficiales del punto de suministro es donde caen la mayoría de los expedientes montados.

Respuesta

{
  "expediente_id": "59e60d43-...",
  "veredicto": "indicios_manipulacion",   // sin_indicios | revisar | indicios_manipulacion
  "etiqueta": "Indicios de manipulación",
  "riesgo": 66,
  "puntuacion": 34,
  "creditos_consumidos": 1,
  "tipo_detectado": "factura_luz",
  "hallazgos": [
    {
      "id": "fac_total",
      "titulo": "El total NO es la suma de sus partes",
      "resultado": "fallo",              // fallo | aviso | ok | no_aplicable
      "detalle": "total 41,90 € vs conceptos 100,35 € ...",
      "pagina": 1,
      "zona": { "x": 83.1, "y": 64.4, "w": 7.2, "h": 1.8 },   // % de la hoja
      "confianza": "alta",
      "ambito": "documento",
      "evidencia": { }
    }
  ],
  "resumen": "...",
  "recomendacion": "...",
  "limitaciones": [ "..." ],
  "aviso": "..."
}

POST /v1/expediente

Analiza varios documentos como un conjunto. Es la llamada importante: además de revisar cada fichero, ejecuta los cotejos cruzados (titular, DNI, dirección, CUPS, IBAN y fechas) y busca documentos ya usados en otros expedientes de tu cuenta.

curl -X POST https://api.auditalo.es/v1/expediente \
  -H "x-api-key: adt_live_..." \
  -H "content-type: application/json" \
  -d '{
    "tipo": "luz",
    "referencia": "EXP-2026-0412",
    "comercial": "Juan Pérez",
    "declarado": { "titular": "...", "nif": "...", "cups": "...", "iban": "..." },
    "documentos": [
      { "nombre": "factura.pdf", "tipo": "factura",     "mime": "application/pdf", "base64": "..." },
      { "nombre": "dni.jpg",     "tipo": "dni",          "mime": "image/jpeg",      "base64": "..." },
      { "nombre": "banco.pdf",   "tipo": "iban_recibo",  "mime": "application/pdf", "base64": "..." }
    ]
  }'

La respuesta añade documentos[] con el veredicto de cada uno, y los hallazgos de ámbito expediente.

GET /v1/expedientes y /v1/expedientes/{id}

Listado e histórico completo, con sus hallazgos y el estado en que los haya dejado la persona que los revisó.

GET /v1/catalogo

Tipos de expediente, planes, veredictos, limitaciones declaradas y las fuentes oficiales del BOE que se usan para el cotejo, con su norma y su enlace. No necesita clave.

Formatos y límites

Concepto	Límite
Formatos	PDF, JPG, PNG, WebP y HEIC
Tamaño por fichero	25 MB
Documentos por expediente	8
Hojas por documento	200
Duración de una llamada	hasta 5 minutos en expedientes grandes

Códigos de error

Código	Qué significa
400	Falta un campo o el contenido no es correcto
401	Clave de API ausente, revocada o no válida
402	Sin créditos. Devuelve `necesarios` y `saldo`. No se ha analizado ni cobrado nada
413	Fichero demasiado grande
415	Formato no admitido

Recomendaciones para conectar un CRM

Guarda el expediente_id en tu ficha de contrato: te permite volver al informe completo y al registro de accesos.
Marca, no bloquees. Un veredicto rojo debería avisar a back office, no impedir la tramitación: la decisión es de una persona.
Manda siempre declarado con lo que el comercial ha tecleado en tu CRM. Es gratis y multiplica lo que se detecta.
Manda sips si lo tienes. El SIPS no se puede retocar, así que es la comprobación más fuerte de todas.
Llama a /v1/expediente cuando el comercial haya subido toda la documentación, no fichero a fichero: los cotejos cruzados solo existen cuando están todos juntos.