# Ligar o PrestaShop ao RUIT

Tutorial para ligar o PrestaShop: ativa o serviço web, cria uma chave com as permissões que o RUIT usa e cola-a junto com o endereço da tua loja.

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

Neste tutorial ligas a tua loja PrestaShop ao RUIT. O PrestaShop liga-se com uma chave do seu
**serviço web**, que crias no painel da tua própria loja e à qual dás permissões recurso a recurso.
São duas partes: preparar a chave no PrestaShop e colá-la no RUIT. Demora **dez minutos** e faz-se
**uma só vez**.

**Precisas** de acesso de administrador ao painel do PrestaShop, de ter a loja servida em `https://`
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.

## 1. Ativa o serviço web do PrestaShop

No painel da tua loja, entra em **Parâmetros avançados → Webservice**.
Vem desativado de origem: põe **Ativar o webservice do PrestaShop** em **Sim** e carrega em
**Guardar**.

_Captura de ecrã: A página Webservice do PrestaShop: a lista de chaves, o botão de adicionar uma chave nova no canto superior direito e, em baixo, a configuração com o interruptor de ativar o serviço web_

A página do serviço web, com o painel em inglês. Os retângulos assinalam o interruptor de
**ativar** e o botão de **adicionar uma chave nova**.

## 2. Cria uma chave para o RUIT

No mesmo ecrã, carrega em **Adicionar nova chave de webservice**. Carrega em **Gerar** para o
PrestaShop inventar a chave, dá-lhe uma descrição que reconheças e deixa o estado em ativado. Copia
a chave: é a que vais colar no RUIT no passo 4.

_Captura de ecrã: O formulário da chave nova no PrestaShop: o campo da chave com o botão de gerar ao lado, a descrição da chave, o interruptor para a ativar e o início da tabela de permissões_

Os retângulos assinalam **Gerar** e a **descrição**. A chave está tapada: o PrestaShop inventa-a
com 32 caracteres.

## 3. Marca as permissões da chave

Por baixo do formulário está a tabela de permissões, um recurso por linha e uma caixa por ação.
Estas são as que o RUIT usa:

| Recurso | Ver (`GET`) | Modificar (`PUT`) | Adicionar (`POST`) | Eliminar (`DELETE`) |
|---|---|---|---|---|
| `products` | Sim | Sim | Sim | Sim |
| `combinations` | Sim | Sim | Sim | |
| `stock_availables` | Sim | Sim | | |
| `specific_prices` | Sim | | Sim | Sim |
| `images` | Sim | | Sim | Sim |
| `categories`, `manufacturers`, `product_options`, `product_option_values`, `languages`, `taxes`, `tax_rules` | Sim | | | |

As colunas `PATCH` e de visualização rápida ficam por marcar. Carrega em **Guardar**.

_Captura de ecrã: A tabela de permissões da chave no PrestaShop, com as colunas de ver, modificar, adicionar, patch, eliminar e visualização rápida, e a linha dos produtos com as caixas de ver, modificar, adicionar e eliminar marcadas_

A tabela, deslocada até à linha dos **produtos**. Os retângulos assinalam o cabeçalho com as
colunas e essa linha com as suas quatro caixas marcadas.

> **Dica:** Se não quiseres ir caixa a caixa, marcar todas as permissões também serve: a chave só é usada pelo
> RUIT e podes apagá-la neste ecrã quando quiseres.

> **Aviso:** Ao ligar, o RUIT só verifica se a chave consegue **ver idiomas**. Uma permissão em falta não se nota
> ao ligar: nota-se mais tarde, ao importar ou ao publicar. A importação avisa expressamente se a
> chave não conseguir ler `taxes` e `tax_rules`.

## 4. Liga a loja no RUIT

Entra em **Definições → Contas**, carrega em **Ligar conta** e escolhe **PrestaShop**. Escreve o
endereço da tua loja em **Site** (um domínio simples também serve: o RUIT põe-lhe `https://` à
frente) e cola a chave em **Chave API**. Carrega em **Ligar**.

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

A janela do PrestaShop. Os números assinalam **Site** e **Chave API**. O ícone do olho mostra a
chave enquanto a revês.

O RUIT testa a chave pedindo à tua loja a lista de idiomas e fica com o primeiro ativo, que é o
idioma em que vai escrever as fichas.

## O que conseguiste

A tua loja aparece em **Contas ligadas** com o cartão do PrestaShop. A chave não caduca, 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 até
apagares a chave no teu painel.

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

A loja PrestaShop entre as contas ligadas, com o nome que lhe tiveres dado.

**Passo seguinte:** importar a partir de um marketplace para trazeres os produtos que já tens na
loja, 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».** A
  tua loja não respondeu como o RUIT esperava. Confirma, por esta ordem, que o serviço web está
  ativado (passo 1), que a chave está copiada inteira e com a permissão de ver `languages` (passo
  3), e que o endereço é o da loja e não o do painel.
- **«Formato de credenciais inválido».** A chave tem menos de 8 caracteres: colaste só um pedaço.
  As do PrestaShop têm 32.
- **«O URL tem de usar HTTPS (não HTTP)».** O RUIT não liga lojas sem `https://`. Instala um
  certificado na loja e tenta outra vez.
- **A importação avisa sobre os impostos.** Falta à chave ver `taxes` e `tax_rules`. Marca essas
  duas caixas no passo 3 e repete a importação; não é preciso voltar a ligar.
- **A publicação falha e refere um recurso.** É uma permissão que falta na tabela do passo 3.
  Marca-a e volta a publicar.

- [Vender no PrestaShop com o RUIT](https://ruit.es/pt/docs/marketplaces/)
- [Ligar o WooCommerce ao RUIT](https://ruit.es/pt/docs/ligar-o-woocommerce/)
- [Como funciona a ligação de uma conta](https://ruit.es/pt/docs/como-funciona-a-ligacao-de-uma-conta/)