> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fotostudio.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Sincronização com Pennylane

# 🔗 Conexão Pennylane com Fotostudio

## O que é o Pennylane?

[Pennylane](https://www.pennylane.com/) é um software de contabilidade francês destinado a TPE/PME e contabilistas. A conexão com o Fotostudio permite sincronizar automaticamente os teus documentos contabilísticos (faturas, pagamentos, notas de crédito) para o Pennylane, sem qualquer reintrodução de dados.

---

## O que faz a integração

Uma vez ativada, a integração envia automaticamente para o Pennylane:

| O que é sincronizado | Detalhe |
| ---- |
| **Faturas** | Com todas as linhas, os montantes sem IVA/com IVA e as taxas de IVA |
| **Pagamentos** | A fatura é automaticamente marcada como paga no Pennylane |
| **Notas de crédito** | Criadas no Pennylane e ligadas à fatura original se já estiver sincronizada |
| **Clientes** | Criados automaticamente no Pennylane (empresas e particulares) se ainda não existirem |

---

## Como conectar o Pennylane

### Passo 1 — Gerar a tua chave API no Pennylane

![](https://storage.crisp.chat/users/helpdesk/website/-/1/1/0/6/1106822c7ec6b200/pennylane_1qe37gm.png)


1. Conecta-te à tua conta em [app.pennylane.com](https://app.pennylane.com)
2. Vai a **Definições** → **Conectividade**
3. Clica no separador **Programadores**
4. Clica em **Gerar um token API**
5. Escolhe **Ilimitado** para o período de validade e marca a caixa de aviso
6. No passo seguinte, nas permissões, marca em leitura e escrita: Gestão de clientes, Gestão de faturas de clientes, Gestão de faturas de fornecedores, Gestão de transações, Gestão de fornecedores
7. Finaliza e copia a chave exibida (só será visível uma vez)

### Passo 2 — Configurar o Pennylane no Fotostudio

1. No Fotostudio, vai a **Contabilidade** → **Definições** → **Sincronização contabilística**
2. Clica no botão **Configurar um serviço**
3. Desliza até à secção **Pennylane**
4. Cola a tua chave API no campo **Chave API**
5. Clica em **Testar a conexão** para verificar que a chave é válida
6. Marca **Ativar a sincronização com o Pennylane**
7. Clica em **Guardar**

> ℹ️ Só podes ativar um software de contabilidade de cada vez. Se estavas a usar o SevDesk ou o Lexware, a ativação do Pennylane vai desativá-lo automaticamente.

---

## Funcionamento da sincronização

### Sincronização automática

Assim que o Pennylane está ativado, a sincronização é desencadeada **automaticamente**:
* Quando uma **fatura** é finalizada
* Quando um **pagamento** é registado
* Quando uma **nota de crédito** é emitida e finalizada

Não tens nada a fazer manualmente.

### Sincronização manual

A partir da página **Sincronização contabilística** (`/app/accounting_sync`), podes:
* Ver o estado de sincronização de cada documento (sucesso, erro, em espera)
* Desencadear manualmente a sincronização de um documento específico
* Re-sincronizar um documento em caso de erro

### Idempotência

A sincronização está **protegida contra duplicados**: se uma fatura ou nota de crédito já foi enviada para o Pennylane, o Fotostudio deteta-o e não cria duplicado. Os clientes também são criados apenas uma vez, identificados de forma única através da sua referência interna.

---

### Países e taxas de IVA suportados

A integração gere os códigos de IVA oficiais do Pennylane para os seguintes países:

| País | Taxas suportadas |
| ---- |
| 🇫🇷 França | 20%, 10%, 5,5%, 2,1%, 0% |
| 🇧🇪 Bélgica | 21%, 12%, 6%, 0% |
| 🇪🇸 Espanha | 21%, 10%, 4%, 0% |
| 🇮🇹 Itália | 22%, 10%, 5%, 4%, 0% |
| 🇵🇹 Portugal | 23%, 13%, 6%, 0% |
| 🇩🇪 Alemanha | 19%, 7%, 0% |
| 🇨🇭 Suíça | 8,1%, 2,6%, 0% |


---

## Consultar o histórico de sincronizações

Vai a **Definições** → **Sincronização contabilística** → **Histórico** para ver:
* A lista de todos os documentos sincronizados
* O estado de cada sincronização (sucesso / erro / em espera)
* O detalhe dos erros em caso de falha

---

## Problemas frequentes

### "API key em falta"
A chave API não está preenchida ou está vazia. Verifica que está bem introduzida nas definições e que a integração está ativada.

### "Impossível criar/obter o cliente Pennylane"
O contacto associado à fatura não é encontrado ou está incompleto. Verifica que a fatura está bem ligada a um contacto no Fotostudio.

### "Fatura não sincronizada com o Pennylane"
Um pagamento está registado mas a fatura correspondente ainda não foi sincronizada. Sincroniza primeiro a fatura, depois re-sincroniza o pagamento.

### Erro de conexão
Em caso de erro de rede ou de timeout, a sincronização falha com o estado "erro". Podes re-sincronizar manualmente a partir da página Histórico. Se o problema persistir, verifica que a chave API ainda é válida do lado do Pennylane (pode ser revogada a partir das definições do Pennylane).

---

## Perguntas frequentes

**As faturas já emitidas antes da ativação são sincronizadas?**  
Não, a sincronização automática só se aplica aos documentos criados após a ativação. Os documentos anteriores podem ser sincronizados manualmente a partir da página Sincronização contabilística.

**O que acontece se eu desativar o Pennylane e depois o reativar?**  
Os documentos já sincronizados mantêm a sua ligação com o Pennylane. Os novos documentos serão novamente sincronizados automaticamente. Nenhum duplicado será criado.

**Posso usar o Pennylane e outro software de contabilidade ao mesmo tempo?**  
Não, apenas um software de contabilidade pode estar ativo de cada vez no Fotostudio.

**O Pennylane está disponível para todas as subscrições Fotostudio?**  
A integração Pennylane está disponível para todos os utilizadores com acesso ao módulo de faturação.