entrouvert
/
debian-factur-x
16
0
Fork 0
Code Issues Pull Requests 1 Releases Activity
Debian packaging for factur-x
12 Commits 4 Branches 0 Tags 469 KiB
Python 100%
Go to file
Alexis de Lattre a136ef46db Factur-x specs say /AFRelationship must be /Data (and not /Alternative) 
Add support for additionnal attachments (via generate_facturx_from_file())
Add factur-x lib version in Creator metadata table
Add /PageMode = /UseAttachments, so that the attachments are displayed by default when opening Factur-X PDF invoice with Acrobat Reader
Improve and enrich PDF objects (ModDate, CheckSum, Size)
Better variable names in the code that generate PDF objects
Update Factur-X XSD to v1.0 final
 		2018-03-27 22:09:50 +02:00
bin Factur-x specs say /AFRelationship must be /Data (and not /Alternative) 2018-03-27 22:09:50 +02:00
facturx Factur-x specs say /AFRelationship must be /Data (and not /Alternative) 2018-03-27 22:09:50 +02:00
.gitignore Initial commit 2017-09-10 01:15:26 +02:00
LICENSE Initial check-in 2017-09-10 01:56:48 +02:00
MANIFEST.in Factur-x specs say /AFRelationship must be /Data (and not /Alternative) 2018-03-27 22:09:50 +02:00
README.rst Update README to explain ZUGFeRD 2.0 = Factur-X 2017-09-15 23:33:48 +02:00
requirement.txt Initial check-in 2017-09-10 01:56:48 +02:00
setup.py Factur-x specs say /AFRelationship must be /Data (and not /Alternative) 2018-03-27 22:09:50 +02:00

README.rst 

Factur-X Python library
=======================

Factur-X is the e-invoicing standard for France and Germany. The Factur-X specifications are available on the `FNFE-MPE website <http://fnfe-mpe.org/factur-x/>`_. The Factur-X standard is also called ZUGFeRD 2.0 in Germany.

The main feature of this Python library is to generate Factur-X invoices from a regular PDF invoice and a Factur-X compliant XML file.

This lib provides additionnal features such as:

* extract the Factur-X XML file from a Factur-X PDF invoice,
* check a Factur-X XML file against the official XML Schema Definition.

Some of the features provided by this lib also work for ZUGFeRD 1.0 (the ancestor of the Factur-X standard).

Installation
============

.. code::

  sudo pip install --upgrade factur-x


Usage
=====

.. code::

  from facturx import generate_facturx

  facturx_pdf_invoice = generate_facturx(regular_pdf_invoice, facturx_xml_file)


To have more examples, look at the source code of the command line tools located in the *bin* subdirectory.

Command line tools
==================

Several command line tools are provided with this lib:

* **facturx-pdfgen**: generate a Factur-X PDF invoice from a regular PDF invoice and an XML file
* **facturx-pdfextractxml**: extract the Factur-X XML file from a Factur-X PDF invoice
* **facturx-xmlcheck**: check a Factur-X XML file against the official Factur-X XML Schema Definition

All these commande line tools have a **-h** option that explains how to use them and shows all the available options.

Licence
=======

This library is published under the BSD licence (same licence as `PyPDF2 <http://mstamy2.github.io/PyPDF2/>`_ on which this lib depends).

Contributors
============

* Alexis de Lattre <alexis.delattre@akretion.com>