Slovenská pošta API

Globe Pickup Points integriert sich über die WebEPH API mit Slovenská pošta, dem slowakischen Postbetreiber, und ermöglicht den Bestellexport sowie den Druck von Versandlabels direkt aus Shopify. Mit dieser Integration können Sie:

Bestellungen an Ihr Slovenská pošta-Konto (Moje zásielky) exportieren
Versandlabels direkt in Shopify im Format A6 oder A4 drucken
An Postfilialen, BalíkoBOX-Paketschließfächer oder an die Adresse des Kunden liefern
Nachnahme mit Auszahlung auf Ihre IBAN nutzen

Die Integration wird für die Slowakei angeboten, und die Absenderadresse ist immer eine slowakische Adresse.

Slovenská pošta 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 Slovenská pošta.
Geben Sie Ihre Benutzer-ID und Ihren API-Schlüssel ein — das sind die WebEPH API-Zugangsdaten aus Ihrem Slovenská pošta-Konto. Die WebEPH API muss für das Konto freigeschaltet sein, damit die Authentifizierung funktioniert.
Füllen Sie den Absenderblock aus: Name des Absenders, Straße des Absenders, Stadt des Absenders und PLZ des Absenders sind erforderlich. Absenderorganisation, Telefon des Absenders und E-Mail des Absenders sind optional.
Wählen Sie die Einlieferungsmethode — Auf der Post einliefern oder Beim Kurier einliefern — je nachdem, wie Sie die Pakete übergeben.
Wählen Sie die Zahlungsart für das Porto: Portokredit, Zahlungsautomat, Briefmarken, Per Überweisung bezahlt, Bar bezahlt, Postdienstleistung, Rechnung oder Online.
Aktivieren Sie Vertrag, wenn Sie einen Vertrag mit Slovenská pošta haben.
Wenn Sie per Nachnahme versenden, füllen Sie die Nachnahme-IBAN aus.
Optional können Sie Sendungsversicherung, Standard-Versicherungswert, Standardgewicht (kg), Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren und Benutzerdefiniertes Tag nach dem Export konfigurieren.
Ordnen Sie Ihre Shopify-Versandmethoden den Slovenská pošta-Produkten zu, die Sie mit dem Spediteur vereinbart haben.

Bestellungen exportieren und Labels drucken

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

Jeder Export erzeugt einen hárok (Einlieferungsbogen) pro Produkttyp: Die Bestellungen werden nach dem gewählten Produkt gruppiert, für jede Gruppe wird ein hárok geöffnet, die Pakete werden ihm hinzugefügt, und anschließend wird der hárok automatisch registriert. Schlägt die Registrierung fehl, werden die Pakete trotzdem angelegt und der hárok kann später in Moje zásielky registriert werden.

Das Bestellgewicht wird von Gramm in Kilogramm umgerechnet, mit einem Minimum von 0,1 kg. Wenn Ihre Bestellungen kein Gewicht haben, hinterlegen Sie in den Einstellungen des Spediteurkontos ein Standardgewicht (kg).

Jedes Paket erhält eine Slovenská pošta-Paketnummer (zum Beispiel EB534780848SK). Ist Bestellungen automatisch erfüllen aktiviert, wird die Bestellung mit dieser Nummer und einem Link zur Sendungsverfolgung von Slovenská pošta erfüllt.

Slovenská pošta betreibt ein WebEPH-Testsystem, das jedoch auf Serverebene und nicht pro Spediteurkonto aktiviert wird — Produktivshops kommunizieren immer mit der Live-API von Moje zásielky, und es gibt keinen Sandbox-Schalter in den Einstellungen des Spediteurkontos.

Produkte

Wählen Sie das Produkt, das Ihrer Vereinbarung mit Slovenská pošta entspricht. Alle mit demselben Produkt exportierten Bestellungen kommen auf denselben hárok.

Produkt	Beschreibung
Doporučený list	Einschreiben
Poistený list	Wertbrief
Úradná zásielka	Behördensendung
Balík	Standardpaket
Expres kuriér	Expresskurier
EMS zásielka	EMS-Expresssendung
EPG – obchodný balík	EPG-Geschäftspaket
Balík – zmluvní zákazníci	Paket für Vertragskunden
Balík – zmluvní zákazníci – Consignment	Vertragskundenpaket, Consignment
Balíček	Kleinpaket
Easy Expres 1	Easy Expres, Zustellung in 1 Tag
Easy Expres 10	Easy Expres, Zustellung in 10 Tagen
Prime zásielka	Prime-Sendung
List	Standardbrief

Abholpunkte vs. Heimlieferung

Die Zustellart richtet sich nach der Versandmethode des Kunden:

Abholpunkt — Wählt der Kunde im Checkout einen Slovenská pošta-Abholpunkt (eine Postfiliale oder ein BalíkoBOX-Schließfach), wird die Empfängeradresse auf dem Paket durch die Adresse des Abholpunkts ersetzt, und das Paket wird mit dem Abholservice eingeliefert. Der Name des Punktes wird an die Stadt angehängt, damit er auf dem Label sichtbar ist.
Heimlieferung — Das Paket wird an die Versandadresse des Kunden adressiert. Eine zweite Adresszeile wird an die Straße angehängt.

