Speedy API
Globe Pickup Points lässt sich mit Speedy verbinden, dem bulgarischen Paketdienst, der das DPD-Netz in Bulgarien betreibt. Mit dieser Integration können Sie:
- Bestellungen direkt aus Shopify an Speedy exportieren
- Versandlabels direkt in Shopify drucken
- Innerhalb Bulgariens an die Adresse des Kunden, eine Speedy-Filiale oder einen Speedy-Paketautomaten versenden
- Nachnahmepakete in EUR versenden, auch an Filialen und Paketautomaten
Speedy-API-Integration aktivieren
Abschnitt betitelt „Speedy-API-Integration aktivieren“- Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Klicken Sie auf Spediteurintegration hinzufügen und wählen Sie Speedy.
- Geben Sie Benutzername und Passwort Ihres Speedy-API-Zugangs ein. Speedy vergibt sie an Vertragskunden. Fragen Sie Ihren Kundenbetreuer bei Speedy danach.
- Wählen Sie unter Speedy-Service den Service aus Ihrem Speedy-Vertrag: Standard 24 Stunden (505) oder Standard 24 Stunden Paket (515). Beide sind Services für Pakete innerhalb Bulgariens, und beide liefern an Adressen, Filialen und Paketautomaten.
- Wählen Sie unter Versand bezahlt von, wer Speedy für die Zustellung bezahlt: Absender (mein Speedy-Vertrag) oder Empfänger (zahlt bei Zustellung).
- Wenn Sie Pakete zu einer Speedy-Filiale oder einem Paketautomaten bringen, tragen Sie die ID unter Speedy-Filiale, in der Sie Pakete abgeben ein (zum Beispiel
77). Wenn ein Kurier sie an Ihrer Adresse abholt, lassen Sie das Feld leer. - Klicken Sie optional auf Erweiterte Einstellungen anzeigen:
- Kunden-ID des Absenders: Wenn Ihr Speedy-Vertrag mehr als eine Lieferadresse hat, tragen Sie die Kunden-ID der Adresse ein, von der aus Sie versenden. Lassen Sie das Feld leer, um von der Standardadresse Ihres Speedy-Kontos zu versenden.
- Client system ID: Lassen Sie das Feld leer, es sei denn, Speedy hat Ihnen eine Client system ID gegeben.
- Standardgewicht (kg): das Standardgewicht der Sendung in Kilogramm. Bleibt das Feld leer, wird kein Standardgewicht verwendet.
- Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen:
- Bestellungen automatisch erfüllen: Nie, Ja, senden Sie eine E-Mail mit der Sendungsverfolgungsnummer oder Ja, senden Sie keine E-Mail.
- Bestellungen automatisch mit Sendungsverfolgungsnummer markieren: fügt die Speedy-Sendungsnummer als Tag zur Bestellung hinzu.
- Benutzerdefiniertes Tag nach dem Export: ein Tag, das nach jedem erfolgreichen Label-Export zur Bestellung hinzugefügt wird.
- Ordnen Sie Ihre Shopify-Versandmethoden den Speedy-Servicetypen zu, die unter Servicetypen beschrieben sind. Für eine Abholpunkt-Versandmethode verwenden Sie Speedy (office or locker if selected, otherwise address) oder Speedy to office or locker. Verwenden Sie dafür nicht Speedy to address, sonst ginge das Paket an die Adresse des Kunden.
Speedy-Filiale, in der Sie Pakete abgeben, Kunden-ID des Absenders und Client system ID nehmen nur Ziffern an. Globe übermittelt keine Absenderadresse an Speedy. Absender ist die Standardadresse Ihres Speedy-Kontos oder die Lieferadresse, die Sie mit Kunden-ID des Absenders festlegen.
Bestellungen exportieren und Labels drucken
Abschnitt betitelt „Bestellungen exportieren und Labels drucken“Sie können Bestellungen direkt aus Shopify an Speedy exportieren und Versandlabels drucken, einzeln oder im Stapel. Zum Label-Workflow selbst siehe Versandlabels erstellen.
Globe erstellt für jede Bestellung eine Speedy-Sendung mit einem Paket. Die Speedy-Sendungsnummer ist die Sendungsverfolgungsnummer. Globe speichert sie und ruft das Label bei jedem Druck von Speedy ab, sodass Sie ein Label später erneut drucken können. Die Shopify-Bestellnummer wird auf das Label gedruckt.
Ist das automatische Fulfillment aktiviert, erhält das Fulfillment die Sendungsnummer, Speedy als Spediteur und den Tracking-Link https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.
Speedy-Labels in Globe gelten nur für Zustellungen innerhalb Bulgariens. Bevor eine Bestellung übermittelt wird, prüft Globe die Daten, die Speedy verlangt:
- Die Telefonnummer des Empfängers, bei jeder Zustellung: an eine Adresse, eine Filiale oder einen Paketautomaten. Speedy akzeptiert sie als
+359…oder beginnend mit0. Ausländische Nummern funktionieren in der Form mit+. - Den Namen des Empfängers mit mindestens 3 Zeichen. Ein Firmenname mit 3 oder mehr Zeichen macht die Firma zum Empfänger, mit dem Kunden als Kontaktperson.
- Bei Zustellung an eine Adresse: die Straße und eine Stadt oder eine vierstellige Postleitzahl. Die Stadt kann in lateinischer oder kyrillischer Schrift geschrieben sein. Straße und Adresszeile 2 dürfen zusammen höchstens 200 Zeichen haben.
Eine Bestellung, die eine Prüfung nicht besteht, wird nicht an Speedy übermittelt. Die übrigen Bestellungen des Stapels werden weiter verarbeitet.
Die Speedy-Integration überträgt keine Zustellstatus zurück an Shopify. Globe storniert keine Speedy-Sendungen. Stornieren Sie sie in Ihrem Speedy-Konto.
Servicetypen
Abschnitt betitelt „Servicetypen“Wählen Sie den Servicetyp beim Export einer Bestellung, oder ordnen Sie ihn in den Einstellungen des Spediteurkontos einer Versandmethode zu:
| Servicetyp | Wohin das Paket geht |
|---|---|
| Speedy (office or locker if selected, otherwise address) | An die Speedy-Filiale oder den Paketautomaten, den der Kunde im Checkout gewählt hat. Eine Bestellung ohne Abholpunkt geht an die Adresse des Kunden. |
| Speedy to address | Immer an die Adresse des Kunden, auch wenn die Bestellung einen Abholpunkt hat. |
| Speedy to office or locker | An die Speedy-Filiale oder den Paketautomaten aus der Bestellung. Eine Bestellung ohne Punkt wird abgelehnt. |
Mit Speedy (office or locker if selected, otherwise address) und Speedy to office or locker bricht ein Abholpunkt aus einem anderen Netz oder ein DPD-Punkt außerhalb Bulgariens den Export ab. Globe schickt eine solche Bestellung nie ersatzweise an die Adresse des Kunden. Um sie an die Adresse zu versenden, erstellen Sie das Label mit Speedy to address.
Der unter Speedy-Service gewählte Service gilt für alle drei Servicetypen.
Speedy-Filialen und Paketautomaten
Abschnitt betitelt „Speedy-Filialen und Paketautomaten“Speedy-Filialen und Paketautomaten werden beide über ihre Speedy-Filial-ID adressiert. Die Speedy-Integration akzeptiert Speedy-Punkte aus zwei Abholpunktlisten:
- DPD-Abholpunkte in Bulgarien. Jeder DPD-Punkt in Bulgarien ist eine Speedy-Filiale oder ein Speedy-Paketautomat. Die Punkt-ID ist
BG, gefolgt von der auf fünf Stellen aufgefüllten Speedy-Filial-ID:BG08009ist die Speedy-Filiale 8009. - Speedy-Filialen von Packeta (Packeta-Spediteur
BG Speedy PP). Das sind nur Speedy-Filialen, ohne Paketautomaten. Die Punkt-ID ist die Speedy-Filial-ID.
DPD-Punkte in anderen Ländern sind keine Speedy-Punkte und werden abgelehnt.
Speedy-Paketautomaten nehmen Pakete bis 20 kg an. Die Grenze einer Filiale liegt je nach Filiale zwischen 32 und 1200 kg. Schwerere Pakete lehnt Speedy ab.
Nachnahme (COD)
Abschnitt betitelt „Nachnahme (COD)“Speedy zieht Nachnahme in Bulgarien nur in EUR ein. Der Nachnahmebetrag wird aus der Bestellung übernommen, wenn sie eine Nachnahme-Zahlungsart verwendet. Nachnahme funktioniert bei Zustellungen an Adressen, Filialen und Paketautomaten.
Eine Bestellung mit Nachnahme in einer anderen Währung, auch in BGN, wird abgelehnt, bevor sie an Speedy übermittelt wird.
Labeldruck
Abschnitt betitelt „Labeldruck“Speedy-Labels sind PDF-Dateien. Die folgenden Formate stehen zur Verfügung:
| Format | Positionen pro Bogen |
|---|---|
| 10x15 cm | 1 |
| A6 on A4 | 4 (auf einem einzigen A4-Bogen) |
| A4 | 1 (das Label in der oberen Hälfte einer A4-Seite) |
Eine Startposition auf dem A4-Bogen können Sie nicht wählen. Bei 10x15 cm und A4 folgen die Labels der Reihenfolge Ihrer Auswahl. Bei A6 on A4 sortiert Speedy sie nach Sendungsnummer.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“Lehnt Speedy eine Sendung ab, wird bei Speedy nichts erstellt, und Globe zeigt die Meldung von Speedy mit einem Hinweis für die häufigen Fälle.
| Problem | Lösung |
|---|---|
| Speedy-Einstellungen sind unvollständig | Füllen Sie Benutzername und Passwort aus. Speedy-Filiale, in der Sie Pakete abgeben, Kunden-ID des Absenders und Client system ID nehmen nur Ziffern an. |
| Speedy hat Benutzername oder Passwort abgelehnt | Prüfen Sie Benutzername und Passwort in den Einstellungen der Integration. Nach diesem Fehler übermittelt Globe die übrigen Bestellungen des Stapels nicht. |
| Die Telefonnummer fehlt oder hat eine Form, die Speedy nicht annimmt | Ergänzen oder korrigieren Sie die Telefonnummer in Shopify (+359…, eine Nummer, die mit 0 beginnt, oder eine ausländische Nummer mit +) und erstellen Sie das Label erneut. |
| Speedy benötigt den Namen des Empfängers mit mindestens 3 Zeichen | Korrigieren Sie den Namen in der Lieferadresse in Shopify. |
| Die Lieferadresse liegt außerhalb Bulgariens, ist unvollständig oder zu lang | Speedy-Labels in Globe gelten nur für Adressen in Bulgarien. Die Adresse benötigt die Straße und eine Stadt oder eine vierstellige Postleitzahl. Straße und Adresszeile 2 dürfen zusammen höchstens 200 Zeichen haben, die Stadt höchstens 50. |
Invalid site | Speedy konnte Stadt und Postleitzahl nicht zuordnen, zum Beispiel weil die Postleitzahl zu einer anderen Stadt gehört. Prüfen Sie Stadt und Postleitzahl der Lieferadresse. |
| Der Abholpunkt ist keine Speedy-Filiale und kein Speedy-Paketautomat | Der Punkt gehört zu einem anderen Netz, oder es ist ein DPD-Punkt außerhalb Bulgariens. Wählen Sie mit der Aktion Abholpunkt ändern eine Speedy-Filiale oder einen Paketautomaten, oder erstellen Sie das Label mit Speedy to address, um an die Adresse des Kunden zu versenden. |
| Die Bestellung hat keine Speedy-Filiale und keinen Paketautomaten oder keine Speedy-Filial-ID | Wählen Sie die Filiale oder den Paketautomaten mit der Aktion Abholpunkt ändern, oder erstellen Sie das Label mit Speedy to address. |
| Die Filiale oder der Paketautomat ist geschlossen oder bei Speedy unbekannt | Wählen Sie mit der Aktion Abholpunkt ändern eine andere Speedy-Filiale oder einen anderen Paketautomaten. |
| Speedy zieht Nachnahme nur in EUR ein | Die Bestellung hat eine andere Währung. Siehe Nachnahme (COD). Wenn Speedy selbst die Nachnahme ablehnt, prüfen Sie den Betrag und Ihren Speedy-Vertrag. |
| „The price cannot be determined for provided shipment parameters“ | Ihr Speedy-Vertrag hat keinen Preis für diesen Service und Zahler. Ändern Sie Speedy-Service oder Versand bezahlt von in den Einstellungen der Integration. |
| Die Bestellung hat kein Gewicht | Hinterlegen Sie das Produktgewicht in Shopify, geben Sie das Gewicht beim Erstellen des Labels ein, oder füllen Sie Standardgewicht (kg) aus. |
| Speedy begrenzt die Anfragen, oder Globe konnte keine Verbindung zu Speedy herstellen | Es wurde nichts erstellt. Versuchen Sie es in einer Minute erneut. |
| Speedy hat nicht rechtzeitig geantwortet, die Verbindung ist abgebrochen, oder Speedy hat die Sendung nicht bestätigt | Die Sendung existiert möglicherweise bereits. Prüfen Sie Ihr Speedy-Konto, bevor Sie das Label erneut erstellen. |
| Globe hat angehalten, bevor eine Bestellung an Speedy übermittelt wurde | Eine frühere Bestellung des Stapels hatte kein eindeutiges Ergebnis, oder Globe konnte ihre Sendung nicht speichern. Für diese Bestellung wurde nichts erstellt, Sie können ihr Label also erneut erstellen. |
| Speedy hat die Sendung erstellt, aber Globe konnte sie nicht speichern | Erstellen Sie das Label nicht erneut, sonst würde Speedy eine zweite Sendung anlegen. Drucken oder stornieren Sie die in der Meldung genannte Sendung in Ihrem Speedy-Konto. |
| „Printed X of Y Speedy labels“ oder „Error printing Speedy labels“ | Die Meldung nennt die fehlenden Sendungsnummern und den Grund, zum Beispiel eine Sendungsnummer, die Speedy nicht kennt. Liegt es an der Verbindung, drucken Sie erneut. |