Saltar al contenido
Constaia
us_utility_bill

Factura de suministros de EE. UU. (utility bill)

Justificante de domicilio: proveedor, titular, dirección y fecha.

Categoría
Domicilio
País
Estados Unidos
Campos que extrae
11 campos
Coste
1 crédito
us_utility_billspecimen
Provider
Service type
Titular de la cuenta
Account number
Dirección del suministro
Postal code
Fecha de expedición
Fecha de vencimiento
Service period start

Constaia extrae el proveedor, el titular y la dirección del suministro, comprueba que la factura es reciente y compara la dirección con la esperada.

Qué comprueba

  • Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).us_zip
  • 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

  • Providerprovider
  • Service typeservice_type
  • Titular de la cuentaaccount_holder
  • Account numberaccount_number
  • Dirección del suministroservice_address
  • Postal codepostal_code
  • Fecha de expediciónissue_date
  • Fecha de vencimientodue_date
  • Service period startservice_period_start
  • Service period endservice_period_end
  • Importe a pagaramount_due

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_utility_bill_specimen.pdf" \
  -F 'options={
    "expect": "us_utility_bill",
    "checks": {
      "max_age_days": 90,
      "holder": {
        "full_name": "Jordan Specimen"
      },
      "expected_address": "742 Example Ave, Springfield, OR 97477"
    },
    "storage": "none"
  }'

Pruébalo sin coste con una clave ck_test_ y el fichero us_utility_bill_specimen.pdf.

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_utility_bill",
    "label": "Factura de suministros de EE. UU. (utility bill)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_utility_bill"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Factura de suministros de EE. UU. (utility bill)."
      }
    ]
  },
  "fields": {
    "provider_name": {
      "value": "EXAMPLE POWER & LIGHT",
      "confidence": 0.99,
      "validated": true
    },
    "account_holder": {
      "value": "JORDAN SPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "service_address": {
      "value": "742 EXAMPLE AVE, SPRINGFIELD, OR 97477",
      "confidence": 0.97,
      "validated": null
    },
    "account_number_last4": {
      "value": "0917",
      "confidence": 0.96,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-05",
      "confidence": 0.99,
      "validated": null
    },
    "due_date": {
      "value": "2026-09-26",
      "confidence": 0.98,
      "validated": null
    },
    "amount_due": {
      "value": 84.37,
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "max_age_days",
      "passed": true,
      "message": "La fecha de emisión está dentro del plazo."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "El titular coincide."
    },
    {
      "code": "address_match",
      "passed": true,
      "message": "La dirección coincide con la esperada."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 2
  }
}

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?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.