PS PrestaShop PrestaShop Intermédio

DataFirefly Dunning: documentação

Instalar, configurar e utilizar a cobrança de dívidas B2B: cenários em 3 níveis, cálculo dos juros de mora e da indemnização de 40 €, cartas em PDF, cron e painel das dívidas.

Atualizado Versão do módulo 1.0.0

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.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte