One by Allegro API

Globe Pickup Points integriert sich mit One by Allegro (früher WEDO), einem tschechischen Spediteur, der über die OneDelivery 3.0 API an Paketboxen, Intime-Abholpunkte und Heimadressen zustellt. Mit dieser Integration können Sie:

Bestellungen direkt aus Shopify an One by Allegro exportieren
Versandlabels direkt in Shopify drucken
An eine Paketbox, einen Abholpunkt oder an die Adresse des Kunden liefern
Nachnahme einziehen

One by Allegro API-Integration aktivieren

Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Fügen Sie ein neues Spediteurkonto hinzu und wählen Sie One by Allegro.
Geben Sie Ihre Token-ID und Ihr API-Passwort ein. Beides finden Sie in der One by Allegro Kundenzone unter den API-Einstellungen. Falls Sie diese nicht haben, kontaktieren Sie den One by Allegro Support (eshop-onecz@allegro.com).
Klicken Sie auf Verbindung testen, um vor dem Speichern zu bestätigen, dass die Zugangsdaten akzeptiert werden.
Füllen Sie die Absenderadresse aus — Absender — Firmenname, Absender — Straße, Absender — Hausnummer, Absender — Stadt und Absender — PLZ. Die Absenderadresse wird auf jedes Label gedruckt und für die Paketabholung verwendet; sie wird mit jeder Sendung übermittelt (One by Allegro greift nicht auf eine in Ihrem Konto hinterlegte Standardadresse zurück). Die Integration übermittelt als Absenderland immer Tschechien.
Füllen Sie Standardlänge des Pakets in Millimetern, Standardbreite des Pakets in Millimetern und Standardhöhe des Pakets in Millimetern aus. Diese Angaben sind Pflicht — One by Allegro lehnt Sendungen ohne Paketabmessungen ab.
Optional können Sie ein Standardgewicht (kg) festlegen, das verwendet wird, wenn ein Produkt in Shopify kein Gewicht hat.
Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen.
Ordnen Sie Ihre Shopify-Versandmethoden One by Allegro zu.

Bestellungen exportieren und Labels drucken

Sie können Bestellungen direkt aus Shopify an One by Allegro exportieren und Versandlabels drucken — einzeln oder im Stapel. Den vollständigen Workflow finden Sie unter Versandlabels erstellen.

Jede exportierte Bestellung wird zu einer Sendung mit einem einzigen Paket. Die zurückgegebene Paketnummer dient als Sendungsnummer, und der Tracking-Link verweist auf die Sendungsverfolgungsseite von One by Allegro. Ist die automatische Erfüllung aktiviert, wird die Shopify-Bestellung mit der Sendungsnummer und dem Spediteurnamen One by Allegro erfüllt.

Die API akzeptiert in den Feldern für Paketbeschreibung und Referenz nur Buchstaben, Ziffern, Leerzeichen, Kommas und Punkte. Globe bereinigt diese automatisch — die Beschreibung lautet Order <Bestellname>, und der Bestellname wird als Referenznummer 1 verwendet, gekürzt auf 20 Zeichen.

Zustellarten

One by Allegro ermittelt die Zustellart beim Export aus dem von Ihnen gewählten Produkttyp. Der Standardwert ist AUTO, den die meisten Händler beibehalten sollten.

Produkttyp	Verhalten
AUTO	Verwendet den im Checkout ausgewählten One by Allegro-Abholpunkt — eine Paketbox wird zu BOX, eine Filiale zu PUDO. Enthält die Bestellung keinen One by Allegro-Punkt, wird das Paket an die Lieferadresse gesendet.
TO_DOOR	Zustellung an die Adresse des Kunden. Ein ausgewählter Abholpunkt wird ignoriert.
BOX	Zustellung an eine One Box-Paketbox. Erfordert einen One by Allegro-Punkt auf der Bestellung.
PUDO	Zustellung an einen personalbesetzten Abholpunkt (Intime-Filiale). Erfordert einen One by Allegro-Punkt auf der Bestellung.

Wenn Sie BOX oder PUDO ausdrücklich wählen und die Bestellung keinen One by Allegro-Abholpunkt enthält, wird der Export für diese Bestellung abgelehnt. Die Punktcodes stammen aus dem Abholpunkt, den der Kunde in der Globe-Auswahl gewählt hat — siehe Abholpunkt-Spediteure hinzufügen.

Alle Sendungen werden mit dem Service Standard exportiert. Tschechische und slowakische Empfängertelefonnummern werden automatisch in das internationale Format (+420 / +421) umgewandelt, damit die SMS-Benachrichtigungen des Spediteurs versendet werden können.

