OdooWiki OCA HUB

Account Payment Return Import

account_payment_return_import folder_open OCA/account-payment open_in_new
Accounting License: AGPL-3

This module adds a generic wizard + methods to import payment return file formats.

It's a base to be extended by another modules though it allows to import a csv that will process the return payments on it.

Multiple payment return files contained in a zip are also supported.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Import bank payment return files (CSV or ZIP) to automatically create payment returns in Odoo, with duplicate detection and optional automatic matching.

This module adds an import wizard to Odoo's Accounting app that lets you load payment return files received from your bank. You can find it under Accounting > Customers > Import Payment Return. The wizard accepts a single file or a ZIP archive containing multiple files, and it can automatically match the imported returns with existing payments if you leave the 'Match after import' option checked.

When you import a file, the system reads the bank account number from the file, finds the corresponding bank account in Odoo, and determines the correct bank journal. If the journal cannot be found automatically, you can select it manually in the wizard. Each imported transaction gets a unique import ID, and the system checks for duplicates: if a transaction was already imported, it is skipped and you receive a warning listing the ignored items.

The module extends the payment return form and search views to show the imported bank account, and adds a filter to group payment returns by that bank account. It also adds a new field on payment return lines to store the raw import data for debugging. The import process is designed to be extended by other modules for specific bank file formats, but it already supports a basic CSV format.

Menus it adds

menu_account_payment_return_import
Models and fields (3)
  • payment.return · extends an existing modelimported_bank_account_id (Bank account)
  • payment.return.line · extends an existing modelraw_import_data, unique_import_id (Import ID)
  • payment.return.import · new modeldata_file (Payment Return File), journal_id (Journal), hide_journal_field (Hide the journal field in the view), match_after_import

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/account-payment.

terminal Installation and usage

OCA documentation · Odoo 19.0

Under Invoicing \> Customers there is available a new menu called Import Payment Return that drives to a wizard that allows to upload a csv with that has to have the following columns (* for required):

account_number name * date * amount * unique_import_id * concept reason_code reason partner_name reference

No verified information in OCA: Installation, Configuration.

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.