Metadata-Version: 2.1
Name: odoo-addon-account_payment_fr_lcr
Version: 18.0.1.2.0
Requires-Python: >=3.10
Requires-Dist: odoo-addon-account_payment_batch_oca==18.0.*
Requires-Dist: odoo==18.0.*
Requires-Dist: pypdf>=3.1.0
Requires-Dist: unidecode
Summary: Create French LCR CFONB files
Home-page: https://github.com/OCA/l10n-france
License: AGPL-3
Author: Akretion,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=======================
French Letter of Change
=======================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:78badcb733a4b8117bfd6d06e15249fedd15b2ded5c7240ccaefb8747964e9b9
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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%2Fl10n--france-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-france/tree/18.0/account_payment_fr_lcr
    :alt: OCA/l10n-france
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-france-18-0/l10n-france-18-0-account_payment_fr_lcr
    :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/l10n-france&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module adds support for French Letters of Change. This module
supports:

- **Direct letter of change** (in French : *Lettre de change directe* or
  *LCR directe*),
- **Accepted letter of change** (in French : *Lettre de change acceptée*
  ; I call it *paper letter of change*),
- **Promissory note** (in French : *Billet à ordre*),

It supports cash discounts debit orders and Dailly convention.

This module has 2 main features:

- for **Accepted Letter of Change**, generate a paper letter of change
  as PDF following the official layout NF K 11-030-1.
- generate of LCR (or BOR) CFONB files to send to your bank.

This module follows the specifications published on the `CFONB
website <https://www.cfonb.org/>`__, section *Espace documentaire >
Instruments de paiement > Effet de commerce* (document version of
September 2002).

**Table of contents**

.. contents::
   :local:

Installation
============

This module requires 2 Python libs:

- `pypdf <https://pypi.org/project/pypdf/>`__ version 3.10 or above,
- `unidecode <https://pypi.org/project/Unidecode/>`__ (any version).

In order to have the SIREN of the company and of the customer set in the
CFONB file (optional field) and printed on the paper letter of exchange,
the OCA module **l10n_fr_siret** must be installed. The installation of
the module **l10n_fr_siret** is optional (because the SIREN field in the
CFONB file is optional).

Configuration
=============

To configure this module, you need to create a new payment mode linked
to the payment method *Lettre de Change Relevé* that is automatically
created when you install this module.

Once you selected this payment method, you will have a new section *Bill
of Exchange* on the payment mode where you will have to configure:

- the *LCR type*: *Lettre de change non acceptée (LCR directe)*, *Lettre
  de change acceptée* or *Billet à ordre*,
- the *Default Collection Option*,
- if you have a *Dailly Convention*,
- in case you have a Dailly convention, you will be able to configure
  the *Default Dailly Option* and the *Convention Type*.

Usage
=====

This module adds a new field *Bill of Exchange Bank Account* on customer
invoices to select the bank account of the customer that will be debited
by the letter of exchange. This bank account must be a french IBAN.

If you configured the payment mode for **Accepted Letter of Change**,
you will have a button *Print Bill of Exchange* on customer invoices to
get the letter of change as PDF.

This module uses the standard workflow of debit orders as implemented in
the OCA module **account_payment_batch_oca**. A debit order linked to a
payment mode with the payment method *Lettre de change relevé* has a few
additionnal constraints:

- all payment lines must be in euro currency,
- the bank accounts on the payment lines must be french IBANs,
- if the payment order is configured with cash discount, you must
  configure the value date on the payment order (new field added by this
  module).

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-france/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/l10n-france/issues/new?body=module:%20account_payment_fr_lcr%0Aversion:%2018.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

Contributors
------------

- Alexis de Lattre <alexis.delattre@akretion.com>

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.

.. |maintainer-alexis-via| image:: https://github.com/alexis-via.png?size=40px
    :target: https://github.com/alexis-via
    :alt: alexis-via

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-alexis-via| 

This module is part of the `OCA/l10n-france <https://github.com/OCA/l10n-france/tree/18.0/account_payment_fr_lcr>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
