TracePass
Inizia ora
Passaporti

Verificare la prontezza per il registro

Restituisce se un passaporto supererebbe il gate formale di invio dell'EU DPP Registry — { ready, findings[] }. È il controllo *meccanico* del registro prima dell'invio, distinto da e complementare al verdetto sostanziale /compliance: un passaporto può essere pronto per il registro senza essere sostanzialmente conforme, e viceversa. Chiamalo prima dell'invio al registro per individuare presto le lacune formali.

GET/api/v1/passports/{id}/registry-readiness
Scarica OpenAPI 3.1
GET/api/v1/passports/{id}/registry-readiness

Verificare la prontezza per il registro

Restituisce se un passaporto supererebbe il gate formale di invio dell'EU DPP Registry — { ready, findings[] }. È il controllo *meccanico* del registro prima dell'invio, distinto da e complementare al verdetto sostanziale /compliance: un passaporto può essere pronto per il registro senza essere sostanzialmente conforme, e viceversa. Chiamalo prima dell'invio al registro per individuare presto le lacune formali.

Sei controlli formali, ciascuno portato sulla forma finding standard con un ruleId REG-READY-*. REG-READY-MANDATORY: ogni campo obbligatorio applicabile a questo tipo di batteria è presente e approvato — consapevole dell'applicabilità, così un campo non applicabile alla categoria della batteria (es. state-of-certified-energy su una batteria non-EV) non è conteggiato come mancante, e un campo con applicabilità unknown appare come warning, non come blocco. REG-READY-FORMAT: i campi compilati sono ben formati (tipi, enum, pattern, limiti). REG-READY-LINK: l'indirizzo che il registro riceverebbe si risolve — l'indirizzo congelato quando è stata preparata una registrazione (registryUpi), altrimenti l'indirizzo pubblico attuale del passaporto. Una prova dal vivo; su un passaporto non pubblicato questo è un warning consultivo anziché un blocco, poiché il preflight è pensato per essere eseguito prima della pubblicazione. REG-READY-GRANULARITY: il passaporto reca un numero di serie — le batterie si registrano a livello di articolo (item), quindi un numero di serie mancante è un blocco. REG-READY-COMMODITY: il codice merceologico (CN/TARIC) è ben formato quando la categoria ne reca uno; le batterie non recano un codice merceologico, quindi per le batterie questo è solo un warning consultivo, mai un blocco. REG-READY-SEMANTIC: per le batterie per veicoli elettrici, le batterie per mezzi di trasporto leggeri e le batterie industriali oltre 2 kWh, i dati del passaporto sono verificati rispetto al modello di dati per le batterie della Commissione (pacchetto semantico 1.0.0), il modello con cui il registro convalida gli invii. Un valore mancante o malformato nelle informazioni pubbliche è un blocco; una lacuna nelle informazioni ad accesso limitato (regolamento sulle batterie, allegato XIII, punti da 2 a 4) è un warning. È un blocco anche la mancanza dell'identificativo dell'organizzazione per l'EU DPP Registry (un'impostazione dell'account) o una categoria di batteria non riconosciuta. Le batterie portatili, le batterie per avviamento, illuminazione e accensione e le batterie industriali fino a 2 kWh inclusi sono fuori dal modello della Commissione e non ricevono alcun finding da questo controllo.

ready è true solo quando non ci sono findings critici; i warning non bloccano mai la prontezza. Solo passaporti di batterie in questa versione — un passaporto non-batteria restituisce ready: true con un singolo warning REG-READY-SCOPE, poiché il gate formale del registro per le altre categorie non è ancora modellato. Sola lettura; conta come una lettura di passaporto v1 rispetto al limite giornaliero.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID del passaporto.

Header

  • Authorizationobbligatorio

    string

    Bearer <token> — una chiave API tp_ (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Richiesta

curl -sS \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registry-readiness \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Risposta

{
  "ready": false,
  "findings": [
    {
      "type": "missing_field",
      "severity": "critical",
      "target": "batteryUniqueIdentifier",
      "ruleId": "REG-READY-MANDATORY",
      "why": "A mandatory field that applies to this battery is missing.",
      "fix": "Provide batteryUniqueIdentifier before submitting to the registry."
    },
    {
      "type": "unverifiable_conditional",
      "severity": "warning",
      "target": "https://id.tracepass.eu/p/01/...",
      "ruleId": "REG-READY-LINK",
      "why": "This passport isn't published yet, so the registry link can't be checked live."
    }
  ]
}

Endpoint correlati