Guia prático

Como obter as suas credenciais API do TRACES

Como obter credenciais para a TRACES-NT API: crie um EU Login, registe o operador EUDR com o EORI, ative o acesso de serviço web e guarde a chave de autenticação.

8 min de leitura · atualizado em julho de 2026 · não é aconselhamento jurídico

EUDR dossier · plotvera WS ACCESS
Um EU Login e um acesso de serviço web ativado são o que permite a um software apresentar por si
Um EU Login e um acesso de serviço web ativado são o que permite a um software apresentar por si EPSG:4326

Para que um software apresente uma declaração de devida diligência através da TRACES-NT API, o TRACES tem de reconhecer a conta por trás do pedido. Isso resume-se a três coisas: um EU Login para uma pessoa real, um operador registado no sistema EUDR e um acesso de serviço web cuja chave de autenticação o software apresenta a cada chamada. Este guia percorre os três, de ponta a ponta. É a configuração que está por baixo do guia de apresentação manual no TRACES: faça-a uma vez e a apresentação através da TRACES-NT API torna-se possível.

Uma coisa a manter clara desde o início: preparar estas credenciais não é o mesmo que apresentar seja o que for, e certamente não é uma aprovação. Uma chave configurada significa que o seu software pode submeter uma declaração quando você decidir. Não diz nada sobre se uma declaração foi submetida, aceite ou verificada. Ninguém na Comissão analisa a sua conta quando você gera uma chave.

TRACES, TRACES-NT e EU Login: onde entra realmente

Os três nomes são usados indistintamente e isso custa uma tarde a muita gente. O TRACES-NT é a plataforma da Comissão, o sistema EUDR funciona dentro dela e o EU Login é a autenticação que guarda a porta. Não há um login EUDR separado para criar, e nenhuma conta plotvera o faz entrar: entra no endereço da Comissão com um EU Login e depois pede o papel de operador.

  • EU Login: a conta em si, em nome de uma pessoa identificada e protegida por duplo fator. Se a sua empresa já usa uma para outro serviço da Comissão, reutilize-a.
  • TRACES-NT: a plataforma. Ter uma conta TRACES para outro regime, como os certificados sanitários, não lhe dá o papel EUDR; esse é pedido em separado.
  • O sistema EUDR: aquilo a que pede acesso como operador. A aceitação e a produção são dois sistemas independentes, com contas separadas e chaves separadas.

As três credenciais da TRACES-NT API

  • EU Login: o início de sessão único da Comissão Europeia. Cada ação no TRACES depende de um, criado para uma pessoa singular identificada da sua empresa e não para uma caixa partilhada.
  • Registo do operador EUDR: a sua empresa como operador dentro do módulo EUDR do TRACES, no Estado-Membro onde está estabelecida, com o seu número EORI.
  • Acesso de serviço web e a sua chave de autenticação: uma credencial de máquina ativada no seu perfil de operador. O nome de utilizador e a chave são aquilo com que um cliente API se autentica. A chave é mostrada uma só vez, ao ser gerada.

Antes de começar: escolha o ambiente certo

O TRACES corre em dois sistemas separados. O ambiente de aceitação (também chamado de réplica ou de formação) serve para ensaiar, e é onde foram tiradas as capturas abaixo; tudo o que aí registar é descartável e a sua base de dados é reposta regularmente. O ambiente de produção é o real, o que a alfândega vê. As credenciais não passam de um sistema para o outro, portanto registe-se e gere uma chave no ambiente em que vai realmente apresentar. Ensaiar todo o processo em aceitação primeiro é a melhor preparação antes de o fazer a sério.

Passo 1: criar um EU Login

Ao sistema EUDR acede-se através do portal TRACES, onde inicia sessão. A produção, o sistema real que a alfândega vê, está em https://eudr.webcloud.ec.europa.eu/tracesnt/; o sistema de aceitação (de teste), o lugar mais seguro para ensaiar primeiro todo o processo, está em https://acceptance.eudr.webcloud.ec.europa.eu/tracesnt/. Em qualquer das páginas clica em Log in, que o encaminha para o EU Login.

Se a sua empresa já usa o EU Login para outro serviço da Comissão, reutilize-o; não precisa de um segundo. Caso contrário, crie uma conta para uma pessoa concreta que será responsável pelas apresentações e conclua a configuração de dois fatores, exigida pelo início de sessão. Adicionar mais tarde um segundo utilizador registado é um seguro barato contra férias e saídas, porque uma conta única bloqueada para por completo a sua apresentação.

Passo 2: registar o seu operador EUDR no TRACES

Inicie sessão no sistema EUDR. Uma conta nova não tem qualquer papel, por isso o TRACES pergunta para que tipo de organização está a pedir acesso. Escolha Operador, que abrange os operadores económicos comuns e as empresas a jusante.

O seletor de papel do TRACES com a opção Operador realçada
Uma conta nova não tem qualquer papel. Peça o acesso como operador.

