Bank Statement TXT/CSV Import (Base)
This module is the base for a system for importing sheet-like files, and includes the direct support for TXT/CSV. Other formats like XLS, XLSX will be added by additional modules.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets you import bank statements from TXT/CSV files by defining reusable column mappings, so Odoo knows which column holds the date, amount, description, etc. You can set a default mapping per bank journal and import directly from the standard statement import screen.
This module adds a flexible way to bring bank statement files in TXT or CSV format into Odoo. Instead of a fixed format, you create a "Statement Sheet Mapping" that tells Odoo how to read your file.
- In Accounting, a new menu "Statement Sheet Mappings" lets you create and manage these mappings. On each mapping you choose the file encoding, the column delimiter, the text qualifier, the date format, and the number separators (thousands and decimals).
- You then name the columns that contain the transaction date, amount, balance, currency, description, notes, reference, partner name, bank name and bank account. You can also skip header or footer lines, ignore empty lines, and offset leading columns.
- Three amount styles are supported: a single signed amount, an absolute amount with a separate debit/credit indicator column, or separate debit and credit amount columns. A validation prevents saving a mapping that is missing the columns required by the chosen style.
- On a bank journal you can set a default mapping, which is automatically pre-filled when you import a statement. The import screen shows a "TXT/CSV/XLSX mapping" field where you can pick a different mapping for a one-off import.
- During import, the file is decoded, parsed, sorted by date, and converted into statement lines. If the file has no balance column, Odoo computes the closing balance from the opening balance plus the imported amounts.
Depends on
Required by other modules
Menus it adds
Models and fields (4)
- account.journal · extends an existing modeldefault_sheet_mapping_id
- account.statement.import · extends an existing modelsheet_mapping_id (Sheet mapping)
- account.statement.import.sheet.parser · new model
- account.statement.import.sheet.mapping · new modelname, delimiter, no_header (File does not contain header line), quotechar (Text qualifier), amount_type (Amount type), debit_value, credit_value, notes_column, amount_column (Amount column), file_encoding (Encoding), offset_column, balance_column, currency_column, bank_name_column, reference_column, skip_empty_lines, timestamp_column, timestamp_format, float_decimal_sep (Decimals Separator), description_column, amount_debit_column (Debit amount column), amount_inverse_sign (Inverse sign of amount), bank_account_column, debit_credit_column (Debit/credit column), float_thousands_sep (Thousands Separator), partner_name_column, amount_credit_column (Credit amount column), transaction_id_column (Unique transaction ID column), original_amount_column, footer_lines_skip_count (Footer lines skip count)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/bank-statement-import.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0To create TXT/CSV/XLSX statement sheet columns mapping:
- Open Invoicing \> Configuration \> Accounting \> Statement Sheet Mappings
- Create mapping(s) according to your online banking software statement format
Usage
Source · Odoo 19.0To use this module, you need to:
- Get statement in TXT/CSV from your online banking software
- Go to Odoo and and import the statement file, selecting corresponding format
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.