https://github.com/alyf-de/erpnext_germany
ERPNext customizations for German companies
https://github.com/alyf-de/erpnext_germany
business erpnext frappe-framework germany localization
Last synced: 5 months ago
JSON representation
ERPNext customizations for German companies
- Host: GitHub
- URL: https://github.com/alyf-de/erpnext_germany
- Owner: alyf-de
- License: gpl-3.0
- Created: 2022-02-18T09:40:24.000Z (over 4 years ago)
- Default Branch: version-16-hotfix
- Last Pushed: 2026-01-22T14:14:59.000Z (5 months ago)
- Last Synced: 2026-01-22T14:25:27.564Z (5 months ago)
- Topics: business, erpnext, frappe-framework, germany, localization
- Language: Python
- Homepage:
- Size: 3.02 MB
- Stars: 75
- Watchers: 12
- Forks: 34
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-frappe - ERPNext Germany - Regional code for Germany, built on top of ERPNext. (Uncategorized / Uncategorized)
README
## 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](https://youtu.be/hsFMn2Y85zA) (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](https://github.com/frappe/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](https://frappecloud.com/marketplace/apps/erpnext_germany).
Please refer to the [Frappe Cloud documentation](https://frappecloud.com/docs/installing-an-app) on how to install an app.
### Local
Using bench, [install ERPNext](https://github.com/frappe/bench#installation) as mentioned here.
Once ERPNext is installed, add the ERPNext Germany app to your bench by running
```bash
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
```bash
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](https://github.com/alyf-de/banking) 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](https://www.docker.com/) and [git](https://git-scm.com/) installed on your machine.
```bash
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](docker/README.md) file.
### Contributing
#### Create a release
Create a temporary release branch based on the current hotfix branch:
```bash
git fetch upstream
git checkout upstream/version-XX-hotfix
git checkout -b version-XX-release
```
Create a PR against the main branch:
```bash
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.