DataFirefly Editor de faturas PDF para PrestaShop

Apresentação

O módulo dfinvoiceeditor substitui o esquema das faturas PDF do PrestaShop 8 e 9 pelo seu, definido no back-office. Não altera nenhum ficheiro .tpl nem instala overrides: quando o PrestaShop gera uma fatura, o módulo fornece o seu próprio cabeçalho, corpo e rodapé. Ao desativar o módulo ou o seu interruptor principal, volta a fatura original.

As definições aplicam-se a todas as faturas geradas pelo PrestaShop: a anexada aos e-mails de encomenda, a descarregada na conta do cliente e as impressas uma a uma ou em lote no back-office. Em opção, as guias de remessa adotam a mesma apresentação.

Instalação

1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e envie o ficheiro dfinvoiceeditor.zip.
2. O módulo cria a sua tabela de definições, a pasta img/dfinvoiceeditor para o logótipo e a página Encomendas > Editor de faturas.
3. Abra essa página. O esquema do módulo fica ativo desde a instalação com definições predefinidas sóbrias: gere uma pré-visualização para o ver.

O editor

A página divide-se em secções listadas na coluna da esquerda. Por baixo, um esquema da página A4 realça a zona da fatura em edição. A barra inferior indica se há alterações por guardar e contém o botão Guardar.

Os textos impressos existem em cada idioma da loja. Os botões de idioma sob o cabeçalho escolhem o idioma mostrado em todos os campos multilingues.

Pré-visualização e comparação

No topo da página, escolha uma fatura recente da loja e depois Fatura ou Guia de remessa:

• Pré-visualizar abre o PDF num novo separador com as definições do ecrã, mesmo por guardar. Só um logótipo acabado de carregar espera pelo guardar.
• Comparar com a fatura PrestaShop abre o mesmo documento no esquema original.

Definições gerais

• Usar este esquema nas faturas: o interruptor principal. Desligado, o PrestaShop volta a imprimir a sua fatura, sem perder definições.
• Usar também este esquema nas guias de remessa: ver a secção Guias de remessa.
• Idioma da fatura: o da encomenda (recomendado) ou o do funcionário que gera o PDF.
• Tipo de letra: automático por idioma, Helvetica, DejaVu Sans, Times ou Courier. O DejaVu Sans cobre também polaco, grego e cirílico.
• Tamanho do texto de 7 a 12 pt e quatro cores: destaque (título, cabeçalho da tabela, total a pagar, títulos de secção), texto, texto secundário e texto sobre a cor de destaque.

Cabeçalho e logótipo

Escolha o logótipo de fatura da loja, um logótipo próprio para faturas ou nenhum. O logótipo próprio aceita PNG, JPG ou GIF até 2 MB; um PNG com pelo menos 600 px de largura imprime nítido. Defina a largura de 10 a 90 mm e a posição à esquerda ou à direita. A altura está limitada a 26 mm para que o cabeçalho nunca se sobreponha ao conteúdo.

Moradas e resumo

O bloco do vendedor é um texto livre com variáveis, por predefinição {shop_name}, {shop_address} e {shop_details} (os dados de Parâmetros da loja > Contacto). As moradas de faturação e de entrega usam o formato de morada do país; a de entrega pode ser ocultada quando é igual à de faturação. Número de IVA, telefone e e-mail do cliente são opcionais.

A barra de resumo, uma faixa colorida sob as moradas, mostra à escolha a referência e a data da encomenda, o pagamento, o vencimento, a transportadora e o número de seguimento, além dos campos personalizados colocados na barra.

Linhas de produtos

A tabela reúne as 12 colunas disponíveis: imagem, referência, nome, EAN-13, referência do fornecedor, preço unitário sem IVA, preço unitário com IVA, desconto, taxa de IVA, quantidade, total sem IVA, total com IVA. Para cada uma, marque a impressão, altere o título em cada idioma, defina a largura relativa e o alinhamento, e mude a ordem com as setas. A faixa acima mostra a repartição das larguras, ajustadas para preencher a página.

• As combinações («Tamanho: M, Cor: Azul») passam para uma segunda linha mais pequena.
• As personalizações introduzidas pelo cliente imprimem-se sob o nome do produto.
• A miniatura do produto mede de 6 a 25 mm.
• Linha sob cada fila, grelha completa ou sem contornos; linhas alternadas sombreadas opcionais.
• Os títulos das colunas repetem-se no topo de cada página de uma fatura longa.

Totais

• Resumo do IVA por taxa: incidência e valor por taxa, com produtos, envio, embrulho de oferta e ecotaxa agrupados.
• Ocultar as linhas a zero de desconto e embrulho de oferta.
• Listar os pagamentos recebidos com método, valor e data.
• Conteúdo acrescentado por outros módulos: o que outros módulos acrescentam às faturas através do hook displayPDFInvoice continua impresso, após os totais, após as linhas de produtos, ou oculto.

Pagamento e vencimento

Vencimento e valor em dívida

O prazo de pagamento em dias após a data da fatura imprime a data de vencimento na barra de resumo e preenche a variável {due_date}. Deixe 0 para não imprimir vencimento.

Quando uma fatura está paga em parte, as linhas Já pago e Valor em dívida aparecem sob o total com IVA. O valor pago é a soma dos pagamentos associados à fatura no PrestaShop. O carimbo opcional Paga imprime-se sob os totais quando a fatura está liquidada.

