Sincronização com Pennylane
🔗 Conexão Pennylane com Fotostudio
O que é o Pennylane?
Pennylane é 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
- Conecta-te à tua conta em app.pennylane.com
- Vai a Definições → Conectividade
- Clica no separador Programadores
- Clica em Gerar um token API
- Escolhe Ilimitado para o período de validade e marca a caixa de aviso
- 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
- Finaliza e copia a chave exibida (só será visível uma vez)
Passo 2 — Configurar o Pennylane no Fotostudio
- No Fotostudio, vai a Contabilidade → Definições → Sincronização contabilística
- Clica no botão Configurar um serviço
- Desliza até à secção Pennylane
- Cola a tua chave API no campo Chave API
- Clica em Testar a conexão para verificar que a chave é válida
- Marca Ativar a sincronização com o Pennylane
- 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.
Actualizado em: 09/07/2026
Obrigado!