feat: add README documentation for pos_cash_opening_adjustment module

This commit is contained in:
Suherdy Yacob 2026-05-18 10:57:43 +07:00
parent 191dfc8b5b
commit 064cef7b6b

20
README.md Normal file
View File

@ -0,0 +1,20 @@
# POS Cash Opening Adjustment
This module provides adjustments for the POS opening cash mechanism in Odoo 19.
## Features
- Overrides `_set_opening_control_data` to properly initialize and track `opening_cash_expected` and `opening_cash_counted` while utilizing Odoo's native functionality.
- Tracks opening cash correctly so that the system correctly calculates differences.
- Leverages standard Odoo 19 journal handling for robust accounting integration.
- Suppresses positive cash differences automatically via standard backend validations, adjusting the `cash_register_balance_end_real` to match the expected balance when there is a surplus.
## Technical Details
This module modifies the `pos.session` object, tracking:
- **`opening_cash_expected`**: The expected cash balance when opening the session.
- **`opening_cash_counted`**: The actual cash counted by the cashier.
- **`opening_cash_difference`**: Computed difference between counted and expected opening cash.
It modifies the standard `_validate_session` process strictly for suppressing positive discrepancies (where the ending cash register is higher than expected), logging the event into the chatter.
## Author
Suherdy Yacob