Registo técnico
Formatos de dados e interfaces
Este é o registo em linha exigido pelo artigo 26.º do Regulamento (UE) 2023/2854. Descreve como estão estruturados os seus dados, em que formatos os pode levar, como funciona a mudança de prestador e o que ainda não funciona.
Faz parte das informações que recebe antes de celebrar o contrato connosco, e é mantido atualizado. Abrange a sua conta, o LabelCheck e o ExpertDesk: tudo o que nos enviou através deles e tudo o que o serviço produziu para si, dentro dos limites indicados no ponto 5.
Nesta página
1. Como é uma ficha
São os campos que a exportação contém, um a um.
A sua organização e a sua conta, comuns a todos os serviços
| Organização | denominação social, morada, número de identificação para efeitos de IVA |
|---|---|
| Pessoas | endereço de e-mail, papel atribuído, convites emitidos e o estado de cada um |
| Créditos | compras, atribuições internas e uma ficha por operação com data, serviço e quantidade em créditos |
| Faturas | as faturas que lhe emitimos |
| Definições | idioma da interface, preferências de notificação, o logótipo da organização se o tiver carregado |
| Mensagens | o que nos enviou pelo formulário de comentários, os ficheiros que lhe juntou e as nossas respostas |
LabelCheck, uma ficha por análise
id | o identificador da análise |
|---|---|
title | o nome que lhe deu |
lang | o idioma em que a análise foi produzida |
score | o resultado do controlo |
report | o relatório completo, em texto |
summary | os pontos em forma estruturada |
resolved | os pontos que marcou como resolvidos |
versions | o histórico das versões |
chat | a conversa sobre o relatório, quando a usou |
created_at, updated_at | criação e última alteração |
Declarações, uma ficha por declaração
id | o identificador da declaração |
|---|---|
title | o nome que lhe deu |
markets | os mercados que cobre |
score | o resultado |
blocking_open | quantos pontos bloqueantes continuam abertos |
report | o relatório estruturado |
summary | a síntese em forma estruturada |
documents | os documentos que refere |
checked | os pontos que verificou |
versions | o histórico das versões |
lang | o idioma |
created_at, updated_at | criação e última alteração |
ExpertDesk, uma ficha por conversa
No ExpertDesk, cada pessoa transfere os próprios dados a partir do menu da conta, em «Transferir os meus dados», quando quiser. Os dados chegam num único ficheiro ZIP. Os ficheiros JSON lá dentro usam os formatos do ponto 2. Cada um dos quatro ficheiros com os seus dados tem um campo notes: em account.json explica dois dos campos, e nos outros três diz quem escreveu o quê. Cada conversa é uma ficha de conversations.json, com estes campos:
id | o identificador da conversa |
|---|---|
title | desde 19 de setembro de 2026 é escrito pelo sistema de IA a partir da primeira pergunta; as conversas anteriores, e aquelas cujo título não foi possível escrever, mantêm as primeiras palavras da pergunta (ou uma etiqueta, quando a pergunta era apenas um anexo); uma conversa a que mudou o nome mantém o título que lhe deu |
lang | o idioma da conversa |
mode | a forma como a pergunta foi enviada: direct, ao especialista que escolheu, ou auto, quando foi o ExpertDesk a escolher o especialista ou o painel; as conversas iniciadas em versões anteriores da app podem também trazer panel, para uma pergunta feita a um painel de especialistas, ou label, para a fotografia de um rótulo enviada para ser lida |
expert, expert_name | a função que respondeu primeiro, como código, por exemplo cosmetic-chemist, e o respetivo nome em inglês |
messages | cada mensagem por ordem, com author (person para a pessoa titular da conta, model para o sistema de IA), expert e expert_name para a função que respondeu (panel para a síntese do painel), content para o texto e at para a hora; onde isso ficou registado, um texto do sistema de IA traz também ended (natural_end, length_limit quando atingiu o comprimento máximo e a última parte pode faltar, ou stopped_before_end), e cada pergunta traz routed_experts e experts_without_answer, as funções a que foi enviada e as que não responderam, sob a forma de códigos (unknown para uma função que deixou de ser oferecida) |
created_at, updated_at | criação e última alteração |
Os outros ficheiros do ZIP do ExpertDesk
account.json | o endereço de e-mail, o nome, a empresa registada para o acesso, a data em que este acesso foi criado no ExpertDesk, e requested_language enquanto um pedido de acesso estiver em aberto |
|---|---|
conversations/ | as mesmas conversas, um ficheiro Markdown para cada uma, com as datas escritas por extenso no idioma da aplicação e em UTC |
feedback.json | as avaliações das respostas: rating (up ou down, ou note para uma mensagem enviada pelo antigo formulário de comentários), a pergunta, a resposta avaliada (uma cópia que a aplicação enviou com a avaliação), a nota, a função cuja resposta foi avaliada, e conversation_id, vazio quando essa conversa já não pertence à conta |
feedback-threads.json | as mensagens à equipa: kind (general, ou finding quando a mensagem é sobre uma resposta), a mensagem, refers_to e context (preenchidos pela aplicação), a empresa da conta quando o fio começou, cada intervenção com o seu autor (person, model ou team), e files, cada ficheiro guardado no fio (in_a_message false assinala um ficheiro enviado cuja mensagem não foi guardada) |
attachments/ | os ficheiros anexados às mensagens à equipa, exatamente como foram enviados |
export.json | o que o ZIP contém e quantos elementos, o que deixa de fora e porquê, e missing_files: cada ficheiro que não foi possível incluir, com o motivo |
README.md | um guia do ZIP, no idioma da aplicação |
2. Os formatos
| Dados estruturados e pontos | JSON | RFC 8259, codificação UTF-8 |
|---|---|---|
| Relatórios e declarações | Markdown ou PDF | CommonMark · ISO 32000 |
| Ficheiros que carregou | sem alterações | o formato em que os carregou |
| Datas e horas | ISO 8601 | UTC |
| Idiomas | códigos de duas letras | ISO 639-1 |
| Mercados e países | códigos de duas letras | ISO 3166-1 alpha-2 |
| Nomes de ingredientes | INCI | artigos 19.º, n.º 6, e 33.º do Regulamento (CE) n.º 1223/2009 |
3. Especificações de interoperabilidade aberta
Os formatos acima são abertos, publicados e implementados por software que não escrevemos. Nada do que leva na exportação precisa do nosso software para ser lido: o JSON abre em qualquer ferramenta, o Markdown é texto, o PDF é uma norma ISO publicada.
Para os dados regulamentares dos cosméticos não existe uma norma de interoperabilidade do setor: nenhum esquema comum que outra ferramenta de conformidade possa importar sem correspondência, e nenhuma norma a que declarar conformidade. Usamos formatos abertos e nomes de campo estáveis, para que essa correspondência seja um trabalho curto para quem os recebe, e respondemos às perguntas técnicas do prestador que escolher.
4. Como funciona a mudança de prestador
Peça-nos por escrito para info@cosmetifull.com. A exportação é gratuita, entrega-se de uma só vez e abrange todos os campos enumerados no ponto 1 desta página. Entregamos no prazo de 14 dias úteis a contar do pedido. Pode pedi-la a qualquer momento, e não só à saída, e as vezes que precisar. Mediante instrução escrita, disponibilizamos a mesma exportação e as mesmas respostas técnicas ao prestador que tiver escolhido, em condições iguais. A relação com esse prestador continua a ser sua: o nosso apoio é para si, não agimos em nome dele. Dizemos de antemão o que não se transfere, para que o possa planear. Cada passo de uma mudança, com as respetivas datas, está descrito na ficha pré-contratual sobre a mudança de prestador, em inglês.
5. O que sabemos que ainda não funciona
A exportação de toda a empresa entrega-se a pedido
No ExpertDesk, cada pessoa transfere os próprios dados a partir do menu da conta, quando quiser (ponto 1). Para a sua conta e o LabelCheck, hoje não há exportação em autosserviço: pode reabrir, com o respetivo relatório, cada análise do seu arquivo e cada verificação de prontidão que guardou, e imprimir esse relatório ou guardá-lo em PDF. A exportação completa da sua organização, declarações e ExpertDesk incluídos, passa por um pedido escrito e pelos 14 dias úteis acima.
Não há uma interface pública para o prestador que recebe
O prestador que escolher recebe os ficheiros exportados e pode fazer-nos perguntas técnicas sobre estruturas e formatos. Para ele ainda não existe uma interface de máquina para máquina.
Os anexos às declarações não são conservados
Pode juntar documentos de suporte a uma verificação de prontidão, e valem como afirmação sua de que o documento existe: o conteúdo nunca passa ao modelo, e nenhum ficheiro junto fica guardado, por isso debaixo desta rubrica não há nada a exportar. Se a conservação passar a estar ativa, os ficheiros juntos fazem parte da exportação no formato em que os carregou.
O consumo exporta-se em créditos, não em unidades internas
Uma ficha por operação, com data e serviço. O crédito é a unidade do contrato. A medição interna com que calculamos os nossos custos não é o registo de nada que tenha produzido, e não faz parte da exportação.
A nossa base de conhecimento regulamentar não é exportável
As regras, os modelos de análise e a plataforma são nossos. Seu é tudo o que nos enviou e tudo o que o serviço produziu para si, e é isso que leva daqui.
O que o ZIP do ExpertDesk deixa de fora
Os ficheiros anexados a uma pergunta no chat servem para a resposta e não são guardados, por isso não há nada a exportar nesta rubrica; a conversa mantém o texto de cada mensagem. Os dados demasiado grandes para caberem num único ZIP, os ficheiros que já não cabem nele, os dados anteriores a 21 de agosto de 2026 sem titular e os guardados noutro endereço de e-mail são entregues mediante pedido escrito para info@cosmetifull.com. Dentro do ZIP, o export.json e o README indicam o que fica de fora, e porquê.
O ExpertDesk guarda o trabalho no endereço de cada pessoa
O ExpertDesk regista as conversas, as avaliações e as mensagens à equipa de cada pessoa no respetivo endereço de e-mail. Por isso, a exportação de toda a empresa contém o trabalho das pessoas que pertencem apenas à sua organização, a partir do dia em que cada uma entrou nela; o trabalho de quem pertence também a outra organização, assim como o feito antes de entrar, é entregue à pessoa que o fez.
6. Alterações a esta página
Quando uma limitação acima se fechar, a linha muda com ela, e se aparecer uma nova encontra-a aqui, ao lado das outras.