Preise aktualisieren

In einem Angebotsentwurf fügt das Modul die Schaltfläche „Preise aktualisieren“ hinzu, in einer Rechnungsvorlage dieselbe Schaltfläche. Es zeigt zuerst für jede mit einem Produkt verknüpfte Position den aktuellen Preis, den neuen Preis, die Steuer, den Rabatt und die Differenz in Euro. Die Differenz berücksichtigt den Rabatt, sodass die Summe der Differenzen genau der Änderung der Gesamtsumme entspricht — die Fußzeile der Tabelle zeigt die Nettosumme nach der Übernahme. Sie wählen die Positionen ab, die unverändert bleiben sollen, und übernehmen. Das bestehende Dokument wird geändert: Referenz, Verlauf und Verknüpfungen bleiben unverändert.

Für alle Rechnungsvorlagen auf einmal öffnet das Menü Rechnung | Zahlung › Liste der Vorlagen › Vorlagenpreise aktualisieren eine Seite, die jede Vorlage mit mindestens einer Position auflistet, deren Preis nicht mehr dem Katalog entspricht: Kunde, Datum der nächsten Rechnung, Anzahl der betroffenen Positionen, aktuelle Summe, neue Summe und Differenz. Sie filtern nach Kunde oder Produkt, beziehen bei Bedarf ausgesetzte Vorlagen ein, wählen aus, was unverändert bleiben soll, und aktualisieren alles in einem Schritt. Nur die nächsten erzeugten Rechnungen tragen die neuen Preise: Bereits ausgestellte Rechnungen werden nie verändert.

Der verwendete Preis

Das Modul übernimmt genau die Rangfolge des Dolibarr-Kerns beim Duplizieren eines Angebots mit „Preise mit den aktuell bekannten Preisen aktualisieren“:

1. der Grundpreis des Produkts;
2. wenn Preisstufen aktiviert sind und der Geschäftspartner eine Preisstufe hat, der Preis dieser Stufe;
3. wenn Kundenpreise aktiviert sind, der kundenspezifische Preis — ab Dolibarr 22 derjenige, dessen Gültigkeitszeitraum das heutige Datum abdeckt.

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

Die Rabatte

Standardmäßig bleiben die in den Positionen erfassten Rabatte erhalten. Das ist vorsichtiger als das Duplizieren 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.

Die Schaltfläche erscheint bei den anderen Aktionen in der Ansicht eines Angebots im Entwurf oder einer Rechnungsvorlage, wenn Sie die Berechtigung des Moduls und die Berechtigung zum Bearbeiten dieser Dokumentart haben und das Dokument mindestens eine mit einem Produkt verknüpfte Position enthält. Sonst wird keine unnötige Schaltfläche hinzugefügt.

Die Seite eines Dokuments ist eine Tabelle mit acht Spalten: Auswahl, Produkt, Menge, aktueller Preis, neuer Preis, Steuer, Rabatt, Differenz. Nicht änderbare Positionen erscheinen ebenfalls, mit dem Grund in Klammern: „freie Zeile, unverändert“, „Produkt nicht gefunden“, „bereits aktuell“.

Die Seite der Rechnungsvorlagen zeigt eine Zeile pro Vorlage, mit einem Link Details zur zeilenweisen Ansicht, um nur einen Teil einer Vorlage zu aktualisieren. Auf beiden Seiten folgt die Summe unten Ihrer Auswahl: Was angezeigt wird, wird genau so geschrieben.

• Eine eigene Berechtigung, „Preisaktualisierung verwenden (Angebote und Rechnungsvorlagen)“.
• Zusätzlich die Standardberechtigung von Dolibarr: Angebote bearbeiten für Angebote, Rechnungen anlegen und bearbeiten für Rechnungsvorlagen.
• Die übliche Zugriffskontrolle von Dolibarr, die auch Multi-Company abdeckt.
• Externe Benutzer: Ein mit einem Geschäftspartner verknüpftes Konto kann nur auf die Dokumente dieses Partners zugreifen, in der Vorschau wie beim Schreiben, auch auf der Seite der Rechnungsvorlagen.
• Kein Preis aus dem Formular wird verwendet. Beim Übernehmen wird jede Position auf dem Server neu berechnet; nur die Kennungen werden gelesen, und jede dem Dokument fremde Kennung wird ignoriert.
• Transaktionales Schreiben: Bei einem Dokument wird beim ersten Fehler nichts gespeichert. Bei der Sammelaktualisierung hat jede Vorlage ihre eigene Transaktion; ein Fehler wird gemeldet, ohne die anderen rückgängig zu machen.
• CSRF-Token in den Formularen und keine Änderung an einem Angebot, das kein Entwurf mehr ist.

• Es wird keine Tabelle angelegt und auch kein ergänzendes Attribut.
• Das Modul speichert zwei Einstellungen in den Konstanten von Dolibarr.
• Geändert werden nur die ausgewählten Positionen der Angebote und Rechnungsvorlagen und danach deren Summen, die Dolibarr neu berechnet. Bereits ausgestellte Rechnungen werden nie verändert.
• Jeder Vorgang wird in die Protokolle von Dolibarr geschrieben.
• Keine ausgehende Verbindung: Nichts wird irgendwohin gesendet.