Technisch register
Gegevensformaten en interfaces
Dit is het technische register dat artikel 26 van Verordening (EU) 2023/2854 voorschrijft. Het beschrijft hoe je gegevens gestructureerd zijn, in welke formaten je ze meeneemt, hoe overstappen werkt en wat nog niet werkt.
Het hoort bij de informatie die je krijgt voordat je met ons een overeenkomst sluit, en we houden het bij. Het gaat over je account, LabelCheck en ExpertDesk: alles wat je ons via die drie hebt gestuurd en alles wat de dienst voor je heeft gemaakt, binnen de grenzen die punt 5 noemt.
Op deze pagina
1. Hoe een record eruitziet
Dit zijn de velden die de export bevat, stuk voor stuk.
Je organisatie en je account, gelijk voor elke dienst
| Organisatie | statutaire naam, adres, btw-identificatienummer |
|---|---|
| Personen | e-mailadres, toegewezen rol, verstuurde uitnodigingen en de status van elke uitnodiging |
| Tegoeden | aankopen, interne toewijzingen en één record per verrichting, met datum, dienst en aantal tegoeden |
| Facturen | de facturen die wij je hebben gestuurd |
| Instellingen | taal van de interface, meldingsvoorkeuren, het logo van je organisatie als je dat hebt geüpload |
| Berichten | wat je ons via het reactieformulier stuurde, de bestanden die je eraan hing en onze antwoorden |
LabelCheck, één record per analyse
id | de id van de analyse |
|---|---|
title | de naam die je eraan gaf |
lang | de taal waarin de analyse is gemaakt |
score | de uitkomst van de controle |
report | het volledige rapport, als tekst |
summary | de bevindingen in gestructureerde vorm |
resolved | de bevindingen die je als opgelost hebt gemarkeerd |
versions | de geschiedenis van de versies |
chat | het gesprek over het rapport, als je dat hebt gebruikt |
created_at, updated_at | aanmaak en laatste wijziging |
Verklaringen, één record per verklaring
id | de id van de verklaring |
|---|---|
title | de naam die je eraan gaf |
markets | de markten die ze bestrijkt |
score | de uitkomst |
blocking_open | hoeveel blokkerende punten nog openstaan |
report | het gestructureerde rapport |
summary | de samenvatting in gestructureerde vorm |
documents | de documenten waarnaar ze verwijst |
checked | de punten die je hebt afgevinkt |
versions | de geschiedenis van de versies |
lang | de taal |
created_at, updated_at | aanmaak en laatste wijziging |
ExpertDesk, één record per gesprek
In ExpertDesk downloadt iedere persoon de eigen gegevens zelf via het accountmenu, onder “Mijn gegevens downloaden”, wanneer die maar wil. De download is één ZIP-bestand. De JSON-bestanden erin gebruiken de formaten uit punt 2. Elk van de vier bestanden met je gegevens heeft een veld notes: in account.json legt het twee van de velden uit, en in de andere drie zegt het wie wat heeft geschreven. Elk gesprek is één record in conversations.json, met deze velden:
id | de id van het gesprek |
|---|---|
title | sinds 19 september 2026 geschreven door het AI-systeem op basis van je eerste vraag; oudere gesprekken, en gesprekken waarvan de titel niet geschreven kon worden, houden de eerste woorden van de vraag (of een label, als de vraag alleen een bijlage was); een gesprek dat je hebt hernoemd, houdt de titel die je het gaf |
lang | de taal van het gesprek |
mode | hoe de vraag is gesteld: direct, aan de expert die je koos, of auto, als ExpertDesk de expert of het panel koos; bij gesprekken die in eerdere versies van de app zijn begonnen kan er ook panel staan, voor een vraag aan een panel van experts, of label, voor een foto van een etiket die is ingestuurd om gelezen te worden |
expert, expert_name | de rol die als eerste antwoordde, als code zoals cosmetic-chemist, en de Engelse naam ervan |
messages | elk bericht op volgorde, met author (person voor jou, model voor het AI-systeem), expert en expert_name voor de rol die antwoordde (panel voor de synthese van het panel), content voor de tekst en at voor het tijdstip; waar dat is vastgelegd, draagt een tekst van het AI-systeem ook ended (natural_end, length_limit als hij zijn maximale lengte bereikte en het laatste deel kan ontbreken, of stopped_before_end), en je vraag draagt routed_experts en experts_without_answer, de rollen waarnaar hij is doorgestuurd en de rollen die niet antwoordden, als codes (unknown voor een rol die niet meer wordt aangeboden) |
created_at, updated_at | aanmaak en laatste wijziging |
De andere bestanden in de ExpertDesk-download
account.json | je e-mailadres, je naam, het bedrijf dat bij je toegang is vastgelegd, wanneer deze toegang in ExpertDesk is aangemaakt, en requested_language zolang een toegangsverzoek nog openstaat |
|---|---|
conversations/ | dezelfde gesprekken, één Markdown-bestand per gesprek, met de datums voluit geschreven in de taal van de app en in UTC |
feedback.json | je beoordelingen van antwoorden: rating (up of down, of note voor een bericht dat je met het vroegere feedbackformulier stuurde), je vraag, het beoordeelde antwoord (een kopie die de app met je beoordeling meestuurde), je notitie, de rol waarvan je het antwoord beoordeelde, en conversation_id, leeg als dat gesprek niet meer bij jouw gesprekken hoort |
feedback-threads.json | je berichten aan het team: kind (general, of finding als het bericht over een antwoord gaat), je bericht, refers_to en context (ingevuld door de app), het bedrijf van je account toen de draad begon, elke beurt met de schrijver ervan (person, model of team), en files, elk bestand dat onder de draad is bewaard (in_a_message false markeert een bestand dat je stuurde maar waarvan het bericht niet is opgeslagen) |
attachments/ | de bestanden die je bij je berichten aan het team voegde, precies zoals je ze stuurde |
export.json | wat de download bevat en hoeveel items, wat erbuiten blijft en waarom, en missing_files: elk bestand dat niet kon worden meegenomen, met de reden |
README.md | een handleiding bij de download, in de taal van de app |
2. De formaten
| Gestructureerde gegevens en bevindingen | JSON | RFC 8259, codering UTF-8 |
|---|---|---|
| Rapporten en verklaringen | Markdown of PDF | CommonMark · ISO 32000 |
| Bestanden die je hebt geüpload | ongewijzigd | het formaat waarin je ze uploadde |
| Datum en tijd | ISO 8601 | UTC |
| Talen | tweeletterige codes | ISO 639-1 |
| Markten en landen | tweeletterige codes | ISO 3166-1 alpha-2 |
| Namen van ingrediënten | INCI | artikel 19, lid 6, en artikel 33 van Verordening (EG) nr. 1223/2009 |
3. Open interoperabiliteitsspecificaties
De formaten hierboven zijn open, gepubliceerd en ingebouwd in software die wij niet hebben geschreven. Niets uit je export heeft onze software nodig om gelezen te worden: JSON open je met elk hulpmiddel, Markdown is tekst, PDF is een gepubliceerde ISO-norm.
Voor regelgevingsdossiers in de cosmetica bestaat nog geen sectorbrede interoperabiliteitsnorm: geen gemeenschappelijk schema dat een andere compliancetool zonder mapping kan inlezen, en geen norm waaraan je conformiteit kunt verklaren. Wij gebruiken open formaten en vaste veldnamen, zodat die mapping voor de ontvanger kort werk is, en we beantwoorden de technische vragen van de aanbieder die jij kiest.
4. Hoe overstappen werkt
Vraag het schriftelijk aan op info@cosmetifull.com. De export is gratis, komt in één keer en bevat elk veld dat in punt 1 van deze pagina staat. Wij leveren binnen 14 werkdagen na je verzoek. Je kunt er altijd om vragen, ook als je blijft, en zo vaak als je nodig hebt. Geef je ons schriftelijk opdracht, dan geven we dezelfde export en dezelfde technische antwoorden, onder gelijke voorwaarden, aan de aanbieder die je hebt gekozen. Je relatie met die aanbieder blijft van jou: wij helpen jou, en we treden niet voor hem op. We zeggen je vooraf wat niet meegaat, zodat je daarop kunt plannen. Elke stap van een overstap, met de data erbij, staat op het precontractuele informatieblad over overstappen, in het Engels.
5. Wat er volgens ons nog niet werkt
De export voor het hele bedrijf komt op verzoek
In ExpertDesk downloadt iedere persoon de eigen gegevens zelf via het accountmenu, wanneer die maar wil (punt 1). Voor je account en LabelCheck is er vandaag nog geen export die je zelf aanzet: elke analyse uit je archief en elke gereedheidscontrole die je hebt bewaard, open je opnieuw met het rapport erbij, en dat rapport kun je printen of als PDF bewaren. De volledige export van je organisatie, verklaringen en ExpertDesk inbegrepen, loopt via een schriftelijk verzoek en de 14 werkdagen hierboven.
Er is nog geen openbare API voor de ontvangende aanbieder
De aanbieder die je kiest krijgt de geëxporteerde bestanden en kan ons technische vragen stellen over structuren en formaten. Een koppeling van machine naar machine bestaat voor hem nog niet.
Bijlagen bij een verklaring blijven niet bewaard
Je kunt bewijsstukken aan een gereedheidscontrole hangen, en die gelden als jouw verklaring dat het document bestaat: de inhoud ervan gaat nooit naar het model, en een bijgevoegd bestand blijft niet bewaard, dus onder dit kopje valt er niets te exporteren. Zodra we ze wel gaan bewaren, horen bijgevoegde bestanden bij de export, in het formaat waarin je ze hebt geüpload.
Verbruik gaat als tegoeden de export in, niet als interne eenheden
Eén record per verrichting, met datum en dienst. Het tegoed is de eenheid van de overeenkomst. De interne meting waarmee wij onze eigen kosten berekenen legt niets vast wat jij hebt gemaakt, en zit dus niet in de export.
Onze kennisbank met regelgeving gaat niet mee
De regels, de analysemodellen en het platform zijn van ons. Van jou is alles wat je ons hebt gestuurd en alles wat de dienst voor je heeft gemaakt, en dat is wat je meeneemt.
Wat de ExpertDesk-download weglaat
Bestanden die je bij een vraag in de chat voegt, dienen om je te antwoorden en worden niet bewaard, dus onder dit kopje valt niets te exporteren; het gesprek houdt de tekst van elk bericht. Gegevens die te groot zijn voor één download, bestanden die niet in één download passen, gegevens van vóór 21 augustus 2026 zonder eigenaar en gegevens onder een ander e-mailadres leveren we op schriftelijk verzoek aan info@cosmetifull.com. In de download zeggen export.json en de README wat erbuiten blijft, en waarom.
ExpertDesk bewaart het werk onder het adres van iedere persoon
ExpertDesk legt van iedere persoon de gesprekken, de beoordelingen en de berichten aan het team vast onder diens e-mailadres. Een export voor het hele bedrijf bevat daarom het werk van de mensen die alleen bij jouw organisatie horen, vanaf de dag dat ieder van hen erbij kwam; het werk van iemand die ook bij een andere organisatie hoort, en werk van vóór iemands toetreding, leveren we aan de persoon die het deed.
6. Wijzigingen op deze pagina
Zodra een beperking hierboven is opgelost, verandert die regel mee, en komt er een nieuwe bij, dan vind je die hier bij de andere.