Saltar al contenido

Todo lo que necesitas de la factura, en campos con nombre

Electricidad (2.0TD, 3.0TD y 6.1TD), gas (RL.1 a RL.5), facturas duales con las dos en el mismo PDF y tarifas con autoconsumo.

POST /api/v1/invoices invoice.bills[0]200 OK
{
  "invoice_type": "electricity",
  "cups": "ES0021000000000000AB",
  "provider_name": "Eléctrica Meridiana, S.L.",
  "holder_name": "María", "holder_surname": "García López",
  "fiscal_number": "12345678Z",
  "rate": "2.0TD",
  "initial_date": "2026-08-01", "final_date": "2026-08-31",
  "days_billed": 31,
  "consumption": { "p1": 112, "p2": 98, "p3": 143 },
  "power_prices": [
    { "lot": "P1", "power_supplied": 4.6, "price": 0.0886 },
    { "lot": "P2", "power_supplied": 4.6, "price": 0.0114 }
  ],
  "energy_prices": [
    { "lot": "P1", "consumption": 112, "usage_price": 0.198 },
    { "lot": "P2", "consumption": 98, "usage_price": 0.141 },
    { "lot": "P3", "consumption": 143, "usage_price": 0.1557 }
  ],
  "costs": {
    "energy": 58.27, "power": 14.26, "counter": 0.81,
    "tax_energy": 3.71, "social_bonus": 0.52,
    "tax_iva": 16.29
  },
  "taxable_amount": 77.57, "iva_rate": 21, "total_cost": 93.86,
  "address": {
    "street_type": "CALLE", "street": "FALSA", "number": "12",
    "floor_door": "3 B", "postal_code": "28942",
    "city": "Fuenlabrada", "province": "Madrid",
    "source": "cartociudad",
    "geo": { "lat": 40.2974, "lon": -3.8059 }
  },
  "review": {
    "needed": false, "confidence": 0.97, "checks": [] 
  }
}
  1. Titular y suministroCUPS, comercializadora y su CIF, distribuidora, y nombre, apellidos y NIF del titular.
  2. Tarifa y periodoPeaje de acceso (2.0TD, 3.0TD y 6.1TD en luz; RL.1 a RL.5 en gas), fechas de inicio y fin, días facturados y fecha de emisión.
  3. Consumos y potenciasEnergía por periodo, de P1 a P6, o el total en kWh en gas, y la potencia contratada en cada periodo.
  4. PreciosEl precio de la energía por periodo, el de la potencia por kW y día y, en gas, el del término fijo, con sus descuentos; en autoconsumo, también los precios ligados a la compensación de excedentes.
  5. Impuestos, descuentos e importesImpuesto eléctrico o de hidrocarburos, IVA y su tipo, bono social, alquiler del contador, descuentos, base imponible y total.
  6. Dirección normalizadaLa dirección tal como está impresa y, además, normalizada y geolocalizada con CartoCiudad (IGN).
  7. AutocomprobaciónCada lectura se cuadra contra sí misma (importes, IVA, días) y recibe una confianza de 0 a 1; lo que no cuadra va a revisión.

Tres pasos, sin plantillas que mantener

  1. Envía el PDF

    Desde tu sistema con una llamada a la API, o arrastrándolo en la consola. Varios ficheros en cada petición.

  2. Seleya la lee y la comprueba

    Extrae los campos, los cuadra entre sí y marca para revisión lo que no llega al umbral de confianza.

  3. Recibe el resultado

    Esperando la respuesta (hasta 60 s), consultándola después o con un webhook cuando esté lista.

Hecho para integrarse, no para una demo

Seleya nació dentro de Spock para leer las facturas de sus propios clientes. Ahora lo puedes usar tú.

  • review.neededCola de revisiónLo dudoso se revisa en la consola antes de llegar a tu sistema. Tú eliges el umbral.
  • sk_test_Claves de test gratisLas claves sk_test usan el motor real y no se facturan.
  • Idempotency-KeyIdempotenciaReintenta sin miedo: la misma clave no lee ni cobra dos veces durante 24 h.
  • webhookWebhooks y permisosAviso automático al terminar y claves con permisos de lectura, escritura o borrado.
  • Tus facturas no entrenanNo usamos tus documentos para entrenar el motor de lectura.
  • Datos en la UEAlojado en centros de Google Cloud en la Unión Europea, cifrado en reposo.

Lee tu primera factura hoy

Crea la cuenta, genera una clave de test y lanza la primera llamada con el ejemplo de la guía.