Preise aktualisieren

Das Modul fügt der Ansicht eines Angebotsentwurfs eine Schaltfläche „Update prices“ (Preise aktualisieren) hinzu.

Es zeigt zunächst für jede Position, die mit einem Produkt verknüpft ist: den aktuellen Preis, den aktualisierten Preis, die MwSt., den Rabatt und die Differenz in Euro. Die Differenz berücksichtigt den Rabatt, sodass die Summe der Differenzen genau der Veränderung der Angebotssumme entspricht — die Fußzeile der Tabelle zeigt im Übrigen die Nettosumme so an, wie sie nach der Übernahme wäre.

Sie entfernen das Häkchen bei den Positionen, die unverändert bleiben sollen, und übernehmen dann. Das bestehende Angebot wird geändert: Seine Referenz, sein Verlauf und seine Verknüpfungen bleiben unverändert.

Der verwendete Preis

Das Modul übernimmt genau die Prioritätsreihenfolge des Dolibarr-Kerns beim Duplizieren mit der Option „Preise mit den aktuell bekannten Preisen aktualisieren“:

1. der Basispreis des Produkts;
2. wenn mehrere Preissegmente aktiviert sind und der Geschäftspartner ein Preissegment hat, der Preis dieses Segments;
3. wenn kundenspezifische Preise aktiviert sind, der kundenspezifische Preis, dessen Gültigkeitszeitraum das heutige Datum umfasst.

Die Testsuite des Moduls vergleicht sein Ergebnis mit dem eines echten Duplizierens durch den Kern, mit denselben Daten, und prüft, dass beide Zahlen identisch sind.

Die Rabatte

Standardmäßig bleiben die in den Positionen erfassten Rabatte erhalten. Das ist eine vorsichtigere Wahl als die des Duplizierens in Dolibarr, das sie durch den Standardrabatt des Geschäftspartners ersetzt: Ein ausgehandelter Rabatt ginge verloren. Das Verhalten des Duplizierens bleibt in der Konfiguration des Moduls verfügbar, wenn Sie es vorziehen. Der Vorschaubildschirm zeigt unter der Tabelle an, welches der beiden Verhalten aktiv ist.

Die Schaltfläche erscheint in der Ansicht des Angebots, bei den anderen Aktionen. Sie wird nur angezeigt, wenn alle diese Bedingungen erfüllt sind: Das Angebot ist im Entwurf, Sie haben die Berechtigung des Moduls und die Berechtigung, Angebote zu bearbeiten, das Angebot gehört zu Ihrem Berechtigungsbereich, und es enthält mindestens eine Position, die mit einem Produkt verknüpft ist. Andernfalls wird keine überflüssige Schaltfläche hinzugefügt.

Der Vorschaubildschirm ist eine Tabelle mit acht Spalten: Auswahl, Produkt, Menge, aktueller Preis, aktualisierter Preis, MwSt., Rabatt, Differenz. Nicht änderbare Positionen erscheinen ebenfalls, mit dem Grund im Klartext in Klammern: „free line, left untouched“ (freie Position, nicht geändert), „product not found“ (Produkt nicht gefunden), „already up to date“ (bereits aktuell). Wenn sich nichts geändert hat, schreibt das Modul das und bietet keine Übernahme an.

Für dieses Modul ist noch keine Bildschirmaufnahme verfügbar. Siehe IMAGES.md, das die drei zu erstellenden Aufnahmen und den aufzubauenden Datensatz beschreibt.

• Eine eigene Berechtigung, „Use price update on proposals“ (Preisaktualisierung in Angeboten verwenden).
• Zusätzlich die Standardberechtigung von Dolibarr: Angebote anlegen und bearbeiten.
• Die übliche Zugriffskontrolle von Dolibarr wird auf das betreffende Angebot angewendet, was die Mandantenfähigkeit abdeckt.
• Externe Benutzer: Ein Konto, das einem Geschäftspartner zugeordnet ist, kann nur auf Angebote seines eigenen Geschäftspartners einwirken, in der Vorschau wie beim Schreiben.
• Kein Preis aus dem Formular wird verwendet. Bei der Übernahme wird jede Position auf dem Server neu berechnet; nur die Positions-IDs werden gelesen, und jede ID, die nicht zum Angebot gehört, wird ignoriert.
• Transaktionales Schreiben: Beim ersten Fehler wird nichts gespeichert.
• Anti-CSRF-Token im Formular und Ablehnung jeder Aktion auf einem Angebot, das kein Entwurf mehr ist.

• Es wird keine Tabelle angelegt, auch kein ergänzendes Attribut. Der Ordner des Moduls enthält kein Verzeichnis sql/.
• Das Modul speichert zwei Einstellungen in den Konstanten von Dolibarr.
• Die einzigen geänderten Daten sind die von Ihnen ausgewählten Positionen des Angebots, danach die Summen des Kopfbereichs, die Dolibarr neu berechnet.
• Jeder Vorgang wird in die Protokolle von Dolibarr geschrieben.
• Keine ausgehende Verbindung: Nichts wird irgendwohin gesendet.