TracePass
Passaporti

Verificare la conformità del passaporto

Restituisce un verdetto di conformità a tre livelli per un passaporto — `compliant`, `compliant_with_warnings` o `incomplete` — insieme a findings che citano il regolamento, così un'integrazione può verificare le lacune di un passaporto, correggere le lacune indicate e richiamare per confermare. Quella catena leggere → correggere → verificare è lo scopo: la risposta indica all'agente IA esattamente cosa impostare in seguito.

GET/api/v1/passports/{id}/compliance
Scarica OpenAPI 3.1
GET/api/v1/passports/{id}/compliance

Verificare la conformità del passaporto

Restituisce un verdetto di conformità a tre livelli per un passaporto — `compliant`, `compliant_with_warnings` o `incomplete` — insieme a findings che citano il regolamento, così un'integrazione può verificare le lacune di un passaporto, correggere le lacune indicate e richiamare per confermare. Quella catena leggere → correggere → verificare è lo scopo: la risposta indica all'agente IA esattamente cosa impostare in seguito.

I findings provengono da tre livelli. **Static**: i campi obbligatori del template mancanti o non approvati, e gli operatori economici obbligatori non impostati, sono `critical`; i valori dei campi che violano il formato del template (pattern / enum / limiti) sono `warning`. **Conditional**: regole per categoria in vigore oggi — l'ambito del passaporto della batteria ai sensi del Regolamento (UE) 2023/1542 art. 77, la comunicazione SVHC ai sensi di REACH art. 33 / SCIP, la dichiarazione di prestazione ai sensi del Regolamento (UE) 2024/3110 — più la regola trasversale secondo cui un prodotto immesso sul mercato UE da un fabbricante extra-UE necessita di un operatore stabilito nell'UE (Regolamento (UE) 2019/1020 art. 4).

**Leggete `conditionalCoverage`.** È `evaluated` quando le regole conditional sono state eseguite per questa categoria, o `static-only` quando nessuna regola conditional vincolante è ancora in vigore (oggi 8 delle 12 categorie). Quando è `static-only`, l'assenza di findings conditional NON significa che la categoria non avrà requisiti futuri — solo che nessuno è ancora giuridicamente vincolante. Un finding con tag `unverifiable_conditional` significa che una regola si applica ma i dati necessari per valutarla (es. categoria della batteria, contenuto SVHC) non sono sul passaporto — verificatelo manualmente. Sola lettura; conta come una lettura di passaporto v1 rispetto al limite giornaliero.

Parametri di percorso

  • idobbligatorio

    ObjectId

    ID del passaporto.

Header

  • Authorizationobbligatorio

    string

    `Bearer <api-key>`.

Richiesta

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

Risposta

{
  "verdict": "incomplete",
  "category": "battery",
  "conditionalCoverage": "evaluated",
  "critical": [
    {
      "type": "conditional_missing",
      "severity": "critical",
      "target": "batteryUniqueIdentifier",
      "regulation": "(EU) 2023/1542",
      "article": "Art. 77",
      "ruleId": "BAT-1",
      "why": "This is an in-scope battery (EV); a battery passport with its unique identifier is mandatory.",
      "fix": "Provide batteryUniqueIdentifier — the battery passport's unique identifier (GS1 Digital Link)."
    }
  ],
  "warnings": [],
  "checkedRules": ["static:required-fields", "static:required-parties", "static:format", "BAT-1", "CC-1"],
  "completionPercentage": 72
}