Zum Inhalt springen

Hrvatska pošta API

Globe Pickup Points lässt sich über die HP Shipping Service API mit Hrvatska pošta, dem kroatischen Postbetreiber, verbinden. Mit dieser Integration können Sie:

  • Bestellungen direkt aus Shopify an Hrvatska pošta exportieren
  • Versandlabels direkt in Shopify im Format A6 oder A6 on A4 drucken
  • Paket-24-Sendungen an Postfilialen, Paketautomaten (paketomati) oder die Adresse des Kunden versenden
  • Nachnahme in EUR einziehen
  • Pakete auf der Sendungsverfolgungsseite von Hrvatska pošta verfolgen

Die Integration deckt nur Pakete innerhalb Kroatiens ab.


  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 Hrvatska pošta.
  2. Geben Sie Benutzername und Passwort ein. Das sind die API-Zugangsdaten, die Hrvatska pošta an Vertragskunden vergibt. Fragen Sie Ihren Kundenbetreuer bei Hrvatska pošta danach oder schreiben Sie an npa-3pdx@posta.hr.
  3. Lassen Sie die Umgebung auf Produktion stehen. Entwicklung verbindet Globe mit dem Testsystem von Hrvatska pošta.
  4. Wählen Sie den Dienst: Paket 24 D+1, Paket 24 D+2 oder Paket 24 D+3. Er gilt für jedes Paket. D+1 stellt am nächsten Werktag zu.
  5. Wählen Sie unter Wie Sie Pakete an HP übergeben:
    • Ein HP-Kurier holt sie an meiner Adresse ab (vorausgewählt): Ein Kurier von Hrvatska pošta holt die Pakete an der Absenderadresse ab. Übergibt niemand die Pakete, schließt Hrvatska pošta die Sendung. Wählen Sie diese Option nicht, wenn Sie die Pakete selbst zu Hrvatska pošta bringen.
    • Ich gebe sie in einer Postfiliale ab: Tragen Sie die Postleitzahl der Postfiliale in Postfiliale oder Paketautomat für die Abgabe ein.
    • Ich gebe sie an einem Paketautomaten ab: Tragen Sie den 5-stelligen Code des Paketautomaten in Postfiliale oder Paketautomat für die Abgabe ein. An einem Paketautomaten abgegebene Pakete können nur an eine Postfiliale oder einen Paketautomaten gehen, nicht an eine Adresse, und dürfen höchstens 30 kg wiegen.
  6. Füllen Sie die Absenderdaten aus. Firmenname des Absenders (wird auf jedem Label als Absender gedruckt), Straße des Absenders, Stadt des Absenders, PLZ des Absenders (5 Ziffern) und Telefon des Absenders sind erforderlich. Hausnummer des Absenders und E-Mail des Absenders sind optional. Die Hausnummer können Sie auch unter Straße des Absenders eintragen.
  7. Klicken Sie auf Erweiterte Einstellungen anzeigen, um Folgendes festzulegen:
    • Fachgröße im Paketautomaten: die Fachgröße, die für Pakete angegeben wird, die an einen Paketautomaten gehen oder die Sie an einem abgeben: XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) oder L (39 x 38 x 64 cm). M ist vorausgewählt.
    • Standardgewicht (kg): wird verwendet, wenn eine Bestellung kein Gewicht hat.
  8. Konfigurieren Sie Fulfillment und Tagging: 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, Benutzerdefiniertes Tag nach dem Export und Benutzerdefiniertes Tag nach dem Drucken.
  9. Ordnen Sie unter Versandmethoden Ihre Shopify-Versandmethoden den Typen von Hrvatska pošta zu, die unter Servicetypen beschrieben sind.

Sie können Bestellungen direkt aus Shopify an Hrvatska pošta exportieren und Versandlabels drucken, einzeln oder im Stapel. Siehe Versandlabels erstellen.

  • Jedes Label entspricht einem Paket mit einem einzigen Packstück.
  • Das Paketgewicht ist das Bestellgewicht aus Shopify, umgerechnet von Gramm in Kilogramm. Hat die Bestellung kein Gewicht, verwendet Globe das Standardgewicht (kg). Sie können das Gewicht auch im Label-Panel unter Erweitert → Sendungsgewicht (kg) eingeben.
  • Hrvatska pošta kennt keine zweite Adresszeile, daher hängt Globe die Adresszeile 2 an die Straße an.
  • Die Shopify-Bestellnummer wird auf das Label gedruckt.

Bevor eine Bestellung übermittelt wird, prüft Globe das Zielland, den Abholpunkt, Name, Straße, Stadt, Postleitzahl und Telefonnummer des Empfängers, das Gewicht und den Nachnahmebetrag. Eine Bestellung, die eine Prüfung nicht besteht, wird nicht übermittelt, und das Label-Panel zeigt den Grund an. Fehlende Zugangsdaten, unvollständige Absenderdaten oder ein fehlender Abgabecode brechen den gesamten Export ab.

