pretix-pt-invoicing¶
Emite faturas-recibo certificadas pela AT através de um serviço português de faturação eletrónica, automaticamente assim que uma encomenda do pretix é paga, e uma nota de crédito quando é totalmente reembolsada. Um painel no Control acompanha cada emissão e permite tentar de novo as que falharam.

- PyPI: https://pypi.org/project/pretix-pt-invoicing/
- Código: https://github.com/afonsosantos/pretix-pt-invoicing
- Problemas: https://github.com/afonsosantos/pretix-pt-invoicing/issues
- Requer
pretix>=2024.1.0, Python ≥ 3.11 - Versão documentada: 0.10.0
É a primeira vez? Siga os Primeiros passos, um guia passo a passo com imagens.
Serviços de faturação¶
Cada evento usa um serviço, escolhido no evento ou herdado do organizador.
| Serviço | Identificador | Estado |
|---|---|---|
| Fact.pt | factpt |
Verificado com uma conta sandbox real |
| Moloni | moloni |
Verificado com uma conta real (faturas-recibo, notas de crédito, PDF) |
Antes de usar em produção
Emita alguns documentos de teste na sandbox do serviço e confira os valores, o cliente e o IVA antes de o ativar num evento a sério. Veja as Limitações conhecidas.
O que faz¶
- Fatura-recibo ao pagar, nota de crédito no reembolso total, as duas emitidas em segundo plano para um serviço lento nunca atrasar o comprador.
- Todas as linhas da encomenda: bilhetes, com os iguais agrupados, e todas as taxas; opcionalmente uma linha por participante. Vouchers e descontos aparecem como descontos de linha, e as encomendas gratuitas não são faturadas. Os preços sem IVA são calculados para o total do documento ser exatamente o que foi pago.
- O NIF do comprador de toda a gente, não só das empresas, com um único campo NIF no checkout, opcionalmente obrigatório para empresas ou para todos os compradores portugueses.
- Configurado uma vez por organizador: o serviço, as credenciais e as opções definidas no organizador são herdadas pelos seus eventos, e cada evento pode ainda ser diferente.
- O comprador recebe o PDF na página da encomenda e, se o ligar, por e-mail.
- Um painel geral e um painel por encomenda com estado, número do documento, erros, novas tentativas e páginas de confirmação antes de qualquer ação irreversível.
- Modo só manual, para eventos em que só algumas encomendas precisam de documento.
- Avisos de alteração dos dados de faturação quando um comprador edita a morada depois de faturado; nada é reemitido sem aprovação de quem gere o evento.
- Moloni: ligação por OAuth, associação de cada forma de pagamento do pretix a uma do Moloni, artigos de catálogo criados automaticamente, com referências que controla.
- Novas tentativas seguras: antes de reenviar o que quer que seja, o plugin confirma se o serviço já tem o documento, por isso um timeout nunca dá uma segunda fatura.
Como funciona¶
- Uma encomenda é paga e o pretix dispara
order_paid. - O plugin põe uma tarefa na fila do Celery. O serviço nunca é chamado durante o checkout.
- A tarefa emite a fatura-recibo e guarda o resultado (número do documento, ligação para o PDF, ou o erro do serviço).
- Opcionalmente, o PDF é enviado ao comprador por e-mail e fica disponível para descarregar na página da encomenda.
A emissão é idempotente: cada encomenda tem um identificador estável, e uma emissão bem-sucedida nunca é repetida. Uma encomenda paga de novo depois de a fatura ter sido creditada (um reembolso, seguido de um novo pagamento) recebe uma nova fatura; ver Paga de novo depois de um reembolso.
Instalação¶
pip install pretix-pt-invoicing
python -m pretix migrate
Reinicie o pretix e ative Faturação portuguesa em Configurações → Plugins do evento, no separador Integrações. Depois configure-o. O cartão do plugin nessa página, e as suas páginas de definições, têm uma ligação para esta documentação.