mds-cashbook
============
Tryton module to add a cashbook.
Install
=======
pip install mds-cashbook
Requires
========
- Tryton 7.0
How to
======
This module adds a cash book to Tryton. Each Tryton user can have
any number of cash books. The cash books can be arranged hierarchically.
A cash book contains simple postings, such as expense, revenue, transfer,
split posting. Each booking has a category, an amount and possibly a description.
The cash books of the different Tryton users are separated from
each other by permissions. There is an enhancement module for the connection
to the chart of accounts and analytic.
This module adds new user groups:
Cashbook
The user can make entries in his cash books.
Cashbook - WF - Check
The user can mark his bookings as 'checked'
Cashbook - WF - Done
The user can reconcile his cash books
Cashbook - Administrator
the Cashbook-Administrator
There is a possibility to allow reading or editing for other users via
the Tryton user groups. This makes it possible to set up a administrator
for all cash books of the Tryton system.
Set up your cash book
---------------------
Add the Tryton user to the *Cashbook* group. In the tab *Owner and Authorizeds*,
enter the user as the owner. Enter *Type*, *Currency*, *Initial Date*
and *Line Numbering*. Cash books without a type cannot receive postings
and are treated as a view. You can create several cash books per user
and arrange them hierarchically.
Creating categories
-------------------
Each booking needs a category. The categories are separated by revenue and expense.
In the menu Cash Book / Configuration / Category you create some categories.
Using the chart of accounts
---------------------------
If you want to have the postings as a posting record in Tryton Accounting
install the *cashbook_account* module. For analytic, install *cashbook_analytic*.
In each of the cash books, add one account to the
chart of accounts, in tab *Account Configuration*.
In the categories you add a chart of accounts account in the
tab 'Account and Tax'. If you want to make your transactions with taxes,
you can also add one or more taxes.
Enter bookings
--------------
There are two ways to enter bookings.
1) The *Enter Booking* wizard. The wizard is optimized for use on
small screens. You can write down expenses on the go with your smartphone.
The type of bookings is limited to expense, revenue and transfers between cash books.
When using the wizard, you should check the booking later and possibly complete it.
2) The record form of a cash book. This option offers all posting variants,
such as expense, revenue, transfer to, transfer from, expense split posting
and revenue split posting. When using chart of accounts and analytic,
you also specify the taxes and analytic accounts here.
Processing states
-----------------
Postings in cash books have several workflow states.
Edit
The entry has been created but not yet verified
Checked
The user has checked his entry and has indicated this by clicking on 'Check'
When using the chart of accounts modules, posting records are created here
in the Draft state.
Reconciled
A user (with enough permissions) has checked the entry against a
bank statement. This step is performed in the 'Reconciliations' tab of a cash book.
Done
The entry is committed. This step is performed by completing a
reconciliation in the cash book. When using the chart of accounts modules,
the posting records created in step 'Check' are committed.
Reconciliation
--------------
The bookings should be checked regularly against a bank statement. This is done
in the 'Reconciliations' tab of a cash book.
1) Click the plus button, don't change anything about the contents,
click *ok*, save the cash book. The system will change the dates of the
reconciliation so that all eligible bookings are taken into account.
2) If you want to change the end date, do so now. Save.
3) Open the reconciliation by double-clicking, click on *Check*.
This will insert all posting lines into the list. The posting lines
in the cash book are now protected against edit.
4) Now check line by line against an account statement. To remember what you
have already seen, click the 'Reconciled' button.
5) When you're done, click the *Done* button of the reconciliation. This
sets all posting lines and the reconciliation to *Done*.
Configuration
-------------
The configuration in the menu Cash Book / Configuration is a user-specific setting.
The user can choose which cash books appear in the *Enter Booking* dialog and
which default settings should apply when opening a cash book.
Foreign currencies
------------------
The cash books can be used with foreign currency. Base currency is the company currency.
For transfers between cash books with different currencies, the current conversion
rate in Tryton is used. You can adjust the exchange rate actually used in the booking dialog.
If you have hierarchical cash books, the amounts of subordinate cash books with foreign
currency are converted into the display currency of the parent cash book.
Changes
=======
*7.0.36 - 19.07.2024*
- updt: optimize check of permissions
*7.0.35 - 01.06.2024*
- add: config setting for fixate in booking-wizard
*7.0.34 - 30.05.2024*
- add: fixate of booking from booking-wizard
*7.0.33 - 31.12.2023*
- remove caching
- add worker-based precalculation of cashbook-values
*7.0.32 - 06.12.2023*
- columns optional
*7.0.31 - 30.11.2023*
- compatibility to Tryton 7.0
Raw data
{
"_id": null,
"home_page": "https://www.m-ds.de/",
"name": "mds-cashbook",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "tryton cashbook",
"author": "martin-data services",
"author_email": "service@m-ds.de",
"download_url": "https://files.pythonhosted.org/packages/f3/6b/5e9ddabc21ab19668ba4768e1c7651dbc85b2bc9c3a6e71e76f2662dc15a/mds_cashbook-7.0.36.tar.gz",
"platform": null,
"description": "mds-cashbook\n============\nTryton module to add a cashbook.\n\nInstall\n=======\n\npip install mds-cashbook\n\nRequires\n========\n- Tryton 7.0\n\nHow to\n======\n\nThis module adds a cash book to Tryton. Each Tryton user can have\nany number of cash books. The cash books can be arranged hierarchically.\nA cash book contains simple postings, such as expense, revenue, transfer,\nsplit posting. Each booking has a category, an amount and possibly a description.\nThe cash books of the different Tryton users are separated from\neach other by permissions. There is an enhancement module for the connection\nto the chart of accounts and analytic.\n\nThis module adds new user groups:\n\nCashbook\n The user can make entries in his cash books.\n\nCashbook - WF - Check\n The user can mark his bookings as 'checked'\n\nCashbook - WF - Done\n The user can reconcile his cash books\n\nCashbook - Administrator\n the Cashbook-Administrator\n\nThere is a possibility to allow reading or editing for other users via\nthe Tryton user groups. This makes it possible to set up a administrator\nfor all cash books of the Tryton system.\n\n\nSet up your cash book\n---------------------\n\nAdd the Tryton user to the *Cashbook* group. In the tab *Owner and Authorizeds*,\nenter the user as the owner. Enter *Type*, *Currency*, *Initial Date*\nand *Line Numbering*. Cash books without a type cannot receive postings\nand are treated as a view. You can create several cash books per user\nand arrange them hierarchically.\n\n\nCreating categories\n-------------------\n\nEach booking needs a category. The categories are separated by revenue and expense.\nIn the menu Cash Book / Configuration / Category you create some categories.\n\n\nUsing the chart of accounts\n---------------------------\n\nIf you want to have the postings as a posting record in Tryton Accounting\ninstall the *cashbook_account* module. For analytic, install *cashbook_analytic*.\nIn each of the cash books, add one account to the\nchart of accounts, in tab *Account Configuration*.\n\nIn the categories you add a chart of accounts account in the\ntab 'Account and Tax'. If you want to make your transactions with taxes,\nyou can also add one or more taxes.\n\nEnter bookings\n--------------\n\nThere are two ways to enter bookings.\n\n1) The *Enter Booking* wizard. The wizard is optimized for use on\n small screens. You can write down expenses on the go with your smartphone.\n The type of bookings is limited to expense, revenue and transfers between cash books.\n When using the wizard, you should check the booking later and possibly complete it.\n\n2) The record form of a cash book. This option offers all posting variants,\n such as expense, revenue, transfer to, transfer from, expense split posting\n and revenue split posting. When using chart of accounts and analytic,\n you also specify the taxes and analytic accounts here.\n\n\nProcessing states\n-----------------\n\nPostings in cash books have several workflow states.\n\nEdit\n The entry has been created but not yet verified\n\nChecked\n The user has checked his entry and has indicated this by clicking on 'Check'\n When using the chart of accounts modules, posting records are created here\n in the Draft state.\n\nReconciled\n A user (with enough permissions) has checked the entry against a\n bank statement. This step is performed in the 'Reconciliations' tab of a cash book.\n\nDone\n The entry is committed. This step is performed by completing a\n reconciliation in the cash book. When using the chart of accounts modules,\n the posting records created in step 'Check' are committed.\n\n\nReconciliation\n--------------\n\nThe bookings should be checked regularly against a bank statement. This is done\nin the 'Reconciliations' tab of a cash book.\n\n1) Click the plus button, don't change anything about the contents,\n click *ok*, save the cash book. The system will change the dates of the\n reconciliation so that all eligible bookings are taken into account.\n\n2) If you want to change the end date, do so now. Save.\n\n3) Open the reconciliation by double-clicking, click on *Check*.\n This will insert all posting lines into the list. The posting lines\n in the cash book are now protected against edit.\n\n4) Now check line by line against an account statement. To remember what you\n have already seen, click the 'Reconciled' button.\n\n5) When you're done, click the *Done* button of the reconciliation. This\n sets all posting lines and the reconciliation to *Done*.\n\n\nConfiguration\n-------------\n\nThe configuration in the menu Cash Book / Configuration is a user-specific setting.\nThe user can choose which cash books appear in the *Enter Booking* dialog and\nwhich default settings should apply when opening a cash book.\n\n\nForeign currencies\n------------------\n\nThe cash books can be used with foreign currency. Base currency is the company currency.\nFor transfers between cash books with different currencies, the current conversion\nrate in Tryton is used. You can adjust the exchange rate actually used in the booking dialog.\nIf you have hierarchical cash books, the amounts of subordinate cash books with foreign\ncurrency are converted into the display currency of the parent cash book.\n\n\nChanges\n=======\n\n*7.0.36 - 19.07.2024*\n\n- updt: optimize check of permissions\n\n*7.0.35 - 01.06.2024*\n\n- add: config setting for fixate in booking-wizard\n\n*7.0.34 - 30.05.2024*\n\n- add: fixate of booking from booking-wizard\n\n*7.0.33 - 31.12.2023*\n\n- remove caching\n- add worker-based precalculation of cashbook-values\n\n*7.0.32 - 06.12.2023*\n\n- columns optional\n\n*7.0.31 - 30.11.2023*\n\n- compatibility to Tryton 7.0\n\n\n",
"bugtrack_url": null,
"license": "GPL-3",
"summary": "Tryton module to add a cashbook.",
"version": "7.0.36",
"project_urls": {
"Download": "https://scmdev.m-ds.de/Tryton/Extra/cashbook",
"Homepage": "https://www.m-ds.de/"
},
"split_keywords": [
"tryton",
"cashbook"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ac6d29392bd21ddcc436b94ea50bacba31c8c1b1971f8fda12fa4c84d852f5b3",
"md5": "c0fcd481f6612dc46d67e1afff8c977e",
"sha256": "70703b7adfae2be5bb397c2f1f207ebd7d3aa03598c76200b4598d0620b3539b"
},
"downloads": -1,
"filename": "mds_cashbook-7.0.36-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c0fcd481f6612dc46d67e1afff8c977e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 121992,
"upload_time": "2024-07-19T15:21:47",
"upload_time_iso_8601": "2024-07-19T15:21:47.274014Z",
"url": "https://files.pythonhosted.org/packages/ac/6d/29392bd21ddcc436b94ea50bacba31c8c1b1971f8fda12fa4c84d852f5b3/mds_cashbook-7.0.36-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f36b5e9ddabc21ab19668ba4768e1c7651dbc85b2bc9c3a6e71e76f2662dc15a",
"md5": "72eae0be298f72ec0848f235817d45db",
"sha256": "df47886f985d5df2880a8fca37699edd35bb18458209ab578dd04099e9aee34e"
},
"downloads": -1,
"filename": "mds_cashbook-7.0.36.tar.gz",
"has_sig": false,
"md5_digest": "72eae0be298f72ec0848f235817d45db",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 90139,
"upload_time": "2024-07-19T15:21:49",
"upload_time_iso_8601": "2024-07-19T15:21:49.363778Z",
"url": "https://files.pythonhosted.org/packages/f3/6b/5e9ddabc21ab19668ba4768e1c7651dbc85b2bc9c3a6e71e76f2662dc15a/mds_cashbook-7.0.36.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-19 15:21:49",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mds-cashbook"
}
JSON