Mondial Relay Etiketten (Sendcloud)

Alles geschieht in der Lieferung in Dolibarr und in der Liste der Lieferungen.

Die Wahl des Punktes

Die Lieferung erhält eine Zeile „Mondial Relay Paketshop (Point Relais®)“. Der Stift öffnet die Suche rund um die Lieferpostleitzahl: Paketshops und Locker, mit Name, Adresse, Entfernung und Öffnungszeiten. Der gewählte Punkt wird vor dem Speichern bei Sendcloud erneut abgefragt, zusammen mit seinem Typ: Geschäft oder Locker.

Das Etikett

In einer freigegebenen Lieferung „Mondial-Relay-Etikett erstellen“:

1. Das Modul fragt bei Sendcloud die Mondial-Relay-Versandoptionen für dieses Gewicht und diese Länder ab.
2. Es wählt die zum Punkt passende Option — Paketshop, Locker oder Hauszustellung, wenn Sie sie erlaubt haben —, die günstigste Ihres Kontos, und nie eine Option ohne gedrucktes Etikett.
3. Es legt die Sendung bei Sendcloud an und legt das PDF-Etikett in den Dokumenten der Lieferung ab.
4. Es trägt die Sendungsnummer und die Versandart „Mondial Relay“ in die Lieferung ein.

Danach zeigt „Status aktualisieren“ den Sendcloud-Status des Pakets, und „Etikett stornieren“ beantragt nach einer Bestätigung die Stornierung bei Sendcloud.

Mehrere Pakete auf einmal

In der Liste der Lieferungen zeigt die Massenaktion „Mondial-Relay-Etiketten“ die gewählten Lieferungen („Zu erledigen“, „Bereits erstellt“), erstellt ein Etikett je bereiter Lieferung und bietet dann „Etiketten herunterladen (ZIP)“ an.

Prüfungen vor jeder Anfrage

Nichts wird an Sendcloud gesendet, solange einer dieser Punkte fehlt:

Der Testmodus

Standardmäßig aktiviert, erstellt er Sendcloud-Testetiketten, kostenlos und ohne Versanddienstleister, damit Sie den ganzen Ablauf vor dem ersten Paket ausprobieren können. Nichts wird an Mondial Relay gesendet, die Sendungsnummer wird nicht in die Lieferung eingetragen, und ein Hinweis TEST zeigt das an. Deaktiviert, erstellt das Modul echte Mondial-Relay-Etiketten, die Sendcloud zu den Tarifen Ihres Kontos berechnet.

Was echt ausprobiert wurde

Am 14. Oktober 2026 hat das Modul unter Dolibarr 24.0.1 im Echtbetrieb das Mondial-Relay-Etikett Nr. 73988975 erstellt: ein Paket von 1 kg an einen Paketshop in Straßburg. Das PDF wurde in den Dokumenten der Lieferung abgelegt, Sendungsnummer und Versandart wurden in die Lieferung eingetragen. Die Stornierung wurde noch am selben Tag aus dem Modul beantragt.

Die drei Bildschirmfotos stammen aus dem Echttest vom 14. Oktober 2026, unter Dolibarr 24.0.1, mit englischer Oberfläche.

Die Lieferung nach der Erstellung des echten Etiketts: rechts „Shipping method: Mondial Relay“ und „Tracking number: 73988975“, vom Modul eingetragen; links der Paketshop NEUSHOP STRASBOURG, die Sendungsnummer mit dem Link zum PDF-Etikett und der Sendcloud-Status „Ready to send“.

Die Wahl des Punktes für die Postleitzahl 67100: zwei Geschäfte und ein Locker, mit Adresse, Entfernung und Öffnungszeiten.

Die Einstellungsseite ist Administratoren vorbehalten.

Die Schaltfläche „Verbindung testen“ sucht Paketshops nahe der Adresse Ihres Unternehmens und zeigt, wie viele sie findet.

• Zwei eigene Berechtigungen: „Mondial-Relay-Angaben der Lieferungen ansehen“ und „Paketshop wählen, Mondial-Relay-Etiketten erstellen und stornieren“. Nur mit der ersten ist die Mondial-Relay-Zeile sichtbar, ohne Schaltflächen.
• Zusätzlich die Dolibarr-Berechtigung: Die Seiten für die Punktwahl und die Massenetiketten verlangen auch das Recht, Lieferungen zu lesen.
• Geheimer Schlüssel verschlüsselt gespeichert, auf der Einstellungsseite nie wieder angezeigt.
• Anti-CSRF-Token in jedem Formular. In der Lieferung prüft das Modul das Token der Aktionen Erstellen, Aktualisieren und Stornieren selbst.
• Bestätigte Stornierung: Ein Dialog erinnert daran, dass das Etikett nur erstattet wird, wenn die Stornierung vor der Frist des Versanddienstleisters angenommen wird.
• Ausgehende Verbindungen nur zu panel.sendcloud.sc und servicepoints.sendcloud.sc, ohne Weiterleitungen zu folgen. Ein in Dolibarr eingestellter Proxy wird verwendet.
• Einstellungen nur für Administratoren.

Der Ordner dolixmondialrelay, in lesbarem PHP, unter der Lizenz GPL v3 oder später: der Moduldeskriptor, die Sendcloud-API-Klasse, die Sendungsklasse, die Hooks in der Lieferung und in der Lieferliste, die Seite zur Punktwahl, die Seite für Massenetiketten, die Einstellungsseite, das SQL-Skript der Tabelle, die Symbole.

• Sprachen: Französisch (fr_FR), Englisch (en_US) und Deutsch (de_DE).
• Eine README.md, die Funktionsweise und Grenzen beschreibt.
• Eine ChangeLog.md.

• Eine Tabelle wird angelegt: llx_dolixmr_envoi. Sie enthält eine Zeile je Lieferung: gewählter Paketshop, Sendcloud-Sendung, Sendungsnummer, Dateiname des Etiketts, Status, Test- oder Echtbetrieb.
• Was in die Lieferung geschrieben wird, bei einem echten Etikett: die Sendungsnummer und die Versandart „Mondial Relay“. Das PDF-Etikett liegt in ihren Dokumenten.
• Was an Sendcloud gesendet wird: Namen, Adressen, Telefonnummern und E-Mail-Adressen von Absender und Empfänger, soweit vorhanden, das Gewicht, die Referenz der Lieferung, die Versandoption und der gewählte Punkt; für die Punktsuche Land, Postleitzahl und Gewicht.
• Eine Versandart „Mondial Relay“ wird dem Wörterbuch hinzugefügt, falls es sie nicht gibt.
• Keine Datei von Dolibarr wird verändert.