Configuração¶
Está tudo numa página: Configurações → Faturação PT do evento. (Chama-se "PT" para se distinguir da entrada "Facturação" do próprio pretix, que configura as faturas internas do pretix.) Para uma primeira configuração guiada, comece pelos Primeiros passos; esta página é a referência de cada opção.
A mesma página existe no organizador, para as definições partilhadas por todos os seus eventos; veja Definições ao nível do organizador. As duas páginas têm uma ligação para esta documentação.

Geral¶
| Definição | Por omissão | Descrição |
|---|---|---|
| Serviço de faturação | nenhum | Os cartões: Sem faturação, Fact.pt ou Moloni. Sem nenhum, nada é emitido. Só a secção do serviço selecionado é mostrada, guardada e usada. |
| Prefixo das referências de produto | pretix- |
Colocado antes da referência de cada produto no catálogo do serviço. Só interessa num serviço que tenha catálogo (Moloni); veja Artigos. |
| Emitir documentos automaticamente | ligado | Emite a fatura-recibo quando a encomenda é paga e a nota de crédito quando é totalmente reembolsada. Desligue para um modo só manual: nada é emitido a não ser pelos botões da página da encomenda. Veja Emissão só manual. |
| O campo personalizado da morada de faturação contém o NIF do comprador | desligado | Pede o NIF a todos os compradores, não só às empresas. Veja NIF. |
| Exigir o NIF no checkout | desligado | Torna o NIF obrigatório para empresas portuguesas, e para todos os compradores portugueses quando o pretix exige morada de faturação. Precisa da opção anterior. Veja Exigir o NIF. |
| Permitir ao comprador discriminar a fatura por participante | desligado | Acrescenta uma opção ao formulário de contacto do checkout. Quando o comprador a marca, cada bilhete ganha a sua própria linha na fatura, com o nome do participante. Veja Linhas da fatura. |
| Mostrar a fatura na página da encomenda do comprador | ligado | Acrescenta botões para descarregar a fatura e eventuais notas de crédito junto às descargas dos bilhetes. O PDF passa pelo pretix, por isso as credenciais do serviço nunca chegam ao browser. |
E-mail¶
Os e-mails de encomenda do próprio pretix não conseguem anexar estes documentos (só anexam as faturas do próprio pretix), por isso o plugin envia os seus, um por documento.
| Definição | Por omissão | Descrição |
|---|---|---|
| Enviar a fatura-recibo por e-mail ao comprador | desligado | Envia o PDF assim que a fatura-recibo é emitida. |
| Enviar a nota de crédito por e-mail ao comprador | desligado | Envia o PDF assim que a nota de crédito é emitida; o texto indica a fatura que anula. |
Emitir à mão no Control também envia o e-mail. Se cada documento seguiu ou não aparece na sua linha do painel Faturação PT da encomenda (Enviada por e-mail ao comprador / Não foi possível enviá-la por e-mail ao comprador). Um e-mail que falhe fica no log e nunca marca a emissão como falhada: o documento já existe no serviço.
Definições do serviço¶
Por baixo da secção E-mail vem a secção do serviço selecionado. Cada um tem a sua página:
- Fact.pt: token da API, sandbox, taxa de IVA, unidade e tipo de item.
- Moloni: a ligação, a empresa, as séries de documentos, o IVA, as formas de pagamento e os valores por omissão dos artigos.
Alguns campos (taxa de IVA, empresa, série de documentos…) passam a listas preenchidas em direto a partir da sua conta, assim que as credenciais escritas são válidas, sem precisar de guardar primeiro. Os campos que dependem de outro (as definições por empresa do Moloni) voltam a carregar quando esse muda. Se a consulta falhar, a linha por baixo da secção diz porquê, e os campos ficam como caixas simples com os valores guardados.
Ainda não está em uso
Escolher o cartão de um serviço não chega. Até a página ser guardada com tudo o que o serviço precisa, a sua secção mostra um aviso azul Ainda não está em uso e nada é emitido por ele. O aviso desaparece quando o serviço está selecionado e totalmente configurado.
Os campos das definições indicam aos browsers e gestores de palavras-passe (Bitwarden, 1Password, LastPass, Dashlane) que não os preencham automaticamente, para que o seu login do pretix nunca acabe nas credenciais de um serviço.
Definições ao nível do organizador¶
Tudo o que está nesta página pode ser definido uma só vez para todos os eventos de um organizador: o serviço, as suas credenciais e a ligação, as opções gerais e as de e-mail. Abra Configurações → Faturação PT do organizador (precisa da permissão para alterar as definições do organizador) e preencha-a como faria num evento.

