Metadata-Version: 2.1
Name: odoo-addon-datev_import_csv_dtvf
Version: 18.0.1.1.0
Requires-Python: >=3.10
Requires-Dist: chardet
Requires-Dist: odoo==18.0.*
Summary: Import account moves generated by external software
Home-page: https://github.com/OCA/l10n-germany
License: AGPL-3
Author: Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

============================
Account Move CSV Import DTVF
============================

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

.. |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/license-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/18.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-18-0/l10n-germany-18-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=18.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
------------

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

DATEV Import
------------

1.  Go to Accounting/Actions/DATEV Import
2.  Upload your DATEV format .csv file from your tax advisor
3.  Take care the file format is "DATEV Format .csv" (old version:
    Generic CSV)
4.  Take care your file encoding fits to the provided file (usually
    "Western (Windows-1252)"), if it is the original file from your tax
    advisor
5.  Optionally you may activate "Post Journal Entry" in order to
    immidiately confirm the created Journal Entry
6.  Select the mandatory journal (f.e. "Payroll Account Moves"), usually
    the journal type will be "Miscellaneous"
7.  Enter optionally the "Force Date" field ((will be the field "Date"
    in your Journal Entry)
8.  Enter the mandatory field "Reference" (will be the field "Reference"
    in your Journal Entry)
9.  Enter optionally the field "Force Label" (will be the field "Name"
    in your Journal Items)
10. Finally click on "Run Import"

|image|

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.

|image1|

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

.. |image| image:: https://raw.githubusercontent.com/OCA/l10n-germany/18.0/datev_import_csv_dtvf/static/description/datev_import_csv_wizard.png
.. |image1| image:: https://raw.githubusercontent.com/OCA/l10n-germany/18.0/datev_import_csv_dtvf/static/description/datev_import_csv_wizard_error.png

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:%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
=======

Contributors
------------

- Holger Brunn <mail@hunki-enterprises.com>
  (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/18.0/datev_import_csv_dtvf>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
