Skip to content

Commit

Permalink
Merge PR #121 into 14.0
Browse files Browse the repository at this point in the history
Signed-off-by tv-openbig
  • Loading branch information
OCA-git-bot committed Sep 3, 2023
2 parents 6cec44d + be3311d commit 68f89df
Show file tree
Hide file tree
Showing 25 changed files with 2,280 additions and 0 deletions.
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

0 comments on commit 68f89df

Please sign in to comment.