Technický registr
Formáty dat a rozhraní
Toto je technický registr vyžadovaný článkem 26 nařízení (EU) 2023/2854. Popisuje, jak jsou vaše data strukturovaná, v jakých formátech si je můžete odnést, jak funguje změna poskytovatele a co zatím nefunguje.
Patří k informacím, které od nás dostáváte ještě před uzavřením smlouvy, a udržujeme ho aktuální. Týká se vašeho účtu a aplikací LabelCheck a ExpertDesk: všeho, co jste nám jejich prostřednictvím poslali, i všeho, co pro vás služba vytvořila, v mezích popsaných v části 5.
Na této stránce
1. Jak vypadá záznam
Toto jsou pole, která export obsahuje, jedno po druhém.
Vaše organizace a účet, společné pro každou službu
| Organizace | úřední název, adresa, identifikační číslo pro DPH |
|---|---|
| Osoby | e-mailová adresa, přidělená role, odeslané pozvánky a stav každé z nich |
| Kredity | nákupy, interní přidělení a jeden záznam ke každé operaci s datem, službou a počtem kreditů |
| Faktury | faktury, které jsme vám vystavili |
| Nastavení | jazyk rozhraní, nastavení oznámení, logo vaší organizace, pokud jste ho nahráli |
| Komunikace | co jste nám poslali přes formulář zpětné vazby, soubory k němu připojené a naše odpovědi |
LabelCheck, jeden záznam ke každé analýze
id | identifikátor analýzy |
|---|---|
title | název, který jste jí dali |
lang | jazyk, ve kterém analýza vznikla |
score | výsledek kontroly |
report | úplná zpráva v textové podobě |
summary | zjištění ve strukturované podobě |
resolved | zjištění, která jste označili jako vyřešená |
versions | historie verzí |
chat | konverzace o zprávě, pokud jste ji vedli |
created_at, updated_at | vytvoření a poslední změna |
Prohlášení, jeden záznam ke každému prohlášení
id | identifikátor prohlášení |
|---|---|
title | název, který jste mu dali |
markets | trhy, kterých se týká |
score | výsledek |
blocking_open | kolik blokujících bodů zůstává otevřených |
report | strukturovaná zpráva |
summary | shrnutí ve strukturované podobě |
documents | dokumenty, na které odkazuje |
checked | body, které jste odškrtli |
versions | historie verzí |
lang | jazyk |
created_at, updated_at | vytvoření a poslední změna |
ExpertDesk, jeden záznam ke každé konverzaci
V aplikaci ExpertDesk si každá osoba stahuje svá data sama z nabídky účtu, pod položkou „Stáhnout moje data“, kdykoli chce. Stažený soubor je jeden archiv ZIP. Jeho soubory JSON používají formáty z části 2. Každý ze čtyř souborů s vašimi daty má pole notes: v account.json vysvětluje dvě z jeho polí a v ostatních třech říká, kdo co napsal. Každá konverzace je jeden záznam v souboru conversations.json s těmito poli:
id | identifikátor konverzace |
|---|---|
title | od 19. září 2026 ho píše systém AI podle vaší první otázky; starší konverzace a ty, jejichž název se nepodařilo napsat, si ponechávají první slova otázky (nebo štítek, pokud otázka byla jen příloha); konverzace, kterou jste přejmenovali, si ponechává název, který jste jí dali |
lang | jazyk konverzace |
mode | jak byla otázka položena: direct, odborníkovi, kterého jste si vybrali, nebo auto, když odborníka nebo panel vybral ExpertDesk; konverzace zahájené ve starších verzích aplikace mohou nést také panel, u otázky položené panelu odborníků, nebo label, u fotografie etikety odeslané k přečtení |
expert, expert_name | role, která odpověděla jako první, v podobě kódu, například cosmetic-chemist, a její anglický název |
messages | každá zpráva v pořadí, s poli author (person pro vás, model pro systém AI), expert a expert_name pro roli, která odpověděla (panel pro shrnutí panelu), content pro text a at pro datum a čas; tam, kde se to zaznamenalo, nese text systému AI navíc pole ended (natural_end, length_limit, když dosáhl maximální délky a poslední část může chybět, nebo stopped_before_end) a vaše otázka nese pole routed_experts a experts_without_answer, tedy role, kterým byla poslána, a ty, které neodpověděly, jako kódy (unknown pro roli, kterou už nenabízíme) |
created_at, updated_at | vytvoření a poslední změna |
Ostatní soubory ve staženém archivu aplikace ExpertDesk
account.json | vaše e-mailová adresa, vaše jméno, společnost zaznamenaná pro váš přístup, kdy byl tento přístup v aplikaci ExpertDesk vytvořen, a requested_language, dokud je žádost o přístup ještě otevřená |
|---|---|
conversations/ | tytéž konverzace, každá v samostatném souboru Markdown, s datem a časem zapsanými v plném tvaru v jazyce aplikace a v UTC |
feedback.json | vaše hodnocení odpovědí: rating (up nebo down, případně note u zprávy odeslané dřívějším formulářem zpětné vazby), vaše otázka, hodnocená odpověď (kopie, kterou aplikace poslala spolu s vaším hodnocením), vaše poznámka, role, jejíž odpověď jste hodnotili, a conversation_id, prázdné, pokud ta konverzace už mezi vašimi není |
feedback-threads.json | vaše zprávy týmu: kind (general, nebo finding, když se zpráva týká odpovědi), vaše zpráva, refers_to a context (vyplňuje je aplikace), společnost vašeho účtu v době, kdy vlákno vzniklo, každý příspěvek s autorem (person, model nebo team) a files, tedy každý soubor uložený pod vláknem (in_a_message false označuje soubor, který jste poslali, ale jehož zpráva se neuložila) |
attachments/ | soubory, které jste přiložili ke zprávám týmu, přesně tak, jak jste je odeslali |
export.json | co stažený archiv obsahuje a kolik položek, co v něm není a proč, a missing_files: každý soubor, který se nepodařilo zahrnout, s důvodem |
README.md | průvodce staženým archivem v jazyce aplikace |
2. Formáty
| Strukturovaná data a zjištění | JSON | RFC 8259, kódování UTF-8 |
|---|---|---|
| Zprávy a prohlášení | Markdown nebo PDF | CommonMark · ISO 32000 |
| Soubory, které jste nahráli | beze změny | formát, ve kterém jste je nahráli |
| Datum a čas | ISO 8601 | UTC |
| Jazyky | dvoupísmenné kódy | ISO 639-1 |
| Trhy a země | dvoupísmenné kódy | ISO 3166-1 alpha-2 |
| Názvy přísad | INCI | čl. 19 odst. 6 a čl. 33 nařízení (ES) č. 1223/2009 |
3. Otevřené specifikace interoperability
Formáty uvedené výše jsou otevřené, zveřejněné a implementované v softwaru, který jsme nepsali my. Nic z toho, co si vyexportujete, nepotřebuje ke čtení náš software: JSON otevřete v jakémkoli nástroji, Markdown je text a PDF je zveřejněná norma ISO.
Pro kosmetické regulatorní záznamy žádný oborový standard interoperability neexistuje: není společné schéma, které by jiný nástroj pro regulatorní shodu mohl importovat bez mapování, ani norma, se kterou by šlo prohlásit shodu. Používáme otevřené formáty a stabilní názvy polí, aby mapování bylo pro příjemce krátká práce, a na technické dotazy poskytovatele, kterého si vyberete, odpovídáme.
4. Jak funguje změna poskytovatele
Požádejte nás písemně na info@cosmetifull.com. Export je zdarma, předáváme ho najednou a pokrývá všechna pole vyjmenovaná v části 1 této stránky. Dodáme ho do 14 pracovních dnů od žádosti. Požádat můžete kdykoli, nejen když odcházíte, a tolikrát, kolikrát potřebujete. Na váš písemný pokyn zpřístupníme stejný export a stejné technické odpovědi poskytovateli, kterého jste si vybrali, za stejných podmínek. Vztah s tímto poskytovatelem zůstává váš: pomáháme vám, nejednáme za něj. Předem vám řekneme, co se nepřenáší, abyste s tím mohli počítat. Každý krok změny i s daty popisuje předsmluvní informační list o změně poskytovatele, v angličtině.
5. Co víme, že zatím nefunguje
Export za celou firmu předáváme na žádost
V aplikaci ExpertDesk si každá osoba stahuje svá data sama z nabídky účtu, kdykoli chce (část 1). Pro váš účet a aplikaci LabelCheck dnes samoobslužný export není: každou analýzu ze svého archivu i každou uloženou kontrolu připravenosti si můžete znovu otevřít i s její zprávou a zprávu vytisknout nebo uložit jako PDF. Úplný export celé vaší organizace, včetně prohlášení a dat z aplikace ExpertDesk, jde přes písemnou žádost a přes zmíněných 14 pracovních dnů.
Pro přijímajícího poskytovatele neexistuje veřejné API
Poskytovatel, kterého si vyberete, dostane vyexportované soubory a může nám klást technické dotazy ke strukturám a formátům. Rozhraní mezi stroji pro něj zatím nemáme.
Přílohy k prohlášením se neuchovávají
Ke kontrole připravenosti můžete připojit podpůrné dokumenty a berou se jako vaše tvrzení, že takový dokument existuje: jejich obsah se modelu nikdy nepředává a žádný připojený soubor se neuchovává, takže pod touto položkou není co exportovat. Pokud se uchovávání zapne, připojené soubory budou součástí exportu ve formátu, ve kterém jste je nahráli.
Spotřebu exportujeme v kreditech, ne ve vnitřních jednotkách
Jeden záznam ke každé operaci, s datem a službou. Kredity jsou jednotkou smlouvy. Vnitřní měření, kterým si oceňujeme vlastní náklady, není záznamem ničeho, co jste vytvořili, a do exportu nepatří.
Naši regulatorní znalostní bázi nelze exportovat
Pravidla, analytické modely a platforma jsou naše. Vaše je všechno, co jste nám poslali, a všechno, co pro vás služba vytvořila, a přesně to si odnášíte.
Co stažený archiv aplikace ExpertDesk vynechává
Soubory, které přikládáte k otázce v chatu, slouží k odpovědi a neukládají se, takže pod touto položkou není co exportovat; konverzace si ponechává text každé zprávy. Data příliš velká na jedno stažení, soubory, které se do něj nevejdou, údaje z doby před 21. srpnem 2026 bez vlastníka a údaje vedené pod jinou e-mailovou adresou dodáme na písemnou žádost zaslanou na info@cosmetifull.com. Ve staženém archivu uvádějí export.json a README, co v něm není a proč.
ExpertDesk vede práci pod adresou každé osoby
ExpertDesk ukládá konverzace, hodnocení a zprávy pro tým pod e-mailovou adresou příslušné osoby. Export za celou firmu proto obsahuje práci lidí, kteří patří jen do vaší organizace, ode dne, kdy do ní každý z nich vstoupil; práci někoho, kdo patří i do jiné organizace, a práci z doby před vstupem předáme tomu, kdo ji odvedl.
6. Změny na této stránce
Když se některé z omezení uvedených výše uzavře, změní se s ním i jeho řádek, a pokud přibude nové, najdete ho vypsané vedle ostatních.