Name, Straße, Stadt und PLZ des Empfängers sind Pflichtangaben. Bestellungen, bei denen eine dieser Angaben fehlt, werden beim Export abgelehnt.

Paketnummernbereiche (Vertragskunden)

Wenn Ihnen Slovenská pošta einen eigenen Paketnummernbereich zugeteilt hat, füllen Sie die erweiterten Felder Paketnummernbereich – von und Paketnummernbereich – bis aus (zum Beispiel EB534780848SK). Globe vergibt dann Nummern aus diesem Bereich und speichert nach jedem Export die jeweils nächste Nummer in Nächste Paketnummer, die Sie auch manuell korrigieren können.

Die Nummern haben das Format PPNNNNNNNN[C]SS — ein zweistelliges Buchstabenpräfix, acht Ziffern, eine optionale Prüfziffer und ein zweistelliges Buchstabensuffix. Die Prüfziffer berechnet Globe für Sie. Ist der Bereich aufgebraucht, schlagen Exporte fehl, bis Sie einen neuen Bereich eintragen. Lassen Sie diese Felder leer, damit Slovenská pošta die Nummern vergibt.

Nachnahme (COD)

Nachnahme wird unterstützt. Der Nachnahmebetrag wird aus dem offenen Betrag der Bestellung in der Bestellwährung übernommen und als Banküberweisung an die im Spediteurkonto hinterlegte Nachnahme-IBAN gesendet, wobei das Variabilsymbol aus den Ziffern der Bestellnummer abgeleitet wird. Ohne gültige IBAN lehnt die API das Paket ab.

Versicherung

Eine Versicherung wird hinzugefügt, wenn der Bestellwert größer als null ist und entweder das Produkt Poistený list gewählt wurde oder in den Einstellungen des Spediteurkontos Sendungsversicherung aktiviert ist. Der versicherte Betrag entspricht dem Bestellwert in der Bestellwährung oder dem Standard-Versicherungswert, sofern Sie einen festgelegt haben.

Lieferstatus

Die Lieferstatus-Synchronisation ist für Slovenská pošta nicht verfügbar — Paketstatus werden nicht nach Shopify zurückgeschrieben, und Nachnahmezahlungen werden nicht automatisch als bezahlt markiert. Die Paketnummer und der Link zur Sendungsverfolgungsseite von Slovenská pošta werden dem Fulfillment trotzdem beigefügt. Retourenlabels und das Stornieren eines bereits exportierten Pakets aus Globe werden ebenfalls nicht unterstützt; stornieren Sie Pakete in Moje zásielky.

Labeldruck

Slovenská pošta-Labels werden als PDF zurückgegeben und können in den folgenden Formaten gedruckt werden:

Format	Labels pro Bogen	Startposition
A6	1 (ein Label pro Seite)	–
A4	4 (2×2-Raster)	1–4

Beim Druck auf A4-Bögen wählen Sie die Startposition, um teilweise verbrauchte Labelbögen weiterzuverwenden. Das standardmäßig verwendete Format legen Sie mit Standard-Druckoption in den Einstellungen des Spediteurkontos fest.

Fehlerbehebung

Problem	Lösung
Authentifizierung fehlgeschlagen	Prüfen Sie Benutzer-ID und API-Schlüssel und stellen Sie sicher, dass die WebEPH API in Ihrem Slovenská pošta-Konto freigeschaltet ist.
Pflichtfelder des Absenders fehlen	Name des Absenders, Straße des Absenders, Stadt des Absenders und PLZ des Absenders müssen alle ausgefüllt sein.
Name, Adresse, Stadt oder PLZ des Empfängers fehlt	Die Shopify-Versandadresse ist unvollständig. Prüfen Sie bei Abholpunkt-Bestellungen, ob der Kunde im Checkout tatsächlich einen Punkt ausgewählt hat.
Ungültiges Paketnummernformat	Verwenden Sie in den Feldern für den Paketnummernbereich das Format `PPNNNNNNNN[C]SS`, zum Beispiel `EB534780848SK`.
Paketnummernbereich aufgebraucht	Alle zugeteilten Nummern wurden verwendet. Fordern Sie bei Slovenská pošta einen neuen Bereich an und aktualisieren Sie Paketnummernbereich – von/bis und Nächste Paketnummer.
Validierungsfehler beim Export	Die API hat einen Wert auf dem Paket abgelehnt — meist eine fehlende Nachnahme-IBAN oder ein Versicherungs- bzw. Nachnahmebetrag, den das Produkt nicht zulässt.
Keine Paket-IDs in den Bestellungen gefunden	Die Bestellung wurde nicht erfolgreich exportiert, es gibt also nichts zu drucken. Exportieren Sie sie erneut, bevor Sie drucken.
Labeltyp nicht verfügbar	Das Label ist für dieses Paket noch nicht bereit. Warten Sie einen Moment und drucken Sie erneut.
Verbindung zur SK Posta API nicht möglich	Die WebEPH API ist vorübergehend nicht erreichbar. Wiederholen Sie den Export oder den Druck später.

Add Slovenská pošta pickup points to your Shopify store — pricing, demo & setup →