- Os eventos herdam-nas. Um evento sem nada próprio usa as definições do organizador tal como estão, incluindo as alterações que lhes forem feitas depois. A página de definições do evento mostra os valores herdados e indica-o no topo, com uma ligação para a página do organizador.
- Um evento pode ser diferente. Guardar a página de um evento guarda só os valores que diferem dos do organizador. Esses passam a ser do evento: continuam a aplicar-se mesmo que o valor do organizador mude depois, e mesmo que os volte a pôr iguais. Um evento também pode escolher Sem faturação, ou outro serviço, por conta própria.
- Voltar atrás. Quando um evento tem valores próprios, a nota no topo da sua página oferece Usar as definições do organizador. Depois de uma confirmação, remove tudo o que o evento guardou, incluindo a sua própria ligação ao serviço. Os documentos já emitidos não são afetados.
Duas coisas continuam a ser por evento:
- O plugin tem de estar ativo em cada evento (Configurações → Plugins). As definições do organizador são predefinições, e nada é emitido para um evento onde o plugin esteja desligado.
- A tabela de formas de pagamento do Moloni, porque as formas de pagamento aceites são decididas em cada evento.
Uma ligação ao Moloni feita no organizador é partilhada pelos seus eventos; veja Uma ligação para todos os eventos.
Limpar um valor herdado
Uma lista opcional deixada vazia num evento significa "usar o do organizador", por isso um evento não consegue limpar um valor que o organizador definiu (o motivo de isenção do Moloni, por exemplo), só substituí-lo.
NIF¶
Por omissão, o NIF do comprador é lido do campo Número de IVA da morada de faturação do pretix. O pretix só mostra esse campo a clientes empresa, por isso os particulares não têm onde indicar o NIF e são faturados como consumidor final.
Para o pedir a toda a gente:
-
Em Configurações → Facturação do pretix, abra o separador Formulário de endereço e preencha Custom recipient field label, por exemplo com
NIF. Tem de ser pedida uma morada de faturação (Pedir endereço de facturação) para o formulário aparecer.
-
Ligue aqui O campo personalizado da morada de faturação contém o NIF do comprador.
O campo personalizado passa a ser usado sempre que o campo Número de IVA está vazio, e torna-se o único campo de NIF no checkout:

- O campo de referência interna do pretix, que a tradução portuguesa do próprio pretix chama "NIF (Número de Contribuinte)" para empresas, fica escondido, para não haver uma segunda caixa "NIF".
- Em moradas portuguesas o campo Número de IVA do pretix também fica escondido, para empresas inclusive. Um comprador de outro país da UE continua a vê-lo, porque a autoliquidação precisa dele.
Os números são aceites com espaços, pontos ou traços e com o prefixo PT (PT 237.892.294 serve).
Os NIF portugueses cujo dígito de controlo não confira são ignorados, não são enviados, por isso uma
gralha dá um documento a consumidor final em vez de um documento recusado. Para travar a gralha logo
no checkout, veja Exigir o NIF.
Sem NIF, o documento é emitido a consumidor final (999999990). Um comprador que não indicou
nome nem empresa é faturado como "Consumidor Final", nunca pelo e-mail.
Não torne o Número de IVA obrigatório
Com o campo personalizado como NIF, a opção Exigir número de IVA do próprio pretix recusaria as empresas portuguesas, porque o campo que teriam de preencher está escondido. Deixe-a desligada, e use Exigir o NIF no checkout.
Exigir o NIF¶
Com Exigir o NIF no checkout ligado, o campo personalizado de NIF passa a obrigatório para compradores com morada portuguesa, consoante quem são e consoante a opção Exigir endereço de facturação do próprio pretix (Configurações → Facturação do pretix):
| Comprador | Exigir endereço de facturação desligado | Exigir endereço de facturação ligado |
|---|---|---|
| Empresa | NIF obrigatório | NIF obrigatório |
| Particular | NIF opcional | NIF obrigatório |
- Um número que seja escrito tem de passar no dígito de controlo em qualquer dos casos; o comprador é avisado de que não é um NIF português válido e não consegue continuar até o corrigir ou apagar.
- Compradores com morada fora de Portugal nunca são obrigados, nem as encomendas gratuitas, que não recebem fatura.
- A opção precisa de O campo personalizado da morada de faturação contém o NIF do comprador; a página recusa guardar uma sem a outra.