Jedes Paket erhält eine Paketnummer von Hrvatska pošta. Ist Bestellungen automatisch erfüllen aktiviert, wird die Bestellung mit dieser Nummer und einem Link zur Sendungsverfolgungsseite von Hrvatska pošta erfüllt: https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.

Globe wiederholt einen Export nicht von selbst. Endet ein Export ohne eindeutige Antwort von Hrvatska pošta, existiert das Paket möglicherweise bereits. Prüfen Sie Ihr Konto bei Hrvatska pošta, bevor Sie das Label erneut erstellen.


Wählen Sie den Typ für jede Bestellung im Label-Panel, oder ordnen Sie in den Einstellungen des Spediteurkontos jeder Versandmethode einen Typ zu. Jeder Typ verwendet die Paket-24-Laufzeit, die unter Dienst eingestellt ist.

TypZustellung an
Hrvatska pošta (post office or parcel locker if selected, otherwise address)Die Postfiliale oder den Paketautomaten, die der Kunde im Checkout gewählt hat. Bestellungen ohne Abholpunkt gehen an die Lieferadresse.
Hrvatska pošta Paket 24 (address)Die Lieferadresse des Kunden. Ein Abholpunkt in der Bestellung wird ignoriert.
Hrvatska pošta Paket 24 (post office or parcel locker)Die Postfiliale oder den Paketautomaten aus der Bestellung. Eine Bestellung ohne Abholpunkt wird abgelehnt.

Den ersten Typ können Sie sowohl Versandmethoden für Abholpunkte als auch für die Hauszustellung zuordnen.

Der erste und der dritte Typ lehnen eine Bestellung ab, deren Abholpunkt zu einem anderen Spediteur gehört. Globe schickt ein solches Paket nie ersatzweise an die Adresse des Kunden. Wählen Sie mit der Aktion Abholpunkt ändern einen Punkt von Hrvatska pošta, oder wählen Sie Hrvatska pošta Paket 24 (address), um an die Adresse zu versenden.

Hrvatska pošta EasyReturn und Palettendienste sind nicht verfügbar.


Um Punkte von Hrvatska pošta im Checkout anzubieten, fügen Sie Hrvatska pošta in Globe als Abholpunkt-Spediteur hinzu, siehe Abholpunkt-Spediteure hinzufügen. Globe lädt die Punkte aus den öffentlichen Daten auf posta.hr:

  • Postfilialen: reguläre Postfilialen und Postfilialen mit eingeschränkten Öffnungszeiten. Saisonale Postfilialen und Zollpostämter werden nicht aufgeführt, ebenso wenig Postfilialen ohne veröffentlichte Öffnungszeiten, etwa vorübergehend geschlossene.
  • Paketautomaten: die paketomati von Hrvatska pošta.

Globe übermittelt mit dem Paket den 5-stelligen Code des Punkts bei Hrvatska pošta: die Postleitzahl einer Postfiliale oder den Code eines Paketautomaten, der mit 6 beginnt. Punkte von Hrvatska pošta, die über den Abholpunkt-Spediteur Packeta kommen, werden ebenfalls akzeptiert.

Für die Zustellung an Paketautomaten gelten zusätzliche Anforderungen:

  • Die Telefonnummer des Empfängers muss eine kroatische Mobilnummer sein (091, 092, 095, 097, 098 oder 099). Hrvatska pošta sendet die PIN per SMS an diese Nummer.
  • Das Paket darf höchstens 30 kg wiegen.
  • Die Fachgröße wird aus Fachgröße im Paketautomaten übernommen.

Auch für die Zustellung an Postfilialen und Adressen ist eine Telefonnummer nötig, dort wird aber jede Nummer akzeptiert.


Hrvatska pošta zieht Nachnahme nur in EUR ein, bis zu 13.300 EUR pro Paket. Eine Bestellung mit Nachnahme in einer anderen Währung oder mit einem höheren Betrag wird abgelehnt, und es wird kein Paket erstellt. Nachnahme funktioniert bei der Zustellung an Adressen, Postfilialen und Paketautomaten.

  • Globe füllt den Nachnahmebetrag mit dem offenen Betrag der Bestellung vor, wenn es die Zahlungsart als Nachnahme erkennt, zum Beispiel die Shopify-Zahlungsart Nachnahme (COD).
  • Erkennt Globe Ihre Nachnahme-Zahlungsart nicht, zum Beispiel eine mit kroatischem Namen, wird kein Betrag vorausgefüllt, und das Label-Panel warnt, dass die Bestellung nicht bezahlt ist. Tragen Sie den Betrag dann selbst ein.
  • Sie können den Betrag im Label-Panel unter Erweitert → Nachnahmebetrag ändern.

Die Labels werden beim Drucken als PDF von Hrvatska pošta abgerufen. Die folgenden Formate stehen zur Verfügung:

FormatLabels pro Seite
A61
A6 on A44 (2×2)

