# DataFirefly Dunning: documentação > Apresentação O DataFirefly Dunning automatiza a cobrança amigável das encomendas B2B pagas por transferência bancária e que ficaram por liquidar. Logo na validação de uma encomenda elegível, o módulo abre… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfdunning/index.md), [en](https://www.datafirefly.com/en/documentation/dfdunning/index.md), [es](https://www.datafirefly.com/es/documentation/dfdunning/index.md), [de](https://www.datafirefly.com/de/documentation/dfdunning/index.md), [it](https://www.datafirefly.com/it/documentation/dfdunning/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdunning/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdunning/index.md) - Índice: ## Apresentação O DataFirefly Dunning automatiza a cobrança amigável das encomendas B2B pagas por transferência bancária e que ficaram por liquidar. Logo na validação de uma encomenda elegível, o módulo abre um processo de dívida, acompanha o seu vencimento, despoleta avisos graduais segundo um calendário que definir e calcula os juros de mora e a indemnização fixa de cobrança de 40 €. São fornecidos três níveis de aviso na instalação (aviso cortês, aviso firme com juros e PDF, interpelação formal), todos inteiramente parametrizáveis. Um painel dedicado centraliza o saldo em dívida, a antiguidade dos saldos e o acompanhamento dos envios. **Enquadramento legal: leia antes de configurar.** Os valores e as referências fornecidos de origem seguem o direito francês. Em Portugal, o quadro aplicável aos atrasos de pagamento nas transações comerciais é o Decreto-Lei n.º 62/2013, que transpõe a Diretiva 2011/7/UE. Três consequências práticas: - A **indemnização fixa de 40 €** tem origem na própria diretiva e aplica-se igualmente em Portugal. Este valor predefinido pode ficar como está. - A **taxa de juro** predefinida (12,15 %, correspondente à taxa diretora do BCE acrescida de 10 pontos) é a regra francesa. Em Portugal, a taxa de juro comercial legal é fixada semestralmente por aviso publicado no Diário da República. Substitua o valor predefinido pela taxa em vigor e reveja-o em janeiro e julho. - A referência ao **artigo 1231-6 do Código Civil francês**, usada no modelo de interpelação formal, não tem aplicação em Portugal. O regime da mora consta dos artigos 804.º e seguintes do Código Civil português. Reescreva o modelo do nível 3 com o seu advogado antes de o utilizar. ## Instalação 1. Coloque a pasta `dfdunning` no diretório `/modules/` da sua loja, ou instale o ficheiro ZIP em **Módulos > Gestor de módulos**. 2. Clique em **Instalar**. O módulo cria as suas tabelas, os seus três níveis de aviso predefinidos, a configuração inicial, um token de segurança para o cron e o separador de administração em **Encomendas > Cobrança de dívidas (DF Dunning)**. 3. Limpe a cache do PrestaShop, se for necessário, em **Parâmetros avançados > Desempenho**. ## Configuração A configuração está acessível em **Módulos > Gestor de módulos > dfdunning > Configurar**. As definições principais são: - **Módulos de pagamento acompanhados**: os módulos cujas encomendas abrem um processo de dívida. Por predefinição, a transferência bancária (`ps_wirepayment`). - **Estados de encomenda acompanhados**: os estados considerados «a aguardar pagamento». Por predefinição, o estado de pagamento por transferência pendente. - **Prazo de pagamento**: número de dias concedidos até ao vencimento. Por predefinição, 30 dias. - **Taxa dos juros de mora**: taxa anual aplicada. Por predefinição, 12,15 % (regra francesa: taxa diretora do BCE acrescida de 10 pontos). - **Indemnização fixa**: montante fixo por fatura em atraso. Por predefinição, 40 €. - **Intervalo mínimo entre dois avisos**: proteção antispam, 3 dias por predefinição. - **Envio automático**: ativa o envio dos avisos na passagem do cron. - **Cópia oculta (BCC)**: endereço que recebe uma cópia de cada aviso, para registo contabilístico. A taxa predefinida evolui com a taxa do BCE, seja qual for o país. Reveja-a de seis em seis meses (janeiro e julho) na configuração e, numa loja portuguesa, alinhe-a com o aviso em vigor publicado no Diário da República. ## Os três níveis de aviso Um nível de aviso define quando e como um cliente é avisado. Cada nível parametriza-se na configuração: posição na sequência, prazo de acionamento (em dias após o vencimento), modelo de e-mail, inclusão ou não dos juros, anexo em PDF e ativação. ### Nível 1 — Aviso cortês (V+7) Um lembrete simples, sem juros nem anexo, enviado 7 dias após o vencimento. Objetivo: assinalar o esquecimento sem degradar a relação comercial. ### Nível 2 — Aviso firme (V+15) Um aviso mais firme, com o detalhe dos juros de mora e a indemnização fixa, acompanhado de uma carta em PDF. Enviado 15 dias após o vencimento. ### Nível 3 — Interpelação formal (V+30) Uma interpelação formal que recorda as quantias devidas e os juros, com carta em PDF e prazo de pagamento de 8 dias. Enviada 30 dias após o vencimento. O modelo de origem cita o artigo 1231-6 do Código Civil francês: substitua essa referência antes de o usar em Portugal. Os prazos e o conteúdo de cada nível são indicativos: adapte-os à sua política de cobrança e às suas condições gerais de venda. ## Cálculo dos juros Para cada dívida em atraso, o módulo calcula: - **Os juros de mora**: montante em dívida × (taxa / 100) × (dias de atraso / 365). - **A indemnização fixa de cobrança**: um montante fixo por fatura (40 € por predefinição), devido desde o primeiro dia de atraso. O montante em dívida é determinado a partir do total a pagar e do total efetivamente recebido na encomenda, o que cobre os pagamentos parciais. A base legal de origem são os artigos L441-10 e D441-5 do Código Comercial francês para a indemnização e os juros, e o artigo 1231-6 do Código Civil francês para a interpelação. Em Portugal, a base equivalente é o Decreto-Lei n.º 62/2013 e os artigos 804.º e seguintes do Código Civil. Os modelos de carta refletem o quadro legal francês em vigor. Faça-os validar pelo seu advogado e adapte-os à sua atividade antes da fase de interpelação formal. A DataFirefly não presta aconselhamento jurídico. ## Automatização por cron A sincronização das dívidas e o envio automático dos avisos assentam num controlador do front-office protegido por um token. O URL completo, com o token gerado na instalação, é apresentado no ecrã de configuração, pronto a copiar. Tem a seguinte forma: ``` https://aminhaloja.tld/index.php?fc=module&module=dfdunning&controller=cron&token=O_SEU_TOKEN ``` Agende uma chamada diária, por exemplo às 7 da manhã, através da tarefa agendada (crontab) do seu servidor: ``` 0 7 * * * curl -s "https://aminhaloja.tld/index.php?fc=module&module=dfdunning&controller=cron&token=O_SEU_TOKEN" ``` Em cada passagem, o módulo atualiza as dívidas (vencimentos, fechos, exclusões) e, se o envio automático estiver ativado, expede os avisos cuja data chegou, respeitando o intervalo mínimo configurado. O token protege o acesso ao cron: sem ele, o URL devolve um erro. Regenere-o se achar que foi exposto. ## Painel das dívidas O painel, em **Encomendas > Cobrança de dívidas (DF Dunning)**, apresenta: - **Seis indicadores principais**: saldo total em dívida, montante vencido, dívidas em atraso, processos abertos, juros teóricos e avisos do mês. - **Uma análise de antiguidade dos saldos**, que reparte o valor em dívida por escalão: por vencer, 1-30, 31-60, 61-90 e mais de 90 dias. - **Uma lista filtrável** das dívidas (abertas, em atraso, pagas, excluídas), com ações em cada linha: enviar um nível de aviso à escolha, marcar como paga, excluir ou voltar a incluir, descarregar a carta em PDF. Um processo fecha-se automaticamente quando a encomenda passa a um estado de paga e é excluído se a encomenda for anulada, reembolsada ou ficar em erro de pagamento. ## Cartas em PDF e e-mails Os avisos são enviados por e-mail (versões HTML e texto) e, consoante o nível, acompanhados de uma carta em PDF. As cartas são geradas em francês ou em inglês, conforme o idioma da encomenda. Os modelos usam variáveis substituídas no envio: nome próprio, apelido, referência da encomenda, montante em dívida, data de vencimento, dias de atraso, juros, indemnização fixa, total devido, taxa aplicada e nome da loja. Os e-mails podem ser alterados em **Design > Traduções > Traduções dos e-mails**, idioma a idioma, como qualquer e-mail do PrestaShop. Numa loja portuguesa, crie aí a versão portuguesa dos três níveis: é a ocasião de substituir também as referências legais francesas. ## FAQ ### Que encomendas são objeto de aviso? Apenas as que correspondem aos módulos de pagamento e aos estados selecionados na configuração. Por predefinição, as encomendas pagas por transferência a aguardar liquidação. ### Uma encomenda paga parcialmente é tratada? Sim. O montante em dívida tem em conta as quantias já recebidas; só a parte restante é objeto de aviso, e o processo fecha-se quando o saldo é liquidado. ### O módulo é compatível com o PrestaShop 9 e com multiloja? Sim. Os controladores de administração assentam no ModuleAdminController para compatibilidade com o PrestaShop 8 e 9, sem Composer, e o módulo trata o contexto multiloja. ### Posso despoletar um aviso manualmente? Sim. A partir do painel, pode enviar de imediato o nível que quiser para uma dívida específica, independentemente do cron.