TakePOS-Guthabenkonto

Das Modul gibt jedem Geschäftspartner ein vorausbezahltes Guthaben. Es führt keine eigene Buchhaltung: Es nutzt das verfügbare Guthaben von Dolibarr, das der Kern bereits für Anzahlungen und Gutschriften verwendet.

Aufladung

Aufgeladen wird auf der Registerkarte „Guthaben“ der Geschäftspartner- oder Mitgliederkarte: Betrag, Zahlungsart, Bankkonto, Anmerkung. Das Modul führt dann in einer einzigen Transaktion aus:

1. eine einzeilige Anzahlungsrechnung mit 0 % MwSt., freigegeben;
2. die Zahlung dieser Rechnung, auf das Bankkonto gebucht, wenn das Modul Banken | Kassen aktiviert ist;
3. die Rechnung wird als bezahlt markiert;
4. ihre Umwandlung in verfügbares Guthaben des Kunden.

Schlägt ein Schritt fehl, wird nichts in der Datenbank gespeichert. Dieselbe Registerkarte zeigt das verfügbare Guthaben und den Verlauf der Aufladungen und Einkäufe.

Auf der Mitgliederkarte zeigt die Registerkarte das Guthabenkonto des mit dem Mitglied verknüpften Geschäftspartners. Ein Mitglied ohne verknüpften Geschäftspartner hat kein Guthabenkonto: Die Registerkarte weist darauf hin.

An der Kasse

Auf dem Zahlungsbildschirm von TakePOS erscheint eine Schaltfläche „Guthaben (Betrag)“, wenn der Kunde des Verkaufs ein Guthaben hat und der Verkauf nicht beglichen ist.

• Der Browser sendet keinen Betrag. Der Server rechnet höchstens den offenen Betrag und höchstens das Guthaben an.
• Die ältesten Guthaben werden zuerst verwendet. Ein Guthaben, das größer ist als nötig, wird in zwei Teile aufgeteilt: den verwendeten Teil und den Rest, der verfügbar bleibt.
• Deckt das Guthaben den Verkauf, wird er ohne weitere Zahlung freigegeben und bezahlt.
• Andernfalls zeigt der Bildschirm den offenen Betrag, der bar, mit Karte oder per Scheck zu begleichen ist.
• Der Link „Rückgängig“ gibt das Guthaben zurück.

Das Guthaben wird als Zahlung angerechnet, nicht als Rabatt: Der Beleg behält seine Zeilen und seine MwSt., ohne negative Zeile.

Es werden nur Guthaben aus Aufladungen verwendet. Gewöhnliche Gutschriften und Anzahlungen des Kunden werden nie angetastet.

Das Guthaben ist geschützt

Wird ein Verkauf im Entwurf, auf den das Guthaben angerechnet wurde, geändert — Zeile hinzugefügt, geändert oder gelöscht —, gelöscht oder einem anderen Kunden zugeordnet, wird der angerechnete Betrag dem Guthabenkonto zurückgegeben. Ein erneuter Klick auf die Schaltfläche genügt.

Damit wird eine Lücke im Kern geschlossen: Beim Löschen einer Rechnung gibt Dolibarr die als Zahlung angerechneten Guthaben nicht frei.

Je nach Dolibarr-Version

Von 19 bis 22 zeigt der Zahlungsbildschirm von TakePOS keine von Modulen hinzugefügten Schaltflächen an. Auf diesen Versionen gibt das Modul seine Schaltfläche selbst aus.

Die MwSt.

Eine Aufladung wird mit 0 % MwSt. erfasst: Die MwSt. fällt beim Einkauf an, auf dem Beleg. Das entspricht einem Mehrzweck-Gutschein und gilt, wenn Ihre Produkte unterschiedlichen MwSt.-Sätzen unterliegen.

Haben alle Ihre Produkte denselben Satz — zum Beispiel nur Lebensmittel zu 5,5 % —, ist das Guthaben ein Einzweck-Gutschein: Die MwSt. fällt bereits bei der Aufladung an, und Version 1.0.0 unterstützt diesen Fall nicht (französische Verwaltungsanweisung BOI-TVA-CHAMP-10-10-40-50). Für nicht umsatzsteuerpflichtige Organisationen ohne Bedeutung. Im Zweifel fragen Sie Ihren Steuerberater.

Auf dem Zahlungsbildschirm von TakePOS erscheint für einen Verkauf von 107,60 € inkl. MwSt. die Schaltfläche „Porte-monnaie (51,60 €)“ (Guthaben) unter dem Ziffernblock, neben den Zahlungsarten „Espèce“, „Chèque“ und „Carte bancaire“ (bar, Scheck, Karte).

