[MERGE] Sync with trunk
[odoo/odoo.git] / addons / l10n_be_coda / __openerp__.py
1 # -*- encoding: utf-8 -*-
2 ##############################################################################
3 #
4 #    OpenERP, Open Source Management Solution
5 #    
6 #    Copyright (c) 2011 Noviat nv/sa (www.noviat.be). All rights reserved.
7
8 #    This program is free software: you can redistribute it and/or modify
9 #    it under the terms of the GNU Affero General Public License as
10 #    published by the Free Software Foundation, either version 3 of the
11 #    License, or (at your option) any later version.
12 #
13 #    This program is distributed in the hope that it will be useful,
14 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
15 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 #    GNU Affero General Public License for more details.
17 #
18 #    You should have received a copy of the GNU Affero General Public License
19 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
20 #
21 ##############################################################################
22 {
23     'name': 'Belgium - Import Bank CODA Statements',
24     'version': '2.1',
25     'author': 'Noviat',
26     'category': 'Accounting & Finance',
27     'description': '''
28 Module to import CODA bank statements.
29 ======================================
30
31 Supported are CODA flat files in V2 format from Belgian bank accounts.
32 ----------------------------------------------------------------------
33     * CODA v1 support.
34     * CODA v2.2 support.
35     * Foreign Currency support.
36     * Support for all data record types (0, 1, 2, 3, 4, 8, 9).
37     * Parsing & logging of all Transaction Codes and Structured Format 
38       Communications.
39     * Automatic Financial Journal assignment via CODA configuration parameters.
40     * Support for multiple Journals per Bank Account Number.
41     * Support for multiple statements from different bank accounts in a single 
42       CODA file.
43     * Support for 'parsing only' CODA Bank Accounts (defined as type='info' in 
44       the CODA Bank Account configuration records).
45     * Multi-language CODA parsing, parsing configuration data provided for EN, 
46       NL, FR.
47
48 The machine readable CODA Files are parsed and stored in human readable format in 
49 CODA Bank Statements. Also Bank Statements are generated containing a subset of 
50 the CODA information (only those transaction lines that are required for the 
51 creation of the Financial Accounting records). The CODA Bank Statement is a 
52 'read-only' object, hence remaining a reliable representation of the original
53 CODA file whereas the Bank Statement will get modified as required by accounting 
54 business processes.
55
56 CODA Bank Accounts configured as type 'Info' will only generate CODA Bank Statements.
57
58 A removal of one object in the CODA processing results in the removal of the 
59 associated objects. The removal of a CODA File containing multiple Bank 
60 Statements will also remove those associated statements.
61
62 The following reconciliation logic has been implemented in the CODA processing:
63 -------------------------------------------------------------------------------
64     1) The Company's Bank Account Number of the CODA statement is compared against 
65        the Bank Account Number field of the Company's CODA Bank Account 
66        configuration records (whereby bank accounts defined in type='info' 
67        configuration records are ignored). If this is the case an 'internal transfer'
68        transaction is generated using the 'Internal Transfer Account' field of the 
69        CODA File Import wizard.
70     2) As a second step the 'Structured Communication' field of the CODA transaction
71        line is matched against the reference field of in- and outgoing invoices 
72        (supported : Belgian Structured Communication Type).
73     3) When the previous step doesn't find a match, the transaction counterparty is 
74        located via the Bank Account Number configured on the OpenERP Customer and 
75        Supplier records.
76     4) In case the previous steps are not successful, the transaction is generated 
77        by using the 'Default Account for Unrecognized Movement' field of the CODA 
78        File Import wizard in order to allow further manual processing.
79
80 In stead of a manual adjustment of the generated Bank Statements, you can also 
81 re-import the CODA after updating the OpenERP database with the information that 
82 was missing to allow automatic reconciliation.
83
84 Remark on CODA V1 support:
85 ~~~~~~~~~~~~~~~~~~~~~~~~~~
86 In some cases a transaction code, transaction category or structured 
87 communication code has been given a new or clearer description in CODA V2.The
88 description provided by the CODA configuration tables is based upon the CODA 
89 V2.2 specifications.
90 If required, you can manually adjust the descriptions via the CODA configuration menu.
91 ''',
92     'images'   : ['images/coda_logs.jpeg','images/import_coda_logs.jpeg'],
93     'depends': ['account_voucher','base_iban', 'l10n_be_invoice_bba',],
94     'demo': [],
95     'data': [
96         'l10n_be_coda_wizard.xml',
97         'l10n_be_coda_view.xml',
98     ],
99     'auto_install': False,
100     'installable': True,
101     'license': 'AGPL-3',
102 }
103
104 # vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: