Saltar para o conteúdo
Constaia
us_utility_bill

Fatura de serviços dos EUA (utility bill)

Comprovativo de morada: fornecedor, titular, morada e data.

Categoria
Morada
País
Estados Unidos
Campos extraídos
11 campos
Custo
1 crédito
us_utility_billspecimen
Provider
Service type
Titular da conta
Account number
Morada do fornecimento
Postal code
Data de emissão
Data de vencimento
Service period start

A Constaia extrai o fornecedor, o titular e a morada do fornecimento, verifica que a fatura é recente e compara a morada com a esperada.

O que verifica

  • Identificadores nacionais. Checksum ou formato oficial do número (NIF, CPF, CURP, RUT…).us_zip
  • Código postal. Formato do código postal do país.
  • Titular. Nome, número ou data de nascimento coincidem com o esperado.
  • Antiguidade. Emitido há menos de N dias.

Campos extraídos

  • Providerprovider
  • Service typeservice_type
  • Titular da contaaccount_holder
  • Account numberaccount_number
  • Morada do fornecimentoservice_address
  • Postal codepostal_code
  • Data de emissãoissue_date
  • Data de vencimentodue_date
  • Service period startservice_period_start
  • Service period endservice_period_end
  • Montante a pagaramount_due

Exemplo de pedido

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"
  }'

Experimente sem custo com uma chave ck_test_ e o ficheiro us_utility_bill_specimen.pdf.

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_utility_bill",
    "label": "Fatura de serviços dos EUA (utility bill)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_utility_bill"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Fatura de serviços dos EUA (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": "A data de emissão está dentro do prazo."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "O titular coincide."
    },
    {
      "code": "address_match",
      "passed": true,
      "message": "A morada coincide com a esperada."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 2
  }
}

FAQ

A Constaia prova que o documento é autêntico?

Não. Verifica o tipo, a coerência dos dados e as suas regras, e assinala sinais como possível edição ou fotografia de ecrã. Isso não prova autenticidade.

É guardada uma cópia do documento?

Não, a menos que o peça. Com storage "none" (por omissão) o ficheiro é apagado quando a análise termina.

Outros documentos

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.