Sammellieferschein

Das Modul erstellt ein einziges Dokument für mehrere freigegebene Lieferungen desselben Kunden. Es liest die Lieferungen und verändert sie nie.

Die Erstellung

1. Unter ProdukteLieferungenListe die Lieferungen des Kunden markieren.
2. Die Massenaktion „Sammellieferschein (ein PDF)“ wählen.
3. Eine Seite zeigt den Kunden und die ausgewählten Lieferungen: Auftrag, Kundenreferenz, geplantes Lieferdatum, Anzahl der Positionen, Status. Bei Bedarf eine Notiz hinzufügen, die auf das Dokument gedruckt wird, dann „Sammellieferschein erstellen“.

Das PDF wird sofort erstellt. Vorher prüft das Modul drei Punkte:

• mindestens eine Lieferung ist ausgewählt;
• keine ist im Entwurf — sonst nennt die Meldung ihre Referenz;
• alle betreffen denselben Kunden.

Fehlt ein Punkt, wird nichts erstellt und der Grund angezeigt.

Das Dokument

• Kopf: Logo Ihres Unternehmens (sonst sein Name), Titel „Sammellieferschein“, Nummer BLGjjmm-NNNN, Datum, Anzahl der Lieferungen und Seitenzahl.
• Block „Absender“ mit Ihrer Firmenadresse; Block „Lieferadresse“ mit dem Lieferkontakt der ersten Lieferung, sonst der Kundenadresse.
• Ein Block je Lieferung, nach geplantem Lieferdatum geordnet (ersatzweise Erstellungsdatum): „Lieferung – Auftrag (Kundenreferenz) – Datum“.
• Für jede Position: Referenz, Bezeichnung, bestellte Menge, gelieferte Menge und Gewicht (Produktgewicht × gelieferte Menge).
• Unten: gelieferte Gesamtmenge, Gesamtgewicht, wenn Positionen ein Gewicht haben, Ihre Notiz, dann ein Feld „In gutem Zustand erhalten am: / Name und Unterschrift:“.

Auf mehreren Seiten werden Seitenkopf und Tabellenkopf wiederholt, und die durch den Seitenumbruch geteilte Lieferung wird mit „(Fortsetzung)“ erneut genannt.

Die Sprache des PDF

Das Dokument wird in der Sprache erstellt, die auf der Karte des Kunden eingetragen ist, sonst in der Sprache des Benutzers. Die eigenen Bezeichnungen des Moduls — Titel, Summen, Unterschriftsfeld — gibt es auf Französisch, Englisch und Deutsch; für andere Sprachen sind sie auf Englisch.

Einen Sammellieferschein wiederfinden

• Die Karte des Sammellieferscheins zeigt Kunde, Datum, Notiz, Link zum PDF und die Lieferungen, mit den Schaltflächen „PDF herunterladen“, „PDF neu erzeugen“ (nach Änderung einer Lieferung) und „Löschen“.
• ProdukteLieferungenSammellieferscheine: die Liste aller Sammellieferscheine.
• Auf der Karte jeder Lieferung verweist eine Zeile „Sammellieferschein“ auf den oder die Sammellieferscheine, in denen sie enthalten ist.

Das PDF für drei Lieferungen eines fiktiven Lebensmittelgeschäfts: ein Block je Lieferung, mit Auftrag, Kundenreferenz und Datum, dann Mengen und Gewichte. Unten die gelieferte Gesamtmenge (116), das Gesamtgewicht (71,6 kg), die Notiz und das Unterschriftsfeld.

In der Liste der Lieferungen unter Dolibarr 24.0.1 sind die drei Lieferungen des Kunden markiert. Die Aktion „Sammellieferschein (ein PDF)“ kommt zu den Aktionen von Dolibarr hinzu, unter „PDFs verbinden“.

Die Karte des Sammellieferscheins BLG2610-0009: Kunde, Datum, Notiz, Link zum PDF, die drei Lieferungen mit Auftrag, Kundenreferenz und geplantem Lieferdatum, und die Schaltflächen Herunterladen, Neu erzeugen und Löschen.

Keine: Das Modul hat keine Einstellungsseite. Das PDF übernimmt Logo und Adresse Ihres Unternehmens sowie Papierformat und Ränder aus den Einstellungen von Dolibarr.

• Zwei eigene Rechte: „Sammellieferscheine ansehen und herunterladen“ und „Sammellieferscheine erstellen, neu erzeugen und löschen“.
• Ohne das zweite Recht erscheint die Massenaktion nicht in der Liste der Lieferungen, und die Karte eines Sammellieferscheins zeigt nur die Schaltfläche zum Herunterladen. Erstellen, neu Erzeugen und Löschen werden abgelehnt.
• Zusätzlich das Recht von Dolibarr: Die Liste, die Karte eines Sammellieferscheins und sein PDF verlangen auch das Recht, Lieferungen einzusehen.
• Vertriebsmitarbeiter auf ihre Kunden beschränkt: Ohne das Dolibarr-Recht, alle Geschäftspartner zu sehen, sieht, lädt und erstellt ein Benutzer nur die Sammellieferscheine der Kunden, deren zuständiger Vertriebsmitarbeiter er ist, wie in den Listen von Dolibarr; ein gefälschter Link zu einem anderen Sammellieferschein wird abgelehnt.
• Lieferungen nur gelesen: Das Modul verändert keine Lieferung und keinen Auftrag.
• Bestätigtes Löschen: Das Löschen eines Sammellieferscheins verlangt eine Bestätigung; der Sammellieferschein, seine Zeilen und sein PDF werden gelöscht, die Lieferungen bleiben unberührt.
• Ein Sammellieferschein und seine Lieferungen werden in einer Transaktion gespeichert: Schlägt das Schreiben in die Datenbank fehl, wird nichts gespeichert.

• Der Modulordner dolixblgroupe, 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).
• Ein README.md und ein Änderungsprotokoll (ChangeLog.md) im Modulordner.
• Lizenz GPL v3 oder später, vollständiger und lesbarer Quellcode.

• Zwei Tabellen werden angelegt: llx_dolixblg (ein Sammellieferschein: Nummer, Kunde, Notiz, Benutzer, Erstellungsdatum, Mandant) und llx_dolixblg_exp (die Lieferungen jedes Sammellieferscheins in Druckreihenfolge).
• Das PDF wird unter documents/dolixblgroupe/ in einem Ordner mit der Nummer des Sammellieferscheins abgelegt.
• Lieferungen, ihre Positionen und Aufträge werden nur gelesen. Keine Datei von Dolibarr wird verändert.
• Beim Deaktivieren verschwinden Menü, Massenaktion und die Zeile auf der Lieferungskarte. Die Tabellen llx_dolixblg und llx_dolixblg_exp und die bereits erstellten PDFs werden nicht gelöscht.