Magyar Posta API
Globe Pickup Points integruje się z Magyar Posta (MPL), węgierskim narodowym przewoźnikiem pocztowym, umożliwiając bezproblemowy eksport zamówień i drukowanie etykiet wysyłkowych bezpośrednio z Shopify. Dzięki tej integracji możesz:
- Eksportować zamówienia do Magyar Posta przez API MPL v2
- Drukować etykiety wysyłkowe w Shopify, z obowiązkowym manifestem EFJ zawartym w tym samym pliku PDF
- Wysyłać do punktów PostaPont, placówek pocztowych, automatów paczkowych lub na adres klienta
- Obsługiwać płatność za pobraniem (COD) oraz ubezpieczenie wartości paczki
- Dostarczać na Węgry i do 24 innych krajów europejskich
Włączanie integracji z API Magyar Posta
Dział zatytułowany „Włączanie integracji z API Magyar Posta”- W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz Magyar Posta.
- Wprowadź swój Klucz API i Sekret API — oba znajdziesz na swoim koncie Magyar Posta. Użyj przycisku Testuj połączenie, aby zweryfikować je przed zapisaniem; Globe pobiera token OAuth2 i od razu informuje, czy dane uwierzytelniające są prawidłowe.
- Wprowadź swoją Umowę — numer umowy z Magyar Posta.
- Wprowadź swój Numer konta — kod rozliczeniowy klienta Magyar Posta. Eksporty są odrzucane, jeśli brakuje numeru umowy lub numeru konta.
- Wprowadź swój Numer konta bankowego — Magyar Posta używa go do przekazywania pobranych kwot za pobraniem. Wpisz wszystkie 24 cyfry bez myślników i spacji; jeśli Twój numer konta ma 16 cyfr (2×8), dodaj na końcu
00000000(np.11733003-27329661staje się117330032732966100000000). - Wybierz Przechowywanie paczki (dni) — liczbę dni, przez które Magyar Posta przechowuje paczkę: 0, 5 lub 10.
- Wypełnij blok nadawcy: Nazwa nadawcy, Ulica nadawcy, Kod pocztowy nadawcy, Miasto nadawcy, Telefon nadawcy (w formacie międzynarodowym, np.
+36123456789) i Email nadawcy. - Skonfiguruj według potrzeb opcje Automatycznie realizuj zamówienia i Automatycznie oznaczaj zamówienia numerem śledzenia.
- Przypisz metody wysyłki Shopify do odpowiedniego produktu Magyar Posta.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”Możesz eksportować zamówienia do Magyar Posta i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Pełny przepływ pracy opisujemy w artykule Tworzenie etykiet wysyłkowych.
Każda wyeksportowana paczka otrzymuje numer śledzenia, który służy do śledzenia realizacji i który można sprawdzić na stronie śledzenia Magyar Posta. Jeśli zamówienie nie ma wagi, Globe wysyła domyślnie 100 g.
Manifest (EFJ) i zamknięcie dnia
Dział zatytułowany „Manifest (EFJ) i zamknięcie dnia”Kurierzy Magyar Posta wymagają przekazania razem z paczkami manifestu EFJ (Elektronikus Feladójegyzék) — bez niego mogą odmówić przyjęcia przesyłki. Globe załatwia to za Ciebie: podczas drukowania etykiet zamyka przesyłki w Magyar Posta i dołącza manifest do tego samego pliku PDF. Wydrukowany plik zawiera kolejno:
- Etykiety wysyłkowe
- List przewozowy — papierowe potwierdzenie podpisywane przez kuriera
- Podsumowanie listy nadawczej (a także paletową listę nadawczą, jeśli partia zawiera palety)
Wygenerowany plik PDF jest przechowywany, więc ponowne wydruki są natychmiastowe i nigdy nie kończą się błędem „already closed”. Jeśli manifestu nie uda się wygenerować, Globe i tak zwraca etykiety i ostrzega, że manifest trzeba przygotować osobno przed przyjazdem kuriera.
Produkty
Dział zatytułowany „Produkty”Przypisz każdą metodę wysyłki Shopify do produktu Magyar Posta uzgodnionego w Twojej umowie:
| Produkt | Kod usługi MPL | Opis |
|---|---|---|
| Business Parcel | A_175_UZL | Umowna usługa paczki biznesowej |
| Postal Parcel | A_177_MPC | Standardowa usługa paczki pocztowej |
Punkty odbioru a dostawa do domu
Dział zatytułowany „Punkty odbioru a dostawa do domu”Tryb dostawy jest wyprowadzany automatycznie z punktu odbioru wybranego przez klienta podczas realizacji zamówienia:
| Wybór klienta | Tryb dostawy MPL |
|---|---|
| PostaPont | PP |
| Placówka pocztowa | PM |
| Automat paczkowy (Csomagautomata) | CS |
| Brak punktu odbioru — adres wysyłki | HA (dostawa do domu) |
Przesyłki do automatów paczkowych są zawsze nadawane z rozmiarem paczki L, ponieważ Magyar Posta wymaga podania rozmiaru przy dostawach do automatów.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”Magyar Posta obsługuje COD. Gdy zamówienie korzysta z metody płatności za pobraniem, Globe dodaje usługę dodatkową COD i wysyła kwotę pobrania wraz z przesyłką. Pobrane kwoty są rozliczane przelewem bankowym na numer konta bankowego skonfigurowany u przewoźnika — upewnij się, że wpisano go jako 24 cyfry.
Zamówienia złożone w HUF są dodatkowo ubezpieczane na wartość zamówienia (z limitem maksymalnym Magyar Posta wynoszącym 2 000 000 HUF). Zamówienia w innych walutach są eksportowane bez ubezpieczenia wartości.
Status dostawy
Dział zatytułowany „Status dostawy”Synchronizacja statusów dostawy nie jest dostępna dla Magyar Posta — statusy paczek nie są zapisywane z powrotem w zamówieniu. Realizacje w Shopify nadal zawierają numer śledzenia MPL oraz link do strony śledzenia Magyar Posta. Etykiety zwrotne również nie są obsługiwane.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Magyar Posta oferuje najszerszy wybór formatów etykiet spośród wszystkich przewoźników w Globe. Wybierz ten, który pasuje do Twojej drukarki i materiałów:
| Format | Opis |
|---|---|
A4 | Pełnowymiarowa etykieta adresowa A4, 210 × 297 mm |
A5 | Etykieta A5 umieszczona u góry arkusza A4 |
A5inA4 | Dwie etykiety A5 w orientacji poziomej na jednym arkuszu A4 |
A5E | Etykieta A5 pozioma bez dwóch dodatkowych odcinków |
A5E_EXTRA | Etykieta A5 pozioma z dwoma dodatkowymi odcinkami |
A5E_STAND | Etykieta A5 pionowa bez dwóch dodatkowych odcinków |
A6 | Etykieta A6, 148,5 × 105 mm |
A6inA4 | Cztery etykiety A6 na jednym arkuszu A4 |
A4ONE | Etykieta i lista nadawcza dla jednej paczki na jednym arkuszu A4 |
Etykiety są zawsze generowane jako PDF, a drukowanie zawsze zaczyna się od pierwszej pozycji — dla Magyar Posta nie ma przesunięcia dla częściowo zużytych arkuszy. Na etykiecie drukowane są numer telefonu i adres e-mail odbiorcy.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Problem | Rozwiązanie |
|---|---|
| Błąd uwierzytelniania | Klucz API lub sekret API jest nieprawidłowy. Wprowadź je ponownie i naciśnij Testuj połączenie — musi zgłosić udane połączenie. |
| Błąd konfiguracji — brak umowy lub numeru konta | Zarówno Umowa, jak i Numer konta są obowiązkowe. Uzupełnij je i wyeksportuj ponownie. |
| Brak miasta / kodu pocztowego / adresu / nazwy odbiorcy | Adres wysyłki w Shopify jest niekompletny. Uzupełnij adres w zamówieniu przed eksportem. |
| Błąd walidacji z parametrem i kodem | Magyar Posta odrzuciła dane przesyłki. Komunikat wskazuje problematyczne pole — popraw je w zamówieniu lub w ustawieniach przewoźnika i wyeksportuj ponownie. |
| Nie znaleziono numerów śledzenia — nie można wydrukować etykiet | Zamówienie nigdy nie zostało poprawnie wyeksportowane. Najpierw wyeksportuj, a potem drukuj. |
| Ostrzeżenie: nie udało się wygenerować manifestu | Etykiety zostały wydrukowane, ale brakuje manifestu EFJ. Wydrukuj ponownie lub przygotuj manifest przed przyjazdem kuriera — Magyar Posta może odmówić przyjęcia paczek bez niego. |
| Kwota pobrania nierozliczona | Sprawdź Numer konta bankowego — musi mieć dokładnie 24 cyfry, bez myślników i spacji. |