Resolução de problemas¶
Ambos os plugins¶
O plugin não aparece em Configurações → Plugins.
O pretix só lê os plugins instalados no arranque — reinicie-o (servidor web e workers do Celery)
depois do pip install. Confirme que instalou no mesmo ambiente Python em que o pretix corre.
euPago¶
Os pagamentos ficam pendentes para sempre. Os pagamentos só são confirmados pelo webhook da euPago. Confirme que:
- o URL do webhook
https://<o-seu-domínio-pretix>/eupago/webhook/está definido no Backoffice da euPago para todos os canais que usa (Webhooks); - a sua instância do pretix está acessível a partir da internet nesse endereço;
- a Chave do webhook está definida em Configurações → euPago — sem ela, as notificações de pagamento v2.0 são recusadas;
- o log do pretix mostra linhas
euPago webhookquando é feito um pagamento — se não houver nenhuma, a euPago não está a chegar até si.
O webhook responde webhook key not configured.
Chegou uma notificação v2.0 de pagamento ou reembolso para um evento sem Chave do webhook. Copie a
chave do webhook do canal no Backoffice para Configurações → euPago. A euPago volta a tentar as
notificações falhadas durante algum tempo, por isso os pagamentos recentes costumam confirmar-se
sozinhos depois de a definir; confirme os mais antigos à mão.
Uma notificação v1.0 é ignorada (chave_api mismatch no log).
A notificação trouxe uma chave API diferente da configurada no pretix. Copie de novo a chave API desse
canal em Backoffice → Canais → Listagem de Canais.
O webhook responde invalid signature.
A assinatura de uma notificação v2.0 não corresponde à Chave do webhook. Copie de novo a chave
nas definições de webhook do canal no Backoffice.
O webhook responde invalid credentials (webhooks encriptados).
A notificação foi encriptada com a chave do webhook de outro evento, e não com a do evento a que o
pagamento pertence. Confirme que cada evento tem a chave do seu próprio canal.
As notificações chegam, mas nada acontece (webhooks encriptados).
Com a opção "encriptar" da euPago ligada, o log do pretix mostra
could not decrypt payload with any configured webhook secret. A notificação é aceite mas ignorada,
por isso a euPago não a volta a enviar. Defina a chave do canal como Chave do webhook no pretix e
confirme à mão os pagamentos afetados.
O Multibanco e o MB WAY não aparecem no checkout. Ficam ocultos quando a moeda do evento não é o euro, ou quando o Modo de sandbox está ativo mas o evento não está em modo de teste. A página Configurações → euPago mostra um aviso em ambos os casos.
O checkout diz "Não foi possível contactar o fornecedor de pagamentos" ou "O fornecedor de pagamentos devolveu um erro". O pedido à euPago falhou. Normalmente é uma chave API errada, ou o Modo de sandbox não corresponde à chave: as chaves de sandbox e de produção são diferentes.
O checkout diz "Não foi possível enviar o pedido MB WAY para este número". A euPago recusou o pedido MB WAY — normalmente o número não está registado no MB WAY. O comprador pode tentar outro número ou método de pagamento. A resposta da euPago fica no log do pretix.
Aparece "O modo de sandbox da euPago está ativo" no checkout. Desligue o Modo de sandbox antes de vender a sério — em sandbox não é cobrado nenhum pagamento real.
O comprador não aprovou o MB WAY a tempo. O pedido expira ao fim de 5 minutos. O comprador pode pagar novamente na página da encomenda.
Foi feito um pagamento, mas o pedido continua expirado (quota is exceeded no log).
O comprador pagou depois de o pedido expirar e de os bilhetes terem sido vendidos. O pagamento fica
registado no pedido; reembolse-o ou liberte um bilhete à mão.
Um reembolso feito na euPago não aparece no pretix.
É registado quando a euPago envia uma notificação Refund — confirme que o webhook está a funcionar.
Os reembolsos não podem ser iniciados a partir do pretix.
Faturação PT¶
A maioria dos problemas aparece no painel Faturação PT ou no painel Faturação PT da encomenda, com a mensagem do serviço de faturação. Depois de corrigir a causa, carregue em Tentar novamente.
Uma encomenda paga não tem fatura, nem linha no painel. A emissão é ignorada sem aviso quando:
- não há nenhum Serviço de faturação selecionado, nem no evento nem no organizador, ou o cartão do serviço foi escolhido mas nunca guardado (a página de definições mostra então Ainda não está em uso);
- Emitir documentos automaticamente está desligado;
- o plugin não está ativo no evento (as definições do organizador, por si só, não o ativam), ou a encomenda não está paga;
- a encomenda é gratuita: um total de 0,00 nunca é faturado.
Corrija as definições e use Emitir fatura agora na página da encomenda. As encomendas pagas antes de o plugin estar configurado também precisam disto; para muitas de uma vez, veja Emissão em massa.
Não emitida: o Fact.pt não está totalmente configurado, ou a ligação expirou.
O serviço está selecionado mas não consegue emitir: o Fact.pt não tem token da API, falta uma
definição obrigatória do Moloni, ou a ligação ao Moloni expirou. A linha fica guardada para a
encomenda não ser esquecida. Corrija as definições e carregue em Tentar novamente.
Uma linha fica em "A processar". A tarefa foi posta na fila mas nunca correu: os workers do Celery do pretix não estão a correr, ou não estão a apanhar tarefas. Verifique-os. Ao fim de dez minutos a linha deixa de contar como em curso e aparece Tentar novamente.
… — nova tentativa automática dentro de alguns minutos / … — desistiu ao fim de várias tentativas
Uma falha de rede com o serviço. A primeira mensagem quer dizer que a tarefa vai tentar de novo
sozinha (três vezes, com uns minutos de intervalo); a segunda, que todas as tentativas falharam.
Carregue em Tentar novamente quando o serviço estiver acessível. Tentar de novo nunca emite duas
vezes: o Fact.pt recusa duplicados, e o plugin pergunta ao Moloni por um documento existente antes
de cada tentativa. Se o pedido falhado tiver afinal criado o documento, a nova tentativa encontra-o
e associa-o à encomenda.
… — o documento pode ou não ter sido criado. Confirme no … antes de tentar novamente
Só aparece num serviço que não consegue recusar um duplicado nem ser consultado sobre um documento
existente. Desde a 0.9 nenhum dos serviços incluídos está nessa situação; as linhas que falharam
numa versão anterior podem ainda ter a mensagem. Carregar em Tentar novamente nelas é agora
seguro, pela razão acima.
Divergência de IVA: o pretix cobrou X% nesta encomenda mas a taxa configurada no Fact.pt é Y%
O pretix e o Fact.pt não concordam na taxa de IVA, e a fatura ficaria com o valor errado. Corrija a
regra fiscal do evento no pretix, ou escolha a taxa de IVA correspondente nas definições do
plugin. Veja Fact.pt.
A taxa de IVA N não existe nesta conta Fact.pt.
A taxa configurada foi apagada no Fact.pt, ou o token é de outra conta (ou do outro ambiente —
confirme Usar ambiente de testes (sandbox)). Escolha de novo a taxa.
Multiple clients with same tin. Specify an ID.
O Fact.pt tem vários clientes com o NIF do comprador, e o plugin não adivinha a qual faturar. Junte
ou apague os duplicados no Backoffice do Fact.pt e tente novamente.
Falha de ligação ao Fact.pt: … / Não foi possível contactar o Moloni: …
O serviço estava em baixo ou inacessível. Veja as mensagens de nova tentativa acima: a tarefa repete
sozinha.
price: Trying to use an item having more than 2 decimal digits, in an incompatible series.
A série associada à chave da API do Fact.pt tem 2 casas decimais. O plugin precisa de uma série com
8 casas decimais; associe uma à chave no Backoffice do Fact.pt. Veja
Configurar o Fact.pt.
Resposta inválida do Fact.pt (HTTP …)
Muitas vezes é um token de produção usado na sandbox, ou o contrário. Confirme Usar ambiente de
testes (sandbox).
O Moloni rejeitou o pedido. seguido de uma lista de campos
Os erros de validação do Moloni, um por campo. document_set_id ou document_set_wsat_id must be
valid quer dizer que a série escolhida não serve: não é do tipo de documento certo (as notas de
crédito precisam de série própria), ou não é da empresa selecionada. Escolha de novo a série nas
definições e tente novamente.
O Moloni tem N clientes com o NIF X. Junte-os no Moloni e tente novamente.
Vários clientes do Moloni têm o NIF do comprador, e o plugin não adivinha a qual faturar. Junte-os
no Moloni e carregue em Tentar novamente.
O Moloni recusou as credenciais.
Confirme o ID de programador, o segredo do cliente, o utilizador e a palavra-passe. São verificados
em direto quando os preenche: os erros aparecem por baixo das definições do Moloni.
Sem ligação ao Moloni, ou a ligação expirou.
A ligação ao Moloni não existe ou expirou, e não há utilizador/palavra-passe definidos como
alternativa. Carregue em Ligar ao Moloni (ou Voltar a ligar) nas definições e tente
novamente. O plugin renova a ligação todos os dias, por isso isto costuma significar que o Moloni a
revogou. Se a página do evento disser A ligação do organizador ao Moloni expirou, volte a ligar em
Configurações → Faturação PT do organizador; fica reposta para todos os eventos que a usam. Veja
A ligação.
A referência “…” de “…” tem N caracteres; o Moloni permite 30.
O prefixo e a referência do produto juntos passam do limite do Moloni. Não foi criado nada. Encurte
a referência do produto na sua página, ou o Prefixo das referências de produto nas definições, e
tente novamente. Veja Artigos.
Um evento ignora uma alteração feita nas definições de faturação do organizador. O evento guardou um valor próprio para essa definição, que continua a aplicar-se. Abra Configurações → Faturação PT do evento e defina aí o valor, ou carregue em Usar as definições do organizador para remover tudo o que o evento guardou. Veja Definições ao nível do organizador.
Divergência de IVA: o pretix cobrou X% nesta encomenda mas a taxa configurada no Moloni é Y%
Tal como no Fact.pt: corrija a regra fiscal do evento, ou escolha a taxa de IVA correspondente.
Nada foi criado no Moloni. Veja IVA.
Esta encomenda tem linhas com IVA a 0%, que o Moloni só aceita com um motivo de isenção.
Defina um Motivo de isenção (por exemplo M07) nas definições do Moloni e tente novamente.
As listas de taxa de IVA / empresa / série de documentos não aparecem. São preenchidas a partir da sua conta no serviço quando as credenciais são válidas. Se ficarem como campos numéricos, a linha por baixo das definições do serviço diz porquê (token errado, serviço inacessível).
A fatura saiu para consumidor final, mas o comprador indicou um NIF.
O pretix só pede Número de IVA a clientes empresa. Peça-o a toda a gente com um campo personalizado
na morada de faturação; veja NIF. Os NIF que não passam no
dígito de controlo português são ignorados (espaços, pontos e o prefixo PT são aceites).
As empresas portuguesas não conseguem concluir o checkout. A opção Exigir número de IVA do pretix está ligada enquanto o campo personalizado contém o NIF, o que esconde o campo de Número de IVA do pretix em moradas portuguesas. Desligue a obrigatoriedade.
"Indique o seu NIF nos dados de faturação." no checkout. Exigir o NIF no checkout está ligado, e o comprador tem uma morada portuguesa sem NIF: uma empresa tem sempre de o indicar, um particular quando a opção Exigir endereço de facturação do pretix está ligada. Se não é o que pretende, desligue a opção. Veja Exigir o NIF.
"O comprador alterou os dados de faturação depois de emitida a fatura …" Não é um erro: o comprador editou a morada de faturação depois de faturado, e o e-mail de contacto do evento recebeu a mesma mensagem. Um documento emitido não pode ser alterado. Para aceitar os dados novos, carregue em Emitir nota de crédito e depois em Emitir fatura agora; para manter o documento como está, ignore o aviso. Veja Alterações aos dados de faturação depois de faturar.
O PDF do Moloni mostra um preço unitário de 34,99999 em vez de 35,00. O Moloni guarda os preços unitários com 5 casas decimais, e um preço com IVA dividido por 1,23 não acaba. A incidência, o IVA e o total estão certos. Veja IVA.
Uma encomenda foi reembolsada, mas não foi emitida nota de crédito. Só é emitida automaticamente quando:
- o reembolso está marcado como concluído no pretix;
- os reembolsos somam o valor total pago — um reembolso parcial não emite nada;
- a fatura da encomenda foi emitida com sucesso.
Caso contrário, use Emitir nota de crédito na página da encomenda. Veja Notas de crédito.
O comprador não recebeu o documento por e-mail. Os dois e-mails estão desligados por omissão — ligue-os em E-mail. Um e-mail que falhe não marca a emissão como falhada; consulte o log do pretix.
A descarga do PDF devolve "não encontrado". O documento foi emitido por outro serviço que não o atualmente selecionado, e as credenciais do serviço antigo não são guardadas. Descarregue-o no back office desse serviço. Do lado do comprador, a descarga também desaparece quando Mostrar a fatura na página da encomenda do comprador está desligado ou o plugin está desativado no evento.