Instalar e gerir apps da Loja de apps
Acrescenta funcionalidades à loja com apps revistas pela DTEC: explorar, instalar com segurança, usar dentro do painel, aprovar cobranças e desinstalar.
Neste artigo
A Loja de apps funciona como uma loja de aplicações no telemóvel: escolhes uma app feita por um parceiro, autorizas o que ela pode fazer na tua loja e passas a usá-la dentro do painel. Todas as apps publicadas são revistas pela DTEC antes de aparecerem.
Explorar as apps
- Passo 1:
No menu lateral, abre Apps.
- Passo 2:
No separador Loja de apps vês as apps Em destaque e todas as outras, organizadas por categorias. Usa a pesquisa para procurar por nome ou função.
- Passo 3:
Carrega numa app para veres a página dela: o que faz, o Preço, o Programador, o Suporte, a Política de privacidade e, muito importante, as Permissões — o que a app pode fazer na tua loja.
Instalar uma app
Só o proprietário da loja pode instalar apps, conceder permissões e aprovar cobranças.
- Passo 1:
Na página da app, carrega em Instalar.
- Passo 2:
Abre o ecrã de autorização. Aqui a Feitora explica em linguagem simples cada permissão pedida, por exemplo "ver as encomendas" ou "alterar o stock". Se a app tiver acesso a dados pessoais dos teus clientes, aparece o aviso Inclui dados pessoais dos teus clientes.
- Passo 3:
Se a app for paga, o mesmo ecrã mostra o preço e os dias grátis: nada é cobrado sem aprovares a cobrança (vê mais abaixo).
- Passo 4:
Se concordares, carrega em Instalar app. Se não, Cancelar — nada é partilhado.
- Passo 1:
A app fica nas Instaladas e, se funcionar dentro do painel, aparece também no menu lateral, por baixo de Apps. Carrega em Abrir para a usar.
Como funciona a ligação, em linguagem simples
A instalação usa um método seguro chamado OAuth: a app nunca recebe a tua palavra-passe. Em vez disso, a Feitora dá-lhe uma chave própria, limitada às permissões que aprovaste. Se desinstalares a app, essa chave deixa de funcionar no mesmo instante.
Aprovar cobranças das apps
Algumas apps são pagas. Nesse caso, a app pede uma cobrança e tu decides:
- Passo 1:
A app abre o ecrã Cobrança pedida por com o nome do plano da app, o preço (sem IVA) e, se houver, os dias grátis.
- Passo 2:
Carrega em Aprovar cobrança ou Recusar.
- Passo 3:
As cobranças aprovadas entram na fatura da tua subscrição Feitora — não precisas de dar o cartão a cada app. Vês as cobranças ativas em Definições → Plano e faturação.
- Passo 4:
Uma cobrança marcada Teste — não é cobrada é só para experiências do programador.
Desinstalar uma app
- Passo 1:
Abre Apps e o separador Instaladas.
- Passo 2:
No menu Mais ações (três pontos) da app, escolhe Desinstalar e confirma.
- Passo 3:
A app perde de imediato o acesso à loja, as cobranças dela são canceladas e os avisos automáticos (webhooks) que tinha são apagados.
- Passo 4:
A app é avisada e tem 48 horas para apagar os dados da tua loja, como manda o RGPD — vê Dados dos clientes e RGPD.
Para programadores e parceiros
Queres criar uma app para os lojistas Feitora? Cria uma conta de parceiro em app.feitora.pt/parceiros, regista a app (recebes um client_id e um client_secret) e submete-a para revisão da DTEC. Enquanto não for publicada, só pode ser instalada em lojas de desenvolvimento. O guia técnico completo, com uma app de exemplo, está no repositório da Feitora em docs/apps.md. A DTEC retém uma comissão sobre as cobranças das apps (15 % por omissão).
Se só precisas de ligar a tua loja a um programa (um ERP, uma folha de cálculo, o Claude), não precisas de uma app pública: usa uma app personalizada — vê Apps personalizadas, API e webhooks.
Problemas frequentes
| Problema | O que fazer |
|---|---|
| Não vejo o botão Instalar | Só o proprietário pode instalar. Pede-lhe para entrar com a conta dele. |
| A app não abre dentro do painel | Algumas apps abrem numa janela própria. Usa Abrir na lista de instaladas e permite janelas pop-up. |
| Uma app aparece como "Retirada da loja" | A DTEC retirou-a da Loja de apps. Contacta o suporte da app e considera desinstalá-la. |