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 tudo o que nos enviou e tudo o que o serviço produziu para si.
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 |
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 | Decisão (UE) 2019/701 |
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.
5. O que sabemos que ainda não funciona
A exportação entrega-se a pedido, não a partir de um botão
Hoje não há exportação em autosserviço na conta. Já pode abrir e guardar em PDF cada relatório e cada declaração, e ver a lista completa do que produziu; a exportação única e completa 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.
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.