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

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

1. No menu lateral, abre **Apps**.
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.
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.

*(Captura do painel: Apps → Loja de apps, com os separadores e as apps em destaque)*

## Instalar uma app

Só o **proprietário** da loja pode instalar apps, conceder permissões e aprovar cobranças.

1. Na página da app, carrega em **Instalar**.
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**.
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).
4. Se concordares, carrega em **Instalar app**. Se não, **Cancelar** — nada é partilhado.

*(Captura do painel: O ecrã de instalação explica as permissões em linguagem simples, antes de carregares em "Instalar app")*
5. 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.

> **Dica — Dá só o que é preciso**
> Antes de instalares, lê as permissões com calma. Uma app de etiquetas de envio precisa de ver encomendas, mas não precisa de mexer em descontos. Na dúvida, contacta o suporte da app.

> **Nota — Novas permissões**
> Quando uma app é atualizada e passa a pedir mais permissões, o painel mostra "Esta versão da app pede novas permissões". Abre a app para as aprovares (ou não).

## 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:

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.
2. Carrega em **Aprovar cobrança** ou **Recusar**.
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**.
4. Uma cobrança marcada **Teste — não é cobrada** é só para experiências do programador.

> **Em testes — Por validar com conta real**
> As cobranças das apps na fatura Feitora seguem o mesmo sistema de pagamento da subscrição (Stripe), que ainda não foi validado com uma conta real. Enquanto isso, confirma os valores na tua fatura.

## Desinstalar uma app

1. Abre **Apps** e o separador **Instaladas**.
2. No menu **Mais ações** (três pontos) da app, escolhe **Desinstalar** e confirma.
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.
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](https://feitora.pt/ajuda/seguranca/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](https://feitora.pt/ajuda/apps-api/apps-personalizadas-e-api).

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