Un passaporto fa un regalo a chi lo elabora: la zona a lettura ottica. Un blocco di lettere maiuscole, cifre e caratteri di riempimento < in fondo alla pagina dati, con cifre di controllo calcolate sui suoi campi. Leggi la zona, ricalcoli le cifre e sai se la lettura è coerente prima di fidarti di un solo campo.

Una patente di guida di solito non ti dà niente di tutto questo. La maggior parte degli emittenti non stampa alcuna zona a lettura ottica sulla patente, quindi non c'è niente da ricalcolare. Gli sviluppatori che hanno costruito il primo flusso sui passaporti spesso lo scoprono a proprie spese, quando il codice che "valida la MRZ" incontra una tessera senza zona e comincia a trattare una patente perfettamente valida come un errore.

Questo articolo parla di quel caso. Cosa riporta una patente al posto della zona, cosa un'API di riconoscimento può e non può dirti, e come controllare tu stesso i campi quando non ci sono cifre di controllo su cui contare. Le citazioni di AAMVA e dell'UE sono tradotte da noi; gli originali sono in inglese.

Questo è il blog di doc.cheap, un'API OCR per passaporti e documenti d'identità. Leggi la parte sul prodotto tenendolo presente.

Cosa riporta una patente al suo posto

Non esiste un formato unico di patente. Ogni emittente progetta la propria tessera, e gli standard esistenti stabiliscono cosa deve contenere e come deve essere organizzata, non una stringa fissa da analizzare.

Nord America: un codice a barre sul retro. L'American Association of Motor Vehicle Administrators pubblica l'AAMVA DL/ID Card Design Standard per le tessere rilasciate dai suoi membri. L'edizione 2026 ha un allegato intitolato "Codice a barre PDF417 obbligatorio", che dice: "La simbologia di codice a barre bidimensionale PDF417 è la tecnologia minima obbligatoria a lettura ottica che deve essere presente sui documenti DL/ID conformi". Lo stesso allegato aggiunge: "Tutti i dati obbligatori e facoltativi devono essere non cifrati". Quindi una tessera conforme riporta i dati del titolare due volte: stampati sul fronte e codificati in un codice a barre bidimensionale che chiunque abbia un decodificatore può leggere.

L'UE: un modello di tessera comune, letto dalla faccia. La pagina di La tua Europa sulla conversione e il riconoscimento delle patenti descrive la patente attuale come "il nuovo formato standard dell'UE (tessera con fotografia in plastica, del formato di una carta di credito)". L'impaginazione è comune, ma ciò che ne leggi è il testo stampato. Sono ancora in circolazione anche vecchie patenti cartacee: la stessa pagina dice che "se hai una patente UE del vecchio modello, puoi ancora usarla in tutti i paesi dell'UE", e che una patente del genere va sostituita "entro il 2033 al più tardi".

Il livello internazionale. La pagina stessa di AAMVA osserva che il lavoro verso uno standard internazionale per le patenti si svolge in ISO, e che "lo standard internazionale (18013) stabilisce linee guida sul formato e sul contenuto delle patenti di guida dei veicoli a motore (DL)". Elenca le tecnologie di cui lo standard si occupa, tra cui "codici a barre, mono e bidimensionali" e "riconoscimento ottico dei caratteri". In altre parole, lo standard lascia scegliere all'emittente; non ti consegna una zona con cifre di controllo.

Il risultato pratico per chi elabora il documento:

Passaporto Patente di guida
Zona a lettura ottica Sempre, nella pagina dati Di solito nessuna
Cifre di controllo che puoi ricalcolare Sì, sulla zona Nessuna, quando non c'è zona
Una seconda copia dei dati La zona Un codice a barre, se l'emittente lo stampa (di solito sul retro)
Data di scadenza Stampata nella pagina dati Stampata quando la patente ne ha una; alcune valgono a vita
Cosa ti dice che la lettura è coerente La zona confrontata con la pagina stampata I tuoi controlli sui campi stampati

Perché "nessuna zona" non deve voler dire "non valida"

Se il tuo flusso è nato con i passaporti, probabilmente si dirama in base alla zona: superata, prosegui; non superata, chiedi una nuova foto. Una patente aggiunge una terza risposta, ed è quella più comune.

doc.cheap riporta la zona come un unico verdetto, mrz.status, con tre valori. passed significa che la zona è presente e ogni cifra di controllo è stata validata. failed significa che una zona è stata letta e qualcosa non tornava. absent significa che il documento non ne ha – e allora reason, lines e text sono tutti null. La guida alla patente di guida lo dice chiaramente: "Tratta absent come un esito normale, non come un errore."

Il resto del documento non ne risente. Una patente viene riconosciuta dalla sua faccia stampata come qualsiasi altro documento, e meta.status torna recognized. Quindi la diramazione che ti serve non è "zona superata o rifiuto", ma:

  • failed – qualcosa in una zona non tornava; chiedi una foto migliore.
  • passed – la zona è stata verificata; prosegui.
  • absent – non c'era niente da verificare; passa ai tuoi controlli sui campi qui sotto.

Leggerla con una sola chiamata API

Una patente va allo stesso endpoint di un passaporto, con lo stesso corpo: un POST /v1/scans con la foto codificata in base64 dentro un JSON. La chiave pubblica di sandbox sk_sandbox_public funziona senza account. Usala con un'immagine di prova, mai con una patente vera: ogni scansione fatta con la chiave pubblica viene conservata per un anno per il registro interno del servizio.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"

Le parti della risposta che contano per una patente sono fatte così. Ogni valore è inventato, e lo Stato emittente è UTO, lo Stato fittizio usato dai documenti campione:

