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 alles wat je ons hebt gestuurd en alles wat de dienst voor je heeft gemaakt.
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 |
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 | Besluit (EU) 2019/701 |
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.
5. Wat er volgens ons nog niet werkt
De export komt op verzoek, nog niet met een knop
In het account zit vandaag nog geen export die je zelf aanzet. Je kunt elk rapport en elke verklaring al openen en als PDF bewaren, en je ziet de volledige lijst van wat je hebt gemaakt. De ene volledige export 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.
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.