ZeRechnung
Idioma: Português
Esta tradução ainda não foi revista por um falante nativo. Sugerir uma correção

Pacote Go de código aberto · licença MIT

Faturas eletrónicas em Go, a partir dos PDF que já produz

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.

O gopher do Go, de óculos e com um barco de papel na cabeça, lê um livro de faturas numa secretária com uma máquina de escrever, entre pilhas de faturas.

O que faz

Um só pacote para toda a vida de uma fatura eletrónica, tanto na emissão como na receção.

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.

Ler

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.

Validar

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.

Converter

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.

Porquê o ZeRechnung

  • Go puro, apenas a biblioteca padrão

    Sem CGO, sem Java, sem binários externos, sem chamadas de rede. Um go get é toda a instalação.

  • Comparado com os validadores de referência

    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.

  • Rápido

    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 seu PDF fica como está

    O XML é acrescentado com uma atualização incremental. Os bytes originais não mudam, por isso uma assinatura existente continua válida.

Formatos e países

Um único modelo de fatura, invoice.Invoice, para todas as sintaxes: passar de uma para outra resume-se a uma leitura e uma escrita.

FormatoPaísesLeituraEscritaValidação
Factur-X 1.0x / ZUGFeRD 2.xCII · perfis de MINIMUM a EXTENDED, e EXTENDED-CTC-FRFRDEsimsimsim
XRechnung 3.0CII · UBLDEsimsimsim
Peppol BIS Billing 3.0CII · UBLEUsimsimsim
NLCIUSCII · UBLNLsimsimsim
CIUS-ITCII · UBLITsimsimsim
UBL 2.1Invoice · CreditNote · EN 16931EUsimsimsim
FatturaPA 1.2FPA12 · FPR12ITsimsimatravés de CII (CIUS-IT)
Facturae 3.2.x3.2 · 3.2.1 · 3.2.2ESsimsimesquema XSD; EN 16931 através de UBL ou CII
ZUGFeRD 1.0CIIDEsimcomo Factur-Xverificações mínimas

Qual é a fiabilidade?

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.

Método e limitações, na wiki

Começar

  1. Instale o pacote. Requer Go 1.24 ou posterior.

    Shell
    go get github.com/ritoon/zerechnung
  2. Transforme o seu PDF numa fatura Factur-X.

    Go
    pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
    	Calculate: true,                // totals and VAT breakdown
    	Validate:  &validate.Options{}, // refuse an invalid invoice
    })
  3. Valide uma fatura recebida, com as regras nacionais do país do vendedor.

    Go
    report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    for _, f := range report.Errors() {
    	fmt.Println(f)
    }
  4. 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.

    Shell
    go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
    zerechnung validate -auto invoice.pdf

Código aberto e aberto a contribuições

O 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.

Abrir uma issue

As traduções estão abertas a todos. Encontrou um erro no seu idioma? Editar esta tradução