Zum Inhalt springen

InPost API

Globe Pickup Points lässt sich über die ShipX API mit InPost Poland verbinden. Mit dieser Integration können Sie:

  • Bestellungen direkt aus Shopify an InPost exportieren
  • Versandlabels direkt in Shopify drucken
  • An Paczkomat-Automaten und PaczkoPunkt-Punkte von InPost in Polen liefern
  • Mit InPost Kurier an Adressen in Polen liefern, auch per Express bis 10:00, 12:00 oder 17:00 Uhr
  • Nachnahmen in PLN einziehen
  • Pakete auf der Sendungsverfolgungsseite von InPost verfolgen

Sie benötigen ein InPost-Konto im Manager Paczek (manager.paczkomaty.pl), in dem Ihre Firmen- und Rechnungsdaten ausgefüllt sind. InPost Kurier standard und express erfordern einen Kuriervertrag mit InPost. Mit einem Prepaid-Konto verwenden Sie für Kurierpakete InPost Kurier C2C.

  1. Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Klicken Sie auf Spediteurintegration hinzufügen und wählen Sie InPost Poland.
  2. Geben Sie Ihr ShipX-API-Token und Ihre Organisations-ID ein. Das Token erzeugen Sie im Manager Paczek unter Moje konto → API. Die Organisations-ID ist die Nummer, die neben dem Token angezeigt wird.
  3. Wählen Sie die Umgebung: Produktion für echte Pakete oder Entwicklung mit einem Token aus der InPost-Sandbox (sandbox-manager.paczkomaty.pl).
  4. Wählen Sie unter Wie InPost Ihre Pakete bekommt, wie Sie die Pakete übergeben:
    • Abholung durch den Kurier an meiner Adresse: Ein InPost-Kurier holt die Pakete ab, bei einer regelmäßigen Abholung, die Sie mit InPost vereinbart haben, oder bei einer Abholung, die Sie im Manager Paczek beauftragen.
    • Ich gebe sie an einem beliebigen Paczkomat oder PaczkoPunkt ab
    • Ich gebe sie an einem PaczkoPunkt ab
    • Ich bringe sie in eine InPost-Filiale
  5. Wählen Sie die Paketgröße für Paczkomat-Pakete und InPost Kurier C2C. Siehe Paketgrößen.
  6. Wählen Sie den Kurierdienst für Bestellungen ohne Paczkomat: InPost Kurier standard (Kuriervertrag) oder InPost Kurier C2C (Prepaid-Konto). Das AUTO-Produkt verwendet ihn für Bestellungen ohne InPost-Punkt.
  7. Tragen Sie Standardlänge des Pakets in Millimetern, Standardbreite des Pakets in Millimetern und Standardhöhe des Pakets in Millimetern ein. InPost Kurier standard und express brauchen die Paketmaße.
  8. Füllen Sie die Absenderdaten aus, oder lassen Sie alle Felder leer, damit die Daten Ihres InPost-Kontos gedruckt werden (Manager Paczek, Moje konto → Dane). Wenn Sie die Felder ausfüllen, dann alle: Firmenname des Absenders, Name des Absenders, Straße des Absenders, Hausnummer des Absenders, Stadt des Absenders, PLZ des Absenders, Telefon des Absenders und E-Mail des Absenders. Telefon des Absenders ist eine polnische Nummer mit 9 Ziffern, mit oder ohne +48.
  9. 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. Wenn die Option aktiv ist, wird nach dem Export das Fulfillment mit der InPost-Sendungsnummer, InPost als Spediteur und einem Link zur Sendungsverfolgungsseite angelegt.
    • Bestellungen automatisch mit Sendungsverfolgungsnummer markieren fügt die Sendungsnummer als Tag zur Bestellung hinzu.
    • Benutzerdefiniertes Tag nach dem Export fügt nach jedem erfolgreichen Export Ihr eigenes Tag hinzu.

