Faturação Resumo B2B: documentação

Apresentação

A Faturação Resumo agrupa todas as encomendas de um cliente profissional num período (o mês transato, por defeito) numa única fatura consolidada. Em vez de uma fatura por encomenda, os seus clientes B2B recebem uma fatura mensal única, numerada em sequência, com a repartição do IVA por taxa e o detalhe encomenda a encomenda. O módulo gera o PDF através do motor nativo do PrestaShop, envia-o por e-mail e retira, de passagem, as faturas individuais dos e-mails de encomenda dirigidos aos clientes profissionais.

Instalação

Instale o módulo como qualquer módulo PrestaShop, a partir de Módulos > Gestor de módulos > Carregar um módulo, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas, o seu separador de administração e um valor de token aleatório para o cron. Não é necessária nenhuma dependência Composer.

Configuração

Vá a Módulos > Gestor de módulos e clique em Configurar em frente de Faturação Resumo. A página de configuração reúne todas as definições.

Grupos de clientes B2B

Marque o ou os grupos de clientes considerados profissionais. Só os clientes que pertencem a estes grupos veem as suas encomendas consolidadas, recebem a fatura resumo e acedem à área « As minhas faturas resumo ». É esta definição que delimita o seu perímetro B2B.

Estados de encomenda incluídos

Selecione os estados de encomenda que tornam uma encomenda elegível para a consolidação (por defeito: pagamento aceite, em preparação, enviada, entregue). Uma encomenda cujo estado atual não figure nesta lista é ignorada na geração.

Dia de geração

Escolha o dia do mês (de 1 a 28) em que o cron desencadeia a geração do mês anterior. Um dia entre 1 e 28 garante que a data existe em todos os meses.

Prefixo e numeração

Defina o prefixo de numeração (por defeito REC). As faturas resumo são numeradas em sequência no formato PREFIXO-AAAA-00042, através de um contador dedicado. Os números nunca são reutilizados, mesmo depois da eliminação de uma fatura.

Envio automático e limpeza dos e-mails

Dois interruptores controlam o comportamento de envio:

• Envio automático por e-mail: na geração (cron ou manual), a fatura resumo é enviada ao cliente com o PDF anexado.
• Retirar a fatura individual dos e-mails de encomenda: para os clientes B2B, o PDF da fatura individual é retirado dos e-mails de encomenda, para só conservar um envio limpo: a fatura resumo mensal.

Menções legais e condições de pagamento

Duas zonas de texto multilingues permitem-lhe personalizar as menções legais (por defeito, um lembrete do artigo 289 I-3 do CGI francês relativo à fatura periódica recapitulativa) e as condições de pagamento apresentadas no rodapé da fatura. Estes textos podem ser introduzidos em cada um dos idiomas da loja.

Automatização por cron

A geração automática assenta num URL de cron protegido por um token. Recupere o URL completo (token incluído) no painel de informação da página de configuração e agende-o no planificador de tarefas do seu servidor. Exemplo de entrada crontab para um disparo diário:

0 6 * * * wget -q -O /dev/null "https://a-sua-loja.pt/module/dfdeferredinvoicing/cron?token=O_SEU_TOKEN"

O cron é idempotente: só gera a fatura de um cliente se ela ainda não existir para o período. Pode portanto executá-lo todos os dias sem risco: só o dia de geração configurado desencadeia realmente o processamento do mês anterior.

Parâmetros opcionais

• &force=1: força a geração qualquer que seja o dia do mês.
• &month=6&year=2026: visa um período preciso (útil para reprocessar um mês passado).

A resposta é devolvida em formato JSON, com o número de clientes processados, de faturas criadas e de encomendas consolidadas.

Utilização no dia a dia

Separador « Faturas resumo »

É acrescentado um separador Faturas resumo em Encomendas. Lista todas as faturas resumo geradas, com o número, o cliente, o período, o número de encomendas, o total com IVA e o estado de envio do e-mail. Cada linha propõe descarregar o PDF, reenviar o e-mail ou eliminar a fatura.

Geração manual

No topo deste separador, um painel permite gerar manualmente um período (mês e ano, pré-preenchidos com o mês anterior) para o conjunto dos clientes B2B ou para um cliente preciso. É útil para uma recuperação pontual ou para emitir a fatura de um cliente a pedido.

Área de cliente

Os clientes profissionais dispõem de uma ligação « As minhas faturas resumo » na sua conta, onde encontram e descarregam o conjunto das suas faturas consolidadas. Esta ligação só aparece para os clientes que pertencem aos grupos B2B configurados.

O que contém a fatura resumo

Cada fatura retoma: os dados da loja e a morada de faturação do cliente (denominação social, número de IVA), o detalhe encomenda a encomenda (data, referência, número da fatura PrestaShop de origem, montante), a repartição do IVA por taxa (produtos e portes), com uma linha de ajuste de arredondamento se aparecer uma diferença mínima, depois os totais sem IVA / IVA / com IVA, e por fim as suas condições de pagamento e menções legais.

Garantias e limites

• Anti-duplicado: cada encomenda é registada numa tabela de ligação onde é única. Uma encomenda já consolidada nunca pode ser retomada noutra fatura resumo.
• Eliminação: eliminar uma fatura resumo liberta as suas encomendas, que voltam a ser elegíveis para uma nova consolidação. O número eliminado não é, porém, reatribuído.
• Faturas individuais: continuam visíveis no histórico de encomendas do lado do cliente; só o e-mail fica sem elas. Ocultá-las quebraria a contabilidade do PrestaShop.
• Repartição do IVA: a repartição por taxa é reconstituída a partir das linhas de encomenda e da entrega; pode ser aproximada no caso raro em que um mesmo produto acumula vários impostos sobrepostos.

Compatibilidade

A Faturação Resumo é compatível com PrestaShop 8.0 a 9.x, em loja simples como em multiloja, nos cinco idiomas do catálogo (francês, inglês, espanhol, alemão, italiano; o português acrescenta-se em Internacional > Traduções e nos campos multilingues das menções), sem qualquer dependência Composer.