Ir para o conteúdo

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 webhook quando é 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.