Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[18.0][MIG] base_facturx #1101

Open
wants to merge 28 commits into
base: 18.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
9792943
Port Factur-X invoice generation stack v10 -> v12
alexis-via Feb 10, 2020
c08ddcd
[MIG] base_facturx to v13
alexis-via Jun 11, 2020
bfb879a
base_facturx: black, isort, ...
alexis-via Jun 11, 2020
cee0b1c
base_facturx: XML reformatting to make Travis happy
alexis-via Nov 23, 2020
502f834
[UPD] README.rst
OCA-git-bot Nov 23, 2020
96b8c5a
[MIG] base_facturx to v14
alexis-via Nov 23, 2020
0842fed
[UPD] Update base_facturx.pot
oca-travis Jun 16, 2021
7b8968f
[UPD] README.rst
OCA-git-bot Jun 16, 2021
37ad397
Added translation using Weblate (French)
Yvesldff Jun 17, 2021
f58acad
Translated using Weblate (French)
Yvesldff Jun 17, 2021
076685b
[MIG] base_facturx from v14 to v15
alexis-via Dec 31, 2021
99f1ef0
[UPD] Update base_facturx.pot
Jan 28, 2022
b6ace32
[UPD] README.rst
OCA-git-bot Jan 28, 2022
c4d38e6
[MIG] base_facturx to v16
alexis-via Dec 26, 2022
2a38eff
[UPD] Update base_facturx.pot
Mar 23, 2023
baa3c0b
[UPD] README.rst
OCA-git-bot Mar 23, 2023
a9a71f9
Update translation files
weblate Mar 23, 2023
6335325
Translated using Weblate (French)
Jun 27, 2023
fc57f06
Translated using Weblate (Spanish)
Ivorra78 Aug 7, 2023
c817f4a
[UPD] README.rst
OCA-git-bot Sep 3, 2023
3d8f865
[IMP] base_facturx: pre-commit auto fixes
alexis-via Mar 4, 2024
af7c8cc
[MIG] base_facturx: migration to v17
alexis-via Mar 4, 2024
a888874
[UPD] Update base_facturx.pot
Mar 12, 2024
fe166e3
[BOT] post-merge updates
OCA-git-bot Mar 12, 2024
5e2f370
Added translation using Weblate (Italian)
mymage Mar 13, 2024
9554753
Translated using Weblate (Italian)
mymage Mar 13, 2024
dcd070f
[IMP] base_facturx: pre-commit auto fixes
alexis-via Dec 27, 2024
f085779
[MIG] base_facturx to v18
alexis-via Dec 27, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
126 changes: 126 additions & 0 deletions base_facturx/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,126 @@
=============
Base Factur-X
=============

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:9ce2cb7b7cfaf1029268ae6e659574a5f086b352254ca7f0f4bcc817845772c5
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/18.0/base_facturx
:alt: OCA/edi
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/edi-18-0/edi-18-0-base_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=18.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This is the base module for the implementation of the
`Factur-X <http://fnfe-mpe.org/factur-x/factur-x_en/>`__ and
`ZUGFeRD <https://www.ferd-net.de/standards/was-ist-zugferd/index.html>`__
standards. The standard Factur-X 1.0 is the same as ZUGFeRD 2.1 (the
name Factur-X is always used in France, whereas in Germany many people
use the name ZUGFeRD). It is a standard based on
`CII <http://tfig.unece.org/contents/cross-industry-invoice-cii.htm>`__
(Cross-Industry Invoice) for electronic invoicing.

The great idea of the Factur-X/ZUGFeRD standard is to embed an XML file
inside the PDF invoice to carry structured information about the
invoice.

**Table of contents**

.. contents::
:local:

Configuration
=============

To configure this module, you need to:

- go to the menu *Inventory > Configuration > Units of Measures > UoM*
and check the *UNECE Code* for the units of measures.
- go to the menu *Invoicing > Configuration > Accounting > Taxes* and,
for each tax, set a *UNECE Type Code* and a *UNECE Category Code*.
- go to the menu *Invoicing > Configuration > Management > Payment
Methods* (to see that menu entry, the module *account_payment_mode*
must be installed) and assign a *UNECE Code* to the payment methods
that are selected in the payment modes.

