Boxpi API

Globe Pickup Points integriert sich mit Boxpi, einem grenzüberschreitenden Logistik-Aggregator. Eine einzige API-Verbindung gibt Ihnen Zugriff auf mehr als 60 Spediteurdienste in 16 europäischen Märkten, ohne einen separaten Vertrag mit jedem nationalen Spediteur. Mit dieser Integration können Sie:

Bestellungen direkt aus Shopify an Boxpi exportieren
Versandlabels direkt in Shopify drucken
An Paketschließfächer, Paketshops und Postfilialen oder an die Adresse des Kunden liefern
Nachnahme (COD) nutzen
Lieferstatus zurück nach Shopify synchronisieren

Boxpi 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 Boxpi.
Geben Sie Ihren API-Schlüssel ein — wenden Sie sich an den Boxpi-Kundenservice, um ihn zu erhalten. Live- und Testumgebung verwenden unterschiedliche API-Schlüssel.
Wählen Sie die Umgebung — Produktion für Live-Sendungen, Entwicklung zum Testen gegen die Test-API von Boxpi. Der API-Schlüssel muss zur gewählten Umgebung gehören.
Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen (Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren, Benutzerdefiniertes Tag nach dem Export, Standardgewicht (kg)).
Ordnen Sie Ihre Shopify-Versandmethoden den Boxpi-Services zu, die Sie verwenden möchten.

Bestellungen exportieren und Labels drucken

Sie können Bestellungen direkt aus Shopify an Boxpi exportieren und Versandlabels drucken — einzeln oder im Stapel. Den allgemeinen Workflow finden Sie unter Versandlabels erstellen.

Jede Bestellung wird als ein Boxpi-Paket registriert. Die Registrierung beim Endspediteur erfolgt asynchron — Globe wartet einige Sekunden auf die Zuweisung des Tracking-Codes. Ist er noch nicht eingetroffen, ist der Export trotzdem erfolgreich und die Boxpi-Paket-ID wird zwischenzeitlich verwendet; die Lieferstatusprüfung ersetzt sie durch die echte Sendungsnummer des Endspediteurs, sobald diese vorliegt.

Boxpi verlangt für jede Sendung eine Telefonnummer des Empfängers. Bestellungen ohne Telefonnummer werden vor dem Versand abgelehnt.

Spediteurdienste

Boxpi ist ein Aggregator — der Endspediteur wird pro Bestellung durch den Service bestimmt, dem Sie die Versandmethode zuordnen. Service-IDs folgen dem Muster CARRIER-SERVICE-COUNTRY, zum Beispiel GLS-COURIER-SK, PACKETA-POINT-CZ oder SPS-POSTOFFICE-SK. Der mittlere Teil gibt an, wie das Paket zugestellt wird:

Service	Zustellung
COURIER	An die Adresse des Kunden
POINT	An einen Paketshop oder ein Paketschließfach
POSTOFFICE	An eine Postfiliale

62 Services stehen in Österreich, Belgien, Bulgarien, Kroatien, Tschechien, Frankreich, Deutschland, Griechenland, Ungarn, Italien, Luxemburg, den Niederlanden, Polen, Rumänien, der Slowakei und Slowenien zur Verfügung — darunter GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT sowie die österreichische und die slowakische Post.

Abholpunkte vs. Heimlieferung

POINT- / POSTOFFICE-Services — Das Ziel wird ausschließlich über den im Checkout ausgewählten Abholpunkt adressiert; die Felder der Straßenadresse werden ignoriert. Enthält die Bestellung keinen Abholpunkt, wird der Export abgelehnt.
COURIER-Services — Straße, Stadt und PLZ sind erforderlich. Die zweite Adresszeile wird als Hausnummer übermittelt, wenn sie höchstens 10 Zeichen lang ist, andernfalls wird sie an die Straße angehängt. Die Provinz/Region aus der Bestellung wird als Landesgebiet übergeben, was rumänische und bulgarische Kuriere benötigen.

Boxpi validiert den Abholpunkt gegen seine eigenen Punktlisten. Punkt-IDs aus einer direkten Spediteur-Integration stimmen nicht zuverlässig mit den Boxpi-IDs überein, daher müssen Versandmethoden, die über Boxpi exportiert werden, die Boxpi-Abholpunkte in der Checkout-Auswahl verwenden — siehe Abholpunkt-Spediteure hinzufügen.

Nachnahme (COD)

Boxpi unterstützt Nachnahme. Der Betrag wird aus der Bestellung übernommen und in der Bestellwährung übermittelt — CZK und HUF werden auf ganze Einheiten gerundet, andere Währungen auf zwei Nachkommastellen. Der numerische Teil des Bestellnamens wird als Variabilsymbol für die Nachnahme verwendet.