Auf A4-Bögen mit A6-Labels beginnt der Druck immer an der ersten Position. Eine Startposition lässt sich nicht wählen. Das standardmäßig verwendete Format legen Sie mit Standard-Druckoption in den Einstellungen des Spediteurkontos fest.

A6-Labels werden in der Reihenfolge Ihrer Auswahl gedruckt, wenn alle Labels zurückgegeben werden. Auf A4-Bögen sortiert Hrvatska pošta die Labels nach Paketnummer. Labels stornierter Pakete und von Paketen, die nicht zu diesem Konto bei Hrvatska pošta gehören, werden ohne Fehlermeldung weggelassen.


ProblemLösung
Benutzername und Passwort sind nicht eingetragen, oder Hrvatska pošta hat sie abgelehntPrüfen Sie Benutzername und Passwort in den Einstellungen des Spediteurkontos. Es wurde kein Paket erstellt.
Anmeldung bei Hrvatska pošta fehlgeschlagen, oder Globe konnte keine Verbindung zu Hrvatska pošta herstellenEs wurde kein Paket erstellt. Versuchen Sie es in einer Minute erneut.
Absenderadresse ist unvollständigFüllen Sie die Absenderfelder aus, die die Meldung nennt. PLZ des Absenders muss 5 Ziffern haben.
Einstellungen sind unvollständig: Postleitzahl der Postfiliale oder Code des Paketautomaten für die AbgabeTragen Sie den 5-stelligen Code in Postfiliale oder Paketautomat für die Abgabe ein.
Hrvatska pošta liefert nur innerhalb KroatiensDie Bestellung geht in ein anderes Land. Verwenden Sie dafür einen anderen Spediteur.
Der Abholpunkt ist keine Postfiliale und kein Paketautomat von Hrvatska poštaDer Kunde hat einen Punkt eines anderen Spediteurs gewählt. Wählen Sie mit der Aktion Abholpunkt ändern einen Punkt von Hrvatska pošta, oder wählen Sie Hrvatska pošta Paket 24 (address).
Die Bestellung hat keine Postfiliale und keinen Paketautomaten von Hrvatska pošta, oder ihr Punkt hat keinen 5-stelligen CodeWählen Sie den Punkt mit der Aktion Abholpunkt ändern, oder wählen Sie einen Typ, der an die Adresse liefert.
Am Paketautomaten abgegebene Pakete können nicht an eine Adresse gehenUm an eine Adresse zu versenden, stellen Sie Wie Sie Pakete an HP übergeben auf die Option Postfiliale oder Kurier um.
Die Bestellung hat kein GewichtHinterlegen Sie Produktgewichte in Shopify, geben Sie das Gewicht im Label-Panel ein, oder legen Sie ein Standardgewicht (kg) fest.
Paketautomaten nehmen höchstens 30 kg anDie Grenze gilt für die Zustellung an einen Paketautomaten und für die Abgabe dort. Schicken Sie ein schwereres Paket an eine Postfiliale oder eine Adresse, und stellen Sie Wie Sie Pakete an HP übergeben auf die Option Postfiliale oder Kurier um.
Paketautomaten benötigen eine kroatische Mobilnummer, oder die Telefonnummer fehltKorrigieren Sie die Telefonnummer in der Bestellung. Für einen Paketautomaten muss es eine kroatische Mobilnummer sein (091, 092, 095, 097, 098 oder 099).
Keine kroatische Postleitzahl, oder Name, Straße oder Stadt des Empfängers fehltVervollständigen Sie die Lieferadresse der Bestellung. Die Postleitzahl muss 5 Ziffern haben.
Nachnahme in einer anderen Währung als EUR oder über 13.300 EURSiehe Nachnahme (COD).
Eine Meldung, die mit „Hrvatska pošta:“ beginntHrvatska pošta hat das Paket abgelehnt. Der Text, oft auf Kroatisch, nennt das abgelehnte Feld. Korrigieren Sie den Wert und exportieren Sie erneut.
Hrvatska pošta hat nicht rechtzeitig geantwortet, die Verbindung ist abgebrochen, oder das Paket wurde nicht bestätigtDas Paket existiert möglicherweise bereits. Prüfen Sie Ihr Konto bei Hrvatska pošta, bevor Sie das Label erneut erstellen.
Hrvatska pošta hat das Paket erstellt, aber Globe konnte es nicht speichernErstellen Sie das Label nicht erneut, sonst legt Hrvatska pošta ein zweites Paket an. Schreiben Sie mit der Paketnummer an help@appfleece.com.
Der Versanddienstleister hat das Etikett nicht geliefertDrucken Sie gleich noch einmal. Für ein storniertes Paket oder ein Paket, das nicht zu diesem Konto gehört, gibt Hrvatska pošta kein Label zurück. Schlägt der Druck weiterhin fehl, prüfen Sie Benutzername und Passwort.
Im PDF fehlen einige LabelsHrvatska pošta lässt Labels stornierter Pakete und von Paketen weg, die nicht zu diesem Konto gehören.