O campo aparece marcado como obrigatório no formulário da morada de faturação do checkout, e a regra é verificada outra vez quando a encomenda é feita. Dois sítios onde não chega: a página alterar morada de faturação, que o comprador pode usar mais tarde, só é verificada no browser, e as encomendas criadas fora do checkout da loja (pela API, por exemplo) não são verificadas.
Linhas da fatura¶
Cada documento leva todas as posições não canceladas e todas as taxas da encomenda (taxa de pagamento, de serviço, de envio…), por isso o seu total é o total da encomenda.
- Bilhetes iguais (mesmo produto, preço e taxa) partilham uma linha com quantidade.
-
Com Permitir ao comprador discriminar a fatura por participante ligado e a opção marcada no checkout, cada bilhete ganha a sua linha, chamada
<produto> — <nome do participante>.
-
Cada linha mostra o nome do produto no pretix e o preço efetivamente pago.
- Um voucher ou um desconto automático aparece como desconto de linha: a linha leva o preço
de tabela, a percentagem descontada e um nome que diz de onde veio, por exemplo
Bilhete normal (voucher TWENTY). Os serviços só aceitam percentagens, por isso com um voucher de valor fixo o preço unitário pode sair com uma fração de cêntimo de diferença; os totais são exatamente o que foi pago. Um bilhete que ficou gratuito com um voucher de 100% continua no documento, com 100% de desconto. - Tudo o resto a 0,00 (um extra incluído, um produto gratuito) fica fora do documento.
Encomendas gratuitas não têm documento. Uma encomenda com total de 0,00 nunca é faturada, nem automaticamente nem à mão; o painel diz Esta encomenda é gratuita: não há nada a faturar. Se uma alteração posterior lhe der um valor a pagar, é faturada nessa altura.
Os serviços recebem preços unitários sem IVA e acrescentam-lhes o IVA configurado. Os preços do pretix são com IVA, por isso o valor sem IVA é calculado a 8 casas decimais e escolhido de forma a que o total do documento seja exatamente o que o comprador pagou, ao cêntimo, mesmo com várias linhas à mesma taxa.
Emissão só manual¶
Com Emitir documentos automaticamente desligado, pagar uma encomenda ou concluir um reembolso não emite nada. Os documentos saem só dos botões do painel Faturação PT da encomenda: Emitir fatura agora e Emitir nota de crédito. Tudo o resto funciona da mesma forma, incluindo os e-mails e as descargas do comprador.
Útil para um evento em que só algumas encomendas precisam de documento oficial, ou enquanto ainda está a conferir o que o serviço emite.
Alterações aos dados de faturação depois de faturar¶
Cada documento emitido guarda os dados de faturação com que foi passado (nome, NIF, morada). Se o comprador editar depois a morada de faturação na página da encomenda, o plugin compara os dois e, quando diferem:
- o painel Faturação PT da encomenda mostra um aviso com o número da fatura;
- o e-mail de contacto do evento (pretix Configurações → Geral) recebe uma mensagem com uma ligação para a encomenda.
Nada é creditado nem reemitido sozinho. Para aceitar a alteração, carregue em Emitir nota de crédito e depois em Emitir fatura agora na página da encomenda; a nova fatura usa os dados novos. O e-mail repete-se a cada gravação posterior enquanto os dados continuarem diferentes. Os documentos emitidos por versões do plugin anteriores à 0.7 não têm estes dados guardados e nunca avisam.