OdooWiki OCA HUB

Bank Statement TXT/CSV/XLSX Import

account_statement_import_txt_xlsx folder_open OCA/bank-statement-import open_in_new
Accounting License: AGPL-3

This module allows you to import any TXT/CSV or XLSX file in Odoo as bank statements.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Import bank statements from TXT, CSV or XLSX files into Odoo by describing which column holds each piece of data. Mappings can be saved, reused and set as the default for a bank journal.

This module adds a flexible way to bring bank statements into Odoo when the bank does not provide a standard format. Instead of a fixed file layout, you create a "Sheet Mapping" that tells Odoo how to read your file.

In a mapping you choose the file encoding, the column delimiter, the text qualifier, the date format, and the thousands and decimal separators. You then say which column contains the date, the amount (or separate debit and credit amounts), the balance, the currency, the description, the reference, the transaction ID, the partner name and the partner's bank details. If the file has no header line, you can enter column numbers instead of names, and you can skip empty lines or ignore leading rows and columns.

Mappings are managed under Accounting > Statement Sheet Mappings. On a bank journal you can set a default mapping, which is then pre-filled when you import a statement. A guided wizard also lets you upload a file, preview its columns and build a mapping step by step.

When importing, Odoo reads the file, sorts transactions by date, and fills the statement's opening and closing balances when a balance column is provided. If the closing balance is missing, it is computed from the opening balance plus the transaction amounts. Transactions keep their unique ID, reference, notes and partner information.

Menus it adds

Statement Sheet Mappings
Models and fields (5)
  • 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), offset_row, debit_value, credit_value, notes_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), 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, original_currency_column
  • account.statement.import.sheet.mapping.wizard · new modelheader, delimiter, quotechar (Text qualifier), debit_value, credit_value, notes_column, amount_column, file_encoding (Encoding), attachment_ids (Files), balance_column, currency_column, bank_name_column, reference_column, timestamp_column, description_column, amount_debit_column (Debit amount column), bank_account_column, debit_credit_column (Debit/credit column), partner_name_column, amount_credit_column (Credit amount column), transaction_id_column (Unique transaction ID column), original_amount_column, original_currency_column

Text generated by AI (DeepSeek) from reading the Odoo 15.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

Sources · Odoo 14.0

Confirmed on 2026-11-03 in branch 14.0 of OCA/bank-statement-import.

terminal Installation and usage

OCA documentation · Odoo 15.0

To 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

To use this module, you need to:

  • Get statement in TXT/CSV or XLSX from your online banking software
  • Go to Odoo and and import the statement file, selecting corresponding format

No verified information in OCA: Installation.

info

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.