Dados bancários e código QR SEPA

Escolha quando imprimir o bloco bancário: nunca, só quando há valor em dívida, ou sempre. Preencha o titular (o nome da loja se vazio), o banco, o IBAN, o BIC e a referência de pagamento, por predefinição {invoice_number}. O IBAN é verificado pelos dígitos de controlo: um IBAN errado é assinalado e bloqueia o guardar.

O código QR SEPA (formato EPC069-12) contém beneficiário, IBAN, BIC, valor ainda em dívida e referência. O cliente lê-o com a app do banco e a transferência fica preenchida. Só é impresso em faturas em euros e só quando há valor em dívida.

Campos personalizados

Acrescente os campos de que precisar: número de nota de encomenda, NIF do cliente, condições de pagamento, mensagem do cliente. Cada campo tem:

• uma etiqueta e um conteúdo em cada idioma, com negrito, itálico e sublinhado;
• uma posição: barra de resumo, sob as moradas, sob as linhas de produtos, sob os totais ou no rodapé;
• a escolha Imprimir em: faturas, guias de remessa ou ambas;
• a opção Ocultar quando as variáveis estão vazias;
• condições de impressão (ver abaixo).

O painel Variáveis insere uma variável no último campo editado. As variáveis cobrem a loja (nome, morada, e-mail, telefone, dados), a encomenda e a fatura (número, datas, vencimento, valor em dívida, pagamento, transportadora, seguimento, número da guia de remessa, moeda) e o cliente (nome, empresa, e-mail, número de IVA, SIRET, APE, DNI, telefones, mensagem deixada na encomenda).

Menções legais por país

Cada regra contém um texto por idioma e condições. Todas as regras que correspondem à fatura são impressas, pela ordem da lista, num quadro sob os totais ou no rodapé.

Condições

• Destino: todos os países, país da loja, União Europeia, UE exceto o país da loja, fora da UE, ou uma lista de países. Clique num país para o selecionar ou retirar.
• Cliente: qualquer, com ou sem número de IVA, empresa ou particular.
• Imposto na fatura: com ou sem imposto.

O país usado nas regras é por predefinição o da morada que o PrestaShop usa para calcular os impostos; pode forçar a morada de faturação ou de entrega.

Regras de exemplo

São instaladas três regras inativas: transmissão intracomunitária isenta (artigo 138.º da Diretiva 2006/112/CE, com o número de IVA do cliente), exportação para fora da UE (artigo 146.º) e condições de atraso B2B em França (penalizações e indemnização fixa de 40 EUR). Peça ao seu contabilista que valide o texto antes de as ativar.

Rodapé

O texto do rodapé imprime-se no fim de cada página, por predefinição {shop_name}, {shop_address_inline}. Limite-o a três linhas: o PrestaShop reserva pouco espaço ao rodapé, os textos longos vão num campo personalizado sob os totais. Podem ser acrescentados o texto legal livre e o texto de rodapé de Encomendas > Faturas.

Textos

A secção Textos lista cada palavra impressa na fatura: título, número, datas, títulos das moradas, totais, resumo do IVA, vencimento, dados bancários, textos das guias de remessa. Vêm preenchidos em português, inglês, francês, espanhol, alemão, italiano, neerlandês e polaco, e editáveis em cada idioma.

Guias de remessa

Ative Usar também este esquema nas guias de remessa nas definições gerais. A guia retoma logótipo, cores, moradas, barra de resumo e linhas de produtos, sem qualquer preço: só se imprimem as colunas imagem, referência, nome, EAN-13, referência do fornecedor e quantidade. Totais, dados bancários, menções legais e texto legal da fatura não aparecem. O cabeçalho indica o número da guia, a data e o número da fatura.

Cópia de segurança e transferência

Exportar as definições descarrega um ficheiro JSON com todas as definições da loja, textos incluídos. Os textos são identificados pelo código de idioma, por isso o ficheiro importa-se noutra loja ou instalação mesmo que os identificadores de idioma sejam diferentes. O logótipo não é incluído. Importar substitui todas as definições da loja atual após confirmação.

Repor as definições predefinidas, na barra inferior, repõe todas as definições e textos originais mantendo o logótipo carregado.

Resolução de problemas

A pré-visualização indica que o editor não conseguiu assumir a fatura

A mensagem a seguir a essa frase indica a causa, também registada em Parâmetros avançados > Logs. Nesse caso o PrestaShop produz a sua fatura original: nenhuma fatura fica bloqueada.

Um funcionário obtém a fatura original

O PrestaShop não executa os hooks de um módulo quando o perfil do funcionário ligado não tem a permissão Ver nesse módulo. Conceda-a em Parâmetros avançados > Equipa > Permissões > Módulos. As faturas enviadas aos clientes e descarregadas na conta deles não são afetadas.

O rodapé sobrepõe-se ao conteúdo

Encurte o texto do rodapé, passe as menções longas para um campo personalizado sob os totais ou escolha a posição «Num quadro sob os totais» para as menções legais.

O código QR não aparece

Verifique se o bloco bancário está ativo, se o IBAN está guardado, se a fatura é em euros e se há valor em dívida. No modo «Sempre», uma fatura liquidada mostra os dados bancários sem código QR.

As notas de crédito mantêm o esquema antigo

A versão 1.0.0 cobre faturas e guias de remessa. As notas de crédito mantêm o esquema do PrestaShop.