Erpnext Germany

bench get-app https://github.com/alyf-de/erpnext_germany

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=alyf-de%2Ferpnext_germany)](https://frappegems.com/gems/apps/alyf-de/erpnext_germany)

ERPNext Germany

App to hold regional code for Germany, built on top of ERPNext.

Features

• German accounting reports

  • Summen- und Saldenliste
  • Zusammenfassende Meldung

• Section for Register Information (Registerart, -gericht und nummer) in Company, Customer and Supplier

  

• Validation of EU VAT IDs

  Automatically checks the validity of EU VAT IDs of all your customers every three months, or manually whenever you want. Check out the intro on Youtube (german).

  

• Allow deletion of the most recent sales transaction (per naming series and company) only

  This ensures consecutive numbering of transactions. Applies to Quotation, Sales Order, Sales Invoice.

• Restrict deletion of attachments to submitted transactions

• Custom fields in Employee (tax information, etc.)
• List of religios denominations ("Konfessionen")
• List of German health insurance providers (depends on HRMS)
• Create Business Letters from a template and print or email them to your customers or suppliers
• Record Business Trips and pay out allowances to your employees (dt. Reisekostenabrechnung) (depends on HRMS)

Installation

[!NOTE] Some features of this app depend on the HRMS app. If you want to use them, you need to install the HRMS app before installing this app.

On Frappe Cloud

You can find ERPNext Germany in the Frappe Cloud Marketplace. Please refer to the Frappe Cloud documentation on how to install an app.

Local

Using bench, install ERPNext as mentioned here.

Once ERPNext is installed, add the ERPNext Germany app to your bench by running

bench get-app https://github.com/alyf-de/erpnext_germany.git

After that, you can install the app on required site (let's say demo.com ) by running

bench --site demo.com install-app erpnext_germany

Business Trip

Before an employee can create a Business Trip (Dienstreise), you should configure the available regions and their travel allowances in the Business Trip Region list. A basic list based on the German tax law is imported on installation, but not further updated later. In the Business Trip Settings (Dienstreise-Einstellungen) you can set the value for the mileage allowance and select Expense Claim Type for mileage allowance and Additional meal expenses. Both Expense Claim Type are preset to Additional meal expenses. If you have HRMS installed, it allows you to book expenses as Expense Claims.

When a Business Trip is submitted, it creates a draft Expense Claim for the employee's travel allowances including the Additional meal expenses as well as mileage allowance for "Car (private)". One business trip will create on Expense Claim which can be approved and submitted as usual.

Mileage allowance is calculated based on the distance entered in the details of the journey when "Car (private)" is selected.

The Additional meal expenses depend on the selected region. Select the "From" and "To" dates of the trip and with the click on "Add Row" all days of the trip a pre-created.

The receipts for transport and accommodation can be attached, but are not processed automatically. You can check them, create a Purchase Invoice and pay the respective amount to the employee.

You can use our Banking app to reconcile the Expense Claims and Purchase Invoices with the respective Bank Transactions.

Zusammenfassende Meldung

Currently, this report lists all invoices as other service ("S"). If you do triangular transactions ("D") or intra-Community supplies ("L"), you need to manually adjust this column in the CSV file. Automatically determining the service type is planned for a future version.

Quick Start Demo

The fastest way to get a running demo site on your local desktop.

Prerequisites: Docker and git installed on your machine.

git clone https://github.com/alyf-de/erpnext_germany.git
cd erpnext_germany/docker
cp .env.example .env
docker compose up -d

The first setup will take a while. Then you can access the demo site at http://localhost:8000. Log in with the Username Administrator and the default password admin.

Read more about the setup in the docker/README.md file.

Contributing

Create a release

Create a temporary release branch based on the current hotfix branch:

git fetch upstream
git checkout upstream/version-XX-hotfix
git checkout -b version-XX-release

Create a PR against the main branch:

gh pr create --base version-XX --title "chore: release vXX" --body ""

If all tests pass, merge the PR using a merge commit (don't rebase or squash). This should automatically delete the release branch and trigger a CI workflow to create a new release.

License

GNU GPL V3. See the LICENSE file for more information.