Criar
Transforme o PDF que a sua aplicação gera numa fatura Factur-X ou ZUGFeRD. Os totais e a discriminação do IVA são calculados com decimais exatos, e uma fatura inválida é recusada antes de se escrever o que quer que seja.
Pacote Go de código aberto · licença MIT
Continue a gerar as suas faturas em PDF como hoje. O ZeRechnung acrescenta a fatura XML e os metadados que a norma exige, e o PDF torna-se uma fatura eletrónica Factur-X ou ZUGFeRD conforme. Também lê e valida as faturas que recebe.
go get github.com/ritoon/zerechnung
Versão 0: a API ainda pode mudar antes da v1.
Um só pacote para toda a vida de uma fatura eletrónica, tanto na emissão como na receção.
Transforme o PDF que a sua aplicação gera numa fatura Factur-X ou ZUGFeRD. Os totais e a discriminação do IVA são calculados com decimais exatos, e uma fatura inválida é recusada antes de se escrever o que quer que seja.
Leia PDF híbridos e XML simples, em CII ou UBL, de todas as versões do ZUGFeRD desde a 1.0. Os dados para os quais o modelo não tem campo são preservados e reescritos no seu lugar.
Verifique os esquemas, as regras EN 16931, as dos perfis e as regras nacionais de França, Alemanha, Países Baixos e Itália, além do Peppol. Cada resultado indica o identificador oficial da regra e o XPath do elemento.
Converta entre CII, UBL, FatturaPA e Facturae, e reescreva um PDF como PDF/A-3 quando isso não exige um motor PDF. Caso contrário, recebe os motivos, página a página.
Sem CGO, sem Java, sem binários externos, sem chamadas de rede. Um go get é toda a instalação.
Cada pull request compara os resultados com o KoSIT, o Mustang e o veraPDF, fatura a fatura. Uma nova diferença faz falhar a compilação.
Ler e validar por completo uma fatura típica demora cerca de 25 µs, um quinto do tempo do pacote Go mais rápido a seguir.
O XML é acrescentado com uma atualização incremental. Os bytes originais não mudam, por isso uma assinatura existente continua válida.
Um único modelo de fatura, invoice.Invoice, para todas as sintaxes: passar de uma para outra resume-se a uma leitura e uma escrita.
| Formato | Países | Leitura | Escrita | Validação |
|---|---|---|---|---|
| Factur-X 1.0x / ZUGFeRD 2.xCII · perfis de MINIMUM a EXTENDED, e EXTENDED-CTC-FR | FRDE | sim | sim | sim |
| XRechnung 3.0CII · UBL | DE | sim | sim | sim |
| Peppol BIS Billing 3.0CII · UBL | EU | sim | sim | sim |
| NLCIUSCII · UBL | NL | sim | sim | sim |
| CIUS-ITCII · UBL | IT | sim | sim | sim |
| UBL 2.1Invoice · CreditNote · EN 16931 | EU | sim | sim | sim |
| FatturaPA 1.2FPA12 · FPR12 | IT | sim | sim | através de CII (CIUS-IT) |
| Facturae 3.2.x3.2 · 3.2.1 · 3.2.2 | ES | sim | sim | esquema XSD; EN 16931 através de UBL ou CII |
| ZUGFeRD 1.0CII | DE | sim | como Factur-X | verificações mínimas |
Cada pull request executa os validadores de referência sobre os corpora de teste oficiais e compara os seus resultados com os do ZeRechnung, fatura a fatura.
128 / 128
KoSIT
faturas XRechnung com exatamente os mesmos erros que o validador KoSIT.
241 / 282
Mustang
faturas com os mesmos erros que o Mustang. Cada diferença vem das próprias referências e está explicada.
283 / 290
NPa
ficheiros NLCIUS com as mesmas regras que os validadores neerlandeses da NPa. As restantes diferenças estão justificadas.
609 / 614
veraPDF
ficheiros PDF/A inválidos do corpus do veraPDF detetados por uma regra da cláusula certa.
Instale o pacote. Requer Go 1.24 ou posterior.
go get github.com/ritoon/zerechnungTransforme o seu PDF numa fatura Factur-X.
pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
Calculate: true, // totals and VAT breakdown
Validate: &validate.Options{}, // refuse an invalid invoice
})Valide uma fatura recebida, com as regras nacionais do país do vendedor.
report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
if err != nil {
log.Fatal(err)
}
for _, f := range report.Errors() {
fmt.Println(f)
}Ou use a linha de comandos. validate termina com o código 1 quando há erros, por isso encaixa tal como está num pipeline de CI.
go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
zerechnung validate -auto invoice.pdfO ZeRechnung é software livre com licença MIT. Relatórios de erros, diferenças em relação a um validador de referência e regras em falta são bem-vindos.
As traduções estão abertas a todos. Encontrou um erro no seu idioma? Editar esta tradução