Produkt in GlobeZustellung
InPost (Paczkomat if selected, otherwise courier to the address)An den InPost-Punkt, den der Kunde im Checkout gewählt hat, andernfalls mit dem Kurierdienst aus den Einstellungen an die Adresse
InPost Paczkomat or PaczkoPunkt (pickup point)An den im Checkout gewählten InPost-Punkt
InPost Kurier standard (address)Per Kurier an die Adresse, Kuriervertrag erforderlich
InPost Kurier C2C (address, prepaid account)Per Kurier an die Adresse
InPost Kurier express by 10:00, 12:00 or 17:00 (address)Per Expresskurier an die Adresse, Kuriervertrag erforderlich

InPost schaltet Dienste pro Konto frei. Ist ein Dienst für Ihr Konto nicht freigeschaltet, meldet Globe das, bevor etwas gesendet wird. Bitten Sie InPost, den Dienst freizuschalten, oder wählen Sie ein anderes Produkt.

Kurierdienste können nicht an einem beliebigen Paczkomat oder PaczkoPunkt übergeben werden, und InPost Kurier C2C kann nicht in einer InPost-Filiale übergeben werden. Die Abholung durch den Kurier und PaczkoPunkt funktionieren für jeden Dienst.


Sie können Bestellungen direkt aus Shopify an InPost exportieren und Versandlabels drucken, einzeln oder im Stapel. Zum Label-Workflow selbst siehe Versandlabels erstellen.

Der Export einer Bestellung erstellt eine InPost-Sendung. InPost bestätigt die Sendung innerhalb weniger Sekunden und vergibt die Sendungsnummer. Die Sendungsverfolgung läuft über https://inpost.pl/sledzenie-przesylek?number=<tracking number>. Die Shopify-Bestellnummer wird als Referenz auf jedes Label gedruckt.

Bestätigt InPost eine Sendung nicht rechtzeitig, storniert Globe sie, und es wird nichts versendet. Eine bestätigte Sendung lässt sich über die API nicht mehr stornieren.

Labels werden bei jedem Druck von InPost heruntergeladen, sodass Sie ein Label später erneut drucken können.

Die Integration überträgt keine Zustellstatus zurück an Shopify.


Paczkomat-Pakete und InPost Kurier C2C werden nach Größe gebucht, bis 25 kg:

GrößeBezeichnung in Globe
AKlein (A, 8 × 38 × 64 cm)
BMittel (B, 19 × 38 × 64 cm)
CGroß (C, 41 × 38 × 64 cm)
DExtra groß (D, 50 × 50 × 80 cm, nur InPost Kurier C2C)

InPost rechnet nach Größe ab, und das Paket muss in das Fach des Automaten passen. InPost Kurier standard und express verwenden stattdessen die Standardmaße in Millimetern und nehmen Pakete bis 50 kg an. Globe prüft das Sendungsgewicht vor dem Export.


Globe übermittelt den Namen des InPost-Punkts, zum Beispiel KRA010 für einen Paczkomat oder POP-WAW364 für einen PaczkoPunkt. InPost liefert nur an Punkte in Polen. Der Kunde wählt den Punkt im Checkout. Wie Sie InPost-Punkte anbieten, lesen Sie unter Abholpunkt-Spediteure hinzufügen. Die InPost-Automaten von Packeta in Polen werden ebenfalls akzeptiert.

Eine Bestellung mit einem Punkt aus dem Netz eines anderen Spediteurs wird nicht exportiert. Wählen Sie mit der Aktion Abholpunkt ändern einen InPost-Punkt oder verwenden Sie ein Kurierprodukt.

InPost sendet den Abholcode an die E-Mail-Adresse und die Telefonnummer des Kunden. Bestellungen an einen Punkt brauchen daher beides. Die Telefonnummer kann polnisch sein oder ausländisch mit Ländervorwahl, zum Beispiel +420 777 123 456.


InPost zieht Nachnahmen nur in PLN ein. Globe versieht jede Nachnahmesendung mit einer Versicherung mindestens in Höhe des Nachnahmebetrags, wie InPost es verlangt. Eine Bestellung in einer anderen Währung wird nicht exportiert: Versenden Sie sie mit einem anderen Spediteur oder setzen Sie den Nachnahmebetrag im Label-Panel auf 0, wenn die Bestellung bereits bezahlt ist.


