Es ist möglich, Ihr eigenes Dokument über die SOAP Webservice oder REST API zu übermitteln. Dies kann zum Beispiel ein PDF-Lieferschein sein, der in Ihrem ERP- oder WMS-System erzeugt wird. Mit etwas zusätzlicher Konfiguration im MyTranssmart Admin Panel – entweder per Self-Service oder über unsere Beratungsabteilung – ist es möglich, dieses Dokument zu dem Zeitpunkt zu drucken, an dem das Versandetikett gedruckt wird.
Über die SOAP Webservice können Sie das base64-Dokument wie folgt übermitteln:
Für weitere Informationen zu den SOAP Webservice-Feldern sehen Sie sich bitte die wsdl an und suchen Sie nach dem Begriff „customerDocuments“.
Über die REST API können Sie das base64-Dokument wie folgt übermitteln:
Für weitere Informationen zu den API-Feldern sehen Sie sich bitte die DevDocs an und suchen Sie nach dem Begriff „customerDocuments“
Hinweis: Das Dokument kann auf Sendungsebene (mehr als 1 Dokument erlaubt) oder auf Packstückebene (max. 1 Dokument pro Sendungszeile/Packstück) übermittelt werden.
Example
Nachfolgend erläutern wir den Ablauf des Einsendens eines Lieferscheins PDF auf Sendungsebene.
1. Stellen Sie sicher, dass in der Admin Panel (falls Sie hierfür Self-Service-Zugriff haben) eine Konfiguration in 2 Tabellen vorhanden ist.
- Document Generation:
- Document Retrieval:
Wie oben erwähnt, kontaktieren Sie bitte unseren Service Desk, wenn Sie keinen Zugriff auf das Admin Panel-Menü haben; beachten Sie, dass für Änderungen an Ihrer Konfiguration zusätzliche Beratungskosten anfallen können.
2. Buchen Sie eine Sendung über SOAP Webservice oder REST API mit dem ausgefüllten customerDocuments-Abschnitt im Format „PDF“ und in diesem Beispiel mit templateName „DELNOTE“, wie oben beschrieben.
3. Führen Sie entweder einen getDocs-Aufruf über die SOAP Webservice aus oder einen REST-API-Print-Aufruf, und zusätzlich zu den Standardpaket-/Sendungsetiketten wird auch das DELNOTE-Dokument zurückgegeben. In MyTranssmart wird beim Durchführen eines Print-Aufrufs sowohl das/die Etikett(e) als auch das Dokument gedruckt. Sie können auch eine ZIP-Datei herunterladen; diese enthält alle Etiketten und Dokumente.
Wichtige Hinweise:
Es ist wichtig, dass der Maßstab des Dokuments 100 % beträgt. Wenn zum Beispiel ein PDF mit einem Maßstab von 70 % erstellt wird, wird er nicht korrekt gedruckt. Siehe folgendes Beispiel.
Der Ersteller des PDF hat einen Maßstab von 70 % verwendet:
Daher passt tatsächlich nur dieser Teil auf eine Seite:
Dies führt dazu, dass unsere Plattform das Dokument wie folgt an Sie übermittelt: