Magyar Posta API

Globe Pickup Points integruje s Magyar Posta (MPL), maďarským národním poštovním dopravcem, což umožňuje bezproblémový export objednávek a tisk přepravních štítků přímo ze Shopify. S touto integrací můžete:

Exportovat objednávky do Magyar Posta přes MPL API v2
Tisknout přepravní štítky přímo v Shopify, včetně povinného manifestu EFJ ve stejném PDF
Doručovat na místa PostaPont, na pošty, do balíkomatů nebo na adresu zákazníka
Podporovat dobírku (COD) a pojištění hodnoty zásilky
Doručovat do Maďarska a dalších 24 evropských zemí

Aktivace integrace Magyar Posta API

Ve vaší Shopify administraci otevřete Globe Pickup Points a přejděte do sekce Přepravní štítky. Přidejte nového dopravce a vyberte Magyar Posta.
Zadejte API klíč a API tajný klíč — oba najdete ve svém účtu Magyar Posta. Před uložením je ověřte tlačítkem Otestovat připojení; Globe si vyžádá token OAuth2 a ihned oznámí, zda jsou přihlašovací údaje platné.
Zadejte Smlouva — vaše číslo smlouvy s Magyar Posta.
Zadejte Číslo účtu — vaše zákaznické účetní číslo u Magyar Posta. Pokud číslo smlouvy nebo číslo účtu chybí, exporty se zamítají.
Zadejte Číslo bankovního účtu — Magyar Posta jej používá k přeposílání vybraných částek z dobírky. Zadejte všech 24 číslic bez pomlček a mezer; pokud má vaše číslo účtu 16 číslic (2×8), doplňte na konec 00000000 (např. z 11733003-27329661 se stane 117330032732966100000000).
Zvolte Uchování balíku (dny) — počet dní, po které Magyar Posta zásilku drží: 0, 5 nebo 10.
Vyplňte blok odesílatele: Název odesílatele, Ulice odesílatele, PSČ odesílatele, Město odesílatele, Telefon odesílatele (v mezinárodním formátu, např. +36123456789) a Email odesílatele.
Podle potřeby nastavte Automaticky splnit objednávky a Automaticky označit objednávky číslem sledování.
Namapujte vaše Shopify dopravní metody na odpovídající produkt Magyar Posta.

Export a tisk štítků

Objednávky lze exportovat do Magyar Posta a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě. Kompletní postup najdete v průvodci Vytváření přepravních štítků.

Každá exportovaná zásilka obdrží sledovací číslo, které se používá pro sledování v plnění a lze jej vyhledat na stránce pro sledování Magyar Posta. Pokud objednávka nemá hmotnost, Globe odešle výchozí hodnotu 100 g.

Manifest (EFJ) a denní uzávěrka

Kurýři Magyar Posta vyžadují, aby jim byl spolu se zásilkami předán manifest EFJ (Elektronikus Feladójegyzék) — bez něj mohou zásilky odmítnout převzít. Globe to za vás vyřeší: při tisku štítků uzavře zásilky u Magyar Posta a manifest připojí do stejného PDF. Vytištěný soubor obsahuje v tomto pořadí:

Přepravní štítky
Dodací list — papírový doklad, který kurýr podepisuje
Souhrnný podací arch (a paletový podací arch, pokud dávka obsahuje palety)

Vygenerované PDF se ukládá, takže opakovaný tisk je okamžitý a nikdy neselže chybou „already closed“. Pokud manifest nelze vygenerovat, Globe štítky přesto vrátí a upozorní vás, že je manifest nutné před příjezdem kurýra vytvořit samostatně.

Produkty

Namapujte každou Shopify dopravní metodu na produkt Magyar Posta sjednaný ve vaší smlouvě:

Produkt	Kód služby MPL	Popis
Business Parcel	`A_175_UZL`	Smluvní obchodní balíková služba
Postal Parcel	`A_177_MPC`	Standardní poštovní balíková služba

Výdejní místa vs. doručení na adresu

