[IMP] accounting: batch payments sdd

Forward to 16.0

closes odoo/documentation#3034

X-original-commit: fe2d694aff
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: chiaraprattico <chpr@odoo.com>
This commit is contained in:
“Chiara 2022-10-27 14:53:59 +00:00
parent b9c6c0a058
commit ab561680eb
6 changed files with 53 additions and 75 deletions

View File

@ -3,11 +3,11 @@ Batch payments: SEPA Direct Debit (SDD)
======================================= =======================================
SEPA, the Single Euro Payments Area, is a payment-integration initiative of the European Union for SEPA, the Single Euro Payments Area, is a payment-integration initiative of the European Union for
simplification of bank transfers denominated in EURO. With **SEPA Direct Debit**, your customers can simplification of bank transfers denominated in euros. With **SEPA Direct Debit** (SDD), your
sign a **mandate** that authorizes you to collect future payments from their bank accounts. This is customers can sign a mandate that authorizes you to collect future payments from their bank
particularly useful for recurring payments based on a subscription. accounts. This is particularly useful for recurring payments based on a subscription.
You can record customer mandates in Odoo, and generate XML files containing pending payments made You can record customer mandates in Odoo, and generate `.xml` files containing pending payments made
with an SDD mandate. with an SDD mandate.
.. note:: .. note::
@ -19,11 +19,12 @@ with an SDD mandate.
Configuration Configuration
============= =============
Go to :menuselection:`Accounting --> Configuration --> Settings`, activate **SEPA Direct Debit Go to :menuselection:`Accounting app --> Configuration --> Settings`, activate
(SDD)** and click on *Save*. Enter your company's **Creditor Identifier**. This number is provided :guilabel:`SEPA Direct Debit (SDD)`, and click on :guilabel:`Save`. Enter your company's
by your bank institution, or the authority responsible for delivering them. :guilabel:`Creditor Identifier`. This number is provided by your bank institution, or the authority
responsible for delivering them.
.. image:: batch_sdd/batch-sdd-creditor-identifier.png .. image:: batch_sdd/creditor-identifier.png
:align: center :align: center
:alt: Add a SEPA Creditor Identifier to Odoo Accounting :alt: Add a SEPA Creditor Identifier to Odoo Accounting
@ -33,117 +34,94 @@ SEPA Direct Debit Mandates
Create a mandate Create a mandate
---------------- ----------------
The SEPA Direct Debit Mandate is the document that your customers sign to authorize you to collect The :abbr:`SDD (sepa direct debit)` Mandate is the document that your customers sign to authorize
money directly from their bank accounts. you to collect money directly from their bank accounts.
To create a new mandate, go to :menuselection:`Accounting --> Customers --> Direct Debit Mandates`, To create a new mandate, go to :menuselection:`Accounting app --> Customers -->
click on *Create*, and fill out the form. Direct Debit Mandates`, on :guilabel:`Create`, and fill out the form. Export the PDF file by
clicking on :guilabel:`Print`. It is then up to your customer to sign this document. Once done,
.. image:: batch_sdd/batch-sdd-mandate-form.png upload the signed file and click on :guilabel:`Validate` to start running the mandate.
:align: center
:alt: Fill out SEPA Direct Debit in Odoo Accounting
Export the PDF file by clicking on *Print*. It is then up to your customer to sign this document.
Once done, upload the signed file in the **Original Document** field, and click on *Validate* to
start running the mandate.
.. important:: .. important::
Make sure that the **IBAN bank accounts details** are correctly recorded on the debtors contact Make sure that the **IBAN bank accounts details** are correctly recorded on the debtors contact
form, under the *Accounting* tab, and in your own :doc:`Bank Account form, under the :guilabel:`Accounting` tab, and in your own :doc:`Bank Account
<../../bank/setup/bank_accounts>` settings. <../../bank/setup/bank_accounts>` settings.
SEPA Direct Debit as a Payment Method SEPA Direct Debit as a payment method
------------------------------------- -------------------------------------
SEPA Direct Debit can be used as a payment method both on your **eCommerce** or on the **Customer SDD can be used as a payment method both on your **eCommerce** or on the **Customer
Portal** by activating SDD as a **Payment Acquirer**. With this method, your customers can create Portal** by activating SDD as a **Payment Acquirer**. With this method, your customers can create
and sign their mandates themselves. and sign their mandates themselves.
To do so, go to :menuselection:`Accounting --> Configuration --> Payment Acquirers`, click on *SEPA To do so, go to :menuselection:`Accounting app --> Configuration --> Payment Acquirers`, click on
Direct Debit*, and set it up according to your needs. :guilabel:`SEPA Direct Debit`.
.. important:: .. important::
Make sure to change the **State** field to *Enabled*, and to check **Online Signature**, as this Make sure to change the :guilabel:`State` field to :guilabel:`Enabled`, and to check
is necessary to let your customers sign their mandates. :guilabel:`Online Signature`, as this is necessary to let your customers sign their mandates.
Customers using SDD as payment method get prompted to add their IBAN, email address, and to sign Customers using SDD as payment method get prompted to add their IBAN, email address, and to sign
their SEPA Direct Debit mandate. their SDD mandate.
.. todo::
Add link to future **Payment Acquirer** documentation.
Close or revoke a mandate Close or revoke a mandate
------------------------- -------------------------
Direct Debit mandates are closed automatically after their *End Date*. If this field is left blank, Direct debit mandates are closed automatically after their :guilabel:`End Date`. If this field is
the mandate keeps being *Active* until it is *Closed* or *Revoked*. left blank, the mandate keeps being **Active** until it is **Closed** or **Revoked**.
.. image:: batch_sdd/batch-sdd-revoke-close.png Clicking on :guilabel:`Close` updates the mandates end day to the current day. This means that
:align: center invoices issued after the present day will not be processed with an SDD payment.
:alt: Close or Revoke an SDD Mandate in Odoo Accounting
Clicking on **Close** updates the mandates end day to the current day. This means that invoices Clicking on :guilabel:`Revoke` disables the mandate immediately. No SDD payment can be registered
issued after the present day will not be processed with an SDD payment. anymore, regardless of the invoices date. However, payments that have already been registered are
still included in the next SDD `.xml` file.
Clicking on **Revoke** disables the mandate immediately. No SDD payment can be registered anymore,
regardless of the invoices date. However, payments that have already been registered are still
included in the next SDD XML file.
.. warning:: .. warning::
Once a mandate has been *closed* or *revoked*, it cannot be reactivated. Once a mandate has been :guilabel:`closed` or :guilabel:`revoked`, it cannot be reactivated.
Get paid with SDD Batch Payments Get paid with SEPA Direct Debit batch payments
================================ ==============================================
Customer Invoices Customer invoices
----------------- -----------------
You can register SDD payments for invoices issued to customers who have an active SDD mandate. You can register SDD payments for invoices issued to customers who have an active SDD mandate.
To do so, open the invoice, click on *Register Payment*, and choose *SEPA Direct Debit* as payment To do so, open the invoice, click on :guilabel:`Register Payment`, and choose
method. :guilabel:`SEPA Direct Debit` as payment method.
Generate SEPA Direct Debit XML files to submit payments Generate SEPA Direct Debit `.XML` files to submit payments
------------------------------------------------------- ----------------------------------------------------------
**XML files** with all SDD payment instructions can be uploaded to your online banking interface to `.xml` files with all SDD payment instructions can be uploaded to your online banking interface
process all payments at once. to process all payments at once.
.. note:: .. note::
The files generated by Odoo follow the SEPA Direct Debit **PAIN.008.001.02** specifications, as The files generated by Odoo follow the SEPA Direct Debit **PAIN.008.001.02** specifications, as
required by the SEPA customer-to-bank Implementation Guidelines, which ensures compatibility with required by the SEPA customer-to-bank `implementation guidelines
the banks. <https://www.europeanpaymentscouncil.eu/document-library/implementation-guidelines/sepa-credit-transfer-customer-psp-implementation>`_,
which ensures compatibility with the banks.
To generate your XML file for the pending SDD payments, go to the related *bank journal* on your To generate your `.xml` file of multiple pending SDD payments, you can create a batch payment.
*Accounting dashboard*, then click on *Direct Debit Payments to Collect*. To do so, go to :menuselection:`Accounting app --> Customers --> Payments`, select the needed
payments, then click on :guilabel:`Action`, and finally :guilabel:`Create a batch Payment`. Once
you click on :guilabel:`Validate`, the `.xml` file is directly available for download.
.. image:: batch_sdd/batch-sdd-collect.png .. image:: batch_sdd/xml.png
:align: center :align: center
:alt: Start the SDD payments collection in Odoo Accounting :alt: Generate an .XML file for your SDD payments in Odoo Accounting
Select all the payments you want to include in your SDD XML file, then click on *Action* and select
*Create Batch Payment*.
.. image:: batch_sdd/batch-sdd-batch.png
:align: center
:alt: Create a batch payment with all the SDD payments in Odoo Accounting
Odoo then takes you to your *Batch Payment*s form. Click on *Validate* and download the SDD XML
file.
.. image:: batch_sdd/batch-sdd-xml.png
:align: center
:alt: Generate an XML file for your SDD payments in Odoo Accounting
Finally, upload this file to your online banking interface to process the payments. Finally, upload this file to your online banking interface to process the payments.
.. tip:: .. tip::
You can retrieve all the generated SDD XML files by going to You can retrieve all the generated SDD `.xml` files by going to
:menuselection:`Accounting --> Configuration --> Customers --> Batch Payments`. :menuselection:`Accounting app --> Customers --> Batch Payments`.
.. seealso:: .. seealso::
* :doc:`batch` * :doc:`batch`
* :doc:`../../bank/setup/bank_accounts` * :doc:`../../bank/setup/bank_accounts`
* `Odoo Academy: SEPA Direct Debit Mandates (SDD) <https://www.odoo.com/r/Zxs>`_
* `List of all SEPA countries * `List of all SEPA countries
<https://www.europeanpaymentscouncil.eu/document-library/other/epc-list-sepa-scheme-countries>`_ <https://www.europeanpaymentscouncil.eu/document-library/other/epc-list-sepa-scheme-countries>`_
* `Sepa guidelines
<https://www.europeanpaymentscouncil.eu/document-library/implementation-guidelines/sepa-credit-transfer-inter-psp-implementation-guidelines>`_