Saltar al contenido
Constaia
utility_bill

Factura de suministros

Factura de luz, gas, agua, internet o teléfono de cualquier país, usada como justificante de domicilio: comercializadora, titular, dirección de suministro, CUPS, periodo e importe.

Categoría
Domicilio
País
Internacional
Campos que extrae
16 campos
Coste
1 crédito
utility_billspecimen
Supplier
Supplier tax id
Service type
Nombre del titular
DNI/NIE del titular
Supply address
Postal code
Country
Cups

Qué comprueba

  • Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).postal_code
  • Código postal. Formato del código postal del país.
  • Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
  • Antigüedad. Emitido hace menos de N días.

Campos que extrae

  • Suppliersupplier
  • Supplier tax idsupplier_tax_id
  • Service typeservice_type
  • Nombre del titularholder_name
  • DNI/NIE del titularholder_id
  • Supply addresssupply_address
  • Postal codepostal_code
  • Countrycountry
  • Cupscups
  • Contract numbercontract_number
  • Invoice numberinvoice_number
  • Fecha de expediciónissue_date
  • Period startperiod_start
  • Period endperiod_end
  • Importeamount
  • Monedacurrency

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "utility_bill",
    "checks": {
      "max_age_days": 90,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "utility_bill",
    "label": "Factura de suministros",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "utility_bill"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Factura de suministros."
      }
    ]
  },
  "fields": {
    "supplier": {
      "value": "ESPECIMEN ENERGÍA S.A.",
      "confidence": 0.99,
      "validated": true
    },
    "supplier_tax_id": {
      "value": "A12345674",
      "confidence": 0.98,
      "validated": null
    },
    "service_type": {
      "value": "electricidad",
      "confidence": 0.97,
      "validated": null
    },
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.96,
      "validated": null
    },
    "holder_id": {
      "value": "99999999R",
      "confidence": 0.99,
      "validated": null
    },
    "supply_address": {
      "value": "C/ MAYOR 1, 3º A, MADRID",
      "confidence": 0.98,
      "validated": null
    },
    "postal_code": {
      "value": "28013",
      "confidence": 0.97,
      "validated": null
    },
    "country": {
      "value": "ESP",
      "confidence": 0.96,
      "validated": null
    },
    "cups": {
      "value": "ES0021000000000000AA",
      "confidence": 0.99,
      "validated": null
    },
    "contract_number": {
      "value": "123456789",
      "confidence": 0.98,
      "validated": null
    },
    "invoice_number": {
      "value": "FE26-000123",
      "confidence": 0.97,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-05",
      "confidence": 0.96,
      "validated": null
    },
    "period_start": {
      "value": "2026-08-01",
      "confidence": 0.99,
      "validated": null
    },
    "period_end": {
      "value": "2026-08-31",
      "confidence": 0.98,
      "validated": null
    },
    "amount": {
      "value": 68.42,
      "confidence": 0.97,
      "validated": null
    },
    "currency": {
      "value": "EUR",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

Solo si hay que revisarlo: entonces se guarda cifrado hasta que se decide y 24 horas más (configurable). Si no, se borra en cuanto termina el análisis. Puedes elegir no guardarlo nunca.

Otros documentos

Y para que conste…

Crea tu cuenta gratis y valida tu primer documento en cinco minutos. Sin tarjeta.