Magyar Posta API

Globe Pickup Points integriert sich mit Magyar Posta (MPL), dem ungarischen nationalen Postdienstleister, und ermöglicht einen nahtlosen Bestellexport sowie den Druck von Versandlabels direkt aus Shopify. Mit dieser Integration können Sie:

Bestellungen über die MPL API v2 an Magyar Posta exportieren
Versandlabels direkt in Shopify drucken, wobei das obligatorische EFJ-Manifest im selben PDF enthalten ist
An PostaPont-Standorte, Postfilialen, Paketschließfächer oder an die Adresse des Kunden liefern
Nachnahme (COD) und eine Wertversicherung für Pakete nutzen
Nach Ungarn und in 24 weitere europäische Länder liefern

Magyar Posta 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 Magyar Posta.
Geben Sie Ihren API-Schlüssel und Ihr API-Geheimnis ein — beides finden Sie in Ihrem Magyar Posta-Konto. Prüfen Sie die Angaben vor dem Speichern mit Verbindung testen; Globe fordert ein OAuth2-Token an und meldet sofort zurück, ob die Zugangsdaten gültig sind.
Tragen Sie Ihre Vereinbarung ein — Ihre Magyar Posta-Vereinbarungsnummer.
Tragen Sie Ihre Kontonummer ein — Ihren Magyar Posta-Kundenbuchhaltungscode. Exporte werden abgelehnt, wenn die Vereinbarungsnummer oder die Kontonummer fehlt.
Tragen Sie Ihre Bankkontonummer ein — Magyar Posta überweist darauf die eingezogenen Nachnahmebeträge. Geben Sie alle 24 Ziffern ohne Bindestriche oder Leerzeichen ein; hat Ihre Kontonummer 16 Ziffern (2×8), hängen Sie 00000000 an (aus 11733003-27329661 wird z. B. 117330032732966100000000).
Wählen Sie die Paketaufbewahrung (Tage) — die Anzahl der Tage, die Magyar Posta das Paket bereithält: 0, 5 oder 10.
Füllen Sie den Absenderblock aus: Name des Absenders, Straße des Absenders, PLZ des Absenders, Stadt des Absenders, Telefon des Absenders (internationales Format, z. B. +36123456789) und E-Mail des Absenders.
Konfigurieren Sie nach Bedarf Bestellungen automatisch erfüllen und Bestellungen automatisch mit Sendungsverfolgungsnummer markieren.
Ordnen Sie Ihre Shopify-Versandmethoden dem passenden Magyar Posta-Produkt zu.

Bestellungen exportieren und Labels drucken

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

Jedes exportierte Paket erhält eine Sendungsnummer, die für die Sendungsverfolgung im Fulfillment verwendet wird und auf der Sendungsverfolgungsseite von Magyar Posta nachgeschlagen werden kann. Hat die Bestellung kein Gewicht, sendet Globe standardmäßig 100 g.

Manifest (EFJ) und Tagesabschluss

Kuriere von Magyar Posta verlangen, dass zusammen mit den Paketen ein EFJ-Manifest (Elektronikus Feladójegyzék) übergeben wird — ohne dieses können sie die Annahme der Sendung verweigern. Globe erledigt das für Sie: Beim Labeldruck schließt Globe die Sendungen bei Magyar Posta ab und hängt das Manifest an dasselbe PDF an. Die gedruckte Datei enthält in dieser Reihenfolge:

Die Versandlabels
Den Lieferschein — den Papierbeleg, den der Kurier unterschreibt
Die Zusammenfassung der Einlieferungsliste (und eine Paletten-Einlieferungsliste, falls der Stapel Paletten enthält)

Das erzeugte PDF wird gespeichert, sodass Nachdrucke sofort verfügbar sind und nie mit einem „already closed“-Fehler fehlschlagen. Kann das Manifest nicht erzeugt werden, liefert Globe trotzdem die Labels und weist Sie darauf hin, dass das Manifest vor dem Eintreffen des Kuriers separat erstellt werden muss.

Produkte

Ordnen Sie jede Shopify-Versandmethode dem in Ihrem Vertrag vereinbarten Magyar Posta-Produkt zu:

Produkt	MPL-Servicecode	Beschreibung
Business Parcel	`A_175_UZL`	Vertragliches Geschäftspaket
Postal Parcel	`A_177_MPC`	Standard-Postpaket

Abholpunkte vs. Heimlieferung

Die Zustellart wird automatisch aus dem Abholpunkt abgeleitet, den der Kunde im Checkout ausgewählt hat:

