pybill(1)

NAME
pybill - produces PDF bills from XML

SYNOPSIS
pybill [ options ] <src>

DESCRIPTION
PyBill reads an XML file describing an accounting document (bill, claim-form, debit, downpayment, pro-forma) and produces a PDF document. The XML document should be in PBD (PyBill Document) format.

PyBill uses a configuration XML file to customize the PDF rendering (logo, sender address, sender bank data, i18n texts, etc.) This configuration file can be specified with a command-line option or in the XML document into a dedicated processing instruction. In this last case, the configuration file is search in the user configuration directory ($HOME/.config/pybill) and then in the system configuration directory (/etc/config/pybill).

Example:

<?xml version="1.0"?> <?pybill config="my-config"?> <accounting document type="bill" format="1.0"> and so on

Here, PyBill will search the my-config.xml XML file in the configuration directories. If it cann't be found, PyBill will backup on default.xml configuration file (that it is at least installed in the system configuration directory).

PyBill can produce accounting entries in an XML format compatible with pycompta tool. By default, the entries are generated in an entries.xml file. Command-line options control this generation. When several XML documents are processed in one call, a single entries.xml file is generated but it contains several accounting entries. Another dedicated processing instruction can be inserted in the XML document to specify the accounts number used in the entries.

Example:

<?xml version="1.0"?> <?pybill config="my-config"?> <?accounts client="41101" client-holdback="41102"
           product="7001" vat="44501"?> <accounting-document type="bill" format="1.0"> and so on

Here, PyBill will generate accounting entries using the 41101 account as the client account, the 41102 for the holdbacks concerning this client, the 7001 as the product account and the 44501 for all the VAT movements.

  Command-line options:

-h, --help
    Show the help message and exit

--version
    Show the version number and exit

-c CFGFILE, --config=CFGFILE
    Name of the config file to be used for generating the PDFs of the accounting documents. This config file overrides the config specified in the processing instructions of each accounting document.

-k, --convert
    Convert the processed accounting documents into the last 'PyBill Document' format and save them. The initial document is kept with a .old extension.

-n, --no-entries
    Don't generate the accounting entries corresponding to the processed accounting documents.

-e XMLFILE, --entries-files=XMLFILE
    Name of the file where the generated accounting entries will be saved in 'pycompta' format. By default, this is the entries.xml file.

-d, --debug
    Print debug information and don't catch the exceptions.

LICENCE
(c) 2001-2010 Logilab. GNU Public Licence Version 2

SEE ALSO
/usr/share/doc/pybill/

AUTHOR
Olivier Cayrol <olivier.cayrol@logilab.fr>