========================
Account Invoice Factur-X
========================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:5f740f47c183d54ba286ddaa17f4aeb875c3367693840b8e8c0a98fc98cad75d
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fedi-lightgray.png?logo=github
:target: https://github.com/OCA/edi/tree/17.0/account_invoice_facturx
:alt: OCA/edi
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/edi-17-0/edi-17-0-account_invoice_facturx
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/edi&target_branch=17.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
With this module, the PDF customer invoices and refunds generated by the
Qweb reporting engine of Odoo will comply with the
`Factur-X <http://fnfe-mpe.org/factur-x/>`__ standard. The Factur-X
standard is an e-invoicing standard for France and Germany released on
December 31st 2017. In Germany, it is also known as the `ZUGFeRD
2.0 <http://www.ferd-net.de/aktuelles/meldungen/verabschiedung-zugferd-2.0_profil-en16931.html/>`__
standard. This standard is based on
`CII <http://tfig.unece.org/contents/cross-industry-invoice-cii.htm>`__
(Cross-Industry Invoice) for electronic invoicing. The great idea of the
ZUGFeRD/Factur-X standard is to embed an XML file inside the PDF invoice
to carry structured information about the invoice. So, with a
ZUGFeRD/Factur-X PDF invoice:
- no need to change your habbits and those of your customers: you can
still send your PDF invoices by email as usual.
- customers equiped with a modern accouting software will be able to
import the invoice automatically as supplier invoice by taking
advantage of the embedded XML file,
- customers with an ancient accounting software will just open the PDF
file with their PDF reader and manually encode the document as
supplier invoice in their accounting software.
**Table of contents**
.. contents::
:local:
Installation
============
This module requires a recent version of the Python library
`factur-x <https://github.com/akretion/factur-x>`__ developped by
Akretion. Note that the factur-x library depends on PyPDF2 for the
low-level PDF manipulation. To install it, run:
::
sudo pip3 install --upgrade factur-x
Configuration
=============
In the menu *Invoicing > Configuration > Settings*, check these options:
- *XML Format embedded in PDF invoice*: if you want to generate
Factur-X invoices, this option must be set to *Factur-X (CII)*
- the *Factur-X Level*: unless you have a good reason, you should keep
the default value *EN 16931 (Comfort)*
- *Factur-X Refund Type*: choose the type of the XML invoice for
customer refunds (keep the default value if you are not familiar with
this setting).
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/edi/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/edi/issues/new?body=module:%20account_invoice_facturx%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
-------
* Akretion
Contributors
------------
- Alexis de Lattre <alexis.delattre@akretion.com>
Maintainers
-----------
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
.. |maintainer-alexis-via| image:: https://github.com/alexis-via.png?size=40px
:target: https://github.com/alexis-via
:alt: alexis-via
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-alexis-via|
This module is part of the `OCA/edi <https://github.com/OCA/edi/tree/17.0/account_invoice_facturx>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/edi",
"name": "odoo-addon-account-invoice-facturx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Akretion,Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": null,
"platform": null,
"description": "========================\nAccount Invoice Factur-X\n========================\n\n.. \n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! source digest: sha256:5f740f47c183d54ba286ddaa17f4aeb875c3367693840b8e8c0a98fc98cad75d\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fedi-lightgray.png?logo=github\n :target: https://github.com/OCA/edi/tree/17.0/account_invoice_facturx\n :alt: OCA/edi\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/edi-17-0/edi-17-0-account_invoice_facturx\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png\n :target: https://runboat.odoo-community.org/builds?repo=OCA/edi&target_branch=17.0\n :alt: Try me on Runboat\n\n|badge1| |badge2| |badge3| |badge4| |badge5|\n\nWith this module, the PDF customer invoices and refunds generated by the\nQweb reporting engine of Odoo will comply with the\n`Factur-X <http://fnfe-mpe.org/factur-x/>`__ standard. The Factur-X\nstandard is an e-invoicing standard for France and Germany released on\nDecember 31st 2017. In Germany, it is also known as the `ZUGFeRD\n2.0 <http://www.ferd-net.de/aktuelles/meldungen/verabschiedung-zugferd-2.0_profil-en16931.html/>`__\nstandard. This standard is based on\n`CII <http://tfig.unece.org/contents/cross-industry-invoice-cii.htm>`__\n(Cross-Industry Invoice) for electronic invoicing. The great idea of the\nZUGFeRD/Factur-X standard is to embed an XML file inside the PDF invoice\nto carry structured information about the invoice. So, with a\nZUGFeRD/Factur-X PDF invoice:\n\n- no need to change your habbits and those of your customers: you can\n still send your PDF invoices by email as usual.\n- customers equiped with a modern accouting software will be able to\n import the invoice automatically as supplier invoice by taking\n advantage of the embedded XML file,\n- customers with an ancient accounting software will just open the PDF\n file with their PDF reader and manually encode the document as\n supplier invoice in their accounting software.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nInstallation\n============\n\nThis module requires a recent version of the Python library\n`factur-x <https://github.com/akretion/factur-x>`__ developped by\nAkretion. Note that the factur-x library depends on PyPDF2 for the\nlow-level PDF manipulation. To install it, run:\n\n::\n\n sudo pip3 install --upgrade factur-x\n\nConfiguration\n=============\n\nIn the menu *Invoicing > Configuration > Settings*, check these options:\n\n- *XML Format embedded in PDF invoice*: if you want to generate\n Factur-X invoices, this option must be set to *Factur-X (CII)*\n- the *Factur-X Level*: unless you have a good reason, you should keep\n the default value *EN 16931 (Comfort)*\n- *Factur-X Refund Type*: choose the type of the XML invoice for\n customer refunds (keep the default value if you are not familiar with\n this setting).\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/edi/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us to smash it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/edi/issues/new?body=module:%20account_invoice_facturx%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n-------\n\n* Akretion\n\nContributors\n------------\n\n- Alexis de Lattre <alexis.delattre@akretion.com>\n\nMaintainers\n-----------\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\n.. |maintainer-alexis-via| image:: https://github.com/alexis-via.png?size=40px\n :target: https://github.com/alexis-via\n :alt: alexis-via\n\nCurrent `maintainer <https://odoo-community.org/page/maintainer-role>`__:\n\n|maintainer-alexis-via| \n\nThis module is part of the `OCA/edi <https://github.com/OCA/edi/tree/17.0/account_invoice_facturx>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Generate Factur-X/ZUGFeRD customer invoices",
"version": "17.0.1.0.0.6",
"project_urls": {
"Homepage": "https://github.com/OCA/edi"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a8c976bfbd9830348b5456030096d2cfdec60e73867645da8de92e83391ac271",
"md5": "cab2cd271e802224759044eba8b47c3a",
"sha256": "323b38257ad56d6b2fbdce8c5ba5c3574ab26dbeb3b7261bd26a76f2383308b4"
},
"downloads": -1,
"filename": "odoo_addon_account_invoice_facturx-17.0.1.0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cab2cd271e802224759044eba8b47c3a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 85444,
"upload_time": "2024-03-29T04:09:24",
"upload_time_iso_8601": "2024-03-29T04:09:24.518633Z",
"url": "https://files.pythonhosted.org/packages/a8/c9/76bfbd9830348b5456030096d2cfdec60e73867645da8de92e83391ac271/odoo_addon_account_invoice_facturx-17.0.1.0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-29 04:09:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "edi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "dateparser",
"specs": []
},
{
"name": "factur-x",
"specs": []
},
{
"name": "invoice2data",
"specs": []
},
{
"name": "ovh",
"specs": []
},
{
"name": "phonenumbers",
"specs": []
},
{
"name": "pypdf",
"specs": [
[
">=",
"3.1.0"
]
]
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "regex",
"specs": []
},
{
"name": "xmlschema",
"specs": []
}
],
"lcname": "odoo-addon-account-invoice-facturx"
}