Paketgewicht und -abmessungen

One by Allegro lehnt Sendungen ohne Paketabmessungen ab, daher sind die Standardwerte in den Einstellungen des Spediteurkontos verpflichtend und nicht optional.

Gewicht — wird aus der Shopify-Bestellung übernommen. Hat die Bestellung kein Gewicht, wird das Standardgewicht (kg) aus den Einstellungen des Spediteurkontos verwendet. Ist beides nicht verfügbar, schlägt der Export für diese Bestellung fehl.
Abmessungen — werden immer aus den Feldern Standardlänge / -breite / -höhe des Pakets in Millimetern übernommen. Ist eines davon leer oder null, schlägt der Export mit einer Meldung fehl, die Sie zum Ausfüllen auffordert.

Nachnahme (COD)

One by Allegro unterstützt Nachnahme. Wenn eine Bestellung eine Nachnahme-Zahlungsmethode verwendet, wird der Nachnahmebetrag aus der Bestellung übernommen und in der Bestellwährung zusammen mit der Sendung übermittelt. In den Einstellungen des Spediteurkontos gibt es kein separates Bankkontofeld — die Auszahlungen laufen über Ihren One by Allegro-Vertrag.

Lieferstatus

Die Lieferstatus-Synchronisation ist nicht verfügbar. One by Allegro ist nicht Teil der Lieferstatus-Synchronisation von Globe, Paketstatus werden also nicht nach Shopify zurückgeschrieben. Die Sendungsnummer und der Tracking-Link werden dem Fulfillment trotzdem beigefügt, sodass Kunden das Paket auf der Sendungsverfolgungsseite des Spediteurs verfolgen können.

Labeldruck

One by Allegro liefert die Labels als ein einzelnes PDF für den gesamten gedruckten Stapel, in einem von zwei Formaten:

Format	Beschreibung
PDF_A6	Ein Label pro Seite (Standard)
PDF_A4	Ein Label pro A4-Seite

Die OneDelivery API unterstützt den Druck ab einer gewählten Position auf einem Bogen nicht, teilweise verbrauchte Labelbögen können mit diesem Spediteur daher nicht weiterverwendet werden.

Retouren und Stornierung

Retourenlabels werden über diese Integration nicht unterstützt.
Sendungen können nicht storniert werden. Die OneDelivery API hat keinen Endpunkt zum Stornieren oder Löschen. Sobald eine Bestellung exportiert wurde, bleibt die Sendung in Ihrem One by Allegro-Konto — übergeben Sie das Paket einfach nicht, oder klären Sie den Fall im One by Allegro-Portal.

Fehlerbehebung

Problem	Lösung
`Failed to authenticate with One by Allegro`	Prüfen Sie Token-ID und API-Passwort in den Einstellungen des Spediteurkontos und nutzen Sie Verbindung testen. Eine 401-Antwort bedeutet, dass die Zugangsdaten ungültig sind.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	Der Produkttyp ist auf BOX oder PUDO gesetzt, die Bestellung enthält aber keinen One by Allegro-Abholpunkt. Verwenden Sie AUTO oder TO_DOOR, oder prüfen Sie, ob der Kunde im Checkout einen One by Allegro-Punkt ausgewählt hat.
`Order … has no weight`	Hinterlegen Sie das Produktgewicht in Shopify, geben Sie das Gewicht beim Export manuell ein oder füllen Sie Standardgewicht (kg) aus.
`default package dimensions are not set`	Füllen Sie Standardlänge, -breite und -höhe (in Millimetern) in den One by Allegro-Einstellungen aus — die API verlangt sie bei jeder Sendung.
Empfänger erhält keine Spediteur-Benachrichtigungen	Nur tschechische und slowakische Nummern erhalten automatisch eine Ländervorwahl. Hinterlegen Sie Telefonnummern für andere Länder in vollständigem internationalem Format auf der Bestellung.
`One by Allegro did not return a PDF label`	Die API hat etwas anderes als ein PDF zurückgegeben. Versuchen Sie den Druck erneut; schlägt er weiterhin fehl, wenden Sie sich mit der Sendungsnummer an den One by Allegro Support.
Bestellung versehentlich exportiert	Sendungen können über die API nicht gelöscht werden. Übergeben Sie das Paket nicht und klären Sie die Sendung im One by Allegro-Portal.

Add One by Allegro pickup points to your Shopify store — pricing, demo & setup →