Technisches Register
Datenformate und Schnittstellen
Dies ist das technische Register nach Artikel 26 der Verordnung (EU) 2023/2854. Es beschreibt, wie Ihre Daten strukturiert sind, in welchen Formaten Sie sie mitnehmen können, wie der Anbieterwechsel funktioniert und was noch nicht funktioniert.
Es gehört zu den Informationen, die Sie vor Vertragsschluss erhalten, und es wird aktuell gehalten. Es umfasst Ihr Konto, LabelCheck und ExpertDesk: alles, was Sie uns dort geschickt haben, und alles, was der Dienst für Sie erstellt hat, in den Grenzen, die Abschnitt 5 nennt.
Auf dieser Seite
1. Wie ein Datensatz aussieht
Das sind die Felder, die der Export enthält, eines nach dem anderen.
Ihre Organisation und Ihr Konto, für alle Dienste gleich
| Organisation | Firma, Anschrift, Umsatzsteuer-Identifikationsnummer |
|---|---|
| Personen | E-Mail-Adresse, zugewiesene Rolle, versendete Einladungen und deren Status |
| Guthaben | Käufe, interne Zuweisungen und ein Datensatz je Vorgang mit Datum, Dienst und Menge in Guthabeneinheiten |
| Rechnungen | die Rechnungen, die wir Ihnen ausgestellt haben |
| Einstellungen | Sprache der Oberfläche, Benachrichtigungseinstellungen, Logo Ihrer Organisation, sofern hochgeladen |
| Nachrichten | was Sie uns über das Rückmeldeformular geschickt haben, die angehängten Dateien und unsere Antworten |
LabelCheck, ein Datensatz je Analyse
id | die Kennung der Analyse |
|---|---|
title | der Name, den Sie vergeben haben |
lang | die Sprache, in der sie erstellt wurde |
score | das Ergebnis der Prüfung |
report | der vollständige Bericht als Text |
summary | die Feststellungen in strukturierter Form |
resolved | die von Ihnen als erledigt markierten Feststellungen |
versions | der Verlauf der Fassungen |
chat | das Gespräch über den Bericht, sofern genutzt |
created_at, updated_at | Erstellung und letzte Änderung |
Meldungen, ein Datensatz je Meldung
id | die Kennung der Meldung |
|---|---|
title | der Name, den Sie vergeben haben |
markets | die abgedeckten Märkte |
score | das Ergebnis |
blocking_open | wie viele blockierende Punkte noch offen sind |
report | der strukturierte Bericht |
summary | die Zusammenfassung in strukturierter Form |
documents | die referenzierten Dokumente |
checked | die von Ihnen geprüften Punkte |
versions | der Verlauf der Fassungen |
lang | die Sprache |
created_at, updated_at | Erstellung und letzte Änderung |
ExpertDesk, ein Datensatz je Gespräch
In ExpertDesk lädt jede Person ihre eigenen Daten selbst über das Kontomenü herunter, unter „Meine Daten herunterladen“, wann immer sie will. Der Download ist eine einzige ZIP-Datei. Die JSON-Dateien darin verwenden die Formate aus Abschnitt 2. Jede der vier Dateien mit Ihren Daten hat ein Feld notes: In account.json erklärt es zwei der Felder, in den anderen drei sagt es, wer was geschrieben hat. Jedes Gespräch ist ein Datensatz in conversations.json mit diesen Feldern:
id | die Kennung des Gesprächs |
|---|---|
title | seit dem 19. September 2026 vom KI-System anhand Ihrer ersten Frage geschrieben; ältere Gespräche und solche, deren Titel nicht geschrieben werden konnte, behalten die ersten Wörter der Frage (oder eine Bezeichnung, wenn die Frage nur ein Anhang war); ein Gespräch, das Sie umbenannt haben, behält den Titel, den Sie ihm gegeben haben |
lang | die Sprache des Gesprächs |
mode | wie die Frage gestellt wurde: direct, an die Fachperson Ihrer Wahl, oder auto, wenn ExpertDesk die Fachperson oder das Panel ausgewählt hat; Gespräche, die in früheren Versionen der App begonnen wurden, können außerdem den Wert panel haben, für eine Frage an ein Panel von Fachpersonen, oder label, für das Foto eines Etiketts, das zum Lesen geschickt wurde |
expert, expert_name | die Rolle, die zuerst geantwortet hat, als Code wie cosmetic-chemist, und ihr englischer Name |
messages | jede Nachricht der Reihe nach, mit author (person für Sie, model für das KI-System), expert und expert_name für die Rolle, die geantwortet hat (panel für die Synthese des Panels), content für den Text und at für den Zeitpunkt; wo es erfasst wurde, trägt ein Text des KI-Systems zusätzlich ended (natural_end, length_limit, wenn er seine Höchstlänge erreicht hat und der letzte Teil fehlen kann, oder stopped_before_end), und Ihre Frage trägt routed_experts und experts_without_answer, die Rollen, an die sie ging, und die, die nicht geantwortet haben, als Codes (unknown für eine Rolle, die nicht mehr angeboten wird) |
created_at, updated_at | Erstellung und letzte Änderung |
Die übrigen Dateien des ExpertDesk-Downloads
account.json | Ihre E-Mail-Adresse, Ihr Name, das für Ihren Zugang hinterlegte Unternehmen, wann dieser Zugang in ExpertDesk angelegt wurde, und requested_language, solange eine Zugangsanfrage noch offen ist |
|---|---|
conversations/ | dieselben Gespräche, je eine Markdown-Datei, mit ausgeschriebenen Datumsangaben in der Sprache der App und in UTC |
feedback.json | Ihre Bewertungen von Antworten: rating (up oder down, oder note für eine Nachricht aus dem früheren Feedback-Formular), Ihre Frage, die bewertete Antwort (eine Kopie, die die App mit Ihrer Bewertung gesendet hat), Ihre Notiz, die Rolle, deren Antwort Sie bewertet haben, und conversation_id, leer, wenn dieses Gespräch nicht mehr zu Ihren Gesprächen gehört |
feedback-threads.json | Ihre Nachrichten an das Team: kind (general, oder finding, wenn es um eine Antwort geht), Ihre Nachricht, refers_to und context (von der App ausgefüllt), das Unternehmen Ihres Kontos zu Beginn des Threads, jeder Beitrag mit seinem Verfasser (person, model oder team) und files, jede Datei, die unter dem Thread gespeichert ist (in_a_message false kennzeichnet eine von Ihnen gesendete Datei, deren Nachricht nicht gespeichert wurde) |
attachments/ | die Dateien, die Sie Ihren Nachrichten an das Team angehängt haben, genau so, wie Sie sie gesendet haben |
export.json | was der Download enthält und wie viele Einträge, was er auslässt und warum, und missing_files: jede Datei, die nicht aufgenommen werden konnte, mit dem Grund |
README.md | eine Anleitung zum Download, in der Sprache der App |
2. Die Formate
| Strukturierte Daten und Feststellungen | JSON | RFC 8259, Kodierung UTF-8 |
|---|---|---|
| Berichte und Meldungen | Markdown oder PDF | CommonMark · ISO 32000 |
| Von Ihnen hochgeladene Dateien | unverändert | das Format, in dem Sie sie hochgeladen haben |
| Datum und Uhrzeit | ISO 8601 | UTC |
| Sprachen | zweibuchstabige Codes | ISO 639-1 |
| Märkte und Länder | zweibuchstabige Codes | ISO 3166-1 alpha-2 |
| Namen der Bestandteile | INCI | Artikel 19 Absatz 6 und Artikel 33 der Verordnung (EG) Nr. 1223/2009 |
3. Offene Interoperabilitätsspezifikationen
Die genannten Formate sind offen, veröffentlicht und werden von Software umgesetzt, die nicht von uns stammt. Für nichts aus Ihrem Export brauchen Sie unsere Software: JSON lässt sich mit jedem Werkzeug öffnen, Markdown ist Text, PDF ist eine veröffentlichte ISO-Norm.
Für kosmetikregulatorische Daten gibt es keinen branchenweiten Interoperabilitätsstandard: kein gemeinsames Schema, das ein anderes Compliance-Werkzeug ohne Zuordnung einlesen könnte, und keine Norm, für die sich Konformität erklären ließe. Wir verwenden offene Formate und stabile Feldnamen, damit die Zuordnung beim Empfänger schnell erledigt ist, und wir beantworten die technischen Fragen des Anbieters, den Sie wählen.
4. Wie der Anbieterwechsel abläuft
Fordern Sie ihn schriftlich unter info@cosmetifull.com an. Der Export kostet nichts, kommt in einem Zug und umfasst alle Felder, die in Abschnitt 1 dieser Seite stehen. Wir liefern innerhalb von 14 Werktagen nach der Anforderung. Sie können jederzeit fragen, nicht nur beim Weggang, und so oft Sie wollen. Auf Ihre schriftliche Weisung geben wir denselben Export und dieselben technischen Auskünfte an den Anbieter, den Sie gewählt haben, zu denselben Bedingungen. Ihre Beziehung zu diesem Anbieter bleibt Ihre: Wir helfen Ihnen, wir handeln nicht für ihn. Was nicht mitgeht, sagen wir Ihnen vorher, damit Sie danach planen können. Jeder Schritt eines Wechsels steht mit seinen Fristen im vorvertraglichen Informationsblatt zum Anbieterwechsel, auf Englisch.
5. Was nach unserem Wissen noch nicht funktioniert
Der Export für das ganze Unternehmen kommt auf Anforderung
In ExpertDesk lädt jede Person ihre eigenen Daten selbst über das Kontomenü herunter, wann immer sie will (Abschnitt 1). Für Ihr Konto und LabelCheck gibt es heute keinen Export auf Knopfdruck: Jede Analyse aus Ihrem Archiv und jede gespeicherte Bereitschaftsprüfung können Sie mit ihrem Bericht wieder öffnen und den Bericht drucken oder als PDF speichern. Der vollständige Export Ihrer Organisation, Meldungen und ExpertDesk eingeschlossen, läuft über eine schriftliche Anforderung und die 14 Werktage von oben.
Für den aufnehmenden Anbieter gibt es keine öffentliche Schnittstelle
Der Anbieter, den Sie wählen, bekommt die exportierten Dateien und kann uns technische Fragen zu Strukturen und Formaten stellen. Eine Maschine-zu-Maschine-Schnittstelle gibt es für ihn noch nicht.
Anhänge zu Meldungen werden nicht aufbewahrt
Sie können einer Bereitschaftsprüfung Belege anhängen, und sie gelten als Ihre Erklärung, dass das Dokument existiert. Ihr Inhalt geht nie an das Modell, und keine angehängte Datei wird aufbewahrt, also gibt es unter diesem Punkt nichts zu exportieren. Sollte die Aufbewahrung einmal aktiv werden, gehören angehängte Dateien zum Export, in dem Format, in dem Sie sie hochgeladen haben.
Der Verbrauch wird in Guthabeneinheiten exportiert, nicht in internen Einheiten
Ein Datensatz je Vorgang, mit Datum und Dienst. Die Guthabeneinheit ist die Einheit des Vertrags. Womit wir intern unsere eigenen Kosten messen, hält nichts fest, was Sie erzeugt haben, und gehört deshalb nicht zum Export.
Unsere regulatorische Wissensbasis ist nicht exportierbar
Die Regeln, die Analysemodelle und die Plattform gehören uns. Ihnen gehört alles, was Sie uns geschickt haben, und alles, was der Dienst für Sie erzeugt hat, und genau das nehmen Sie mit.
Was der ExpertDesk-Download auslässt
Dateien, die Sie einer Frage im Chat anhängen, dienen der Antwort und werden nicht aufbewahrt, unter diesem Punkt gibt es also nichts zu exportieren; das Gespräch behält den Text jeder Nachricht. Daten, die für einen einzigen Download zu groß sind, Dateien, die nicht mehr hineinpassen, Daten von vor dem 21. August 2026 ohne Inhaber und Daten unter einer anderen E-Mail-Adresse liefern wir auf schriftliche Anforderung an info@cosmetifull.com. Im Download sagen export.json und das README, was fehlt und warum.
ExpertDesk führt die Arbeit unter der Adresse jeder Person
ExpertDesk speichert die Gespräche, Bewertungen und Nachrichten an das Team unter der E-Mail-Adresse der jeweiligen Person. Ein Export für das ganze Unternehmen enthält deshalb die Arbeit der Personen, die nur zu Ihrer Organisation gehören, ab dem Tag, an dem sie ihr jeweils beigetreten sind; die Arbeit von jemandem, der auch zu einer anderen Organisation gehört, und die Arbeit vor dem Beitritt liefern wir der Person, von der sie stammt.
6. Änderungen an dieser Seite
Wird eine der oben genannten Einschränkungen behoben, ändert sich die Zeile mit ihr, und kommt eine neue hinzu, finden Sie sie zusammen mit den anderen aufgeführt.