InPost-Labels können in den folgenden Formaten gedruckt werden:

FormatEtiketten
A6 (10x15 cm)Ein Label pro Seite
A4Paczkomat-Labels auf A4-Bögen, bis zu vier pro Bogen. Kurierlabels bleiben im Format A6

Labels für mehrere Bestellungen werden in einem PDF zusammengefasst. Liefert InPost einige Labels nicht, druckt Globe die übrigen und teilt Ihnen mit, welche Sendungen fehlen.


ProblemLösung
InPost settings are incompleteDie Meldung nennt die fehlenden Einstellungen. Füllen Sie sie in den Einstellungen des Spediteurkontos aus.
InPost rejected the API tokenPrüfen Sie das ShipX-API-Token in den Einstellungen des Spediteurkontos. Es ist das Token aus dem Manager Paczek (Moje konto → API).
InPost did not accept organization … for this API tokenPrüfen Sie die Organisations-ID. Sie wird im Manager Paczek neben dem Token angezeigt.
… is not enabled on your InPost accountBitten Sie InPost, den Dienst freizuschalten, oder wählen Sie ein anderes InPost-Produkt.
InPost Kurier standard and express need an InPost courier contractWählen Sie mit einem Prepaid-Konto InPost Kurier C2C.
… parcels cannot be handed over at …Wählen Sie eine andere Option unter Wie InPost Ihre Pakete bekommt oder ein anderes InPost-Produkt. Siehe Produkte.
Order … has no InPost Paczkomat or PaczkoPunktDie Bestellung hat keinen InPost-Punkt, oder ihr Punkt gehört zum Netz eines anderen Spediteurs. Wählen Sie mit der Aktion Abholpunkt ändern einen InPost-Punkt oder verwenden Sie ein Kurierprodukt.
InPost Poland delivers within Poland onlyInPost Poland liefert nur an Adressen und Punkte in Polen. Versenden Sie die Bestellung mit einem anderen Spediteur.
InPost cannot use the receiver's phone number …InPost akzeptiert eine polnische Nummer (9 Ziffern, mit oder ohne +48) oder eine Nummer mit Ländervorwahl aus den Ländern, die InPost angibt, zum Beispiel +420 777 123 456. Korrigieren Sie die Telefonnummer in der Lieferadresse der Bestellung und erstellen Sie das Label erneut.
Order … has no e-mail addressInPost sendet den Abholcode an die E-Mail-Adresse und die Telefonnummer des Kunden. Ergänzen Sie die E-Mail-Adresse in der Bestellung.
InPost Kurier needs street, house number, postcode and cityKorrigieren Sie die Adresse in Shopify und erstellen Sie das Label erneut.
… needs the parcel dimensionsLegen Sie in den Einstellungen des Spediteurkontos Standardlänge des Pakets in Millimetern, Standardbreite des Pakets in Millimetern und Standardhöhe des Pakets in Millimetern fest.
Order … weighs … kgIst das Gewicht falsch, korrigieren Sie das Sendungsgewicht (kg) im Label-Panel. Andernfalls verwenden Sie ein anderes Produkt oder einen anderen Spediteur.
InPost collects cash on delivery only in PLNVersenden Sie die Bestellung mit einem anderen Spediteur oder setzen Sie den Nachnahmebetrag auf 0, wenn die Bestellung bereits bezahlt ist.
InPost does not accept new shipments for this account (debt collection)Bezahlen Sie die letzte InPost-Rechnung oder laden Sie ein Prepaid-Konto im Manager Paczek auf.
InPost did not confirm the shipment … so Globe cancelled itEs wurde nichts versendet. Erstellen Sie das Label in einigen Minuten erneut.
… Check … before creating the label againInPost hat die Sendung nicht rechtzeitig bestätigt, oder Globe konnte die Antwort nicht lesen. Die Sendung existiert aber möglicherweise. Prüfen Sie den Manager Paczek, bevor Sie die Bestellung erneut exportieren.
Im PDF fehlt ein LabelGlobe druckt die übrigen Labels und listet die fehlenden Sendungen auf. Drucken Sie später erneut oder laden Sie das Label im Manager Paczek herunter.