From 189105e29f86f9d767120d391110119d8e1c9ca4 Mon Sep 17 00:00:00 2001 From: Daniel Seichter Date: Sun, 25 Aug 2024 20:56:58 +0200 Subject: [PATCH] Enable german readme --- README-de.md | 137 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 7 ++- 2 files changed, 142 insertions(+), 2 deletions(-) create mode 100644 README-de.md diff --git a/README-de.md b/README-de.md new file mode 100644 index 0000000..cf09a88 --- /dev/null +++ b/README-de.md @@ -0,0 +1,137 @@ +# VATValidation + +[![en](https://img.shields.io/badge/lang-en-blue.svg)](https://github.com/dseichter/VATValidation/blob/master/README.md) +[![de](https://img.shields.io/badge/lang-de-blue.svg)](https://github.com/dseichter/VATValidation/blob/master/README-de.md) + +![pep8](https://github.com/dseichter/VATValidation/actions/workflows/pep8.yml/badge.svg) +![bandit](https://github.com/dseichter/VATValidation/actions/workflows/bandit.yml/badge.svg) +![trivy](https://github.com/dseichter/VATValidation/actions/workflows/trivy.yml/badge.svg) +[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dseichter_VATValidation&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dseichter_VATValidation) + +Validierung von Umsatzsteuernummern über die Schnittstellen von BZSt, MIAS und/oder HMRC. Bietet Einzel- oder Batch-Validierung mit Unterstützung für CSV, XLSX und JSON. + +## Merkmale + +* Grafische Benutzeroberfläche +* Einfache Validierung +* Stapelverarbeitung von CSV, JSON oder XLSX +* Validierung mittels BZSt (konfigurierbar, kann nur verwendet werden, wenn Ihre Umsatzsteuer mit `DE` beginnt) +* Validierung über VIES (konfigurierbar) +* Validierung mit HMRC (wenn Sie eine mit „UK“ beginnende Mehrwertsteuer validieren möchten) +* Batch-Verarbeitung kann über die CLI-Schnittstelle ausgeführt werden (siehe Releases) +* **keine** Abhängigkeiten erforderlich + +Dies ist der Nachfolger meiner VAT-Validation. Jetzt als Open Source veröffentlicht. + +Wenn Ihnen diese Software gefällt, zögern Sie bitte nicht, ihr einen :star: zu geben oder mir eine :moneybag: Spende in der Höhe zukommen zu lassen, die die Software Ihrer Meinung nach wert ist. + +## Über + +VAT Validation unterstützt Sie bei der Validierung Ihrer Umsatzsteuernummern auf der Grundlage Ihrer Stammdaten. Egal, ob Sie eine Umsatzsteuer-Identifikationsnummer direkt an Ihrem Arbeitsplatz prüfen oder in Ihre ERP/CRM-Anwendungen integrieren wollen. + +## Kommandozeilen-Tool + +Wenn Sie Batch-Dateien (z.B. json, csv oder XLSX) prüfen möchten, können Sie die Versionen wie `VATValidation-cli-windows-v2024-07-08.exe` herunterladen und in vatvalidation_cli.exe umbenennen. + +Führen Sie das Tool einfach aus, indem Sie eine Eingabe- und eine Ausgabedatei angeben. Für weitere Informationen, führen Sie bitte + +``vatvalidation_cli.exe`` + +```shell +usage: vatvalidation_cli.py [-h] [--version] --input INPUT --output OUTPUT + +VAT-Validation CLI - v2024-07-06 + +options: + -h, --help show this help message and exit + --version show version of and exit + --input INPUT Input filename for VAT numbers. + --output OUTPUT Output ffilename for validation results. + +For more information, visit our GitHub repository: https://github.com/dseichter/VATValidation License: GPL 3.0 - see LICENSE file at the root of the repository for details. +``` + +Es wird nur die Stapelverarbeitung angeboten. + +## Grafische Benutzeroberfläche + +VAT Validation bietet eine grafische Benutzeroberfläche für Einzel- und Stapel-Validierung. Sie kann an jedem Arbeitsplatz verwendet werden und muss nicht installiert werden, und es sind keine weiteren Komponenten von Drittanbietern erforderlich. + +### Einzelvalidierung + +Sie können die Software an Ihrem Arbeitsplatz einsetzen und direkt gegen die offiziell unterstützten Schnittstellen von BZSt, MIAS und/oder HMRC prüfen. + +![Einzelvalidierung](images/single.png "VAT-Validation Einzelvalidierung") + +### Stapelverarbeitung + +Exportieren Sie Ihre Stammdaten in eine Datei (JSON, XLSX oder CSV) und überprüfen Sie sie vollständig. Die Codepage sollte UTF-8 sein. + +![Stapelverarbeitung](images/batch.png "VAT Validation Stapelverarbeitung") + +Die importierten Dateien müssen die folgenden Felder/Spalten enthalten. Im Falle von CSV und XLSX fügen Sie bitte die Feldnamen in die erste Zeile ein. Fügen Sie keine weiteren Spalten hinzu. + +* key1 +* key2 +* ownvat +* foreignvat +* company +* street +* zip +* town + +Die Ausgabedatei (Logfile) enthält die folgenden Informationen: + +* key1 +* key2 +* ownvat +* foreignvat +* type +* valid +* errorcode +* errorcode_description +* valid_from +* valid_to +* timestamp +* company +* address +* town +* zip +* street + +Je nach den importierten Daten und der verwendeten Schnittstelle werden einige Schlüssel keine Werte haben. + +## Konfiguration + +Die Konfiguration ist sehr einfach. Wechseln Sie auf die Registerkarte Konfiguration und geben Sie Ihre eigene Mehrwertsteuer ein. Diese wird für die einmalige Validierung als Standard-Mehrwertsteuer verwendet. +Daneben können Sie Ihre Standardschnittstelle auswählen. Wenn Sie eine deutsche MwSt. besitzen, empfehlen wir die Verwendung von BZSt. Ändern Sie die Sprache Ihrer Ausgabe. + +![Konfiguration](images/config.png "Konfiguration der VAT-Validierung") + +Falls Sie CSV verwenden, können Sie das Trennzeichen für Ihre Import- und Exportdateien wählen. + +# Bekannte Probleme + +Zurzeit gibt es mehrere bekannte Probleme. Sie finden diese in der Liste der Probleme. Wenn Sie auf ein weiteres Problem stoßen, fügen Sie bitte ein Problem hinzu. + +# Beitragen + +Wenn Sie einen Beitrag leisten wollen, indem Sie einen Fehler beheben, eine neue Funktion hinzufügen oder einfach etwas optimieren, finden Sie hier eine einfache Anleitung, wie Sie mit der Entwicklung beginnen können. + +## Entwicklung starten + +Erstellen und aktivieren Sie eine Umgebung, indem Sie den folgenden Befehl ausführen: + +```python -m venv .venv``` + +```.venv/Scripts/activate`` + +Installieren Sie die erforderlichen Abhängigkeiten + +```pip install -r src/requirements.txt`` + +Wenn Sie einige Änderungen an der Benutzeroberfläche vornehmen möchten, laden Sie den neuesten wxFormBuilder von der [wxFormBuilder Homepage] (https://github.com/wxFormBuilder/wxFormBuilder) herunter und installieren Sie ihn. + +Sie können die VATValidation starten, indem Sie den folgenden Befehl ausführen: + +```python src/vatvalidation.py`` diff --git a/README.md b/README.md index 59c7dac..8d814dd 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,8 @@ # VATValidation +[![en](https://img.shields.io/badge/lang-en-blue.svg)](https://github.com/dseichter/VATValidation/blob/master/README.md) +[![de](https://img.shields.io/badge/lang-de-blue.svg)](https://github.com/dseichter/VATValidation/blob/master/README-de.md) + ![pep8](https://github.com/dseichter/VATValidation/actions/workflows/pep8.yml/badge.svg) ![bandit](https://github.com/dseichter/VATValidation/actions/workflows/bandit.yml/badge.svg) ![trivy](https://github.com/dseichter/VATValidation/actions/workflows/trivy.yml/badge.svg) @@ -28,7 +31,7 @@ VAT Validation supports you in validating your vat numbers based on your master ## Command Line tool -If you want to check batch files (e.g. json, csv or XLSX) you can download the releases like VATValidation-cli-windows-v2024-07-08.exe and rename it to vatvalidation_cli.exe. +If you want to check batch files (e.g. json, csv or XLSX) you can download the releases like `VATValidation-cli-windows-v2024-07-08.exe` and rename it to vatvalidation_cli.exe. Just run the tool and by providing an input and an output file. For further information, please run @@ -58,7 +61,7 @@ The VAT Validation provides a graphical user interface for single and batch vali You can use the software at your workplace and check directly against the official supported interfaces of BZSt, VIES and/or HMRC. -![single validation](images/single.png "VAT Validation Single Validtion") +![single validation](images/single.png "VAT Validation Single Validation") ### Batch Validation