Boxpi validiert die Währung gegen den gewählten Service. Ist Nachnahme in dieser Währung für den zugeordneten Spediteur nicht zulässig, wird der Export abgelehnt und die Fehlermeldung von Boxpi auf der Bestellung angezeigt.

Aktivieren Sie Automatisch Lieferstatus in Shopify aktualisieren und anschließend Automatisch Zahlung auf Vorauszahlung markieren, damit Nachnahmebestellungen in Shopify als bezahlt markiert werden, sobald das Paket zugestellt wurde.

Lieferstatus

Boxpi ist einer der Spediteure, für die die Lieferstatus-Synchronisation verfügbar ist. Ist Automatisch Lieferstatus in Shopify aktualisieren aktiviert, fragt Globe Boxpi regelmäßig ab und hält den Shopify-Fulfillment-Status synchron, sodass Sie Bestellungen in der Shopify-Verwaltung nach Status filtern können:

Status in Shopify	Beschreibung
Sendungsverfolgung hinzugefügt	Bei Boxpi oder beim Spediteur registriert, aber noch nicht physisch übergeben.
Unterwegs	Im Boxpi-Lager oder beim Spediteur eingegangen und auf dem Weg.
Wird zugestellt	In Zustellung an die Heimadresse oder zur Abholung am Punkt bereit.
Zustellung fehlgeschlagen	Vom Spediteur abgelehnt, storniert, verloren, auf dem Rückweg oder zurückgeschickt.
Zugestellt	Zugestellt oder zugestellt mit eingezogener Nachnahme.

Die optionale Einstellung Bestellung erst erfüllen, wenn der Carrier das Paket erhalten hat verschiebt das Shopify-Fulfillment, bis Boxpi bestätigt, dass das Paket den Spediteur physisch erreicht hat, statt es beim Export anzulegen.

Labeldruck

Boxpi-Labels werden als PDF erzeugt und können in den folgenden Formaten gedruckt werden:

Format	Positionen pro Bogen
A6	1
A4	4 (2×2 auf einem einzelnen A4-Bogen)

Beim Druck auf A4 können Sie eine Startposition wählen (Positionen 1–4), um teilweise verbrauchte Labelbögen weiterzuverwenden.

Labels werden auf Boxpi-Seite asynchron erzeugt, ein Label existiert also erst, sobald das Paket beim Spediteur registriert ist. Wenn Sie unmittelbar nach dem Export drucken, wiederholt Globe den Abruf einige Sekunden lang automatisch.

Retourenlabels werden von dieser Integration nicht unterstützt — Rücksendungen müssen im Boxpi-Portal veranlasst werden.

Fehlerbehebung

Problem	Lösung
Boxpi-Authentifizierung fehlgeschlagen	Prüfen Sie den API-Schlüssel und stellen Sie sicher, dass er zur gewählten Umgebung passt — Live- und Testschlüssel sind unterschiedlich.
`Invalid Boxpi carrier ID`	Die Versandmethode ist einem Wert zugeordnet, der kein Boxpi-Service ist. Ordnen Sie sie einem `CARRIER-SERVICE-COUNTRY`-Service neu zu.
`Pickup point must be selected for pickup point delivery`	Die Bestellung nutzt einen POINT- oder POSTOFFICE-Service, enthält aber keinen Abholpunkt. Prüfen Sie, ob der Kunde im Checkout einen ausgewählt hat.
`Recipient phone number is missing`	Boxpi verlangt für jede Sendung eine Telefonnummer. Ergänzen Sie sie auf der Bestellung, bevor Sie exportieren.
`Missing required address fields`	Kurierdienste benötigen Straße, Stadt und PLZ. Vervollständigen Sie die Versandadresse und exportieren Sie erneut.
Paket vom Spediteur abgelehnt	Der Endspediteur hat die Sendung abgelehnt — Globe zeigt dessen eigene Fehlermeldung an. Korrigieren Sie die Daten und exportieren Sie die Bestellung erneut.
Label nicht rechtzeitig bereit	Die Registrierung beim Spediteur läuft noch. Warten Sie einen Moment und drucken Sie erneut.
Abholpunkt nicht akzeptiert	Die Punkt-ID existiert in der Boxpi-Liste für diesen Spediteur nicht. Stellen Sie sicher, dass der Checkout für diese Versandmethode Boxpi-Abholpunkte anbietet.

Add Boxpi pickup points to your Shopify store — pricing, demo & setup →