Způsob doručení se odvozuje automaticky z výdejního místa, které zákazník vybral při objednávce:

Volba zákazníka	Způsob doručení MPL
PostaPont	`PP`
Pošta	`PM`
Balíkomat (Csomagautomata)	`CS`
Bez výdejního místa — doručovací adresa	`HA` (doručení na adresu)

Zásilky do balíkomatů se vždy podávají s velikostí balíku L, protože Magyar Posta u doručení do boxů velikost vyžaduje.

Dobírka (COD)

Magyar Posta podporuje dobírku. Pokud objednávka používá platební metodu na dobírku, Globe přidá doplňkovou službu dobírky a odešle částku dobírky spolu se zásilkou. Vybrané částky se vyplácejí bankovním převodem na číslo bankovního účtu nastavené u dopravce — ujistěte se, že je zadané jako 24 číslic.

Objednávky v HUF jsou navíc pojištěny na hodnotu objednávky (nejvýše však do maxima Magyar Posta 2 000 000 HUF). Objednávky v jiných měnách se exportují bez pojištění hodnoty.

Stav doručení

Synchronizace stavů doručení není u Magyar Posta k dispozici — stavy zásilek se nezapisují zpět do objednávky. Plnění v Shopify přesto nesou sledovací číslo MPL a odkaz na stránku pro sledování Magyar Posta. Podporovány nejsou ani štítky pro vrácení.

Tisk štítků

Magyar Posta nabízí nejširší výběr formátů štítků ze všech dopravců v Globe. Vyberte ten, který odpovídá vaší tiskárně a papíru:

Formát	Popis
`A4`	Adresní štítek v plné velikosti A4, 210 × 297 mm
`A5`	Štítek A5 umístěný v horní části archu A4
`A5inA4`	Dva štítky A5 na šířku na jednom archu A4
`A5E`	Štítek A5 na šířku bez dvou doplňkových útržků
`A5E_EXTRA`	Štítek A5 na šířku se dvěma doplňkovými útržky
`A5E_STAND`	Štítek A5 na výšku bez dvou doplňkových útržků
`A6`	Štítek A6, 148,5 × 105 mm
`A6inA4`	Čtyři štítky A6 na jednom archu A4
`A4ONE`	Štítek a podací arch pro jednu zásilku na jednom archu A4

Štítky se vždy vytvářejí jako PDF a tisk vždy začíná na první pozici — u Magyar Posta není možné posunout začátek na částečně použitém archu. Na štítku se tiskne telefonní číslo a e-mailová adresa příjemce.

Řešení problémů

Problém	Řešení
Chyba ověření	API klíč nebo API tajný klíč je chybný. Zadejte je znovu a stiskněte Otestovat připojení — musí hlásit úspěšné připojení.
Chyba konfigurace — chybí smlouva nebo číslo účtu	Pole Smlouva i Číslo účtu jsou povinná. Vyplňte je a exportujte znovu.
Chybí město / PSČ / adresa / jméno příjemce	Doručovací adresa v Shopify je neúplná. Před exportem adresu u objednávky doplňte.
Chyba validace s parametrem a kódem	Magyar Posta odmítla data zásilky. Zpráva uvádí problematické pole — opravte je u objednávky nebo v nastavení dopravce a exportujte znovu.
Nenalezena žádná sledovací čísla — štítky nelze vytisknout	Objednávka nebyla nikdy úspěšně exportována. Nejprve ji exportujte, pak tiskněte.
Upozornění: generování manifestu selhalo	Štítky se vytiskly, ale chybí manifest EFJ. Vytiskněte znovu, nebo manifest vytvořte před příjezdem kurýra — Magyar Posta může zásilky bez něj odmítnout.
Částka dobírky nebyla vyplacena	Zkontrolujte Číslo bankovního účtu — musí mít přesně 24 číslic, bez pomlček a mezer.

Přidejte výdejní místa Magyar Posta do svého Shopify obchodu — ceny, demo a nastavení →