# Ligar a tua loja Shopify ao RUIT

Tutorial para ligar o Shopify: criar a app no Dev Dashboard, colar as oito permissões, instalá-la e copiar as suas duas chaves para o RUIT.

_Updated: 2026-09-17 · Source: https://ruit.es/pt/docs/vender-no-shopify/_

Neste tutorial ligas a tua loja Shopify ao RUIT. São duas partes: primeiro crias uma app dentro da
tua própria loja e depois colas as duas chaves dela no RUIT. Demora **cinco minutos** e faz-se **uma
só vez**.

**Precisas** de ser o proprietário da loja, ou de ter a permissão de desenvolvimento de apps se és
membro da equipa. Serve qualquer loja, incluindo as de desenvolvimento. O RUIT nunca te pede a
palavra-passe do Shopify: as permissões defines-as tu e podes retirá-las quando quiseres.

> **Aviso:** Desde 2026 as apps novas **só se criam no Dev Dashboard**. Se entrares em Definições, Apps e canais
> de venda, já não há formulário: só um cartão que te manda para lá. As apps que criaste antes no
> painel continuam a funcionar, e as chaves delas estão no separador de credenciais.

## 1. Abre o Dev Dashboard

Entra em [dev.shopify.com](https://dev.shopify.com) com a mesma conta com que administras a tua
loja. Vês a lista de apps da tua organização e, no canto superior direito, `Create app`.

_Captura de ecrã: A lista de apps do Dev Dashboard do Shopify, com a pesquisa por nome e o botão de criar app no canto superior direito_

A lista de apps. Se for a tua primeira vez estará vazia e vais ver um comando de terminal:
ignora-o, é para quem programa apps. O botão que procuras é `Create app`.

## 2. Cria a app e dá-lhe um nome

Carrega em `Create app`, escreve um nome que reconheças e confirma. O nome é só para ti.

_Captura de ecrã: O ecrã de criar uma app no Dev Dashboard, com o campo do nome e o botão de criar_

Qualquer nome serve. Nas figuras deste guia chama-se RUIT.

## 3. Cola as oito permissões

O Shopify deixa-te no ecrã da versão. Procura a secção `API access` e, no campo `Scopes`, cola
esta lista tal como está:

```
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publications
```

Há também um botão para as marcar uma a uma numa lista enorme, mas colar a lista é mais rápido e não
te esqueces de nenhuma. Os restantes campos ficam como vêm.

_Captura de ecrã: O campo `Scopes` do Dev Dashboard com as oito permissões coladas como uma lista separada por vírgulas_

As oito permissões coladas de uma vez. Por baixo do campo há um seletor com caixas que faz o mesmo,
uma a uma.

| Permissão                                  | Obrigatória?    | Para quê                                                       |
| ------------------------------------------ | --------------- | --------------------------------------------------------------- |
| `read_products` e `write_products`         | Sim             | Importar, publicar e editar produtos                             |
| `read_inventory` e `write_inventory`       | Sim             | Manter o stock sincronizado                                      |
| `read_locations`                           | Sim             | Saber em que armazém escrever esse stock                         |
| `read_orders`                              | Sim             | Saber das vendas no momento. Sem ela a ligação é recusada        |
| `read_publications` e `write_publications` | Muito recomendada | Que o produto se veja na tua loja e não só no painel           |

> **Aviso:** As seis primeiras verificam-se ao ligar, por isso se faltar alguma sabes logo. **As duas das
> publicações não se verificam**, e essa é a armadilha: a ligação corre bem, o produto cria-se, e não
> aparece na tua loja porque ninguém o publicou no canal de venda. Põe-nas agora e poupas a viagem.

## 4. Publica a versão

Carrega em `Release`, no canto superior direito, e confirma na janela que se abre. O nome e a
mensagem que te pede são opcionais.

_Captura de ecrã: A janela que confirma a publicação de uma versão nova da app, com os campos opcionais de nome e mensagem_

Este é o passo que mais se esquece. **Sem publicar a versão, as chaves do passo 6 ainda não
existem.**

## 5. Instala a app na tua loja

Volta à vista geral da app e carrega em `Install app`. Escolhe a tua loja e confirma no ecrã das
permissões.

_Captura de ecrã: A vista geral da app no Dev Dashboard, com a versão ativa e o botão de instalar a app_

A vista geral, com a versão já publicada e o botão de instalar.

_Captura de ecrã: O ecrã de instalação dentro do painel da loja, com as permissões que a app pede e os botões de cancelar e instalar_

O Shopify avisa que a app não passou a revisão dele. É o normal numa app privada criada na tua
própria organização: ninguém além de ti a pode instalar, e as permissões são as que acabaste de
definir.

> **Nota:** Sem este passo as chaves existem mas não autorizam nada, e o RUIT recusa a ligação dizendo que a app
> não está instalada na loja.

## 6. Copia o `Client ID` e o `Client Secret`

Nas definições da app, na secção de credenciais, tens os dois valores. O segredo está oculto até
carregares no ícone do olho.

> **Aviso:** O RUIT quer o par **`Client ID` mais `Client Secret`**, e mais nada. Não copies a chave de automatização
> do Dev Dashboard nem, numa app antiga, a chave de acesso que começa por `shpat_`. Com essas duas
> chaves o RUIT emite os seus próprios acessos, que caducam todos os dias e se renovam sozinhos, por
> isso nunca guardamos uma chave permanente da tua loja.

## 7. Liga a loja no RUIT

Entra em **Definições → Contas**, carrega em **Ligar Conta** e escolhe **Shopify**. Pede-te três
coisas:

| Campo             | O que colar                                       |
| ----------------- | -------------------------------------------------- |
| URL da loja       | O domínio que acaba em `.myshopify.com`             |
| `Client ID`         | O do passo 6                                        |
| `Client Secret`     | O do passo 6                                        |

O endereço é o domínio terminado em `.myshopify.com`, não o domínio com que vendes ao público. O
RUIT é tolerante no copiar e colar: também aceita o endereço do painel de administração.

_Vídeo ainda por gravar: Ligar uma loja Shopify_

## O que conseguiste

A tua loja Shopify está ligada ao RUIT com umas chaves que são tuas e que podes revogar quando
quiseres. A partir daqui podes importar os produtos que já tens, publicar os do teu inventário, e o
RUIT sabe de cada venda assim que ela acontece.

**Passo seguinte:** [importar a partir de um marketplace](https://ruit.es/docs/importar-desde-un-marketplace/) para
trazer o que já vendes nessa loja.

## Se algo não bater certo

- **A ligação falha dizendo que faltam permissões.** O erro diz quais. Volta ao passo 3, cola a
  lista inteira numa **versão nova** da app e publica-a; as permissões viajam com a versão, por isso
  editá-las sem publicar não muda nada.
- **O produto cria-se mas não se vê na loja.** Faltam-te as duas permissões das publicações. São as
  que não se verificam ao ligar.
- **A ligação falha dizendo que a app não está instalada.** Saltaste o passo 5, ou instalaste a app
  noutra loja.
- **Tinhas uma app de antes de 2026.** Continua a servir. As chaves dela estão no separador de
  credenciais dentro do painel da loja, não no Dev Dashboard.
- **Esgota-se o stock de um produto.** O RUIT arquiva o produto no Shopify em vez de o apagar, por
  isso o histórico e o endereço do produto conservam-se.

- [Vender no WooCommerce com RUIT](https://ruit.es/docs/vender-en-woocommerce/)
- [Vender no PrestaShop com RUIT](https://ruit.es/docs/vender-en-prestashop/)