# Ligar o 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-28 · Source: https://ruit.es/pt/docs/ligar-o-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

Abre o [guia do Dev Dashboard da Shopify](https://shopify.dev/docs/apps/build/dev-dashboard) e inicia sessão em `dev.shopify.com/dashboard` 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.

_Captura de ecrã: A janela de ligar o Shopify no RUIT: o atalho para este guia, os campos do URL da loja, do identificador e do segredo da app, e os botões de cancelar e ligar_

A janela do Shopify. Os números assinalam **URL da loja**, `Client ID` e `Client Secret`.

_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.

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

A loja Shopify entre as contas ligadas, com o nome que a loja tem no Shopify e sem botão de voltar a
ligar.

**Passo seguinte:** importar a partir de um marketplace para trazeres 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.

- [Vender no Shopify com o RUIT](https://ruit.es/pt/docs/vender-no-shopify/)
- [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/)