TracePass
Inizia ora
Passaporti

Annotare l'esito dell'EU DPP Registry per un passaporto della batteria

Annota ciò che l'operatore economico riporta dal sito web dell'EU DPP Registry per un passaporto della **batteria** pubblicato. TracePass annota la dichiarazione dell'operatore e non la verifica presso il registro. Il corpo ha una di due forme, scelta tramite `environment`.

POST/api/v1/passports/{id}/registration
Scarica OpenAPI 3.1
POST/api/v1/passports/{id}/registration

Annotare l'esito dell'EU DPP Registry per un passaporto della batteria

Annota ciò che l'operatore economico riporta dal sito web dell'EU DPP Registry per un passaporto della **batteria** pubblicato. TracePass annota la dichiarazione dell'operatore e non la verifica presso il registro. Il corpo ha una di due forme, scelta tramite `environment`.

**`environment: "production"`** — il passaporto è registrato nel registro di produzione. Imposta `placeOnMarketStatus: "placed"`, `registrationMode: "website"`, `placedOnMarketAt` e, se lo inviate, `registrationId` (l'identificativo di registrazione del registro, al massimo 200 caratteri). `placedOnMarketAt` è la data di immissione sul mercato nel formato `YYYY-MM-DD`: per impostazione predefinita oggi, non nel futuro e non prima della prima pubblicazione del passaporto. Le parti operatore e stabilimento vengono bloccate (una scrittura su una parte che cambierebbe un identificativo memorizzato risponde 409 `operator_locked`), la copia di riserva del passaporto viene messa in coda e si attiva il webhook `passport.placed_on_market`.

**`environment: "acceptance"`** — un test nell'ambiente di accettazione del registro: `result` è `passed` o `failed`, con il codice di errore del registro in `errorCode` in caso di esito negativo (al massimo 100 caratteri, ad es. `SEMANTIC_VALIDATION_UNAVAILABLE`). Un test non ha effetti giuridici e non cambia nulla nel passaporto tranne `registryAcceptanceTest`.

**Rifiuti:** `400` per un corpo che non supera la validazione o una data respinta (`invalid_date` se non è `YYYY-MM-DD`, `date_in_future`, `date_before_publication`, `registration_id_too_long`); `409` per `not_a_battery`, `not_published` o, per la produzione, `already_registered` (il passaporto è già immesso sul mercato o in corso di invio a un registro EN 18222). Un'annotazione errata si annulla con `DELETE /api/v1/passports/{id}/registration`.

**Solo piani a pagamento** (`402` su Free). Le chiamate OAuth devono agire per un amministratore o un proprietario. Restituisce il passaporto dopo l'annotazione. Conta come una scrittura v1, e solo quando la chiamata riesce. Rispetta `Idempotency-Key`.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID di un passaporto della batteria pubblicato.

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

  • environmentobbligatorio

    "production" | "acceptance"

    Da quale ambiente del registro proviene l'esito. `acceptance` è un test senza effetti giuridici.

    e.g. production

  • placedOnMarketAt

    string (YYYY-MM-DD)

    Solo produzione. La data di immissione sul mercato. Predefinita: oggi; non nel futuro, non prima della prima pubblicazione del passaporto.

    e.g. 2027-03-01

  • registrationId

    string (≤ 200 chars)

    Solo produzione. L'identificativo di registrazione del registro, se lo avete.

    e.g. URI-000-00-000

  • result

    "passed" | "failed"

    Solo `acceptance`, e lì obbligatorio. L'esito del test.

    e.g. failed

  • errorCode

    string (≤ 100 chars)

    Solo `acceptance`. Il codice di errore del registro per un test non superato.

    e.g. SEMANTIC_VALIDATION_UNAVAILABLE

Richiesta

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registration \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9e3b6c28-1f7a-4d52-b0e4-6a8c2d1f5b97" \
  -d '{ "environment": "production", "placedOnMarketAt": "2027-03-01", "registrationId": "URI-000-00-000" }'

Risposta

{
  "passport": {
    "_id": "6650b2c3d4e5f6a7b8c9d0e1",
    "status": "published",
    "placeOnMarketStatus": "placed",
    "registrationMode": "website",
    "placedOnMarketAt": "2027-03-01T00:00:00.000Z",
    "registrationId": "URI-000-00-000",
    "registryUpi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3",
    "registrationPreparedAt": "2027-02-26T09:12:00.000Z",
    "registrationPreparedVia": "form"
  }
}

Endpoint correlati