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

[14.0][MIG] migrate account_move_csv_import_dtvf from a private repo #121

Closed
wants to merge 12 commits into from
143 changes: 143 additions & 0 deletions datev_import_csv_dtvf/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
============================
Account Move CSV Import DTVF
============================

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

.. |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%2Fl10n--germany-lightgray.png?logo=github
:target: https://github.com/OCA/l10n-germany/tree/14.0/datev_import_csv_dtvf
:alt: OCA/l10n-germany
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/l10n-germany-14-0/l10n-germany-14-0-datev_import_csv_dtvf
: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/l10n-germany&target_branch=14.0
:alt: Try me on Runboat

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

DATEV Format .csv Import
========================

The module "datev_import_csv_dtvf" enables the import of DATEV journal entries into Odoo.
Possible use cases include:

- DATEV journal entries from payroll and salary accounting
- DATEV journal entries in the context of annual financial statements
- DATEV journal entries in the context of reallocations by the tax consultant
- DATEV journal entries in the context of depreciation (AfA) bookings by the tax consultant
- DATEV journal entries in the context of loans

Currently, the following limitations exist:

- DATEV journal entries containing tax-related booking keys require adjustments in Odoo
- Under certain circumstances, DATEV journal entries on creditor and debtor accounts may also be affected.

**Table of contents**

.. contents::
:local:

Usage
=====

Import from DATEV into Odoo
===========================

Requirements
~~~~~~~~~~~~

#. Make sure your user has group 'Full accounting features'
#. Check if the file you want to import into Odoo is DATEV format .csv (move lines start is line 3)
#. Check the description in order to check if your use case is supported
#. Take care of the limitation to import account moves with taxes


DATEV Import
~~~~~~~~~~~~~

#. Go to `Accounting/Actions/DATEV Import`

#. Upload your DATEV format .csv file from your tax advisor

#. Take care the file format is "DATEV Format .csv" (old version: Generic CSV)

#. Take care your file encoding fits to the provided file (usually "Western (Windows-1252)"), if it is the original file from your tax advisor

#. Optionally you may activate "Post Journal Entry" in order to immidiately confirm the created Journal Entry

#. Select the mandatory journal (f.e. "Payroll Account Moves"), usually the journal type will be "Miscellaneous"

#. Enter optionally the "Force Date" field ((will be the field "Date" in your Journal Entry)

#. Enter the mandatory field "Reference" (will be the field "Reference" in your Journal Entry)

#. Enter optionally the field "Force Label" (will be the field "Name" in your Journal Items)

#. Finally click on "Run Import"


.. image:: https://raw.githubusercontent.com/OCA/l10n-germany/14.0/datev_import_csv_dtvf/static/description/datev_import_csv_wizard.png
:width: 100%


If everyting works fine, you should now see your created Journal Entry in draft (execept you activated "Post Journal Entry")


Typical issue
~~~~~~~~~~~~~

If accounts doesen't exist in Odoo the wizard may interrupt and show you potential missing accounts.


.. image:: https://raw.githubusercontent.com/OCA/l10n-germany/14.0/datev_import_csv_dtvf/static/description/datev_import_csv_wizard_error.png
:width: 100%

In this case you have to ensure to create the missing accounts in Odoo.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-germany/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/l10n-germany/issues/new?body=module:%20datev_import_csv_dtvf%0Aversion:%2014.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
=======

Contributors
~~~~~~~~~~~~

* Holger Brunn <[email protected]> (https://hunki-enterprises.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.

This module is part of the `OCA/l10n-germany <https://github.com/OCA/l10n-germany/tree/14.0/datev_import_csv_dtvf>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
2 changes: 2 additions & 0 deletions datev_import_csv_dtvf/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
from . import models
from . import wizard
20 changes: 20 additions & 0 deletions datev_import_csv_dtvf/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
{
"name": "Account Move CSV Import DTVF",
"summary": "Import account moves generated by external software",
"author": "Odoo Community Association (OCA)",
"version": "14.0.1.0.0",
"category": "Accounting",
"depends": ["account"],
"website": "https://github.com/OCA/l10n-germany",
"demo": [],
"external_dependencies": {"python": ["unicodecsv"]},
"data": [
"security/ir.model.access.csv",
"data/sequence.xml",
"wizard/import_move_view.xml",
],
"installable": True,
"auto_install": False,
"license": "AGPL-3",
}
12 changes: 12 additions & 0 deletions datev_import_csv_dtvf/data/sequence.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8" ?>
<odoo noupdate="1">

<record id="account_move_import_seq" model="ir.sequence">
<field name="name">Account Move Import</field>
<field name="code">account.move.import</field>
<field name="prefix">IMPORT</field>
<field name="padding">3</field>
<field name="company_id" eval="False" />
</record>

</odoo>
Loading
Loading