====================
Account Cash Deposit
====================

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

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

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

This module adds support for **cash deposits at the bank**. It also
supports the other way around: **ordering cash at the bank**. It allows
to declare the kind of cash you want to deposit (or order): bank notes,
coins and coin rolls and the quantity for each of them. Coins are rarely
used, because most banks only allow to deposit/order coin rolls.

**Table of contents**

.. contents::
   :local:

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

First, for each currency of your cash boxes, you must define the bank
notes and coin rolls for that currency (coin rolls are often
standardised by the Central Bank). You can also definie the coins, but
it's not useful if your bank only accept coin rolls and not coins.

|image1|

To save time for new users, this module provides the bank notes, coins
and coin rolls for several currencies (EUR, USD, CAD, etc.). If it is
not the case for your currency, it would be very nice of you to
contribute it (you can use the file
*account_cash_deposit/data/cash_unit_eur.xml* as an example).

To save time when encoding the cash deposits/orders, you can set the
parameter *Auto Create* on the bank notes and/or coin rolls that you use
very often.

On the Accounting configuration page, in the section *Bank & Cash*, the
*Inter-Banks Transfer Account* must be configured.

.. |image1| image:: https://raw.githubusercontent.com/OCA/account-financial-tools/18.0/account_cash_deposit/static/description/currency_form_view.png

Usage
=====

To create a new cash **deposit**, go to the menu *Invoicing > Accounting
> Miscellaneous > Cash Deposits* and click on *Create*: select the
currency, the cash box from which you will take the cash out and the
bank journal corresponding to the bank account on which you want to
deposit the cash. Then create/edit lines to enter the quantity for each
kind of bank note and coin rolls. Then, you can print a PDF report
designed to be a kind of delivery report for the cash. Upon validation,
Odoo will generate a journal entry in the cash journal that:

- credits the cash account,
- debits the inter-banks transfer account.

|Screenshot|

The process is very similar when **ordering** cash but you have to use
another menu entry: menu *Invoicing > Accounting > Miscellaneous > Cash
Orders*. Select the currency, the cash box that will receive the cash
and the bank account from which the bank will take the money.
Create/edit lines to enter the details of your order (bank notes, coin
rolls). Then, you can confirm the order and print a PDF report designed
to be sent to your bank as a cash order. Eventually, when the bank
delivers the cash to you, you should validate the cash order and Odoo
will generate a journal entry in the cash journal that:

- debits the cash account,
- credits the inter-banks transfer account.

.. |Screenshot| image:: https://raw.githubusercontent.com/OCA/account-financial-tools/18.0/account_cash_deposit/static/description/cash_deposit_form.png

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/account-financial-tools/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/account-financial-tools/issues/new?body=module:%20account_cash_deposit%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.

This module is part of the `OCA/account-financial-tools <https://github.com/OCA/account-financial-tools/tree/18.0/account_cash_deposit>`_ project on GitHub.

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