Ir para o conteúdo

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.

O topo da página de definições Faturação PT de um evento: a nota sobre as definições do organizador, os cartões dos serviços, o prefixo das referências de produto e as primeiras opções gerais

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.

A página de definições Faturação PT do organizador, no menu Configurações do organizador, com a nota de que são predefinições para todos os seus eventos

  • 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:

  1. 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.

    As definições de faturação do pretix com o campo personalizado de destinatário chamado NIF

  2. 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 formulário da morada de faturação no checkout com um único campo NIF

  • 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 formulário da morada de faturação no checkout com "Empresa ou organização" selecionado e o campo NIF marcado como obrigatório

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>.

    O formulário de contacto do checkout com a opção "Discriminar a fatura por 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.