PrestaShop Contabilidade & Faturação

DataFirefly Factur-X: Faturação Eletrónica PDF/A-3 + XML

Faturas eletrónicas Factur-X conformes à norma europeia EN 16931

Transforme cada encomenda do PrestaShop numa fatura eletrónica híbrida Factur-X: um PDF/A-3b legível e imprimível que contém, incorporados no interior, os dados estruturados em XML CII (norma EN 16931). Transferência individual a partir da ficha de encomenda, geração em massa em arquivo ZIP e disponibilização na área de cliente. Concebido para a reforma francesa da facturação eletrónica de 2026-2027.

Factur-X EN 16931 PDF/A-3b PS 8 e 9 Reforma francesa 2026-2027
  • Reembolso em 30 dias
  • 12 meses de atualizações
  • Suporte em 24h
www.datafirefly.com/pt/
Geração de faturas eletrónicas Factur-X (PDF/A-3 + XML) no PrestaShop
v1.0.0 · atualizado 2026-06-04
O que faz

A versão curta.

01

PDF/A-3b com XML incorporado

Cada fatura é um ficheiro único: um PDF/A-3b imprimível acompanhado dos dados estruturados em XML CII incorporados (objeto EmbeddedFile, matriz /AF, relação /AFRelationship Data, metadados XMP Factur-X). Um só documento para a pessoa e para a máquina.

02

Perfis BASIC, EN 16931, EXTENDED

Escolha o perfil emitido na configuração. EN 16931 para conformidade completa com o núcleo europeu, BASIC para um XML mais leve. O identificador de especificação é definido automaticamente consoante o perfil.

03

Individual, em massa e do lado do cliente

Botões de transferência do PDF e do XML em cada ficha de encomenda, ação em lote para exportar um conjunto de faturas em arquivo ZIP, e ligação opcional « As minhas faturas Factur-X » na área de cliente.

04

Totais recalculados, coerência garantida

Linhas, portes (encargo de documento), descontos (repartidos proporcionalmente pelas bases de IVA) e repartição do IVA são recalculados para satisfazer as regras de equilíbrio BR-CO da EN 16931, independentemente dos arredondamentos do PrestaShop.

A versão longa

Tudo o que quer saber antes de instalar.

Uma análise detalhada de como o DataFirefly Factur-X: Faturação Eletrónica PDF/A-3 + XML funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.

§ 01

Para quem é este módulo em Portugal

Este módulo gera faturas no formato Factur-X, que é o padrão híbrido utilizado em França e na Alemanha. Interessa-lhe se vende a clientes profissionais nesses mercados, se pertence a um grupo que trabalha com esse formato, ou se quer estar preparado para trocas B2B intracomunitárias baseadas na norma europeia EN 16931. Em Portugal, a facturação eletrónica para entidades públicas assenta no CIUS-PT transmitido através da eSPap, e a facturação comercial exige software certificado pela AT com ATCUD e SAF-T (PT): esses requisitos não são cobertos por este módulo, que é um complemento e não um substituto da sua solução certificada.

§ 02

Factur-X: um formato híbrido legível por pessoas e por máquinas

Uma fatura Factur-X é um único ficheiro que reúne dois mundos: um PDF/A-3b que o seu cliente pode abrir, ler e imprimir como uma fatura normal, e um ficheiro XML estruturado incorporado dentro do PDF, que os softwares de contabilidade e as plataformas conseguem ler automaticamente. Deixa de ser preciso enviar um PDF de um lado e um ficheiro de dados do outro: está tudo no mesmo documento, o que elimina os riscos de dessincronização entre a imagem legível e os dados tratados.

§ 03

Dados estruturados conformes à EN 16931

O módulo constrói o XML no formato CII (Cross Industry Invoice do UN/CEFACT), o padrão em que assenta o Factur-X. A ordem dos elementos respeita estritamente o esquema, a identidade do vendedor leva o seu número de identificação (com o identificador de esquema adequado) e o número de IVA intracomunitário, e a repartição do IVA é detalhada taxa a taxa. Estão disponíveis três perfis: BASIC para um XML mais leve, EN 16931 para conformidade completa com o núcleo europeu, e EXTENDED.

§ 04

Uma incorporação robusta, independente da sua versão do TCPDF

O PDF visual é gerado pelo TCPDF já presente no PrestaShop, em modo PDF/A-3b. Já a incorporação do XML não depende de qualquer detalhe interno do TCPDF: é feita por atualização incremental do PDF, uma técnica que acrescenta os objetos necessários (o ficheiro incorporado, a matriz /AF, a relação /AFRelationship Data, os metadados XMP Factur-X e o esquema de extensão PDF/A) sem tocar num único byte do documento existente. Resultado: a solução mantém-se estável seja qual for a versão do TCPDF fornecida com o seu PrestaShop.

§ 05

Todos os seus casos de facturação cobertos

As linhas de encomenda, os portes (modelados como encargo ao nível do documento) e os descontos (modelados como allowance e repartidos proporcionalmente pelas bases de IVA) são traduzidos no XML com a respetiva taxa de IVA. Todos os totais, total sem IVA, base tributável, total do IVA, total com IVA e valor a pagar, são recalculados a partir das linhas e da repartição para respeitar as regras de equilíbrio BR-CO da EN 16931. É a coerência interna do documento que prevalece, aquela que os validadores oficiais verificam.

§ 06

Três formas de obter as faturas

Na ficha de encomenda do back-office, um painel dedicado permite transferir de imediato o PDF Factur-X e o XML isolado. Um separador de administração lista as encomendas e permite a geração em massa: seleciona um conjunto e recebe todas as faturas num arquivo ZIP. Do lado do cliente, uma ligação opcional na área de conta permite ao comprador transferir a fatura. Por fim, pode ser acionada uma geração automática na mudança para um estado de encomenda à sua escolha.

§ 07

Geração e transmissão: o que o módulo faz

Este módulo cobre a geração de faturas Factur-X conformes, a etapa que exige mais rigor técnico. A transmissão através de uma Plataforma Autorizada e, para certas operações, o e-reporting, constituem uma camada distinta que se acrescenta por cima. A versão 1.0 concentra-se na produção de ficheiros conformes, prontos a ser transmitidos pela plataforma à sua escolha ou integrados no seu fluxo contábil, em complemento natural do nosso módulo de exportação contábil.

§ 08

Compatível com o PrestaShop 8 e 9

A arquitetura assenta em ModuleAdminController, Smarty e um autoloader PSR-4 manual (sem Composer), que funcionam de forma idêntica no PrestaShop 8.0, 8.1, 8.2 e 9.0. Sem ramo de código específico, sem dependências Symfony particulares, sem migração dolorosa na passagem para o PrestaShop 9.