home.md

-
-Developer
--------
-
-Das Rechnungsmodul bietet für Entwickler eine große API an Events an. Durch die verschiedenen Events ist es dir möglich auf verschiedene Ereignisse von Rechnungen oder Rechnungsentwürfen zu reagieren.
-
-
-## Invoice Events
-
-##### onQuiqqerInvoiceCreateCreditNote
-
-- `onQuiqqerInvoiceCreateCreditNote [Invoice]`
-
-Invoice = Original Rechnung
-
-Wird gefeuert wenn eine Gutschrift (Credit Note) erstellt werden soll. Zu diesem Zeitpunkt ist diese noch nicht erstellt.
-
-##### onQuiqqerInvoiceCreateCreditNoteEnd
-
-- `onQuiqqerInvoiceCreateCreditNoteEnd [Invoice, CreditNote]`
-
-Invoice = Original Rechnung
-CreditNote = Erstellte Gutschrift Rechnung
-
-Wird gefeuert wenn eine Gutschrift (Credit Note) erstellt ist
-
-##### onQuiqqerInvoiceCancel
-
-- `onQuiqqerInvoiceCancel [Invoice]`
-
-
-##### onQuiqqerInvoiceStorno
-
-- `onQuiqqerInvoiceStorno [Invoice] (Same as cancel, alias)`
-
-##### onQuiqqerInvoicePaymentStatusChanged
-
-- `onQuiqqerInvoicePaymentStatusChanged [Invoice, (int) $newStatus, (int) $oldStatus]`
-
-##### onQuiqqerInvoiceAddComment
-
-- `onQuiqqerInvoiceAddComment [Invoice, message]`
-
-##### onQuiqqerInvoiceAddHistory
-
-- `onQuiqqerInvoiceAddHistory [Invoice, message]`
-
-##### onQuiqqerInvoiceCopyBegin
-
-- `onQuiqqerInvoiceCopyBegin [Invoice]`
-
-##### onQuiqqerInvoiceCopy
+# E-COYN Rechnungen
+
+![image](https://dev.quiqqer.com/quiqqer/invoice/-/raw/master/bin/images/Readme.jpg)
+
+Das E-COYN Rechnungen Modul ermöglicht die vollständige Verwaltung von Rechnungen für deinen Shop. Vom händisch erstellten Entwurf bis zur automatisch gebuchten Rechnung bietet dieses Modul alles, um Rechnungen effizient und übersichtlich zu handhaben.
+
+## Features
+* Übersichtliche Verwaltungsoberflächen für Rechnungs-Entwürfe und gebuchte Rechnungen ("Journal")
+  * Listet alle Rechnungen mit den wichtigsten Details auf einen Blick
+  * Filtern nach Rechnungs-Status, Zeitraum und Währung
+  * Anzeige von Summen (netto / brutto / MwSt.) der gefilterten Rechnungen
+  * Schnellsuche nach Rechnungs- und Kunden-Nummern
+  * Schnell-Aktionen: Rechnung ausgeben (Druck / PDF / E-Mail-Versand), Zahlung buchen, Rechnung stornieren, Rechnung kopieren, Gutschrift erstellen
+  * Einfache Erkennung von verschiedenen Rechnungstypen anhand spezieller Icons
+* Rechnungs-Entwürfe - Einfache Festlegung aller Rechnungs-Details, vor der verbindlichen Buchung
+  * Kundendaten; auf Wunsch Trennung von Rechnungs- und Lieferadresse
+  * Rechnugsdaten wie Datum, Projekt, Bearbeiter, Status, Zahlungsart, Zahlungsziel und individuellem Rechnungstext
+  * Umfangreiches Artikel-Management - Füge Artikel aus dem Produktkatalog oder freihändige Artikel mit individuellem Preis und/oder Rabatt in beliebiger Menge hinzu
+  * Freie Kommentare zu jeder Rechnung
+  * Überprüfung - Letzter Schritt vor der Buchung, der alle Rechnungs-Informationen auf Stimmigkeit überprüft; so werden Fehlbuchungen verhindert
+* Rechnungs-Panel - Darstellung aller Rechnungsdetails
+  * Änderung des Rechnungs-Status möglich
+  * Buchung von Zahlungseingängen
+  * Detaillierter Verlauf aller Rechnungs-Ereignisse
+  * Kommentare
+  * Ansicht der finalen Rechnung
+* Einfache Erzeugung von Storno-Rechnungen
+  * Stornierung einer vorhandenen Rechnung und gleichzeitige Erstellung einer passenden Storno-Rechnung mit negiertem Rechnungsbetrag
+  * Optionale automatische Rückzahlung (je nach Zahlungsart)
+  * Automatischer Hinweis auf Original-Rechnung im Rechnungstext
+* Einfache Erzeugung von Gutschriften
+  * Gutschriften zu einer vorhandene Rechnung über einen beliebigen Betrag erzeugen
+  * Automatischer Hinweis auf Original-Rechnung im Rechnungstext
+* Umfangreiche Konfigurationsmöglichkeiten
+  * Globales Entwurfs- / Rechnungs-Präfix
+  * Globaler Rechnungstext
+  * Standard-Zahlungsziel
+  * Optionale Deaktivierung von Stornierungen
+  * Dateinamen für Rechnungs-Downloads mit Platzhaltern
+  * Vollständig konfigurierbare Satus-Verwaltung für eigene Rechnungs-Status mit eigener Farbkodierung (es werden bereits einige Standard-Status mitgliefert)
+* Eigener Nummernkreis für Entwürfe und gebuchte Rechnungen
+* Rechnung werden von einer Vielzahl an weiteren E-COYN Modulen verwendet
+  * Automatische Rechnungserstellung bei Bestellungen und Verträgen
+  * Rechnungen aus Angeboten erzeugen
+  * und weitere...
+
+## Benutzerhandbuch
+Die Anleitung zur Bedienung des Moduls für Endbenutzer findet sich [hier](docs/de/users).
+
+## Dokumentation für Entwickler
+Die Dokumentation der APIs für Entwickler findet sich [hier](docs/de/developers).
\ No newline at end of file
-
-- `onQuiqqerInvoiceCopy [Invoice]`
-
-##### onQuiqqerInvoiceCopyEnd
-
-- `onQuiqqerInvoiceCopyEnd [Invoice, TemporaryInvoice]`
-
-##### onQuiqqerInvoiceAddPaymentBegin
-
-```
-onQuiqqerInvoiceAddPaymentBegin [
-    Invoice, 
-    $amount, 
-    QUI\ERP\Accounting\Payments\Api\PaymentsInterface, 
-    $date
-]
-```
-
-##### onQuiqqerInvoiceAddPayment
-
-```
-onQuiqqerInvoiceAddPayment [
-    Invoice, 
-    $amount, 
-    QUI\ERP\Accounting\Payments\Api\PaymentsInterface, 
-    $date
-]
-```
-
-##### onQuiqqerInvoiceAddPaymentEnd
-
-```
-onQuiqqerInvoiceAddPaymentEnd [
-    Invoice, 
-    $amount, 
-    QUI\ERP\Accounting\Payments\Api\PaymentsInterface, 
-    $date
-]
-```
-
-##### onQuiqqerInvoiceProcessingStatusSet
-
-- `onQuiqqerInvoiceProcessingStatusSet [Invoice, $Status]`
-
-##### onQuiqqerInvoiceProcessingStatusChange
-
-- `onQuiqqerInvoiceProcessingStatusChange [Invoice, $Status]`
-
-
-## Temporary Invoice Events
-
-- `onQuiqqerInvoiceTemporaryInvoicePostBegin [TemporaryInvoice]`
-- `onQuiqqerInvoiceTemporaryInvoicePost [TemporaryInvoice]`
-- `onQuiqqerInvoiceTemporaryInvoicePostEnd [TemporaryInvoice, Invoice]`
-
-- `onQuiqqerInvoiceTemporaryInvoiceSaveBegin [TemporaryInvoice]`
-- `onQuiqqerInvoiceTemporaryInvoiceSave [TemporaryInvoice]`
-- `onQuiqqerInvoiceTemporaryInvoiceSaveEnd [TemporaryInvoice]`
-
-- `onQuiqqerInvoiceTemporaryInvoiceCopy [TemporaryInvoice]`
-- `onQuiqqerInvoiceTemporaryInvoiceCopyEnd [TemporaryInvoice, TemporaryInvoice $Copy]`
-
-- `onQuiqqerInvoiceTemporaryInvoiceDelete [TemporaryInvoice]`
-
-- `onQuiqqerInvoiceTemporaryInvoiceAddHistory [TemporaryInvoice, message]`
-- `onQuiqqerInvoiceTemporaryInvoiceAddComment [TemporaryInvoice, message]`
-
-
-##### onQuiqqerInvoiceMissingAttributes
-
-- `onQuiqqerInvoiceMissingAttributes [InvoiceTemporary, array &$missingAttributes]`
-
-Wird ausgeführt wenn bei einer Rechnung geschaut wird welche Attribute noch fehlen um diese buchen zu können. Das $missingAttributes Array kann mit eigenen Missing Attributes erweitert werden. Diese sollten aber dann bei `onQuiqqerInvoiceGetMissingAttributeMessage` beachtet werden!
-
-##### onQuiqqerInvoiceGetMissingAttributeMessage
-
-- `onQuiqqerInvoiceGetMissingAttributeMessage [$missingAttribute, &$message]`
-
-Dieses Event wird gefeuert, wenn eine Fehlermeldung für ein wichtiges fehlendes Buchungsattribut der Rechnung gesucht wird.
-
-Dies kann zum Beispiel verwendet werden, wenn eigene Missing Attribute für eine Rechnung eingeführt wurden. Siehe `onQuiqqerInvoiceTemporaryInvoiceMissingAttributes`