Nach einem Klick deckt das Guthaben nicht den ganzen Verkauf: 51,60 € werden angerechnet, und der Bildschirm zeigt „Reste à payer: 56,00 €“ (offener Betrag), mit einer anderen Zahlungsart zu begleichen. Die Schaltfläche ist verschwunden, da das Guthaben aufgebraucht ist. Unter den Schaltflächen trägt die Zeile „Porte-monnaie appliqué : 51,60 €“ (Guthaben angerechnet) den Link „Annuler“ (Rückgängig).

Die Registerkarte „Porte-monnaie“ (Guthaben) auf der Karte eines Mitglieds unter Dolibarr 24.0.1: verfügbares Guthaben von 51,60 €, verknüpfter Geschäftspartner, Aufladeformular (Betrag, Zahlungsart, Bankkonto, Anmerkung), dann der Verlauf — zwei Aufladungen über 50,00 € und 20,00 €, zwei Einkäufe über 12,00 € und 6,40 €. Jede Zeile verweist auf ihre Rechnung.

Die Einstellungsseite des Moduls ist Administratoren vorbehalten. Sie beginnt mit einem Hinweis zur Behandlung der MwSt.

• Drei eigene Rechte, standardmäßig nicht vergeben: „Guthaben einsehen“ öffnet die Registerkarte, „Guthaben aufladen“ zeigt das Aufladeformular, „An der Kasse mit Guthaben bezahlen“ zeigt die Schaltfläche in TakePOS.
• Zusätzlich das Recht von Dolibarr: Um an der Kasse zu bezahlen, braucht der Benutzer auch das Recht zum Anlegen von Rechnungen.
• Die Registerkarte beachtet die Rechte auf Geschäftspartner: Sie öffnet sich nur bei einem Geschäftspartner, auf den der Benutzer Zugriff hat.
• Der Betrag wird vom Server berechnet. Der Browser fordert nur das Anrechnen oder das Rückgängigmachen an; der Server rechnet höchstens den offenen Betrag und höchstens das Guthaben an.
• Geschützte Anfragen: Anrechnen und Rückgängigmachen akzeptieren nur POST-Anfragen mit dem Anti-CSRF-Token von Dolibarr. Sie werden bei einer Gutschrift, einer Anzahlungsrechnung oder einer bereits bezahlten Rechnung abgelehnt.
• Transaktionen: Eine Aufladung oder eine Anrechnung des Guthabens, die unterwegs fehlschlägt, wird vollständig zurückgenommen.
• Automatische Freigabe des Guthabens, wenn sich ein Verkauf im Entwurf ändert oder verschwindet.

• Der Modulordner dolixportemonnaie, der in htdocs/custom/ abgelegt oder aus der Zip-Datei installiert wird.
• Drei Sprachen: Französisch (fr_FR), Englisch (en_US) und Deutsch (de_DE).
• Kein README und kein ChangeLog im Modulordner.
• Lizenz GPL v3 oder später, vollständiger und lesbarer Quellcode.

• Eine Tabelle wird hinzugefügt: llx_dolixpm_recharge. Sie speichert eine Zeile pro Aufladung: Geschäftspartner, Anzahlungsrechnung, Betrag, Datum, Benutzer, Anmerkung, Mandant. Das Guthaben selbst wird dort nicht gespeichert: Es ist die Summe der verfügbaren Dolibarr-Guthaben aus diesen Anzahlungsrechnungen.
• Was bei jeder Aufladung geschrieben wird, über die Klassen des Kerns: eine Anzahlungsrechnung, ihre Zahlung, die Bankbuchung, wenn das Modul Banken | Kassen aktiviert ist, und ein verfügbares Guthaben des Kunden. Bei der Freigabe erzeugt Dolibarr das PDF der Anzahlungsrechnung, wie bei jeder Rechnung.
• Was an der Kasse geschrieben wird: Das verwendete Guthaben wird dem Verkauf als Zahlung zugeordnet. Das Modul fügt dem Verkauf keine Zeile hinzu.
• Keine Datei von Dolibarr wird verändert. Keine ausgehende Verbindung.
• Bei der Deaktivierung verschwinden die Registerkarte und die Kassenschaltfläche. Anzahlungsrechnungen, Zahlungen und Guthaben bleiben: Es sind Daten Ihrer Datenbank, und nicht verbrauchte Guthaben bleiben verfügbare Guthaben des Kunden in Dolibarr. Die Tabelle llx_dolixpm_recharge und die Einstellungen des Moduls werden nicht gelöscht.