DHL Shipping
v1.0.0Überblick
Ein Versanddienst für die Druckerei. Ist ein Auftrag fertig, fragt es, was eine Abholung für genau das Paket kostet, das diese Auflage ergibt – das Gewicht stammt aus den verbrauchten Bogen –, bietet die zurückgemeldeten Leistungen an, bucht eine davon, legt das Label ab und verfolgt die Sendungsereignisse bis zur Zustellung. Eine Adresse, die nicht angenommen wird, kommt als lesbare Ablehnung zurück, die sich korrigieren lässt, nicht als stiller Fehlschlag. Geschrieben ist es gegen den Vertrag für Versanddienste und nicht gegen ein Unternehmen – deshalb ist der nächste Dienst eine Kopie davon; in der Demo spricht es mit einem Ersatztransport, es wird also nie eine echte Abholung gebucht.
Woran sie sich anschließt
Eine Erweiterung ergänzt eine App, die Sie ohnehin schon betreiben, und wird nie für sich allein bereitgestellt. Diese hier schließt sich an:
Was die Verbindung ihr erlaubt
Es braucht einen API-Schlüssel und eine Kundennummer aus Ihrem eigenen Konto beim Dienst. Beides wird verschlüsselt gespeichert, in jeder Antwort geschwärzt und nie an den Browser gesendet. Verbunden darf es einen fertigen Auftrag lesen, Sendungen und deren Ereignisse festhalten und ein Label in Ihren Dateispeicher legen. Seine Serverhälfte darf genau eine Adresse aufrufen und sonst nichts.
In Ihrer eigenen Installation
- Den Auftrag lesen, an dem es arbeitet
- Sendungen anlegen und fortschreiben
- Dateien in Ihren Dateispeicher schreiben
Adressen, die ihr Servercode erreichen darf
- express.api.dhl.com
Diese Liste ist die ganze Liste: ein Aufruf an eine andere Adresse wird abgewiesen und protokolliert.
Was für die Verbindung nötig ist
Ein API-Schlüssel
Was sie hinzufügt
Wo sie auftaucht 4
- Die Versandaktionen auf dem Auftragsschein
- Die Versandauswahl im Bestellabschluss
- Die Versandübersicht in der Bestellung der Kundschaft
- Ein eigener Bereich unter Erweiterungen in den Einstellungen
Tabellen, die sie mitbringt 2
- shipments
- shipment_events
Einstellungen, die Sie festlegen 4
- API-Schlüssel
- Kundennummer
- Stattdessen den Ersatztransport verwenden
- Annahmeschluss für Abholungen
Wenn Sie sie ausschalten
Beim Trennen verschwinden die Oberflächen der Erweiterung. Die von ihr angelegten Tabellen werden nie verworfen, geschriebene Dateien nie gelöscht und hinzugefügte Zeilen nie entfernt — alles, was sie geschrieben hat, bleibt in Ihrer Datenbank. Die ihr anvertrauten Zugangsdaten werden dabei widerrufen und gelöscht.
Was bleibt
Bereits gebuchte Sendungen, ihre Label und der gesamte Sendungsverlauf bleiben unverändert erhalten.
Was verschwindet
Der Dienst verschwindet aus dem Bestellabschluss, aus der Bestellung der Kundschaft und vom Auftragsschein, und der gespeicherte Schlüssel wird gelöscht. Die Übergabe über den Tresen funktioniert wie vorher.
Zur Demo
Keine Demo auf dieser Seite ruft wirklich einen fremden Dienst auf. Jede Erweiterung bringt einen Ersatz-Transport mit, der aus eingebauten Daten antwortet, und der ist von Haus aus eingeschaltet. Echte Zugangsdaten gehören zum Selbsthosten und sind in der README der Erweiterung beschrieben.
So schalten Sie sie ein Wechseln Sie in der Demo auf die Seite der Druckerei, öffnen Sie Erweiterungen und schalten Sie DHL Shipping ein – dann öffnen Sie einen fertigen Auftrag.
Adminium ist mit diesem Unternehmen nicht verbunden.