ZUGFeRD & Fatura eletrónica

Garantia de 1 hora

Da instalação à primeira fatura ZUGFeRD

1. Instalar o Creator (5 minutos)
2. Mapear os campos (20 minutos)
3. Criar a primeira PDF ZUGFeRD (35 minutos)
4. Ler faturas eletrónicas e processá-las no FM

Novo · ZUGFeRD Suite Versão 3

Fatura eletrónica a partir do FileMaker: a ZUGFeRD Suite

A partir de 1 de janeiro de 2027, as empresas na Alemanha terão de emitir eletronicamente as faturas a outras empresas, a partir de 2028 todas sem exceção. Quem emite as suas faturas a partir do FileMaker não precisa de reconstruir a sua solução. A ZUGFeRD Suite liga-se ao lado, lê o documento através de uma associação e devolve uma PDF ZUGFeRD ou uma XRechnung. Uma chamada, dois formatos, tudo no próprio servidor.

O prazo

Desde 2025, todas as empresas têm de poder receber faturas eletrónicas. Para a emissão aplica-se um faseamento: a partir de 1 de janeiro de 2027 para empresas com mais de 800.000 euros de volume de negócios no ano anterior, a partir de 1 de janeiro de 2028 para todas. Uma PDF por e-mail deixa então de contar como fatura. Exige-se um formato estruturado segundo a norma europeia EN 16931, na Alemanha em duas variantes:

Ambos descrevem a mesma fatura. O que difere é a embalagem.

O que a Suite faz

A ZUGFeRD Suite é um ficheiro FileMaker mais uma pequena componente de servidor em PHP. O programa de faturação chama um script com três indicações: tipo de documento, número do documento, formato.

A chamada é um Executar script em ZF_Beleg_erzeugen na Suite, o parâmetro é um pequeno JSON:

{ "beleg" : "Rechnung", "nr" : "RE100001", "format" : "zugferd" }

A Suite procura o documento, lê os valores, envia-os ao servidor, recolhe o resultado e coloca-o num contentor junto ao documento. Para a XRechnung, a mesma chamada com "format" : "ubl". As notas de crédito são um tipo de documento próprio com o código de tipo 381 e são construídas como nota de crédito, na XRechnung como CreditNote.

Antes da saída, o resultado é verificado contra as regras de validação da norma. O que a Suite entrega passou a verificação Schematron da EN 16931 e, para a XRechnung, adicionalmente as regras da KoSIT. O perfil é EN 16931, ou seja, o âmbito completo: linhas com desconto, custos de envio, desconto global, várias taxas de imposto, entrega intracomunitária, exportação.

A associação: configurar uma vez

A ligação à própria solução chama-se associação. Diz à Suite onde está cada valor da fatura eletrónica. Configura-se numa página no visualizador web, um separador por tipo de documento, os valores em cinco áreas: documento, vendedor, comprador, pagamento, linhas.

Cada valor é uma expressão FileMaker avaliada no contexto do documento:

Um campo, uma fórmula, uma constante, o mesmo mecanismo. Campos relacionados funcionam, porque o FileMaker os resolve de qualquer forma numa expressão. Não são necessários campos auxiliares na própria solução, nem layouts com objetos: por tipo de documento um layout vazio sobre o documento, nada mais. As linhas vêm de uma consulta SQL que a página compõe a partir da associação e mostra por baixo da tabela.

A sugestão de IA

Um botão envia os nomes e tipos dos campos ao próprio servidor, este consulta um modelo de linguagem e, por valor, volta uma expressão com justificação. Num sistema de gestão de mercadorias com mais de trezentos campos, no teste foram 29 sugestões da IA, 14 decididas pelo nome, 5 em aberto, em nove segundos. O que muda em relação ao estado guardado recebe a marca „Novo“ ou „Alterado“, ao lado o valor antigo e um botão „repor“. Os dados dos documentos não saem da casa, apenas nomes de campos. A chave API pertence ao cliente.

A pré-visualização

A pré-visualização mostra por linha o valor do documento real, verde quando preenchido, vermelho quando vazio. Introduzir o número do documento, pré-visualizar, depois „Test PDF“ e „Test UBL“: é este o caminho da associação até à primeira fatura eletrónica, numa única sessão.

Onde ficam os dados

A componente de servidor corre no cliente, no próprio servidor web ou no seu alojamento. Não há servidor do fabricante, nenhuma cloud pelo meio, nenhuma telemetria. A chave de licença é verificada no servidor do cliente, sem ligação ao exterior. Quem utiliza uma versão de teste recebe uma chave com data de validade; depois disso a associação mantém-se, só a geração para.

Isto é assim de propósito. As faturas contêm dados pessoais, e a forma mais simples de os tratar corretamente é aquela em que não saem da empresa.

A integração

O que um programador FileMaker faz para isso cabe numa mão:

1. Colocar o pacote PHP no servidor web, introduzir o endereço no separador Info.
2. Ligar o ficheiro do cliente como fonte de dados externa, arrastar as ocorrências de tabela para o grafo da Suite.
3. Por tipo de documento um layout vazio.
4. Associação: sugestão de IA, rever, pré-visualizar, guardar.
5. Um botão na fatura que chama o script.

O guia correspondente está na própria Suite, como separador ao lado da associação, com uma tabela de erros para o caso de aparecer uma mensagem. Uma parte está escrita de forma a poder ser entregue à contabilidade.

Para quem

Para empresas que emitem as suas faturas a partir do FileMaker e querem cumprir o prazo sem tocar no seu programa de faturação. Para programadores FileMaker que o integram para os seus clientes; para isso existe uma licença de programador. E para todos os que, na fatura eletrónica, querem saber onde estão os seus dados.

Versão de teste e licença: ronny@filemaker-experts.de

Novo · ZUGFeRD Reader Versão 3

A outra direção: faturas recebidas

Emitir é uma metade do prazo, receber é a outra. Receber é algo que todas as empresas já têm de conseguir desde 2025. O ZUGFeRD Reader aceita uma fatura eletrónica recebida, seja PDF ZUGFeRD, UBL ou CII-XML, lê-a através do mesmo servidor, verifica-a e apresenta-a de forma legível. Numa XRechnung sem imagem de impressão, esta é a única vista que uma pessoa consegue ler.

Na ZUGFeRD Suite o Reader já vem incluído, no mesmo separador ao lado do Creator. Quem só precisa de ler, usa o Reader sozinho.

Componentes ZUGFeRD

As 6 áreas principais do processamento de faturas

Gestão de dados estruturada para faturas eletrónicas conformes com a norma

Normalização & Garantia de qualidade

Processamento automático de dados

Mapeamentos estáveis com auxiliares integrados e validação

Modelos de licença

Três modelos de licença para cada caso de utilização

ZUGFeRD Suite V3 como posto único ou servidor, Enterprise a pedido. O Creator e o Reader também estão disponíveis em separado, ver Produtos

Perguntas frequentes

FAQ ZUGFeRD & Fatura eletrónica

Pronto para a fatura eletrónica?

Integrar ZUGFeRD no FileMaker

Comece agora a implementação da sua solução ZUGFeRD

Demonstrações