# Integrações

Liga serviços ao Artur para importar dados e manter faturas e pagamentos atualizados.

Source: https://appartur.pt/docs/integrations

## Ligar um serviço [#ligar-um-serviço]

Abre [Definições → Integrações](/app/settings/integrations) e escolhe o serviço. Precisas de ser proprietário ou ter acesso de Administração.

* **InvoiceXpress:** importa clientes, documentos e PDFs.
* **Stripe:** importa pagamentos para tratares a faturação em Vendas.
* **Segurança Social Direta:** importa pagamentos, comprovativos e referências Multibanco.

## InvoiceXpress [#invoicexpress]

1. Escolhe **InvoiceXpress** e abre **Como configurar**.
2. No InvoiceXpress, abre **Conta → Integrações → API** e gera uma chave, se ainda não tens uma.
3. No Artur, preenche o **Nome da conta** — o subdomínio do InvoiceXpress — e a **Chave de API**.
4. Guarda a ligação e acompanha o estado da primeira sincronização.

As faturas e os clientes aparecem nas respetivas áreas. Para corrigir os dados principais de um documento sincronizado, altera-o no InvoiceXpress e volta a sincronizar.

## Stripe [#stripe]

1. Escolhe **Stripe** e clica em **Ligar Stripe**.
2. No Stripe, seleciona a conta e autoriza o acesso de leitura.
3. Volta ao Artur e abre [Vendas](/docs/sales) depois da sincronização.

Para ligar mais contas, usa **Ligar outra conta**. A ligação está disponível para todas as contas Artur.

## Segurança Social Direta [#segurança-social-direta]

1. Escolhe **Segurança Social Direta** e abre **Como configurar**.
2. Entra no portal com **NISS e palavra-passe** para aceder a **Perfil → Gestão de acessos → Gerir autenticações**.
3. Cria um token para serviços de interoperabilidade.
4. Copia o token para **Token de acesso** no Artur e preenche o teu **NISS**. Guarda a ligação.

Introduz o token no Artur, em vez da palavra-passe do portal. Se a integração não aparecer, confirma a opção de isenção em [Definições de Segurança Social](/app/settings/social-security).

## Sincronização e estados da ligação [#sincronização-e-estados-da-ligação]

Usa **Sincronizar** para pedir uma atualização. Aguarda a conclusão antes de conferir os novos documentos.

Se aparecer **Pausado**:

* No Stripe, usa **Ligar outra conta** e escolhe a mesma conta para retomar.
* No InvoiceXpress ou Segurança Social Direta, usa **Alterar** e atualiza a chave ou o token.

Se o Artur indicar um tempo de espera, aguarda antes de repetir.

## Remover uma ligação [#remover-uma-ligação]

Escolhe **Remover** e confirma. A sincronização automática termina.

No InvoiceXpress e na Segurança Social Direta, os dados já importados ficam guardados. **Remover uma conta Stripe também remove as vendas importadas dessa conta**; as faturas e os recebimentos que já registaste mantêm-se. Para revogar o acesso no Stripe, desinstala também a app Artur nesse serviço.

Para apagar dados de uma importação, usa as opções de [limpeza de dados](/docs/settings#limpar-dados-ou-recomeçar).

## Outras formas de trazer dados [#outras-formas-de-trazer-dados]

* [Importar faturação por CSV ou SAF-T](/docs/invoices#importar-faturação).
* [Importar faturas de compras](/docs/expenses#importar-despesas-a-partir-de-faturas).
* [Ligar uma aplicação de IA por MCP](/docs/ai-apps).

Se falta um serviço que usas, clica em **Sugerir integração** e diz-nos qual gostavas de ligar.