Registro tecnico
Formati dei dati e interfacce
Questo è il registro tecnico richiesto dall’articolo 26 del regolamento (UE) 2023/2854. Descrive come sono strutturati i tuoi dati, in quali formati puoi portarli via, come funziona il passaggio e cosa non funziona ancora.
Fa parte delle informazioni che ricevi prima di concludere il contratto con noi, ed è tenuto aggiornato. Riguarda il tuo account, LabelCheck ed ExpertDesk: tutto quello che ci hai inviato attraverso di loro e tutto quello che il servizio ha prodotto per te, nei limiti indicati al punto 5.
In questa pagina
1. Com’è fatta una scheda
Sono i campi che trovi nell’esportazione, uno per uno.
La tua organizzazione e il tuo account, comuni a ogni servizio
| Organizzazione | ragione sociale, indirizzo, numero di identificazione IVA |
|---|---|
| Persone | indirizzo email, ruolo assegnato, inviti emessi e stato di ciascuno |
| Crediti | acquisti, assegnazioni interne e una scheda per operazione con data, servizio e quantità in crediti |
| Fatture | le fatture che ti abbiamo emesso |
| Impostazioni | lingua dell’interfaccia, preferenze di notifica, logo dell’organizzazione se l’hai caricato |
| Messaggi | quello che ci hai inviato dal modulo di feedback, i file allegati e le nostre risposte |
LabelCheck, una scheda per analisi
id | l’identificativo dell’analisi |
|---|---|
title | il nome che le hai dato |
lang | la lingua in cui è stata prodotta |
score | il risultato del controllo |
report | il referto completo, come testo |
summary | i rilievi in forma strutturata |
resolved | i rilievi che hai segnato come risolti |
versions | la storia delle versioni |
chat | la conversazione sul referto, quando l’hai usata |
created_at, updated_at | creazione e ultima modifica |
Dichiarazioni, una scheda per dichiarazione
id | l’identificativo della dichiarazione |
|---|---|
title | il nome che le hai dato |
markets | i mercati che copre |
score | il risultato |
blocking_open | quanti punti bloccanti restano aperti |
report | il referto strutturato |
summary | la sintesi in forma strutturata |
documents | i documenti che richiama |
checked | i punti che hai verificato |
versions | la storia delle versioni |
lang | la lingua |
created_at, updated_at | creazione e ultima modifica |
ExpertDesk, una scheda per conversazione
In ExpertDesk ogni persona scarica i propri dati dal menu dell’account, alla voce «Scarica i miei dati», quando vuole, e riceve un unico file ZIP. I file JSON che contiene usano i formati del punto 2. Ognuno dei quattro file con i tuoi dati ha un campo notes: in account.json spiega due dei campi, negli altri tre dice chi ha scritto cosa. Ogni conversazione è una scheda di conversations.json, con questi campi:
id | l’identificativo della conversazione |
|---|---|
title | dal 19 settembre 2026 lo scrive il sistema di IA a partire dalla tua prima domanda; le conversazioni di prima, e quelle il cui titolo non si è potuto scrivere, tengono le prime parole della domanda (o un’etichetta, quando la domanda era solo un allegato); una conversazione che hai rinominato tiene il titolo che le hai dato |
lang | la lingua della conversazione |
mode | come è stata inviata la domanda: direct, all’esperto che hai scelto tu, oppure auto, quando a scegliere l’esperto o il panel è stato ExpertDesk; le conversazioni avviate con le versioni precedenti dell’app possono riportare anche panel, per una domanda posta a un panel di esperti, oppure label, per la foto di un’etichetta inviata da leggere |
expert, expert_name | il ruolo che ha risposto per primo, come codice (per esempio cosmetic-chemist), e il suo nome in inglese |
messages | ogni messaggio in ordine, con author (person per te, model per il sistema di IA), expert ed expert_name per il ruolo che ha risposto (panel per la sintesi del panel), content per il testo e at per la data e l’ora; dove è stato registrato, un testo del sistema di IA porta anche ended (natural_end, length_limit quando ha raggiunto la lunghezza massima e l’ultima parte può mancare, oppure stopped_before_end), e la tua domanda porta routed_experts ed experts_without_answer, i ruoli a cui è stata mandata e quelli che non hanno risposto, come codici (unknown per un ruolo che non è più offerto) |
created_at, updated_at | creazione e ultima modifica |
Gli altri file dello ZIP di ExpertDesk
account.json | il tuo indirizzo email, il tuo nome, l’azienda registrata per il tuo accesso, quando questo accesso è stato creato in ExpertDesk, e requested_language finché una richiesta di accesso è ancora aperta |
|---|---|
conversations/ | le stesse conversazioni, un file Markdown per ciascuna, con le date scritte per esteso nella lingua dell’app e in UTC |
feedback.json | le tue valutazioni delle risposte: rating (up o down, oppure note per un messaggio inviato col vecchio modulo di riscontro), la tua domanda, la risposta valutata (una copia che l’app ha inviato insieme alla tua valutazione), la tua nota, il ruolo di cui hai valutato la risposta, e conversation_id, vuoto quando quella conversazione non è più fra le tue |
feedback-threads.json | i tuoi messaggi al Team: kind (general, oppure finding quando il messaggio riguarda una risposta), il tuo messaggio, refers_to e context (compilati dall’app), l’azienda del tuo account quando è nata la discussione, ogni intervento col suo autore (person, model o team), e files, ogni file conservato nella discussione (in_a_message false indica un file che hai inviato il cui messaggio non è stato salvato) |
attachments/ | i file che hai allegato ai tuoi messaggi al Team, identici a come li hai inviati |
export.json | cosa contiene lo ZIP e quante voci, cosa lascia fuori e perché, e missing_files: ogni file che non è stato possibile includere, con il motivo |
README.md | una guida al contenuto dello ZIP, nella lingua dell’app |
2. I formati
| Dati strutturati e rilievi | JSON | RFC 8259, codifica UTF-8 |
|---|---|---|
| Referti e dichiarazioni | Markdown o PDF | CommonMark · ISO 32000 |
| File che hai caricato | invariato | il formato in cui li hai caricati |
| Date e orari | ISO 8601 | UTC |
| Lingue | codici a due lettere | ISO 639-1 |
| Mercati e paesi | codici a due lettere | ISO 3166-1 alpha-2 |
| Nomi degli ingredienti | INCI | articoli 19, paragrafo 6, e 33 del regolamento (CE) n. 1223/2009 |
3. Specifiche di interoperabilità aperte
I formati qui sopra sono aperti, pubblicati e implementati da software che non abbiamo scritto noi. Niente di quello che esporti ha bisogno del nostro software per essere letto: il JSON si apre con qualunque strumento, il Markdown è testo, il PDF è uno standard ISO pubblicato.
Per i dati regolatori cosmetici non esiste uno standard di interoperabilità di settore: nessuno schema comune che un altro strumento di conformità possa importare senza una mappatura, e nessuno standard a cui dichiarare conformità. Usiamo formati aperti e nomi di campo stabili, così la mappatura è un lavoro breve per chi li riceve, e rispondiamo alle domande tecniche del fornitore che scegli.
4. Come funziona il passaggio
Chiedicelo per iscritto a info@cosmetifull.com. L’esportazione è gratuita, si consegna in un’unica soluzione e copre tutti i campi elencati al punto 1 di questa pagina. Consegniamo entro 14 giorni lavorativi dalla richiesta. Puoi chiederla in qualsiasi momento, non solo quando esci, e tutte le volte che ti serve. Su tua istruzione scritta mettiamo la stessa esportazione e le stesse risposte tecniche a disposizione del fornitore che hai scelto, alle stesse condizioni. Il rapporto con quel fornitore resta tuo: assistiamo te, non agiamo per lui. Ti diciamo in anticipo cosa non si trasferisce, così puoi pianificare. Ogni passo di un passaggio, con le sue date, è descritto nella scheda precontrattuale sul passaggio a un altro fornitore.
5. Cosa sappiamo che non funziona ancora
L’esportazione di tutta l’azienda si consegna su richiesta
In ExpertDesk ogni persona scarica i propri dati dal menu dell’account, quando vuole (punto 1). Per il tuo account e per LabelCheck oggi non c’è un’esportazione self-service: puoi riaprire ogni analisi del tuo archivio e ogni verifica di prontezza che hai salvato, ciascuna col suo referto, e stamparlo o salvarlo in PDF. L’esportazione completa della tua organizzazione, dichiarazioni ed ExpertDesk compresi, passa da una richiesta scritta e dai 14 giorni lavorativi qui sopra.
Non c’è un’interfaccia pubblica per il fornitore che riceve i dati
Il fornitore che scegli riceve i file esportati e può farci domande tecniche su strutture e formati. Per lui non esiste ancora un’interfaccia da macchina a macchina.
Gli allegati alle dichiarazioni non si conservano
Puoi allegare documenti di supporto a una verifica di prontezza, e valgono come tua dichiarazione che quel documento esiste: il loro contenuto non passa mai al modello, e nessun file allegato viene conservato, quindi sotto questa voce non c’è niente da esportare. Se la conservazione diventerà attiva, i file allegati faranno parte dell’esportazione nel formato in cui li hai caricati.
I consumi si esportano in crediti, non in unità interne
Una scheda per operazione, con data e servizio. Il credito è l’unità del contratto. La misurazione interna con cui calcoliamo i nostri costi non è la registrazione di qualcosa che hai prodotto tu, e non fa parte dell’esportazione.
La nostra base di conoscenza regolatoria non è esportabile
Le regole, i modelli di analisi e la piattaforma sono nostri. Tuo è tutto quello che ci hai inviato e tutto quello che il servizio ha prodotto per te, ed è quello che porti via.
Cosa resta fuori dallo ZIP di ExpertDesk
I file che alleghi a una domanda nella chat servono per risponderti e non vengono conservati, quindi sotto questa voce non c’è niente da esportare; la conversazione tiene il testo di ogni messaggio. I dati troppo grandi per un solo file ZIP, i file che non ci stanno, i dati di prima del 21 agosto 2026 senza un titolare e quelli conservati sotto un altro indirizzo email si consegnano su richiesta scritta a info@cosmetifull.com. Dentro lo ZIP, export.json e il README dicono cosa resta fuori, e perché.
ExpertDesk tiene il lavoro sotto l’indirizzo di ogni persona
ExpertDesk registra le conversazioni, le valutazioni e i messaggi al Team di ogni persona sotto il suo indirizzo email. Per questo l’esportazione di tutta l’azienda contiene il lavoro delle persone che fanno parte solo della tua organizzazione, dal giorno in cui ciascuna vi è entrata; il lavoro di chi fa parte anche di un’altra organizzazione, come pure quello fatto prima di entrare, si consegna alla persona che lo ha fatto.
6. Modifiche a questa pagina
Quando una limitazione qui sopra si chiude, cambia anche la riga, e se ne compare una nuova la trovi elencata insieme alle altre.