Assistente normativo
Endpoint di dati normativi per il DPP Assistant — campi obbligatori per categoria, modifiche normative, indicazioni sul registro e profilo conformità.
/api/v1/regulatory/required-fieldsOttieni campi obbligatori
Restituisce i campi obbligatori e previsti per un passaporto della categoria indicata, con l'articolo del regolamento UE su cui si basa ogni campo, il suo livello di accesso (public / restricted / authority) e — per le batterie — se i dati sono solitamente detenuti dal produttore, da un fornitore o dall'operatore. Senza `group` restituisce un riepilogo: conteggi totali per gruppo e livello di accesso, più `requiredByHolder` (solo batterie). Con `group` — l'elenco completo dei campi per quel gruppo.
/api/v1/regulatory/changesOttieni modifiche normative
Restituisce voci di modifiche normative curate per le categorie richieste, filtrate a quelle con data uguale o successiva a `since`. Ogni voce porta un `kind` (`adopted`, `amended`, `date_moved`, `standard_published`, `standard_cited`, `applies_from`, …), lo strumento o standard interessato, le categorie interessate, un riepilogo in linguaggio semplice (nella lingua della risposta) e un URL della fonte primaria. L'array `data.upcoming` elenca obblighi DPP datati e atti pianificati nei prossimi 90 giorni.
/api/v1/regulatory/registry-guidanceOttieni indicazioni sul registro
Restituisce punti di guida curati per il topic richiesto. Ogni punto porta un `point` (un'affermazione in linguaggio semplice), un `detail` (spiegazione più dettagliata), una `source` con URL e kind (`commission` / `standard` / `law` / `our_finding`) e una `sourceDate`. I punti delle linee guida della Commissione sono etichettati 'Indicazione della Commissione, non legge'; i punti di ricerca TracePass — 'TracePass research, not law'. `stillMoving` è true finché la Commissione non ha finalizzato la procedura di registro.
/api/v1/company/compliance-profileOttieni profilo di conformità
Restituisce il profilo di conformità aziendale memorizzato e il suo timestamp `updatedAt`. Il profilo contiene dati aziendali usati come predefiniti dagli strumenti del DPP Assistant — `role`, `ownBrand`, `categories`, `markets`, `products`, `sizeBand`, `salesChannels` e `dataSystems`. Quando il profilo non è impostato, la risposta è `{ "complianceProfile": {} }`. Il profilo contiene solo dati aziendali: non memorizza mai dati personali sugli utenti.
/api/v1/company/compliance-profileAggiorna profilo conformità
Unisce i campi forniti nel profilo di conformità memorizzato e restituisce il profilo aggiornato con `updatedAt`. I campi non inclusi nella richiesta rimangono invariati. Impostate un campo su `null` per rimuoverlo. Campi validati: `role`, `ownBrand`, `categories`, `markets`, `products` (array, max 50), `sizeBand`, `salesChannels`, `dataSystems` (stringa, max 200 caratteri). Un valore non valido restituisce 400 `invalid_input`.
/api/v1/company/compliance-profileElimina profilo conformità
Rimuove l'intero sotto-documento `complianceProfile` dal record aziendale, inclusi tutti i dati memorizzati (ruolo, categorie, mercati, prodotti e tutti i valori appresi). Restituisce `{ "deleted": true }` in caso di successo. Dopo l'eliminazione, `GET /api/v1/company/compliance-profile` restituisce un profilo vuoto. Gli strumenti del DPP Assistant non avranno più predefiniti salvati.