Aller au contenu
Constaia
utility_bill

Facture de services

Facture d'électricité, de gaz, d'eau, d'internet ou de téléphone de tout pays, utilisée comme justificatif de domicile : fournisseur, titulaire, adresse de fourniture, PDL/CUPS, période et montant.

Catégorie
Justificatif de domicile
Pays
International
Champs extraits
16 champs
Coût
1 crédit
utility_billspecimen
Supplier
Supplier tax id
Service type
Nom du titulaire
N° d'identité du titulaire
Supply address
Postal code
Country
Cups

Ce qui est contrôlé

  • Identifiants nationaux. Clé de contrôle ou format officiel du numéro (NIR, NIF, CPF, CURP…).postal_code
  • Code postal. Format du code postal du pays.
  • Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.
  • Ancienneté. Délivré il y a moins de N jours.

Champs extraits

  • Suppliersupplier
  • Supplier tax idsupplier_tax_id
  • Service typeservice_type
  • Nom du titulaireholder_name
  • N° d'identité du titulaireholder_id
  • Supply addresssupply_address
  • Postal codepostal_code
  • Countrycountry
  • Cupscups
  • Contract numbercontract_number
  • Invoice numberinvoice_number
  • Date de délivranceissue_date
  • Period startperiod_start
  • Period endperiod_end
  • Montantamount
  • Devisecurrency

Exemple de requête

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

Exemple de réponse

Données fictives. Réponse abrégée.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "utility_bill",
    "label": "Facture de services",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "utility_bill"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Facture de services."
      }
    ]
  },
  "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 prouve-t-il que le document est authentique ?

Non. Il contrôle le type, la cohérence des données et vos règles, et signale des indices comme une possible retouche ou une photo d'écran. Cela ne prouve pas l'authenticité.

Une copie du document est-elle conservée ?

Seulement s'il doit être vérifié : il est alors conservé chiffré jusqu'à la décision, puis 24 heures (délai configurable). Sinon, il est supprimé dès la fin de l'analyse. Vous pouvez choisir de ne jamais le conserver.

Autres documents

Et pour valoir ce que de droit…

Créez votre compte gratuit et validez votre premier document en cinq minutes. Sans carte bancaire.