/api/v1/scope/checkПроверка на обхвата на DPP
Връща структуриран регулаторен отговор за продуктов тип: дали изисква цифров продуктов паспорт, от кога, на какво ниво (изделие или модел), приложимия акт и член, задълженията на ролята на заявителя, кои други актове се прилагат и кои открити въпроси трябва да бъдат отговорени преди окончателен извод. Всеки отговор посочва члена, на който се основава, или казва, когато правилата ни не обхващат продукта.
Достъпно при всеки план, включително Free. Не се брои към дневния лимит за четене или запис на v1. Вместо това се прилага ограничение по компания: около 100 отговора на ден и 30 в минута, споделени между всички канали (табло, API, MCP). Ограничението се нулира в плъзгащ 24-часов прозорец; `resetAt` дава точния момент на следващото нулиране. Отговорът касае продуктов тип, описан с факти — той е регулаторна информация, не правен съвет.
Подайте `productId` или `passportId`, за да попълните предварително факти от записаните отговори на продукта и стойностите на полетата на паспорта (обвързани с компанията; 404, ако принадлежи на друга компания). Полето `locale` управлява езика на отговора (`en`, `bg`, `de`, `it`); по подразбиране е заглавието `Accept-Language` или `en`.
Хедъри
- Authorizationзадължително
string
`Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.
e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Полета в тялото
- category
string
Ключ на продуктовата категория — `battery`, `textile`, `electronics`, `furniture`, `detergents`, `paints-coatings`, `packaging`, `toys`, `fmcg`, `tyres`, `steel`, `construction`, `jewelry`, `vehicles` или `other`.
e.g. battery
- facts
object
Известни факти за продукта като двойки ключ–стойност. Ключовете са именувани по акт (напр. `battery.use`, `battery.capacityKWh`). Неизвестни ключове или стойности извън допустимите връщат 400 `invalid_input`.
- role
string
Вашата роля с термините на акта: `manufacturer`, `importer`, `distributor`, `authorised_representative` или `fulfilment_service_provider`. Продажбата под ваше име е `manufacturer` с факта `ownBrand: true`. По подразбиране от профила на компанията; без роля отговорът изброява задълженията на всяка роля.
- locale
string
Език на отговора — `en`, `bg`, `de` или `it`. По подразбиране от заглавието `Accept-Language`, след това `en`.
e.g. en
- productId
string
Попълва предварително факти от записаните отговори на този продукт. Трябва да принадлежи на вашата компания; в противен случай връща 404.
- passportId
string
Попълва предварително факти от стойностите на полетата на паспорта и записаните отговори на продукта. Трябва да принадлежи на вашата компания.
Заявка
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"
}'Отговор
{
"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"
}