Wie kommen die Daten zu PAQATO?
Wie haben verschiedene Möglichkeiten, wie du uns Auftragsdaten übermitteln kannst. Hier beschreiben wir dir die wichtigsten.
Plugins
Zusammen mit Partnern wie z.B. Shopware oder Plentymarkets haben wir Schnittstellen und Plugins entwickelt. Deine Anbindung wird einfach per Knopfdruck und ohne IT-Know How erledigt.
Shopware 5
Nachdem du das kostenlose Plugin gedownloadet hast, musst du den API-Key eintragen und kannst dann z.B. Farben für die Sendungsverfolgung auswählen, deine Paketdienstleister eintragen und den Paketdatenexport aktivieren (Checkbox).
Wie wird das Plugin konfiguriert?
Das Plugin kann kostenlos im Marketplace heruntergeladen werden: https://store.shopware.com/pqt3996736237710f/track-trace-und-versandnachrichten.html
Der dazugehörige Account bei PAQATO kann über PAQATO/Preise erstellt, über den PAQATO Support (service@paqato.com) angefragt, oder einfach über die Einrichtung des Plugins als Signup durchgeführt werden.
Grundeinstellungen
Im ersten Schritt zur Einrichtung des Plugins ist die Festlegung des PAQATO API-Keys erforderlich. Der API-Key kann unter https://myadmin.paqato.com/api/key generiert werden oder im Kundenservice (service@paqato.com) angefordert werden. Optional kannst du über die Grundeinstellungen einen Link für Versandbestätigungen in die Zwischenablage kopieren, der künftig auf die Sendungsverfolgung im Shop leitet.
Shop-Einstellungen
Im zweiten Schritt der Konfiguration definierst du die Farbe des Kalenderblatts sowie die Schriftfarbe für Erfolgs- und Fehlermeldungen. Außerdem kannst du auch Cross-Selling-Elemente auswählen, die deinen Kunden beim Aufruf der Sendungsverfolgung angezeigt werden. So ist die Sendungsverfolgung auf dein Shop-Design abgestimmt.
Versandartzuordnung
Im dritten Schritt ordnest du die in Shopware hinterlegten Versandarten den Paketdienstleistern zu. Dadurch wird das Tracking der Pakete durch PAQATO ermöglicht. Die in Shopware hinterlegten Versandarten sind vorausgefüllt, der Paketdienstleister kann über das Suchfeld eingegeben werden und wird dann vorgeschlagen.
Paketdatenexport
Durch die Aktivierung der Checkbox werden ab diesem Zeitpunkt die notwendigen Paketdaten an PAQATO übermittelt. Die Übertragung erfolgt, sobald ein Auftrag in Shopware mit einer Sendungsnummer versehen ist. Die übermittelten Pakete können unter https://my.paqato.com eingesehen werden.
Plentymarkets
Das Plugin kannst du kostenlos downloaden und anschließend den API-Key eintragen. Danach kannst du Farben für die Sendungsverfolgung bestimmen, Paketdienstleister auswählen und Bestell-Herkünfte zuordnen.
Magento 2
Mit PAQATO Connect verbindest du deinen Magento 2 Shop mit unseren Dienstleistungen. Das Plugin kannst du ohne Programmierkenntnisse konfigurieren und installieren. Bei der Konfiguration kannst du auswählen, welche Ereignisse, Bezahl- und Versandmethoden an PAQATO übertragen werden. Die Übertragung erfolgt, sobald sich ein Status verändert.
Erfahre hier, mehr über das Plugin und wie du es anbinden kannst.
Installationsanleitung
Mit PAQATO Connect kannst du deine Bestellungen direkt in den Service von PAQATO integrieren. Die Installation erfolgt ganz einfach in deinem Magento Shop unter Stores -> Konfiguration -> clever & zöger Extensions -> PAQATO Connect.
- Bestellstatus: Für die Konfiguration müssen zunächst die API Keys und der Shoptoken angegeben werden. Beides findest du unter myadmin.paqato.com. Nach der Aktivierung durch die Token kannst du auswählen, welche Bestellungen du an PAQATO übertragen möchtest.
- Versandmethoden: Auch für die Versandmethoden hast du die Möglichkeit auszuwählen, was übertragen wird.
- Bezahlmethoden: Dasselbe gilt für die Konfiguration der Zahlungsmethoden.
Für alle Konfigurationsmöglichkeiten gilt: Standardmäßig wird ein beliebiger Status gewählt, sodass jeder Status (auch für die gleiche Bestellnummer) übertragen werden kann. Durch einen Klick auf den Button “Systemwert verwenden” wird das Einstellungsfeld zur Anpassung geöffnet.
CSV-Export
Alternativ kannst du auch die Tagesabschlussdaten aus deiner Versandsoftware als CSV- oder XLS-Datei exportieren. Abgelegt auf einem FTP-Server kann PAQATO diese dann automatisiert abfragen.
CSV-Beispieldatensatz:
Als Trennzeichen sollte das Semikolon (;) verwendet werden.
| Feld | Beschreibung | Pflicht |
|---|---|---|
| shop | Eindeutiges Token (maximal 8 Zeichen) zur Identifikation des Shops / Mandanten | ✅ |
| carrier | Versanddienstleister (DHL, DPD, UPS, …) | ✅ |
| trackingCode | Sendungsverfolgungsnummer | ✅ |
| orderDateTime | Bestellzeitpunkt | |
| packingDateTime | Packzeitpunkt | |
| shippingDateTime | Versandzeitpunkt | ✅ |
| desiredDeliveryDate | Gewünschtes Lieferdatum (bei Speditionen) | |
| scheduledDeliveryDate | Bestätigtes Lieferdatum (bei Speditionen) | |
| weight | Gewicht der Sendung in kg | |
| orderNumber | Bestellnummer | ✅ |
| purchaseOrderNumber | Auftragsnummer | |
| customerNumber | Kundennummer | ✅ |
| billingCompany | Firma der Rechnungsadresse | |
| billingDepartment | Abteilung der Rechnungsadresse | |
| billingSalutation | Anrede der Rechnungsadresse | |
| billingFirstName | Vorname der Rechnungsadresse | |
| billingLastName | Nachname der Rechnungsadresse | |
| billingStreet | Straße der Rechnungsadresse | |
| billingZipCode | Postleitzahl der Rechnungsadresse | |
| billingCity | Stadt der Rechnungsadresse | |
| billingCountry | Land der Rechnungsadresse | |
| billingAddition1 | Addresszusatz 1 der Rechnungsadresse | |
| billingAddition2 | Addresszusatz 2 der Rechnungsadresse | |
| billingAddition3 | Addresszusatz 3 der Rechnungsadresse | |
| billingEmail | E-Mail Adresse der Rechnungsadresse | |
| shippingCompany | Firma der Lieferadresse | |
| shippingDepartment | Abteilung der Lieferadresse | |
| shippingSalutation | Anrede der Lieferadresse | |
| shippingFirstName | Vorname der Lieferadresse | |
| shippingLastName | Nachname der Lieferadresse | ✅ |
| shippingStreet | Straße der Lieferadresse | ✅ |
| shippingZipCode | Postleitzahl der Lieferadresse | ✅ |
| shippingCity | Stadt der Lieferadresse | ✅ |
| shippingCountry | Land der Lieferadresse | ✅ |
| shippingAddition1 | Addresszusatz 1 der Lieferadresse | |
| shippingAddition2 | Addresszusatz 2 der Lieferadresse | |
| shippingAddition3 | Addresszusatz 3 der Lieferadresse | |
| shippingEmail | E-Mail Adresse der Lieferadresse | ✅ |
| languageCode | languageCode Zweistelliger ISO-Code der Sprache (de, en) | |
| return | Handelt es sich um eine Retoure? Retoure = 1, keine Retoure = 0 |
API
Über eine Schnittstelle (PAQATO API) zum Shopsystem bzw. ERP- oder Warenwirtschaftssystem werden die Auftragskopfdaten und Trackingcodes automatisiert transferiert. Die Anbindung an das Shopsystem bzw. die Warenwirtschaft kann flexibel über die PAQATO API erfolgen.
Hinweis: Bei vielen API-Partnern sprechen wir direkt deren Schnittstelle an, um die relevanten Daten zu übermitteln.
BCC-E-Mail
Schicke uns deine Versandbestätigungen einfach in BCC. Die relevanten Daten kann PAQATO durch eingesetzte SPAN-Elemente verarbeiten und deine Aufträge werden mit den Statusinformationen zusammengefügt.
Hinweis: Bei vielen API-Partnern sprechen wir direkt deren Schnittstelle an, um die relevanten Daten zu übermitteln.
Beispiel:
Paketdaten-Import per Versandbestätigungs-E-Mail mit SPAN-Elementen versehen:
Pflicht:
<span id=“paqato-carrier“>
DHL
</span>
<span id=“paqato-trackingCode“>
1234567890
</span>
<span id=“paqato-shop“>
SHOP1
</span>
<span id=“paqato-orderNumber“>
12345-6789
</span>
<span id=“paqato-customerNumber“>
12345-6789
</span>
<span id=“paqato-company“>
Mustermann GmbH
</span>
<span id=“paqato-department“>
Managament
</span>
<span id=“paqato-salutation“>
Herr
</span>
<span id=“paqato-prename“>
Max
</span>
<span id=“paqato-surname“>
Mustermann
</span>
<span id=“paqato-street“>
Mustergasse 1a
</span>
<span id=“paqato-zipCode“>
54321
</span>
<span id=“paqato-city“>
Musterstadt
</span>
<span id=“paqato-country“>
DE
</span>
<span id=“paqato-language“>
de
</span>
<span id=“paqato-email“>
mm@example.com
</span>
<span id=“paqato-addition1“>
Obergeschoss
</span>
<span id=“paqato-addition1“>
Hinten links
</span>Optional:
<span id=“paqato-billing-company“>
Mustermann GmbH
</span>
<span id=“paqato-billing-department“>
Managament
</span>
<span id=“paqato-billing-salutation“>
Herr
</span>
<span id=“paqato-billing-prename“>
Max
</span>
<span id=“paqato-billing-surname“>
Mustermann
</span>
<span id=“paqato-billing-street“>
Mustergasse 1a
</span>
<span id=“paqato-billing-zipCode“>
54321
</span>
<span id=“paqato-billing-city“>
Musterstadt
</span>
<span id=“paqato-billing-country“>
DE
</span>
<span id=“paqato-billing-language“>
de
</span>
<span id=“paqato-billing-email“>
mm@example.com
</span>
<span id=“paqato-billing-addition1“>
Obergeschoss
</span>
<span id=“paqato-billing-addition1“>
Hinten links
</span>Natürlich kannst du uns auch noch weitere Informationen per SPAN-Element übergeben.
Sprich uns einfach an.