/api/v1/passports/{id}/complianceVerificare 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
}