To avoid the manual configuration of taxes, look for a module
*l10n_XX_account_tax_unece* in the OCA project of your localization (it
exists at least for the Netherlands and France). If such a module exists
in your localization, install it and it will auto-configure the taxes
created by your localization.

Usage
=====

This module doesn't do anything by itself, but it is used by 2 other
modules:

- *account_invoice_facturx* that generate Factur-X 1.0 (i.e. ZUGFeRD
2.1) customer invoices/refunds,
- *account_invoice_import_facturx* that imports ZUGFeRD/Factur-X
supplier invoices/refunds (all versions, including ZUGFeRD 1.0).

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:%20base_facturx%0Aversion:%2018.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/18.0/base_facturx>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 1 addition & 0 deletions base_facturx/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
16 changes: 16 additions & 0 deletions base_facturx/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Copyright 2016-2022 Akretion France (http://www.akretion.com/)
# @author: Alexis de Lattre <alexis.delattre@akretion.com>
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).

{
"name": "Base Factur-X",
"version": "18.0.1.0.0",
"category": "Invoicing Management",
"license": "AGPL-3",
"summary": "Base module for Factur-X/ZUGFeRD",
"author": "Akretion,Odoo Community Association (OCA)",
"maintainers": ["alexis-via"],
"website": "https://github.com/OCA/edi",
"depends": ["uom_unece", "account_tax_unece", "account_payment_unece"],
"installable": True,
}
19 changes: 19 additions & 0 deletions base_facturx/i18n/base_facturx.pot
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * base_facturx
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 17.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"

#. module: base_facturx
#: model:ir.model,name:base_facturx.model_base_facturx
msgid "Common methods to generate and parse Factur-X and Order-X"
msgstr ""
47 changes: 47 additions & 0 deletions base_facturx/i18n/base_zugferd.pot
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * base_zugferd
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 10.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: <>\n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"

#. module: base_zugferd
#: model:ir.model,name:base_zugferd.model_base_facturx
msgid "Common methods to generate and parse Factur-X invoices"
msgstr ""

#. module: base_zugferd
#: model:ir.model.fields,field_description:base_zugferd.field_base_facturx_display_name
msgid "Display Name"
msgstr ""

#. module: base_zugferd
#: model:ir.model.fields,field_description:base_zugferd.field_base_facturx_id
msgid "ID"
msgstr ""

#. module: base_zugferd
#: model:ir.model.fields,field_description:base_zugferd.field_base_facturx___last_update
msgid "Last Modified on"
msgstr ""

#. module: base_zugferd
#: code:addons/base_zugferd/models/base_facturx.py:46
#, python-format
msgid "The %s XML file is not valid against the official XML Schema Definition. The XML file and the full error have been written in the server logs. Here is the error, which may give you an idea on the cause of the problem : %s."
msgstr ""

#. module: base_zugferd
#: code:addons/base_zugferd/models/base_facturx.py:29
#, python-format
msgid "Wrong level '%s' for Factur-X invoice."
msgstr ""

31 changes: 31 additions & 0 deletions base_facturx/i18n/es.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * base_zugferd
#
# Translators:
# enjolras <yo@miguelrevilla.com>, 2018
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 10.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-03-12 01:43+0000\n"
"PO-Revision-Date: 2023-08-07 11:09+0000\n"
"Last-Translator: Ivorra78 <informatica@totmaterial.es>\n"
"Language-Team: Spanish (https://www.transifex.com/oca/teams/23907/es/)\n"
"Language: es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 4.17\n"

#. module: base_facturx
#: model:ir.model,name:base_facturx.model_base_facturx
msgid "Common methods to generate and parse Factur-X and Order-X"
msgstr "Métodos habituales para generar y analizar Factur-X y Order-X"

#~ msgid "Display Name"
#~ msgstr "Nombre mostrado"

