TracePass
Започнете
Паспорти

Проверка на готовността за регистъра

Връща дали паспорт би преминал формалната проверка за подаване на EU DPP Registry — { ready, findings[] }. Това е *механичната* проверка на регистъра преди подаване, различна от и допълваща същинската оценка /compliance: паспорт може да е готов за регистъра, но да не е същински съответстващ, и обратно. Извикайте я преди подаване към регистъра, за да откриете формалните пропуски рано.

GET/api/v1/passports/{id}/registry-readiness
Изтегли OpenAPI 3.1
GET/api/v1/passports/{id}/registry-readiness

Проверка на готовността за регистъра

Връща дали паспорт би преминал формалната проверка за подаване на EU DPP Registry — { ready, findings[] }. Това е *механичната* проверка на регистъра преди подаване, различна от и допълваща същинската оценка /compliance: паспорт може да е готов за регистъра, но да не е същински съответстващ, и обратно. Извикайте я преди подаване към регистъра, за да откриете формалните пропуски рано.

Шест формални проверки, всяка носена на стандартната finding форма с REG-READY-* ruleId. REG-READY-MANDATORY: всяко задължително поле, приложимо за този тип батерия, е налично и одобрено — с отчитане на приложимостта, така че поле, неприложимо за категорията на батерията (напр. state-of-certified-energy за батерия, различна от EV), не се брои за липсващо, а поле с unknown приложимост се появява като warning, не като блокиране. REG-READY-FORMAT: попълнените полета са добре формирани (типове, enums, patterns, граници). REG-READY-LINK: адресът, който регистърът би получил, се разрешава — адресът, фиксиран при подготовката на регистрация (registryUpi), а иначе текущият публичен адрес на паспорта. Жива проверка; при непубликуван паспорт това е предупредителен warning, а не блокиране, тъй като preflight-ът е предназначен да се изпълнява преди публикуване. REG-READY-GRANULARITY: паспортът носи сериен номер — батериите се регистрират на ниво артикул (item), затова липсващ сериен номер е блокиране. REG-READY-COMMODITY: митническият код (CN/TARIC) е добре формиран, когато категорията носи такъв; батериите нямат митнически код, затова за батерии това е само предупредителен warning, никога блокиране. REG-READY-SEMANTIC: за акумулаторни батерии за електрически превозни средства, батерии за леки транспортни средства и индустриални батерии над 2 kWh данните на паспорта се проверяват спрямо модела на данни на Комисията за батерии (семантичен пакет 1.0.0) — моделът, по който регистърът валидира подаванията. Липсваща или неправилно форматирана стойност в публичната информация е блокиране; пропуск в информацията с ограничен достъп (Приложение XIII, точки 2–4 от Регламента за батериите) е warning. Липсващ идентификатор на организацията за EU DPP Registry (настройка на акаунта) или неразпозната категория батерия също е блокиране. Портативните батерии, стартерните акумулаторни батерии и индустриалните батерии до 2 kWh включително са извън модела на Комисията и не получават finding от тази проверка.

ready е true само когато няма critical findings; warnings никога не блокират готовността. Само паспорти на батерии в тази версия — паспорт, различен от батерия, връща ready: true с единствен REG-READY-SCOPE warning, тъй като формалната проверка на регистъра за други категории все още не е моделирана. Само за четене; брои се като едно v1 четене на паспорт спрямо дневния лимит.

Параметри в пътя

  • idзадължително

    string (24 hex chars)

    ID на паспорта.

Хедъри

  • 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

Заявка

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

Отговор

{
  "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."
    }
  ]
}

Свързани endpoints