added description for DATEV Import .csv

description (covered use cases, limitations, usage)

datev_import_csv_dtvf/readme/DESCRIPTION.rst

@@ -1 +1,16 @@
-This module is used to import account moves from a CSV file generated by DATEV
+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.

datev_import_csv_dtvf/readme/USAGE.rst

@@ -1,3 +1,53 @@
+Import from DATEV into Odoo
+===========================
+
+Requirements
+~~~~~~~~~~~~
+
 #. Make sure your user has group 'Full accounting features'
-#. Go to `Accounting/Actions/Import DATEV Format (.csv)`
-#. Upload your file, choose a journal and start the import
+#. 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:: ../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:: ../static/description/datev_import_csv_wizard_error.png
+     :width: 100%
+
+In this case you have to ensure to create the missing accounts in Odoo.