--- title: "Annotare l'esito dell'EU DPP Registry per un passaporto della batteria" description: "Annota la risposta dell'EU DPP Registry per un passaporto della batteria: registrazione in produzione o test. Dichiarazione dell'operatore. A pagamento." canonical: "https://www.tracepass.eu/it/docs/record-passport-registration" locale: it source: "https://www.tracepass.eu/it/docs/record-passport-registration" --- # Annotare l'esito dell'EU DPP Registry per un passaporto della batteria > Annota la risposta dell'EU DPP Registry per un passaporto della batteria: registrazione in produzione o test. Dichiarazione dell'operatore. A pagamento. ```http POST /api/v1/passports/{id}/registration ``` 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`. ## Parameters | Name | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `Authorization` | header | string | yes | `Bearer ` — 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. | | `Idempotency-Key` | header | string | no | UUID v4. | | `id` | path | string (24 hex chars) | yes | ID di un passaporto della batteria pubblicato. | | `environment` | body | "production" \| "acceptance" | yes | Da quale ambiente del registro proviene l'esito. `acceptance` è un test senza effetti giuridici. | | `placedOnMarketAt` | body | string (YYYY-MM-DD) | no | Solo produzione. La data di immissione sul mercato. Predefinita: oggi; non nel futuro, non prima della prima pubblicazione del passaporto. | | `registrationId` | body | string (≤ 200 chars) | no | Solo produzione. L'identificativo di registrazione del registro, se lo avete. | | `result` | body | "passed" \| "failed" | no | Solo `acceptance`, e lì obbligatorio. L'esito del test. | | `errorCode` | body | string (≤ 100 chars) | no | Solo `acceptance`. Il codice di errore del registro per un test non superato. | ## Examples ```bash 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" }' ``` ```typescript // What the operator saw on the EU DPP Registry website. const res = await fetch( `https://app.tracepass.eu/api/v1/passports/${id}/registration`, { method: "POST", headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), }, body: JSON.stringify({ environment: "production", placedOnMarketAt: "2027-03-01", registrationId: "URI-000-00-000", }), }, ); if (!res.ok) { const { error } = await res.json(); console.log(error); // e.g. date_in_future, already_registered } else { const { passport } = await res.json(); console.log(passport.placeOnMarketStatus, passport.registrationMode); // "placed" "website" } ``` ```python import os, uuid, requests # A test in the Registry's acceptance environment: no legal effect. res = requests.post( f"https://app.tracepass.eu/api/v1/passports/{passport_id}/registration", headers={ "Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}", "Idempotency-Key": str(uuid.uuid4()), }, json={ "environment": "acceptance", "result": "failed", "errorCode": "SEMANTIC_VALIDATION_UNAVAILABLE", }, ) res.raise_for_status() print(res.json()["passport"]["registryAcceptanceTest"]) ``` ## Responses ### 200 — Produzione annotata ```json { "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" } } ``` ### 200 — Test annotato ```json { "passport": { "_id": "6650b2c3d4e5f6a7b8c9d0e1", "status": "published", "registryAcceptanceTest": { "result": "failed", "errorCode": "SEMANTIC_VALIDATION_UNAVAILABLE", "at": "2026-11-06T10:05:00.000Z" } } } ``` ### 400 — Data respinta ```json { "error": "date_in_future" } ``` ### 409 — Già registrato ```json { "error": "already_registered" } ``` ## Related - [Annullare un'annotazione errata](https://www.tracepass.eu/it/docs/undo-passport-registration.md) - [Ottenere l'indirizzo per il registro](https://www.tracepass.eu/it/docs/passport-registry-upi.md) - [Creare un file di caricamento](https://www.tracepass.eu/it/docs/registry-upload-file.md) - [Leggere un passaporto](https://www.tracepass.eu/it/docs/get-passport.md)