|
| 1 | +============= |
| 2 | +Base Factur-X |
| 3 | +============= |
| 4 | + |
| 5 | +.. |
| 6 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 7 | + !! This file is generated by oca-gen-addon-readme !! |
| 8 | + !! changes will be overwritten. !! |
| 9 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 10 | + !! source digest: sha256:a38a4291df4f47955dee926bc6ad7f84ad890c24f0b1cf4d0de95432380bc223 |
| 11 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 12 | +
|
| 13 | +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png |
| 14 | + :target: https://odoo-community.org/page/development-status |
| 15 | + :alt: Beta |
| 16 | +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png |
| 17 | + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html |
| 18 | + :alt: License: AGPL-3 |
| 19 | +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fedi-lightgray.png?logo=github |
| 20 | + :target: https://github.com/OCA/edi/tree/17.0/base_facturx |
| 21 | + :alt: OCA/edi |
| 22 | +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png |
| 23 | + :target: https://translation.odoo-community.org/projects/edi-17-0/edi-17-0-base_facturx |
| 24 | + :alt: Translate me on Weblate |
| 25 | +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png |
| 26 | + :target: https://runboat.odoo-community.org/builds?repo=OCA/edi&target_branch=17.0 |
| 27 | + :alt: Try me on Runboat |
| 28 | + |
| 29 | +|badge1| |badge2| |badge3| |badge4| |badge5| |
| 30 | + |
| 31 | +This is the base module for the implementation of the |
| 32 | +`Factur-X <http://fnfe-mpe.org/factur-x/factur-x_en/>`__ and |
| 33 | +`ZUGFeRD <https://www.ferd-net.de/standards/was-ist-zugferd/index.html>`__ |
| 34 | +standards. The standard Factur-X 1.0 is the same as ZUGFeRD 2.1 (the |
| 35 | +name Factur-X is always used in France, whereas in Germany many people |
| 36 | +use the name ZUGFeRD). It is a standard based on |
| 37 | +`CII <http://tfig.unece.org/contents/cross-industry-invoice-cii.htm>`__ |
| 38 | +(Cross-Industry Invoice) for electronic invoicing. |
| 39 | + |
| 40 | +The great idea of the Factur-X/ZUGFeRD standard is to embed an XML file |
| 41 | +inside the PDF invoice to carry structured information about the |
| 42 | +invoice. |
| 43 | + |
| 44 | +**Table of contents** |
| 45 | + |
| 46 | +.. contents:: |
| 47 | + :local: |
| 48 | + |
| 49 | +Configuration |
| 50 | +============= |
| 51 | + |
| 52 | +To configure this module, you need to: |
| 53 | + |
| 54 | +- go to the menu *Inventory > Configuration > Units of Measures > UoM* |
| 55 | + and check the *UNECE Code* for the units of measures. |
| 56 | +- go to the menu *Invoicing > Configuration > Accounting > Taxes* and, |
| 57 | + for each tax, set a *UNECE Type Code* and a *UNECE Category Code*. |
| 58 | +- go to the menu *Invoicing > Configuration > Management > Payment |
| 59 | + Methods* (to see that menu entry, the module *account_payment_mode* |
| 60 | + must be installed) and assign a *UNECE Code* to the payment methods |
| 61 | + that are selected in the payment modes. |
| 62 | + |
| 63 | +To avoid the manual configuration of taxes, look for a module |
| 64 | +*l10n_XX_account_tax_unece* in the OCA project of your localization (it |
| 65 | +exists at least for the Netherlands and France). If such a module exists |
| 66 | +in your localization, install it and it will auto-configure the taxes |
| 67 | +created by your localization. |
| 68 | + |
| 69 | +Usage |
| 70 | +===== |
| 71 | + |
| 72 | +This module doesn't do anything by itself, but it is used by 2 other |
| 73 | +modules: |
| 74 | + |
| 75 | +- *account_invoice_facturx* that generate Factur-X 1.0 (i.e. ZUGFeRD |
| 76 | + 2.1) customer invoices/refunds, |
| 77 | +- *account_invoice_import_facturx* that imports ZUGFeRD/Factur-X |
| 78 | + supplier invoices/refunds (all versions, including ZUGFeRD 1.0). |
| 79 | + |
| 80 | +Bug Tracker |
| 81 | +=========== |
| 82 | + |
| 83 | +Bugs are tracked on `GitHub Issues <https://github.com/OCA/edi/issues>`_. |
| 84 | +In case of trouble, please check there if your issue has already been reported. |
| 85 | +If you spotted it first, help us to smash it by providing a detailed and welcomed |
| 86 | +`feedback <https://github.com/OCA/edi/issues/new?body=module:%20base_facturx%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. |
| 87 | + |
| 88 | +Do not contact contributors directly about support or help with technical issues. |
| 89 | + |
| 90 | +Credits |
| 91 | +======= |
| 92 | + |
| 93 | +Authors |
| 94 | +------- |
| 95 | + |
| 96 | +* Akretion |
| 97 | + |
| 98 | +Contributors |
| 99 | +------------ |
| 100 | + |
| 101 | +- Alexis de Lattre <alexis.delattre@akretion.com> |
| 102 | + |
| 103 | +Maintainers |
| 104 | +----------- |
| 105 | + |
| 106 | +This module is maintained by the OCA. |
| 107 | + |
| 108 | +.. image:: https://odoo-community.org/logo.png |
| 109 | + :alt: Odoo Community Association |
| 110 | + :target: https://odoo-community.org |
| 111 | + |
| 112 | +OCA, or the Odoo Community Association, is a nonprofit organization whose |
| 113 | +mission is to support the collaborative development of Odoo features and |
| 114 | +promote its widespread use. |
| 115 | + |
| 116 | +.. |maintainer-alexis-via| image:: https://github.com/alexis-via.png?size=40px |
| 117 | + :target: https://github.com/alexis-via |
| 118 | + :alt: alexis-via |
| 119 | + |
| 120 | +Current `maintainer <https://odoo-community.org/page/maintainer-role>`__: |
| 121 | + |
| 122 | +|maintainer-alexis-via| |
| 123 | + |
| 124 | +This module is part of the `OCA/edi <https://github.com/OCA/edi/tree/17.0/base_facturx>`_ project on GitHub. |
| 125 | + |
| 126 | +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
0 commit comments