#~ msgid "Last Modified on"
#~ msgstr "Última modificación el"
25 changes: 25 additions & 0 deletions base_facturx/i18n/fr.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * base_facturx
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 14.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2023-06-27 19:08+0000\n"
"Last-Translator: Alexis de Lattre <alexis@via.ecp.fr>\n"
"Language-Team: none\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n > 1;\n"
"X-Generator: Weblate 4.17\n"

#. module: base_facturx
#: model:ir.model,name:base_facturx.model_base_facturx
msgid "Common methods to generate and parse Factur-X and Order-X"
msgstr "Méthodes communes pour générer et lire Factur-X et Order-X"

#~ msgid "Display Name"
#~ msgstr "Nom affiché"
22 changes: 22 additions & 0 deletions base_facturx/i18n/it.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * base_facturx
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 17.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2024-03-13 11:40+0000\n"
"Last-Translator: mymage <stefano.consolaro@mymage.it>\n"
"Language-Team: none\n"
"Language: it\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 4.17\n"

#. module: base_facturx
#: model:ir.model,name:base_facturx.model_base_facturx
msgid "Common methods to generate and parse Factur-X and Order-X"
msgstr "Metodi comuni per generare e analizzare Factur-X e Order-X"
1 change: 1 addition & 0 deletions base_facturx/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import base_facturx
13 changes: 13 additions & 0 deletions base_facturx/models/base_facturx.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Copyright 2017-2022 Akretion France
# @author: Alexis de Lattre <alexis.delattre@akretion.com>
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).

from odoo import models


class BaseFacturX(models.AbstractModel):
_name = "base.facturx"
_description = "Common methods to generate and parse Factur-X and Order-X"

# This class will certainly start to be used with the implementation
# of Order-X sooner or later: http://fnfe-mpe.org/factur-x/order-x/
3 changes: 3 additions & 0 deletions base_facturx/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[build-system]
requires = ["whool"]
build-backend = "whool.buildapi"
17 changes: 17 additions & 0 deletions base_facturx/readme/CONFIGURE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
To configure this module, you need to:

- go to the menu *Inventory \> Configuration \> Units of Measures \>
UoM* and check the *UNECE Code* for the units of measures.
- go to the menu *Invoicing \> Configuration \> Accounting \> Taxes*
and, for each tax, set a *UNECE Type Code* and a *UNECE Category
Code*.
- go to the menu *Invoicing \> Configuration \> Management \> Payment
Methods* (to see that menu entry, the module *account_payment_mode*
must be installed) and assign a *UNECE Code* to the payment methods
that are selected in the payment modes.

To avoid the manual configuration of taxes, look for a module
*l10n_XX_account_tax_unece* in the OCA project of your localization (it
exists at least for the Netherlands and France). If such a module exists
in your localization, install it and it will auto-configure the taxes
created by your localization.
1 change: 1 addition & 0 deletions base_facturx/readme/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
- Alexis de Lattre \<<alexis.delattre@akretion.com>\>
12 changes: 12 additions & 0 deletions base_facturx/readme/DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
This is the base module for the implementation of the
[Factur-X](http://fnfe-mpe.org/factur-x/factur-x_en/) and
[ZUGFeRD](https://www.ferd-net.de/standards/was-ist-zugferd/index.html)
standards. The standard Factur-X 1.0 is the same as ZUGFeRD 2.1 (the
name Factur-X is always used in France, whereas in Germany many people
use the name ZUGFeRD). It is a standard based on
[CII](http://tfig.unece.org/contents/cross-industry-invoice-cii.htm)
(Cross-Industry Invoice) for electronic invoicing.

The great idea of the Factur-X/ZUGFeRD standard is to embed an XML file
inside the PDF invoice to carry structured information about the
invoice.
7 changes: 7 additions & 0 deletions base_facturx/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
This module doesn't do anything by itself, but it is used by 2 other
modules:

- *account_invoice_facturx* that generate Factur-X 1.0 (i.e. ZUGFeRD
2.1) customer invoices/refunds,
- *account_invoice_import_facturx* that imports ZUGFeRD/Factur-X
supplier invoices/refunds (all versions, including ZUGFeRD 1.0).
Binary file added base_facturx/static/description/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading