Verificare l'ambito DPP

POST/api/v1/scope/check

Restituisce una risposta normativa strutturata per un tipo di prodotto: se necessita di un passaporto digitale di prodotto, da quando, a quale livello (per unità o per modello), l'atto e l'articolo applicabili, gli obblighi del ruolo della parte richiedente, quali altri atti si applicano e quali domande aperte devono essere risposte prima di un verdetto definitivo. Ogni risposta indica l'articolo su cui si basa, o dice quando le nostre regole non coprono il prodotto.

Disponibile in ogni piano, Free compreso. Non conteggiato sui limiti giornalieri di lettura o scrittura v1. Si applica invece un limite per azienda: circa 100 risposte al giorno e 30 al minuto, condivise tra tutti i canali (dashboard, API, MCP). Il limite si azzera su una finestra mobile di 24 ore; `resetAt` fornisce l'esatto timestamp del prossimo reset. La risposta riguarda un tipo di prodotto descritto da fatti — è informazione normativa, non consulenza legale.

Passate `productId` o `passportId` per pre-compilare i fatti dalle risposte salvate del prodotto e dai valori dei campi del passaporto (con ambito aziendale; 404 se appartiene a un'altra azienda). Il campo `locale` controlla la lingua della risposta (`en`, `bg`, `de`, `it`); il valore predefinito è l'header `Accept-Language` o `en`.

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

Campi del corpo

category
string
Chiave della categoria di prodotto — `battery`, `textile`, `electronics`, `furniture`, `detergents`, `paints-coatings`, `packaging`, `toys`, `fmcg`, `tyres`, `steel`, `construction`, `jewelry`, `vehicles` o `other`.
e.g. battery
facts
object
Fatti noti sul prodotto come coppie chiave-valore. Le chiavi sono con prefisso dell'atto (es. `battery.use`, `battery.capacityKWh`). Chiavi sconosciute o valori fuori dall'intervallo consentito restituiscono 400 `invalid_input`.
role
string
Il vostro ruolo nei termini dell'atto: `manufacturer`, `importer`, `distributor`, `authorised_representative` o `fulfilment_service_provider`. Vendere con il proprio nome è `manufacturer` con il fatto `ownBrand: true`. Predefinito dal profilo aziendale; senza ruolo, la risposta elenca gli obblighi di ogni ruolo.
locale
string
Lingua della risposta — `en`, `bg`, `de` o `it`. Il valore predefinito è l'header `Accept-Language`, poi `en`.
e.g. en
productId
string
Pre-compila i fatti dalle risposte di ambito salvate di questo prodotto. Deve appartenere alla vostra azienda; altrimenti restituisce 404.
passportId
string
Pre-compila i fatti dai valori dei campi del passaporto e dalle risposte salvate del prodotto. Deve appartenere alla vostra azienda.

Richiesta

curl -sS https://app.tracepass.eu/api/v1/scope/check \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "battery",
    "facts": {
      "battery.use": "stationary_energy_storage",
      "battery.capacityKWh": 10
    },
    "role": "importer",
    "locale": "en"
  }'

Risposta

{
  "status": "answered",
  "answer": "Industrial batteries matching the facts you gave need a battery passport from 18 February 2027 (Battery Regulation (EU) 2023/1542, Art. 77(1)). …",
  "locale": "en",
  "data": {
    "inScope": "yes",
    "verdict": "in_scope",
    "governing": {
      "celex": "32023R1542",
      "act": {
        "celex": "32023R1542",
        "name": "Battery Regulation (EU) 2023/1542"
      },
      "verdict": "in_scope",
      "citation": {
        "ref": "Art. 77(1)",
        "quote": "From 18 February 2027 each LMT battery, each industrial battery with a capacity greater than 2 kWh and each electric vehicle battery placed on the market or put into service shall have an electronic record (‘battery passport’)."
      },
      "appliesFrom": {
        "date": "2027-02-18",
        "precision": "day",
        "wording": "from 18 February 2027"
      },
      "level": {
        "value": "item",
        "ref": "Art. 77(2)"
      },
      "role": {
        "asked": "importer",
        "actTerm": "importer",
        "definedIn": "Art. 3(1)(64)",
        "placingOperator": true
      },
      "duties": [
        {
          "id": "32023R1542#duty.unique_identifier@1",
          "holder": "placing_operator",
          "ref": "Art. 77(3)",
          "quote": "The battery passport shall be accessible through the QR code referred to in Article 13(6) which links to a unique identifier that the economic operator placing the battery on the market shall attribute to it.",
          "status": "active"
        },
        …
      ],
      "ruleStatus": "verified"
    },
    "alsoApplies": []
  },
  "ask": [
    {
      "fact": "battery.incorporatedIn",
      "question": "Is it built into military equipment (arms, munitions, war material; not a product that is not intended for specifically military purposes, such as dual-use equipment), equipment sent into space, or equipment specifically designed for the safety of nuclear installations?",
      "blocking": false,
      "act": "32023R1542",
      "type": "enum",
      "values": [
        "none",
        "military",
        "space",
        "nuclear_safety",
        "other"
      ],
      "valueLabels": {
        "none": "none of these",
        "military": "military equipment",
        "space": "equipment sent into space",
        "nuclear_safety": "equipment for the safety of nuclear installations",
        "other": "other equipment"
      }
    },
    {
      "fact": "ownBrand",
      "question": "Do you place it on the market under your own name or trademark?",
      "blocking": false,
      "act": "32023R1542",
      "type": "boolean",
      "valueLabels": {
        "true": "Yes",
        "false": "No"
      }
    },
    {
      "fact": "modified",
      "question": "Have you modified it after it was placed on the market, in a way that could affect compliance?",
      "blocking": false,
      "act": "32023R1542",
      "type": "boolean",
      "valueLabels": {
        "true": "Yes",
        "false": "No"
      }
    },
    {
      "fact": "purposeChanged",
      "question": "Have you changed its intended purpose?",
      "blocking": false,
      "act": "32023R1542",
      "type": "boolean",
      "valueLabels": {
        "true": "Yes",
        "false": "No"
      }
    }
  ],
  "citations": [
    {
      "celex": "32023R1542",
      "ref": "Art. 77(1)",
      "quote": "From 18 February 2027 each LMT battery, each industrial battery with a capacity greater than 2 kWh and each electric vehicle battery placed on the market or put into service shall have an electronic record (‘battery passport’).",
      "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32023R1542"
    },
    …
  ],
  "ruleIds": [
    "32023R1542#duty.accurate_and_delegable@1",
    "32023R1542#duty.importer_checks_marking@1",
    …
  ],
  "asOf": "2026-10-09",
  "ruleStatus": "verified",
  "machineTranslated": false,
  "disclaimer": "Regulatory information as of 9 Oct 2026, not legal advice. Check the cited articles before relying on it. — TracePass"
}

Endpoint correlati

GETGET Report catalogo