Merge pull request #613 from OCA/17.0

Syncing from upstream OCA/bank-statement-import (17.0)
brain-tec · Mar 1, 2025 · 8a7b9c4 · 8a7b9c4
2 parents a05b735 + 241c43a
commit 8a7b9c4
Show file tree

Hide file tree

Showing 35 changed files with 3,431 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -31,6 +31,7 @@ addon | version | maintainers | summary
 [account_statement_import_online](account_statement_import_online/) | 17.0.1.0.0 | [![alexey-pelykh](https://github.com/alexey-pelykh.png?size=30px)](https://github.com/alexey-pelykh) | Online bank statements update
 [account_statement_import_online_gocardless](account_statement_import_online_gocardless/) | 17.0.1.0.0 |  | Online Bank Statements: GoCardless
 [account_statement_import_online_ponto](account_statement_import_online_ponto/) | 17.0.1.1.1 |  | Online Bank Statements: MyPonto.com
+[account_statement_import_paypal](account_statement_import_paypal/) | 17.0.1.0.0 |  | Import PayPal CSV files as Bank Statements in Odoo
 [account_statement_import_sheet_file](account_statement_import_sheet_file/) | 17.0.1.1.0 | [![alexey-pelykh](https://github.com/alexey-pelykh.png?size=30px)](https://github.com/alexey-pelykh) | Import TXT/CSV or XLSX files as Bank Statements in Odoo
 
 [//]: # (end addons)

diff --git a/account_statement_import_paypal/README.rst b/account_statement_import_paypal/README.rst
@@ -0,0 +1,135 @@
+========================================
+PayPal CSV Format Bank Statements Import
+========================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:ec4bf4ac3cec140e769c5e4a1c757ee98e18323ed6fe4f61a57e76c9ad4635e1
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fbank--statement--import-lightgray.png?logo=github
+    :target: https://github.com/OCA/bank-statement-import/tree/17.0/account_statement_import_paypal
+    :alt: OCA/bank-statement-import
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/bank-statement-import-17-0/bank-statement-import-17-0-account_statement_import_paypal
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/bank-statement-import&target_branch=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module allows you to import the PayPal CSV files in Odoo as bank
+statements.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To adjust PayPal report columns mapping:
+
+1. Open *Invoicing > Configuration > Accounting > PayPal Report
+   Mappings*
+2. Modify mapping(s) according to your CSV reports format.
+
+Usage
+=====
+
+To import statements from PayPal via Statement report:
+
+1. Go to
+   `PayPal <https://business.paypal.com/merchantdata/reportHome/>`__
+2. Open *Statements* and select *Monthly* or *Custom*
+3. Select date range of interest and click *Request* under *CSV* column
+4. Wait for statement report to be generated
+5. Download it and save to a file
+6. Go to Odoo and and import saved statement file, selecting
+   corresponding format
+
+To import statements from PayPal via Activity report:
+
+1. Go to
+   `PayPal <https://business.paypal.com/merchantdata/reportHome/>`__
+2. Open *Activity download*
+3. Set *Transaction type* to *Balance affecting*
+4. Set *Format* to *CSV*
+5. Select date range of interest and click *Create report*
+6. Wait for activity report to be generated
+7. Download it and save to a file
+8. Go to Odoo and and import saved statement file, selecting
+   corresponding format
+
+Changelog
+=========
+
+12.0.2.0.0
+----------
+
+- [BREAKING] New mapping, please review mappings after upgrade.
+- [BREAKING] Different bank accounts have to be used per each currency.
+- [ADD] Support for both Statement and Activity reports.
+- [ADD] Separate fee and currency exchange parsing.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/bank-statement-import/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/bank-statement-import/issues/new?body=module:%20account_statement_import_paypal%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Akretion
+* CorporateHub
+
+Contributors
+------------
+
+- Alexis de Lattre <[email protected]>
+- Sebastien BEAU <[email protected]>
+- Tecnativa (https://www.tecnativa.com)
+
+  - Vicent Cubells
+  - Victor M.M. Torres
+  - Carlos Roca
+
+- Alexey Pelykh <[email protected]>
+  (`CorporateHub <https://corporatehub.eu/>`__)
+- Manuel Regidor <[email protected]>
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+This module is part of the `OCA/bank-statement-import <https://github.com/OCA/bank-statement-import/tree/17.0/account_statement_import_paypal>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
diff --git a/account_statement_import_paypal/__init__.py b/account_statement_import_paypal/__init__.py
@@ -0,0 +1,4 @@
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from . import models
+from . import wizards
diff --git a/account_statement_import_paypal/__manifest__.py b/account_statement_import_paypal/__manifest__.py
@@ -0,0 +1,28 @@
+# Copyright 2014-2017 Akretion (http://www.akretion.com).
+# Copyright 2019 Tecnativa - Vicent Cubells
+# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com)
+# Copyright 2020 CorporateHub (https://corporatehub.eu)
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "PayPal CSV Format Bank Statements Import",
+    "summary": "Import PayPal CSV files as Bank Statements in Odoo",
+    "version": "17.0.1.0.0",
+    "category": "Accounting",
+    "website": "https://github.com/OCA/bank-statement-import",
+    "author": "Akretion, CorporateHub, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "installable": True,
+    "depends": [
+        "account_statement_import_file",
+        "multi_step_wizard",
+        "web_widget_dropdown_dynamic",
+    ],
+    "data": [
+        "security/ir.model.access.csv",
+        "data/maps.xml",
+        "views/account_statement_import_paypal_mapping.xml",
+        "views/account_statement_import.xml",
+        "wizards/account_statement_import_paypal_mapping_wizard.xml",
+    ],
+}
diff --git a/account_statement_import_paypal/data/maps.xml b/account_statement_import_paypal/data/maps.xml
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!--
+    Copyright 2019 Tecnativa - Vicent Cubells
+    Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com)
+    Copyright 2020 CorporateHub (https://corporatehub.eu)
+    License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+-->
+<odoo noupdate="1">
+    <record
+        id="paypal_statement_map_en"
+        model="account.statement.import.paypal.mapping"
+    >
+        <field name="name">PayPal Statement (EN)</field>
+        <field name="float_thousands_sep">comma</field>
+        <field name="float_decimal_sep">dot</field>
+        <field name="date_format">%m/%d/%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Date</field>
+        <field name="time_column">Time</field>
+        <field name="tz_column">Time Zone</field>
+        <field name="name_column">Name</field>
+        <field name="currency_column">Currency</field>
+        <field name="gross_column">Gross</field>
+        <field name="fee_column">Fee</field>
+        <field name="balance_column">Balance</field>
+        <field name="transaction_id_column">Transaction ID</field>
+        <field name="description_column">Description</field>
+        <field name="from_email_address_column">From Email Address</field>
+        <field name="invoice_id_column">Invoice ID</field>
+        <field name="bank_name_column">Bank Name</field>
+        <field name="bank_account_column">Bank Account</field>
+    </record>
+    <record id="paypal_activity_map_en" model="account.statement.import.paypal.mapping">
+        <field name="name">PayPal Activity (EN)</field>
+        <field name="float_thousands_sep">comma</field>
+        <field name="float_decimal_sep">dot</field>
+        <field name="date_format">%d/%m/%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Date</field>
+        <field name="time_column">Time</field>
+        <field name="tz_column">TimeZone</field>
+        <field name="name_column">Name</field>
+        <field name="currency_column">Currency</field>
+        <field name="gross_column">Gross</field>
+        <field name="fee_column">Fee</field>
+        <field name="balance_column">Balance</field>
+        <field name="transaction_id_column">Transaction ID</field>
+        <field name="type_column">Type</field>
+        <field name="from_email_address_column">From Email Address</field>
+        <field name="to_email_address_column">To Email Address</field>
+        <field name="invoice_id_column">Invoice ID</field>
+        <field name="subject_column">Subject</field>
+        <field name="note_column">Note</field>
+    </record>
+    <record
+        id="paypal_statement_map_es"
+        model="account.statement.import.paypal.mapping"
+    >
+        <field name="name">PayPal Statement (ES)</field>
+        <field name="float_thousands_sep">dot</field>
+        <field name="float_decimal_sep">comma</field>
+        <field name="date_format">%d/%m/%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Fecha</field>
+        <field name="time_column">Hora</field>
+        <field name="tz_column">Zona horaria</field>
+        <field name="name_column">Nombre</field>
+        <field name="currency_column">Divisa</field>
+        <field name="gross_column">Bruto</field>
+        <field name="fee_column">Comisión</field>
+        <field name="balance_column">Saldo</field>
+        <field name="transaction_id_column">Id. de transacción</field>
+        <field name="description_column">Descripción</field>
+        <field name="from_email_address_column">Correo electrónico del remitente</field>
+        <field name="invoice_id_column">Id. de factura</field>
+        <field name="bank_name_column">Nombre del banco</field>
+        <field name="bank_account_column">Cuenta bancaria</field>
+    </record>
+    <record id="paypal_activity_map_es" model="account.statement.import.paypal.mapping">
+        <field name="name">PayPal Activity (ES)</field>
+        <field name="float_thousands_sep">dot</field>
+        <field name="float_decimal_sep">comma</field>
+        <field name="date_format">%d/%m/%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Fecha</field>
+        <field name="time_column">Hora</field>
+        <field name="tz_column">Zona horaria</field>
+        <field name="name_column">Nombre</field>
+        <field name="currency_column">Divisa</field>
+        <field name="gross_column">Bruto</field>
+        <field name="fee_column">Tarifa</field>
+        <field name="balance_column">Saldo</field>
+        <field name="transaction_id_column">Id. de transacción</field>
+        <field name="type_column">Tipo</field>
+        <field name="from_email_address_column">Correo electrónico del remitente</field>
+        <field
+            name="to_email_address_column"
+        >Correo electrónico del destinatario</field>
+        <field name="invoice_id_column">Número de factura</field>
+        <field name="subject_column">Asunto</field>
+        <field name="note_column">Nota</field>
+    </record>
+    <record
+        id="paypal_statement_map_de"
+        model="account.statement.import.paypal.mapping"
+    >
+        <field name="name">PayPal Statement (DE)</field>
+        <field name="float_thousands_sep">dot</field>
+        <field name="float_decimal_sep">comma</field>
+        <field name="date_format">%d.%m.%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Datum</field>
+        <field name="time_column">Uhrzeit</field>
+        <field name="tz_column">Zeitzone</field>
+        <field name="name_column">Name</field>
+        <field name="currency_column">Währung</field>
+        <field name="gross_column">Brutto</field>
+        <field name="fee_column">Gebühr</field>
+        <field name="balance_column">Guthaben</field>
+        <field name="transaction_id_column">Transaktionscode</field>
+        <field name="description_column">Beschreibung</field>
+        <field name="from_email_address_column">Absender E-Mail-Adresse</field>
+        <field name="invoice_id_column">Rechnungsnummer</field>
+        <field name="bank_name_column">Name der Bank</field>
+        <field name="bank_account_column">Bankkonto</field>
+    </record>
+    <record id="paypal_activity_map_de" model="account.statement.import.paypal.mapping">
+        <field name="name">PayPal Activity (DE)</field>
+        <field name="float_thousands_sep">dot</field>
+        <field name="float_decimal_sep">comma</field>
+        <field name="date_format">%d.%m.%Y</field>
+        <field name="time_format">%H:%M:%S</field>
+        <field name="date_column">Datum</field>
+        <field name="time_column">Uhrzeit</field>
+        <field name="tz_column">Zeitzone</field>
+        <field name="name_column">Name</field>
+        <field name="currency_column">Währung</field>
+        <field name="gross_column">Brutto</field>
+        <field name="fee_column">Gebühr</field>
+        <field name="balance_column">Guthaben</field>
+        <field name="transaction_id_column">Transaktionscode</field>
+        <field name="type_column">Typ</field>
+        <field name="from_email_address_column">Absender E-Mail-Adresse</field>
+        <field name="to_email_address_column">Empfänger E-Mail-Adresse</field>
+        <field name="invoice_id_column">Rechnungsnummer</field>
+        <field name="subject_column">Betreff</field>
+        <field name="note_column">Hinweis</field>
+    </record>
+</odoo>