factur-x 1.4

factur-x python库

factur-x是法国和德国的电子发票标准。factur-x规范在FNFE-MPE website上有英文和法文版本。factur-x标准在德国也被称为zugferd 2.0。

此python库的主要功能是从常规pdf发票和factur-x兼容的xml文件生成factur-x发票。

此库提供附加功能，如：

• 从Factur-X PDF发票中提取Factur-X XML文件，
• 根据正式的xml模式定义检查factur-xxml文件。

这个库提供的一些特性也适用于zugferd 1.0（factur-x标准的前身）。

安装

这个库同时适用于Python2.7和Python3。

要为python 3安装它，请运行：

sudo pip3 install --upgrade factur-x

要为Python2.7安装它，请运行：

sudo pip install --upgrade factur-x

用法

from facturx import generate_facturx_from_file

facturx_pdf_invoice = generate_facturx_from_file(regular_pdf_invoice, facturx_xml_file)

要获得更多示例，请查看位于bin子目录中的命令行工具的源代码。

命令行工具

此库提供了几个命令行工具：

• factur x pdfgen：从常规pdf发票和xml文件生成factur-x pdf发票
• factur x pdf extract xml：从factur-x pdf发票中提取factur-x xml文件
• factur x xml check：根据官方factur-x xml模式定义检查factur-x xml文件

所有这些命令行工具都有一个-h选项，该选项解释如何使用它们并显示所有可用选项。

许可证

此库是根据bsd许可证（与此库所依赖的PyPDF4许可证相同）发布的。

贡献者

• Alexis de Lattre & lt；^ {A3}＆Gt；

更改日志

• 版本1.4，日期：2019-07-24
  • 将factur-x xsd更新到factur-x v1.0.4的最终版本
  • 使用“zugferd invoice.xml”文件名（而不是标准指定的“zugferd invoice.xml”文件名）支持zugferd发票的XML提取。
• 版本1.3，日期：2019-06-12
  • 在python包中为扩展配置文件添加xsd文件
• 版本1.2，日期：2019-06-12
  • 添加对扩展配置文件的支持
  • 按照Cyrille Sautereau的要求，使用概要文件EN 16931的XSD验证最低和基本WL概要文件的XML
  • 对/chids的代码进行了一些小的改进
• 版本1.1，日期：2019-04-22
  • 通过添加对/child的支持来改进对嵌入式文件提取的支持
• 版本1.0，日期：2019-01-26
  • 使用pypdf4而不是pypdf2，因为自2016年5月以来没有新版本的pypdf2（cfhttps://github.com/mstamy2/PyPDF2/wiki/State-of-PyPDF2-and-Future-Plans），我们需要最新版本的pypdf2才能生成完全兼容的pdf/a-3文件。
• 版本0.9，日期：2019-01-25
  • joshuajan提供的python 3端口（https://github.com/joshuajan）
  • 修复zugferd 1.0 xsd的路径
• 版本0.8，日期：2018-06-10
  • 使pretty_print适用于xmp文件，以提高该文件的可读性
• 版本0.7，日期：2018-05-24
  • 修复/x:xmpmeta/rdf:rdf/rdf:description下的xmp结构（使用xml标记而不是xml属性）
  • 声明pdf-1.6而不是pdf-1.3（默认情况下仍然由pypdf2声明）
• 版本0.6，日期：2018-05-01
  • 现在完全符合PDF/A-3标准，并带有附加附件（使用VeraPDF进行测试）
  • facturx pdfgen：默认情况下不覆盖并添加–覆盖选项
  • 在元数据创建者条目中添加factur-x库版本号
• 版本0.5，日期：2018-03-29
  • 修复xmp元数据结构
  • 现在完全符合pdf/a-3标准输入的pdf文件是pdf/a兼容的（用verapdf测试）。这意味着将源pdf中的/outputinents和/id数据复制到factur-xpdf。
  • 修复对附加附件的支持：现在可以使用Acrobat Reader保存它们
  • 改进从pdf factur-x文件提取xml的方法
• 版本0.4，日期：2018-03-27
  • factur-x规格说明/afrelationship必须是/data（而不是/alternative）
  • 将factur-x xsd更新为v1.0 final
  • 添加对附加附件的支持
  • 在创建者元数据表中添加factur-x lib版本
  • add/pagemode=/useattachments，以便在使用Acrobat Reader打开Factur-X PDF发票时默认显示附件
  • 改进和丰富pdf对象（moddate、checksum、size）