Hrvatska pošta API
Globe Pickup Points se napojuje na chorvatského poštovního operátora Hrvatska pošta přes jeho API HP Shipping Service. S touto integrací můžete:
- Exportovat objednávky do systému Hrvatska pošta přímo ze Shopify
- Tisknout přepravní štítky přímo v Shopify ve formátu A6 nebo A6 na A4
- Posílat balíky Paket 24 na pošty, do paketomatů nebo na adresu zákazníka
- Vybírat dobírku v EUR
- Sledovat zásilky na sledovací stránce Hrvatska pošta
Integrace pokrývá jen zásilky v rámci Chorvatska.
Aktivace integrace Hrvatska pošta API
Sekce “Aktivace integrace Hrvatska pošta API”- Ve své Shopify administraci otevřete Globe Pickup Points a přejděte do sekce Přepravní štítky. Klikněte na Přidat dopravce a vyberte Hrvatska pošta.
- Zadejte Uživatelské jméno a Heslo. Jsou to přihlašovací údaje k API, které Hrvatska pošta vydává smluvním zákazníkům. Požádejte o ně svého obchodního zástupce Hrvatska pošta, nebo napište na npa-3pdx@posta.hr.
- Prostředí nechte na Produkce. Vývoj se připojuje k testovacímu systému Hrvatska pošta.
- V poli Služba vyberte Paket 24 D+1, Paket 24 D+2 nebo Paket 24 D+3. Volba platí pro všechny zásilky. D+1 doručuje následující pracovní den.
- V poli Jak předáváte zásilky HP vyberte jednu z možností:
- Kurýr HP si je vyzvedne na mé adrese (předvybráno): kurýr Hrvatska pošta si zásilky vyzvedne na adrese odesílatele. Když mu zásilky nikdo nepředá, Hrvatska pošta zásilku uzavře. Pokud zásilky odevzdáváte sami, tuto možnost nenechávejte.
- Nosím je na poštu: do pole Pošta nebo paketomat pro podání zadejte PSČ pošty.
- Vkládám je do paketomatu: do pole Pošta nebo paketomat pro podání zadejte pětimístný kód paketomatu. Zásilky podané v paketomatu mohou jít jen na poštu nebo do paketomatu, ne na adresu, a mohou vážit nejvýše 30 kg.
- Vyplňte údaje o odesílateli. Povinné jsou Název firmy odesílatele (tiskne se jako odesílatel na každý štítek), Ulice odesílatele, Město odesílatele, PSČ odesílatele (5 číslic) a Telefon odesílatele. Číslo popisné odesílatele a Email odesílatele jsou volitelné. Číslo popisné můžete napsat i do pole Ulice odesílatele.
- Klikněte na Zobrazit pokročilá nastavení a nastavte:
- Velikost schránky v paketomatu: velikost schránky uváděná u zásilek, které jdou do paketomatu nebo které v paketomatu podáváte. Na výběr je XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) nebo L (39 x 38 x 64 cm). Předvybraná je M.
- Výchozí hmotnost (kg): použije se, když objednávka nemá hmotnost.
- Podle potřeby nastavte možnosti plnění a označování objednávek: Automaticky splnit objednávky (Nikdy, Ano, poslat email s číslem sledování zásilky nebo Ano, nezasílat email), Automaticky označit objednávky číslem sledování, Vlastní tag po exportu a Vlastní tag po tisku.
- V části Dopravní metody namapujte své dopravní metody v Shopify na typy Hrvatska pošta popsané v části Typy služeb.
Export a tisk štítků
Sekce “Export a tisk štítků”Objednávky můžete exportovat do systému Hrvatska pošta a přepravní štítky tisknout přímo ze Shopify, hromadně i jednotlivě. Viz Vytváření přepravních štítků.
- Každý štítek je jedna zásilka s jedním balíkem.
- Hmotnost zásilky je hmotnost objednávky ze Shopify, převedená z gramů na kilogramy. Pokud objednávka hmotnost nemá, Globe použije Výchozí hmotnost (kg). Hmotnost můžete zadat také v panelu štítků v části Pokročilé → Hmotnost zásilky (kg).
- Hrvatska pošta nemá druhý řádek adresy, proto Globe připojí druhý řádek adresy k ulici.
- Na štítku je vytištěno číslo objednávky v Shopify.
Před odesláním objednávky Globe zkontroluje cílovou zemi, výdejní místo, jméno příjemce, ulici, město, PSČ a telefonní číslo, hmotnost a částku dobírky. Objednávka, která kontrolou neprojde, se neodešle a panel štítků zobrazí důvod. Chybějící přihlašovací údaje, neúplné údaje o odesílateli nebo chybějící kód místa podání zastaví celý export.
Každá zásilka dostane číslo zásilky Hrvatska pošta. Pokud je zapnuté Automaticky splnit objednávky, objednávka se splní s tímto číslem a s odkazem na sledovací stránku Hrvatska pošta: https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.
Globe export sám neopakuje. Když export skončí bez jasné odpovědi ze systému Hrvatska pošta, zásilka už může existovat. Než štítek vytvoříte znovu, zkontrolujte svůj účet Hrvatska pošta.
Typy služeb
Sekce “Typy služeb”Typ vyberte u každé objednávky v panelu štítků, nebo v nastavení dopravce namapujte typ na každou dopravní metodu. Všechny typy používají dobu doručení Paket 24 nastavenou v poli Služba.
| Typ | Kam doručuje |
|---|---|
| Hrvatska pošta (post office or parcel locker if selected, otherwise address) | Na poštu nebo do paketomatu, které zákazník vybral v pokladně. Objednávky bez výdejního místa jdou na doručovací adresu. |
| Hrvatska pošta Paket 24 (address) | Na doručovací adresu zákazníka. Výdejní místo v objednávce se ignoruje. |
| Hrvatska pošta Paket 24 (post office or parcel locker) | Na poštu nebo do paketomatu z objednávky. Objednávka bez výdejního místa se odmítne. |
První typ můžete namapovat na dopravní metody s výdejními místy i s doručením domů.
První a třetí typ odmítnou objednávku, jejíž výdejní místo patří jinému dopravci. Globe takovou zásilku nepošle ani na adresu zákazníka. Vyberte místo Hrvatska pošta akcí Upravit výdejní místo, nebo pro doručení na adresu zvolte Hrvatska pošta Paket 24 (address).
Služba EasyReturn a paletová přeprava Hrvatska pošta nejsou k dispozici.
Výdejní místa
Sekce “Výdejní místa”Chcete-li v pokladně nabízet místa Hrvatska pošta, přidejte Hrvatska pošta v Globe jako dopravce výdejních míst, viz Přidání výdejních míst. Globe načítá místa z veřejných dat na posta.hr:
- Pošty: běžné pošty a pošty se zkrácenou otevírací dobou. Sezónní a celní pošty v seznamu nejsou, stejně jako pošty bez zveřejněné otevírací doby, například dočasně zavřené.
- Paketomaty: paketomaty Hrvatska pošta (paketomati).
Globe posílá se zásilkou pětimístný kód místa Hrvatska pošta: PSČ pošty, nebo kód paketomatu, který začíná číslicí 6. Přijímají se i místa Hrvatska pošta, která přicházejí přes dopravce výdejních míst Zásilkovna.
Doručení do paketomatu má další požadavky:
- Telefon příjemce musí být chorvatské mobilní číslo (091, 092, 095, 097, 098 nebo 099). Hrvatska pošta na něj pošle PIN v SMS.
- Zásilka může vážit nejvýše 30 kg.
- Velikost schránky se přebírá z pole Velikost schránky v paketomatu.
Doručení na poštu a na adresu také vyžaduje telefonní číslo, může ale být jakékoli.
Dobírka (COD)
Sekce “Dobírka (COD)”Hrvatska pošta vybírá dobírku jen v EUR, a to do 13 300 EUR za zásilku. Objednávka s dobírkou v jiné měně nebo s vyšší částkou se odmítne a zásilka nevznikne. Dobírka funguje při doručení na adresu, na poštu i do paketomatu.
- Globe předvyplní částku dobírky nezaplacenou částkou objednávky, když platební metodu rozpozná jako dobírku, například Shopify Cash on Delivery (COD).
- Pokud Globe vaši platební metodu na dobírku nerozpozná, například metodu s chorvatským názvem, částka se nepředvyplní a panel štítků upozorní, že objednávka není zaplacená. Částku zadejte sami.
- Částku můžete změnit v panelu štítků v části Pokročilé → Dobírka.
Tisk štítků
Sekce “Tisk štítků”Štítky se při tisku stahují ze systému Hrvatska pošta jako PDF. K dispozici jsou následující formáty:
| Formát | Štítků na stránku |
|---|---|
| A6 | 1 |
| A6 on A4 | 4 (2×2) |
Ve formátu A6 on A4 se tiskne vždy od první pozice, počáteční pozici nelze zvolit. Výchozí formát nastavíte v poli Výchozí formát tisku v nastavení dopravce.
Štítky A6 se tisknou v pořadí, ve kterém jste je vybrali, pokud se vrátí všechny. Na archech A4 řadí Hrvatska pošta štítky podle čísla zásilky. Štítky zrušených zásilek a zásilek, které nejsou na tomto účtu Hrvatska pošta, se bez chyby vynechají.
Řešení problémů
Sekce “Řešení problémů”| Problém | Řešení |
|---|---|
| Uživatelské jméno a heslo nejsou nastavené, nebo je Hrvatska pošta odmítla | Zkontrolujte Uživatelské jméno a Heslo v nastavení dopravce. Žádná zásilka nevznikla. |
| Přihlášení do systému Hrvatska pošta selhalo, nebo se k němu Globe nemohl připojit | Žádná zásilka nevznikla. Zkuste to znovu za minutu. |
| Adresa odesílatele je neúplná | Vyplňte pole odesílatele, která zpráva uvádí. PSČ odesílatele musí mít 5 číslic. |
| Nastavení je neúplné: chybí PSČ pošty nebo kód paketomatu pro podání | Zadejte pětimístný kód do pole Pošta nebo paketomat pro podání. |
| Hrvatska pošta doručuje jen v rámci Chorvatska | Objednávka jde do jiné země. Použijte pro ni jiného dopravce. |
| Výdejní místo není pošta ani paketomat Hrvatska pošta | Zákazník vybral místo jiného dopravce. Vyberte místo Hrvatska pošta akcí Upravit výdejní místo, nebo zvolte Hrvatska pošta Paket 24 (address). |
| Objednávka nemá poštu ani paketomat Hrvatska pošta, nebo její místo nemá pětimístný kód | Vyberte místo akcí Upravit výdejní místo, nebo zvolte typ, který doručuje na adresu. |
| Zásilky podané v paketomatu nemohou jít na adresu | Pro doručení na adresu nastavte Jak předáváte zásilky HP na možnost pošta nebo kurýr. |
| Objednávka nemá hmotnost | Nastavte hmotnosti produktů v Shopify, zadejte hmotnost v panelu štítků, nebo nastavte Výchozí hmotnost (kg). |
| Paketomaty přijímají nejvýše 30 kg | Limit platí pro doručení do paketomatu i pro podání v paketomatu. Těžší zásilku pošlete na poštu nebo na adresu a nastavte Jak předáváte zásilky HP na možnost pošta nebo kurýr. |
| Paketomaty vyžadují chorvatské mobilní číslo, nebo telefonní číslo chybí | Opravte telefonní číslo v objednávce. U paketomatu to musí být chorvatské mobilní číslo (091, 092, 095, 097, 098 nebo 099). |
| PSČ není chorvatské, nebo chybí jméno, ulice či město příjemce | Doplňte doručovací adresu v objednávce. PSČ musí mít 5 číslic. |
| Dobírka v jiné měně než EUR, nebo nad 13 300 EUR | Viz Dobírka (COD). |
| Zpráva, která začíná „Hrvatska pošta:“ | Hrvatska pošta zásilku odmítla. Její text, často chorvatsky, uvádí odmítnuté pole. Opravte hodnotu a exportujte znovu. |
| Hrvatska pošta neodpověděla včas, spojení se přerušilo, nebo zásilka nebyla potvrzena | Zásilka už může existovat. Než štítek vytvoříte znovu, zkontrolujte svůj účet Hrvatska pošta. |
| Hrvatska pošta zásilku vytvořila, ale Globe ji nemohl uložit | Štítek znovu nevytvářejte: Hrvatska pošta by vytvořila druhou zásilku. Napište na help@appfleece.com a uveďte číslo zásilky. |
| Dopravce nevrátil štítek | Zkuste tisk za chvíli znovu. Hrvatska pošta nevrací štítek pro zrušenou zásilku ani pro zásilku, která není na tomto účtu. Pokud tisk dál selhává, zkontrolujte Uživatelské jméno a Heslo. |
| V PDF chybí některé štítky | Hrvatska pošta vynechává štítky zrušených zásilek a zásilek, které nejsou na tomto účtu. |