Auswahl des Kunden	MPL-Zustellart
PostaPont	`PP`
Postfiliale	`PM`
Paketschließfach (Csomagautomata)	`CS`
Kein Abholpunkt — Versandadresse	`HA` (Heimlieferung)

Sendungen an Paketschließfächer werden immer mit der Paketgröße L übermittelt, weil Magyar Posta für Schließfachzustellungen eine Größe verlangt.

Nachnahme (COD)

Magyar Posta unterstützt Nachnahme. Wenn eine Bestellung eine Nachnahme-Zahlungsmethode verwendet, fügt Globe den Nachnahme-Zusatzservice hinzu und sendet den Nachnahmebetrag der Bestellung mit der Sendung. Eingezogene Beträge werden per Banküberweisung auf die im Spediteurkonto hinterlegte Bankkontonummer abgerechnet — achten Sie darauf, dass sie mit 24 Ziffern eingetragen ist.

Bestellungen in HUF werden zusätzlich mit ihrem Bestellwert versichert (begrenzt auf das Magyar Posta-Maximum von 2.000.000 HUF). Bestellungen in anderen Währungen werden ohne Wertversicherung exportiert.

Lieferstatus

Die Lieferstatus-Synchronisation ist für Magyar Posta nicht verfügbar — Paketstatus werden nicht in die Bestellung zurückgeschrieben. Shopify-Fulfillments enthalten trotzdem die MPL-Sendungsnummer und den Link zur Sendungsverfolgungsseite von Magyar Posta. Retourenlabels werden ebenfalls nicht unterstützt.

Labeldruck

Magyar Posta bietet die größte Auswahl an Labelformaten aller Spediteure in Globe. Wählen Sie das Format, das zu Ihrem Drucker und Ihrem Papier passt:

Format	Beschreibung
`A4`	Adresslabel in voller A4-Größe, 210 × 297 mm
`A5`	A5-Label oben auf einem A4-Bogen
`A5inA4`	Zwei A5-Querformat-Labels auf einem A4-Bogen
`A5E`	A5-Label im Querformat ohne die beiden zusätzlichen Abrisse
`A5E_EXTRA`	A5-Label im Querformat mit den beiden zusätzlichen Abrissen
`A5E_STAND`	A5-Label im Hochformat ohne die beiden zusätzlichen Abrisse
`A6`	A6-Label, 148,5 × 105 mm
`A6inA4`	Vier A6-Labels auf einem A4-Bogen
`A4ONE`	Label und Einlieferungsliste für ein einzelnes Paket auf einem A4-Bogen

Labels werden immer als PDF erzeugt, und der Druck beginnt immer an der ersten Position — bei Magyar Posta gibt es keinen Versatz für teilweise verbrauchte Bögen. Telefonnummer und E-Mail-Adresse des Empfängers werden auf das Label gedruckt.

Fehlerbehebung

Problem	Lösung
Authentifizierungsfehler	Der API-Schlüssel oder das API-Geheimnis ist falsch. Geben Sie beides erneut ein und klicken Sie auf Verbindung testen — es muss eine erfolgreiche Verbindung gemeldet werden.
Konfigurationsfehler — Vereinbarung oder Kontonummer fehlt	Vereinbarung und Kontonummer sind beide Pflichtfelder. Tragen Sie sie ein und exportieren Sie erneut.
Stadt / PLZ / Adresse / Name des Empfängers fehlt	Die Shopify-Versandadresse ist unvollständig. Vervollständigen Sie die Adresse auf der Bestellung, bevor Sie exportieren.
Validierungsfehler mit Parameter und Code	Magyar Posta hat die Sendungsdaten abgelehnt. Die Meldung nennt das betroffene Feld — korrigieren Sie es auf der Bestellung oder in den Einstellungen des Spediteurkontos und exportieren Sie erneut.
Keine Sendungsnummern gefunden — Labels können nicht gedruckt werden	Die Bestellung wurde nie erfolgreich exportiert. Exportieren Sie sie zuerst und drucken Sie dann.
Warnung: Manifesterstellung fehlgeschlagen	Die Labels wurden gedruckt, aber das EFJ-Manifest fehlt. Drucken Sie erneut oder erstellen Sie das Manifest, bevor der Kurier eintrifft — Magyar Posta kann Pakete ohne Manifest ablehnen.
Nachnahmebetrag nicht abgerechnet	Prüfen Sie die Bankkontonummer — sie muss genau 24 Ziffern haben, ohne Bindestriche oder Leerzeichen.

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