Tudo o que quer saber antes de instalar.
Uma análise detalhada de como o DataFirefly Factur-X SW: fatura eletrónica Shopware 6 com ZUGFeRD e XRechnung 3.0 funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.
A fatura eletrónica deixou de ser opcional
Na Alemanha, qualquer empresa tem de conseguir receber faturas eletrónicas B2B desde janeiro de 2025, e a obrigação de emissão vai sendo alargada por fases até 2028. O B2G já exige XRechnung com Leitweg-ID. Em França, o mandato Factur-X impõe a receção a partir de setembro de 2026 e a emissão em 2026-2027 consoante a dimensão da empresa. Se a sua loja Shopware vende em B2B ou fatura administrações, a fatura eletrónica conforme à EN 16931 torna-se uma condição para ser pago.
O que o nativo do Shopware não cobre
O Shopware oferece uma saída ZUGFeRD básica desde a versão 6.6.10, mas não produz XRechnung 3.0, não gere o Leitweg-ID, não existe nas versões 6.5 e 6.6 anteriores, e os seus dados de vendedor ficam limitados às definições de documento. O DfFacturX é uma suíte de conformidade completa: vários perfis, dados de vendedor detalhados por canal de venda, instruções de pagamento SEPA, categorias de IVA automáticas, anexo por email e ferramentas de regeneração.
XRechnung 3.0 e Leitweg-ID, sem improvisos
Faturar uma administração alemã exige um XML XRechnung com uma referência do comprador BT-10, o Leitweg-ID, que o Shopware não sabe guardar. A extensão instala na ativação um campo personalizado dedicado na ficha do cliente e na encomenda: introduza o Leitweg-ID uma vez no cliente e ele é reutilizado em todas as suas faturas, com possibilidade de o substituir encomenda a encomenda e um valor de recurso configurável. O XML produzido inclui o processo de negócio Peppol, o contacto do vendedor BG-6 e os endereços eletrónicos exigidos pelo validador KOSIT.
Um PDF híbrido, e não mais um documento
Nos perfis Factur-X e ZUGFeRD, o XML é incorporado diretamente no PDF de fatura gerado pelo Shopware, por atualização incremental: ficheiro factur-x.xml anexado, relação AF do tipo Data, metadados XMP PDF A-3 com o esquema de extensão Factur-X completo. O média do documento é substituído no local, pelo que o PDF que o seu cliente transfere da conta ou recebe por email é a fatura eletrónica híbrida. Se uma estrutura de PDF exótica impedir a incorporação, a extensão degrada corretamente: o XML continua disponível em anexo de email e pela consola, e fica registado um aviso.
Um modelo contabilístico que passa nos validadores
A norma EN 16931 é exigente: montantes líquidos, linhas negativas proibidas, repartição de IVA por categoria, totais coerentes ao cêntimo. O DfFacturX converte as encomendas com IVA incluído para o modelo líquido através dos impostos calculados do Shopware, transforma as promoções em descontos ao nível do documento com a respetiva repartição por taxa, declara os portes como encargos de documento, e usa o campo RoundingAmount BT-114 para absorver qualquer desvio de arredondamento: o GrandTotal do XML é sempre rigorosamente igual ao total da encomenda Shopware. As taxas a 0 por cento recebem automaticamente a categoria certa, K intracomunitário, G exportação ou Z, com motivo de isenção.
Automático, e nunca bloqueante
A geração é acionada na criação do documento de fatura, seja qual for o canal: administração, Flow Builder ou API. O modo apenas B2B restringe a geração às encomendas profissionais. O XML é anexado automaticamente aos emails de encomenda. E por conceção, um erro de fatura eletrónica nunca bloqueia a criação da própria fatura: o incidente fica registado e o comando de consola df:facturx:generate permite regenerar após correção, com mudança de perfil na hora e exportação do XML para um ficheiro.
Valide antes de ir para produção
A documentação inclui uma checklist de validação completa: encomendas com e sem IVA incluído, promoção, portes, venda intracomunitária com número de IVA, exportação fora da UE. Exporte o XML com um comando e submeta-o ao validador KOSIT para XRechnung ou ao validador Mustang para Factur-X e ZUGFeRD. Vai para produção sabendo exatamente o que os seus clientes e as ferramentas de contabilidade deles vão receber.
Ainda não existem avaliações.