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

Файл за качване в EU DPP Registry за паспорти на батерии

Създава XML файла, който икономическият оператор качва на уебсайта на EU DPP Registry (DPP Registration → upload a file), за посочените от вас паспорти на батерии, до 100 на извикване. Регистрацията е собствено действие на оператора със собствения му EU Login; TracePass подготвя файла и никога не го подава.

POST/api/v1/registry/upload-file
Изтегли OpenAPI 3.1
POST/api/v1/registry/upload-file

Файл за качване в EU DPP Registry за паспорти на батерии

Създава XML файла, който икономическият оператор качва на уебсайта на EU DPP Registry (DPP Registration → upload a file), за посочените от вас паспорти на батерии, до 100 на извикване. Регистрацията е собствено действие на оператора със собствения му EU Login; TracePass подготвя файла и никога не го подава.

Влизат само паспортите, които биха преминали. Регистърът отхвърля целия файл заради един грешен запис, затова всеки друг паспорт се връща в excluded с reason: not_found, not_battery, not_published, registered_in_production, registration_in_progress (в процес на изпращане към регистър по EN 18222), readiness_blocked (блокиращите констатации са в details), invalid_upi, duplicate_upi (същият адрес като на друг паспорт във файла) или over_limit (след 100-ия). included изброява паспортите във файла, всеки със своя адрес.

Адресът на всеки включен паспорт се фиксира в паспорта (registryUpi) и подготовката се записва (registrationPreparedVia: "file"). Запазете xml под името filename и го качете непроменен: името съдържа само знаците, които регистърът приема. Подготовката не е регистрация: запишете отговора на регистъра за всеки паспорт с POST /api/v1/passports/{id}/registration.

Отговорът е JSON, а не директно XML, за да може да се повтори с Idempotency-Key и да съдържа изключените паспорти. Само за платени планове (402 при Free). OAuth извикванията трябва да са от името на администратор или собственик. Брои се по едно v1 записване за всеки включен паспорт.

Хедъри

  • 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

  • Idempotency-Key

    string

    UUID v4.

Полета в тялото

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

    string[] (24 hex chars each, 1–100)

    Паспортите, които да влязат във файла. Паспортите, които не биха преминали, се връщат в excluded, вместо извикването да се провали.

    e.g. ["6650b2c3d4e5f6a7b8c9d0e1", "6650b2c3d4e5f6a7b8c9d0e2"]

Заявка

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/registry/upload-file \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5a8d2f17-9c4e-4b3a-8e61-0f2c7d9b4e35" \
  -d '{ "passportIds": ["6650b2c3d4e5f6a7b8c9d0e1", "6650b2c3d4e5f6a7b8c9d0e2"] }'

Отговор

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n…",
  "filename": "acme-batteries-dpp-registry-batch-2026-11-06.xml",
  "included": [
    {
      "id": "6650b2c3d4e5f6a7b8c9d0e1",
      "upi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3"
    }
  ],
  "excluded": [
    {
      "id": "6650b2c3d4e5f6a7b8c9d0e2",
      "reason": "readiness_blocked",
      "details": [
        "Required field \"Battery Carbon Footprint — Total\" has no value."
      ]
    }
  ]
}

Свързани endpoints