TracePass
Inizia ora
Passaporti

Creare il file di caricamento per l'EU DPP Registry

Crea il file XML che l'operatore economico carica sul sito web dell'EU DPP Registry (DPP Registration → upload a file) per i passaporti della batteria che indicate, fino a 100 per chiamata. La registrazione è un atto proprio dell'operatore con il proprio EU Login; TracePass prepara il file e non lo presenta mai.

POST/api/v1/registry/upload-file
Scarica OpenAPI 3.1
POST/api/v1/registry/upload-file

Creare il file di caricamento per l'EU DPP Registry

Crea il file XML che l'operatore economico carica sul sito web dell'EU DPP Registry (DPP Registration → upload a file) per i passaporti della batteria che indicate, fino a 100 per chiamata. La registrazione è un atto proprio dell'operatore con il proprio EU Login; TracePass prepara il file e non lo presenta mai.

Entrano solo i passaporti che supererebbero il controllo. Il registro respinge l'intero file per una sola voce errata, quindi ogni altro passaporto torna in excluded con il suo reason: not_found, not_battery, not_published, registered_in_production, registration_in_progress (in corso di invio a un registro EN 18222), readiness_blocked (i risultati bloccanti sono in details), invalid_upi, duplicate_upi (lo stesso indirizzo di un altro passaporto nel file) o over_limit (oltre il centesimo). included elenca i passaporti nel file, ciascuno con il suo indirizzo.

L'indirizzo di ogni passaporto incluso viene congelato nel passaporto (registryUpi) e la preparazione annotata (registrationPreparedVia: "file"). Salvate xml con il nome filename e caricatelo senza modifiche: il nome usa solo i caratteri che il registro accetta. Una preparazione non è una registrazione: annotate la risposta del registro per ogni passaporto con POST /api/v1/passports/{id}/registration.

La risposta è JSON anziché XML grezzo, così può essere ripetuta con Idempotency-Key e riporta le esclusioni. Solo piani a pagamento (402 su Free). Le chiamate OAuth devono agire per un amministratore o un proprietario. Conta una scrittura v1 per ogni passaporto incluso.

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

  • Idempotency-Key

    string

    UUID v4.

Campi del corpo

  • passportIdsobbligatorio

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

    I passaporti da inserire nel file. Quelli che non supererebbero il controllo tornano in excluded invece di far fallire la chiamata.

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

Richiesta

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"] }'

Risposta

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

Endpoint correlati