# Ligar o Todocolección ao RUIT

Tutorial para ligar o Todocolección: pede a chave API e o identificador de utilizador pelo formulário de contacto e cola-os no RUIT quando chegarem.

_Updated: 2026-09-28 · Source: https://ruit.es/pt/docs/ligar-o-todocoleccion/_

Neste tutorial ligas a tua conta do Todocolección ao RUIT. O Todocolección liga-se com dois dados,
uma **Chave API** e o teu **ID de utilizador**, e tem uma particularidade que não partilha com
nenhum outro marketplace: **não és tu que os geras**. Pede-los ao Todocolección pelo formulário de
contacto, chegam-te por e-mail e cola-los no RUIT. O que tu fazes são **cinco minutos**; a espera
depende do Todocolección.

**Precisas** de uma conta de vendedor no Todocolección e do
[telemóvel verificado](https://ruit.es/pt/docs/verificar-o-teu-telemovel/), porque sem ele o assistente de ligação
não se abre.

> **Aviso:** Convém dizê-lo com clareza, porque é a confusão mais habitual: **não são o teu utilizador e a tua
> palavra-passe de sempre**. Com esses não é possível ligar, por muito que funcionem para entrar no
> site.

## 1. Pede a chave API e o identificador de utilizador ao Todocolección

Inicia sessão na tua conta do [Todocolección](https://www.todocoleccion.net) e abre o
[formulário de informação comercial](https://www.todocoleccion.net/contactar/informacion-comercial)
do site. O site só existe em espanhol, por isso os nomes dos campos e dos botões vão aqui tal como
lá aparecem, com a tradução entre parênteses. Preenche o teu nome e o teu e-mail e escolhe
**«Otros motivos»** (outros motivos) em **«Asunto»** (assunto).
Em **«Motivo de la consulta»** (o texto da consulta), pede a chave API e o identificador de
utilizador da tua conta. Por exemplo: «Bom dia, peço a chave API e o identificador de utilizador da
minha conta para a poder integrar com ferramentas externas de gestão. Obrigado.» Carrega em
**«Enviar consulta»** (enviar a consulta) e **aponta o número da consulta** que te derem.

_Captura de ecrã: O formulário de contacto do Todocolección com os campos do nome e do e-mail, o assunto Otros motivos selecionado, uma mensagem a pedir a chave API e o ID de utilizador, e o botão Enviar consulta_

O formulário já preenchido. O que importa são os dois campos marcados: o assunto e a mensagem.

## 2. Espera pela resposta do Todocolección

O Todocolección responde **por e-mail**, e é nessa resposta que vêm os dois dados. Entretanto,
podes ver como está a tua consulta na [página de contacto](https://www.todocoleccion.net/ayuda/contactar)
do site: escreve o número em **«Consulta frecuente (acceso directo)»**
(acesso direto a uma consulta) e carrega em **«Continuar»**.

_Captura de ecrã: A página Contactar do centro de ajuda do Todocolección, com o campo Número de consulta e o botão Continuar marcados_

O acesso direto para acompanhar uma consulta que já enviaste.

## 3. Cola os dois dados no RUIT

Entra em **Definições → Contas**, carrega em **Ligar conta** e escolhe **Todocolección**. Cola a
chave em **Chave API** e o teu identificador em **ID de utilizador**, e carrega em **Ligar**.
Não é preciso escrever nenhum endereço: a loja não é tua, é um marketplace.

_Captura de ecrã: A janela de ligar o Todocolección no RUIT: o atalho para este guia, o campo Chave API com o ícone para a mostrar, o campo ID de utilizador e os botões de cancelar e ligar_

A janela do Todocolección. Os números assinalam **Chave API** e **ID de utilizador**.
O ícone do olho mostra a chave enquanto a revês.

O RUIT testa as credenciais pedindo ao Todocolección um produto da tua conta. Se forem recusadas,
diz-to ali mesmo, em vez de deixar a conta a meio.

## O que conseguiste

A tua conta aparece em **Contas ligadas** com o cartão do Todocolección, que mostra o teu
identificador de utilizador. As credenciais não caducam, por isso o cartão não tem o botão **Voltar a ligar** que o
Wallapop e o Vinted têm: a ligação dura enquanto o Todocolección mantiver a chave.

_Captura de ecrã: O ecrã Contas ligadas do RUIT com um cartão por marketplace, entre eles o do Todocolección com a conta ligada, e o botão de ligar conta no canto superior direito_

A conta do Todocolección entre as contas ligadas. O nome dela mostra o identificador de
utilizador, aqui tapado.

**Passo seguinte:** importar a partir de um marketplace para trazeres os lotes que já tens no
Todocolección, ou [a tua primeira publicação](https://ruit.es/pt/docs/o-seu-primeiro-anuncio/).

## Se algo não bater certo

- **«Não foi possível verificar as credenciais. Verifica as tuas chaves API e o URL da loja».** O
  Todocolección recusou os dados. O aviso fala de um URL de loja que aqui não existe; o que tens de
  rever é a chave, copiada inteira e sem espaços, e o identificador.
- **Não encontras o teu identificador de utilizador no e-mail.** É o mesmo que aparece no endereço
  do teu perfil público, `todocoleccion.net/usuario/<o-teu-id>`.
- **Mais tarde o RUIT diz «Precisamos de validar novamente a tua sessão. Volta a ligar a
  conta».** O Todocolección deixou de aceitar a chave. Pede-lhe uma nova e repete o passo 3.

- [Vender no Todocolección com o RUIT](https://ruit.es/pt/docs/marketplaces/)
- [Como funciona a ligação de uma conta](https://ruit.es/pt/docs/como-funciona-a-ligacao-de-uma-conta/)