Skip to content

Digital-Box-Agency/erpnext_expenses

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ERPNext Expenses

An expenses management module for ERPNext.

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


Table of Contents


Requirements

  • Frappe >= v14.0.0
  • ERPNext >= v14.0.0

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

(Required only once)

bench get-app https://github.com/kid1194/erpnext_expenses
  1. Install plugin on your site
bench --site [sitename] install-app expenses
  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
cd ~/frappe-bench
  1. Update your site
bench --site [sitename] migrate
  1. (Optional) Restart bench
bench restart

Uninstall

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

Usage

  1. Expense Type
  • Create the hierarchy of expense types based on your needs
  • Under each type, add the expense account for each company

ℹ️ Note: The expense accounts are inherited from parents if not set

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

ℹ️ Note: The expense accounts are inherited from expense types if not set

  1. Expense
  • Create a company expense and fill the cost, quantity, etc..
  • The attachments can be added before or after including the expense in an expenses request
  1. Expenses Request
  • Create a request for a company list of expenses so that it can be approved or rejected
  1. Expenses Entry
  • Create entries based on a request or manually add company related expenses
  • When submitted, all the expenses will be posted to the journal
  1. Expenses Settings
  • Plugin update notification Settings

ℹ️ Note: Plugin update notification will be functional in the PRODUCTION stage


Issues

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


Contributors

The list of people who deserves more than a simple thank you.


License

This repository has been released under the MIT License.

About

An expenses management module for ERPNext.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 53.5%
  • Python 39.9%
  • HTML 6.6%