{
  "meta": { "status": "recognized", "billed": true, "confidence": "high" },
  "document": {
    "country": "UTO",
    "number": "DL0000000",
    "issue_date": "2024-05-02",
    "expiry_date": "2034-05-01",
    "is_expired": false,
    "days_remaining": 2725
  },
  "holder": {
    "surname": "SPECIMEN",
    "given_names": "ALEX JORDAN",
    "birth_date": "1990-01-01"
  },
  "fields": [
    { "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
      "category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
    { "id": "authority@0", "name": "authority", "label": "Issuing authority",
      "category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
  ],
  "mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

Cosa leggerci:

  • fields è dove stanno i dati specifici della patente. Il catalogo dei campi elenca cosa riporta di solito una patente: surname, given_names, birth_date, document_number, dl_class o permit_class, issue_date, expiry_date, address e authority. Le parti dell'indirizzo (address_street, address_city, address_state, address_postal_code) vengono pubblicate anche separatamente, oltre all'indirizzo intero. L'insieme è aperto, quindi un campo che il vocabolario non nomina viene comunque pubblicato, nella categoria other.
  • Usa id come chiave, non name. Una patente stampata in due alfabeti restituisce una voce per lingua con lo stesso name; solo id è univoco.
  • document.expiry_date, is_expired e days_remaining sono calcolati dalla data di scadenza stampata, a partire dal giorno della scansione.

Cosa aggiunge un codice a barre e cosa ne fa l'API

Un codice a barre decodificato non ha un gruppo tutto suo nella risposta. I suoi valori arrivano in fields insieme a tutto il resto, e images.barcode ne contiene un ritaglio quando è stato possibile estrarlo.

C'è un dettaglio pratico. L'endpoint legge un'immagine per chiamata, e un emittente che stampa un codice a barre di solito lo mette sul retro della tessera. Quando ti serve ciò che contiene il codice a barre, invia il retro come scansione separata e unisci tu i due risultati. Questa unione è anche il miglior sostituto delle cifre di controllo: due letture indipendenti della stessa tessera, che dovrebbero coincidere.

Validare una patente senza cifre di controllo

Senza zona, la coerenza è compito tuo. Nessuno di questi controlli dimostra che una patente sia autentica; servono a intercettare letture errate e dati palesemente sbagliati prima che arrivino al tuo database.

  1. Date in ordine. birth_date prima di issue_date, issue_date nel giorno della scansione o prima, expiry_date dopo issue_date. Una lettura che rompe quest'ordine è un errore di lettura o una foto scadente.
  2. La scadenza dal documento, non da una formula. I periodi di validità cambiano da emittente a emittente – l'esempio della pagina UE stessa è una patente di Cipro "valida per 15 anni, invece di 10 anni come in Italia". Leggi la data sulla tessera; non calcolarla.
  3. Prevedi l'assenza della data di scadenza. La stessa pagina UE cita "patenti di guida UE valide a vita". Quando non è stata letta alcuna data di scadenza, expiry_date, is_expired e days_remaining sono null insieme, e anche il campo derivato days_to_expire è null. Decidi cosa fa il tuo flusso in quel caso; non trattare null per sbaglio né come scaduta né come valida.
  4. La categoria, non solo la presenza. Se ti serve qualcuno abilitato a guidare l'auto, cerca quella categoria in dl_class o permit_class invece di controllare solo che esista una patente. Il valore è testo stampato come B, BE, quindi dividilo prima del confronto, e confrontalo con le categorie definite dalla tua giurisdizione.
  5. Fronte contro retro. Se la tessera ha un codice a barre, scansiona entrambi i lati e confronta il nome, la data di nascita e il numero del documento. Una discrepanza merita una seconda foto.
  6. Contro ciò che ha scritto l'utente. Confronta holder.surname e holder.birth_date con il modulo compilato dal tuo utente, normalizzati allo stesso modo.
  7. La confidenza come segnale. Ogni lettura ha una fascia – high, medium o low. Una fascia low su un campo da cui dipendi è un buon motivo per chiedere una nuova foto.

Quanto costa una scansione quando non c'è zona

Con una chiave reale, una scansione consuma un credito quando il tipo di documento è stato determinato e vale una di tre condizioni: una zona è stata letta e le sue cifre di controllo sono risultate corrette, sono stati letti cinque o più campi della zona visiva, oppure è stato decodificato un codice a barre. Una patente quindi viene addebitata per la seconda o la terza. Una foto troppo scadente per dare cinque campi e senza codice a barre è gratuita. La regola di addebito riporta la definizione completa.

Cosa l'OCR non ti dice

Leggere una patente e verificarla sono lavori diversi. doc.cheap legge ciò che è stampato sulla tessera e, sul retro, il codice a barre. Nello scenario di solo riconoscimento authenticity.overall è not_checked, quindi non ti dice se la tessera è autentica, se è stata sospesa o se la persona che la tiene in mano ne è il titolare. Se il tuo flusso ha bisogno di una di queste cose, sono passaggi separati, con strumenti e archivi pensati apposta.

Provalo

La chiave pubblica di sandbox non richiede un account. Registrandoti ottieni 100 riconoscimenti gratuiti ogni mese sulla tua chiave, abbastanza per costruire l'intero flusso – fronte, retro e i tuoi controlli. Se stai scegliendo un fornitore, il confronto tra API OCR per passaporti mette fianco a fianco i prezzi pubblicati, e la guida alla patente di guida riporta la chiamata in curl, JavaScript e Python, con consigli per fotografare una tessera lucida.

Una domanda per te: quando una patente non ha zona, quale controllo intercetta più letture sbagliate nel tuo flusso – le date, il codice a barre sul retro o qualcos'altro? Raccontacelo nei commenti qui sotto.