Preencha o formulário do operador para a sua empresa: designação social, país de estabelecimento e pelo menos um endereço. No bloco de atividade, ponha a secção em EUDR e a atividade em EUDR Operator. É o passo que as pessoas esquecem, e sem ele o perfil não pode apresentar.

O formulário de registo do operador com a atividade em EUDR Operator
Nome, país, endereço e a atividade em EUDR Operator.

Acrescente o seu EORI nos identificadores do operador. Se importa ou exporta, o EORI é obrigatório e o TRACES verifica-o no momento da validação, pelo que um em falta ou mal formado aparece mais tarde como declaração rejeitada e não como erro aqui. Cada EORI é único em todo o sistema: se o TRACES indicar que já está em uso, o operador muito provavelmente já existe e deve pedir para se juntar a ele em vez de criar um duplicado.

O cartão de identificadores do operador com um valor EORI introduzido
Acrescente o EORI como identificador do operador. É validado na apresentação, não aqui.

Passo 3: enviar o pedido de autorização

Quando o formulário do operador estiver completo, selecione Create a new operator no canto superior direito. Isto não cria o operador de imediato; abre uma confirmação, porque o que realmente está a fazer é enviar um pedido de autorização para ligar o seu EU Login a esse operador. Acrescente uma mensagem opcional, se quiser, e depois envie-o. Em produção, o pedido é verificado antes de o seu papel ficar ativo, portanto conte com um breve atraso; em aceitação é praticamente imediato.

O formulário do operador preenchido com o botão Create a new operator destacado no canto superior direito
Com o formulário completo, selecione Create a new operator para abrir a confirmação.
A caixa de diálogo de confirmação do pedido de autorização com o botão de envio realçado
Envie o pedido de autorização para ligar o seu início de sessão ao operador.

Passo 4: ativar o acesso de serviço web e gerar a chave de autenticação

Assim que o seu papel de operador estiver ativo, abra o seu perfil TRACES. Perto do fim há um painel Web Services Access que, numa conta nova, mostra «No WS accesses». É aí que reside a credencial de máquina.

O painel Web Services Access no perfil de utilizador do TRACES
O painel Web Services Access do seu perfil, antes de qualquer acesso ser acrescentado.

Crie um utilizador de serviço web nesse painel. Um controlo Active aparece apenas quando o papel de operador se propagou por completo à camada de serviço web, o que pode atrasar-se um pouco face à atribuição do papel; se faltar, aguarde e recarregue em vez de recriar seja o que for. Pôr o acesso em Active revela a chave de autenticação. Copie a chave e o nome de utilizador do serviço web de imediato, porque a chave é mostrada uma vez e não pode voltar a ser mostrada. Se a perder, gera de novo, o que invalida a antiga. Trate-a como uma palavra-passe: autentica apresentações em seu nome.

Screenshot to follow
O botão Active aparece assim que o papel de operador se propaga. A chave é mostrada uma vez, copie-a de imediato.

Se o controlo Active continuar a não aparecer depois de o papel de operador estar totalmente ativo, a ativação do acesso de serviço web poderá ter de ser solicitada à equipa de suporte do TRACES em [email protected].

Onde vão as credenciais no plotvera

No plotvera, abra as Definições e cole o nome de utilizador do serviço web e a chave de autenticação no cartão de credenciais de serviço web do TRACES, e escolha o ambiente correspondente. A chave é cifrada em repouso e nunca lhe volta a ser mostrada. Este é o único passo que precisa dela: verificar as parcelas face aos requisitos de geolocalização EUDR, validar um ficheiro GeoJSON, fazer o screening e gerar dossiês documentais funcionam todos sem qualquer chave do TRACES. Apresentar em nome próprio ou como representante autorizado de um operador mandante é uma escolha à parte, própria de cada declaração; a credencial só prova quem se liga.

Problemas comuns

  • O botão Active nunca aparece. O papel de operador ainda não se propagou à camada de serviço web. Aguarde, recarregue o seu perfil e confirme que o papel está ativo antes de o esperar.
  • EORI já em uso. Provavelmente alguém da sua empresa já registou o operador. Peça para se juntar ao operador existente em vez de criar um segundo.
  • Uma chave que funciona em teste falha em produção. Aceitação e produção são sistemas separados com credenciais separadas. Gere uma chave no ambiente em que realmente apresenta.
  • Uma declaração é rejeitada por EORI em falta. O EORI pertence ao perfil do operador, não à declaração. Corrija o perfil e volte a apresentar. A mecânica de uma apresentação está no guia de apresentação da DDS.

Com a chave guardada, está pronto para apresentar quando decidir, que é exatamente onde entram a própria declaração de devida diligência e a sua lista de conformidade mais ampla. Estar pronto para apresentar é uma linha de partida, não de chegada.

Prazos: 30/12/2026 · 30/06/2027

Analise as suas primeiras 3 parcelas grátis

Carregue um ficheiro GeoJSON, WKT ou KML, ou desenhe uma parcela no mapa, e receba a validação de geometria mais um veredicto de desflorestação por satélite face à data-limite de 31 de dezembro de 2020. Sem cartão, sem chamada comercial.

Guias relacionados