Skip to content

levelupye/erpnext_expenses

 
 

Repository files navigation

ERPNext Expenses

v1.0.0-Alpha5

An expenses management module for ERPNext.

⚠️ This plugin is in ALPHA stage so it is not PRODUCTION ready. ⚠️


Contributors

The list of people who deserves more than a simple "Thank You".

  • Monolith Online
  • Andrew Rogers
  • Washaqq
  • Codi
  • Ian Kahare

Table of Contents


Requirements


Setup

⚠️ Important ⚠️

Do not forget to replace "[sitename]" with the name of your site in all commands.

Install

  1. Go to bench directory
cd ~/frappe-bench
  1. Get plugin from Github
bench get-app https://github.com/kid1194/erpnext_expenses
  1. Build plugin
bench build --app expenses
  1. Install plugin on your site
bench --site [sitename] install-app expenses
  1. Restart bench to clear cache
bench restart
  1. Read the Usage section below

Update

  1. Go to app directory
cd ~/frappe-bench/apps/expenses
  1. Get updates from Github
git pull
  1. Go to bench directory (Optional)
cd ~/frappe-bench
  1. Build plugin
bench build --app expenses
  1. Update your site
bench --site [sitename] migrate
  1. Restart bench to clear cache
bench restart

Uninstall

  1. Go to bench directory
cd ~/frappe-bench
  1. Uninstall plugin from your site
bench --site [sitename] uninstall-app expenses
  1. Remove plugin from bench cache
bench remove-app expenses
  1. Restart bench to clear cache
bench restart

Usage

  1. Expense Type
  • Create the hierarchy of expense types based on your needs
  • Add an expense account for each company so it gets inherited by all new expense items

ℹ️ Note: Expense accounts are inherited from parents.

  1. Expense Item
  • Create the expense items that reflect your expenses
  • Add each expense item to the expense type that it belongs to
  • Add an expense account for each company and/or set the expense defaults (cost, quantity, etc..)
  • Modify the expense defaults (cost, quantity, etc..) of the inherited expense accounts, if exist

ℹ️ Note: Expense accounts will be inherited from linked expense type and they are not modifiable except for cost and quantity related fields.

  1. Expense
  • Create a company expense and select the expense item
  • Fill the cost, quantity, etc.. if not fixed for the expense item
  • Attachments can be added or removed even after submit, but before adding the expense to an expenses request
  1. Expenses Request
  • Create a request for a company list of expenses so that it can be approved or rejected
  • When requests are rejected, the linked expenses will be automatically rejected & cancelled
  • Rejected requests can be appealed and after appealing, the status of linked expenses will be automatically restored and set as Requested
  1. Expenses Entry
  • Create entries based on a request or manually add company related expenses
  • After submit, all the expenses will be posted to the journal
  1. Expenses Settings
  • Enable the module (Enabled by default)
  • Modify the expense settings
  • Modify the update notification settings
  • Check for update manually

ℹ️ Note: Module update functionality will only be enabled in the PRODUCTION stage


Issues

If you find bug in the plugin, please create a bug report and let us know about it.


License

This repository has been released under the MIT License.

About

An expenses management module for ERPNext.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 52.0%
  • JavaScript 44.1%
  • HTML 3.9%