Přeskočit na obsah

InPost API

Globe Pickup Points se napojuje na InPost Poland přes ShipX API. S touto integrací můžete:

  • Exportovat objednávky do InPostu přímo ze Shopify
  • Tisknout přepravní štítky přímo v Shopify
  • Posílat zásilky do Paczkomatů a PaczkoPunktů InPost v Polsku
  • Posílat zásilky kurýrem InPost Kurier na adresy v Polsku, včetně expresu do 10:00, 12:00 nebo 17:00
  • Vybírat dobírku v PLN
  • Sledovat zásilky na sledovací stránce InPostu

Aktivace integrace InPost API

Sekce “Aktivace integrace InPost API”

Potřebujete účet InPost v Manageru Paczek (manager.paczkomaty.pl) s vyplněnými údaji firmy a fakturačními údaji. InPost Kurier standard a express vyžadují kurýrní smlouvu s InPostem. Na předplaceném účtu posílejte kurýrní zásilky přes InPost Kurier C2C.

  1. 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 InPost Poland.
  2. Zadejte API token ShipX a ID organizace. Token vygenerujete v Manageru Paczek v sekci Moje konto → API. ID organizace je číslo zobrazené vedle tokenu.
  3. Vyberte Prostředí: Produkce pro skutečné zásilky, nebo Vývoj s tokenem ze sandboxu InPost (sandbox-manager.paczkomaty.pl).
  4. V poli Jak InPost převezme vaše zásilky zvolte, jak zásilky předáváte:
    • Svoz kurýrem z mé adresy: zásilky vyzvedne kurýr InPost, při pravidelném svozu domluveném s InPostem nebo při svozu, který objednáte v Manageru Paczek.
    • Podávám je v libovolném Paczkomatu nebo PaczkoPunktu
    • Podávám je v PaczkoPunktu
    • Vozím je na pobočku InPost
  5. Vyberte Velikost zásilky pro zásilky do Paczkomatu a pro InPost Kurier C2C. Viz Velikosti zásilek.
  6. V poli Kurýrní služba pro objednávky bez Paczkomatu vyberte InPost Kurier standard (kurýrní smlouva) nebo InPost Kurier C2C (předplacený účet). Produkt AUTO ji použije pro objednávky bez výdejního místa InPost.
  7. Vyplňte pole Výchozí délka balíku v milimetrech, Výchozí šířka balíku v milimetrech a Výchozí výška balíku v milimetrech. InPost Kurier standard a express potřebují rozměry zásilky.
  8. Vyplňte údaje odesílatele, nebo je nechte všechny prázdné a na štítku budou údaje vašeho účtu InPost (Manager Paczek, Moje konto → Dane). Pokud je vyplňujete, vyplňte všechny: Název firmy odesílatele, Název odesílatele, Ulice odesílatele, Číslo popisné odesílatele, Město odesílatele, PSČ odesílatele, Telefon odesílatele a Email odesílatele. Telefon odesílatele je polské devítimístné číslo, s předvolbou +48 nebo bez ní.
  9. 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. Když je volba zapnutá, objednávka se po exportu splní se sledovacím číslem InPost, s InPostem jako dopravcem a s odkazem na sledovací stránku.
    • Automaticky označit objednávky číslem sledování přidá k objednávce sledovací číslo jako tag.
    • Vlastní tag po exportu přidá váš vlastní tag po každém úspěšném exportu.

Produkt v GlobeDoručení
InPost (Paczkomat if selected, otherwise courier to the address)Na výdejní místo InPost, které si zákazník vybral v pokladně, jinak kurýrní službou z nastavení na adresu
InPost Paczkomat or PaczkoPunkt (pickup point)Na výdejní místo InPost vybrané v pokladně
InPost Kurier standard (address)Kurýrem na adresu, vyžaduje kurýrní smlouvu
InPost Kurier C2C (address, prepaid account)Kurýrem na adresu
InPost Kurier express by 10:00, 12:00 or 17:00 (address)Expresním kurýrem na adresu, vyžaduje kurýrní smlouvu

InPost povoluje služby pro každý účet zvlášť. Pokud váš účet některou službu nemá, Globe vám to oznámí dřív, než cokoli odešle. Požádejte InPost o její povolení, nebo zvolte jiný produkt.

Zásilky kurýrních služeb nelze podat v libovolném Paczkomatu nebo PaczkoPunktu a zásilky InPost Kurier C2C nelze podat na pobočce InPost. Svoz kurýrem a podání v PaczkoPunktu fungují pro každou službu.


Objednávky můžete exportovat do InPostu a přepravní štítky tisknout přímo ze Shopify, hromadně i jednotlivě. Samotný postup tvorby štítků najdete v průvodci Vytváření přepravních štítků.

Export objednávky vytvoří jednu zásilku InPost. InPost zásilku během několika sekund potvrdí a přidělí jí sledovací číslo. Zásilky se sledují na adrese https://inpost.pl/sledzenie-przesylek?number=<tracking number>. Číslo objednávky v Shopify se tiskne na každý štítek jako reference.

Pokud InPost zásilku včas nepotvrdí, Globe ji zruší a nic se neodešle. Potvrzenou zásilku už přes API zrušit nelze.

Štítky se z InPostu stahují při každém tisku, takže štítek můžete později vytisknout znovu.

Integrace nesynchronizuje stavy doručení zpět do Shopify.


Zásilky do Paczkomatu a InPost Kurier C2C se objednávají podle velikosti, do 25 kg:

VelikostNázev v Globe
AMalá (A, 8 × 38 × 64 cm)
BStřední (B, 19 × 38 × 64 cm)
CVelká (C, 41 × 38 × 64 cm)
DExtra velká (D, 50 × 50 × 80 cm, jen InPost Kurier C2C)

InPost účtuje podle velikosti a zásilka se musí vejít do schránky Paczkomatu. InPost Kurier standard a express místo toho používají výchozí rozměry v milimetrech a přijímají zásilky až do 50 kg. Globe hmotnost zásilky zkontroluje před exportem.


Globe posílá název výdejního místa InPost, například KRA010 pro Paczkomat nebo POP-WAW364 pro PaczkoPunkt. InPost doručuje jen na místa v Polsku. Zákazník místo vybírá v pokladně. Jak nabídnout výdejní místa InPost, popisuje průvodce Přidání výdejních míst. Přijímají se i Paczkomaty InPost v Polsku ze seznamu míst Zásilkovny (Packeta).

Objednávka s výdejním místem jiného dopravce se neexportuje. Vyberte místo InPost akcí Upravit výdejní místo, nebo použijte kurýrní produkt.

InPost posílá zákazníkovi kód pro vyzvednutí na e-mail i na telefon, takže objednávky na výdejní místo potřebují obojí. Telefon může být polský, nebo zahraniční s předvolbou země, například +420 777 123 456.


InPost vybírá dobírku jen v PLN. Globe ke každé zásilce na dobírku přidá pojištění alespoň ve výši dobírky, jak InPost vyžaduje. Objednávka v jiné měně se neexportuje: pošlete ji jiným dopravcem, nebo nastavte pole Dobírka v panelu štítků na 0, pokud je objednávka už zaplacená.


Štítky InPost lze tisknout v těchto formátech:

FormátŠtítky
A6 (10x15 cm)Jeden štítek na stránku
A4Štítky do Paczkomatu na archu A4, nejvýše čtyři na arch; kurýrní štítky zůstávají A6

Štítky více objednávek se spojí do jednoho PDF. Pokud InPost některé štítky nevrátí, Globe vytiskne ostatní a oznámí vám, které zásilky chybí.


ProblémŘešení
InPost settings are incompleteZpráva vypíše chybějící nastavení. Doplňte je v nastavení dopravce.
InPost rejected the API tokenZkontrolujte API token ShipX v nastavení dopravce. Je to token z Manageru Paczek (Moje konto → API).
InPost did not accept organization … for this API tokenZkontrolujte ID organizace. Najdete ho vedle tokenu v Manageru Paczek.
… is not enabled on your InPost accountPožádejte InPost o povolení služby, nebo zvolte jiný produkt InPost.
InPost Kurier standard and express need an InPost courier contractNa předplaceném účtu zvolte InPost Kurier C2C.
… parcels cannot be handed over at …Zvolte jinou možnost v poli Jak InPost převezme vaše zásilky, nebo jiný produkt InPost. Viz Produkty.
Order … has no InPost Paczkomat or PaczkoPunktObjednávka nemá výdejní místo InPost, nebo její místo patří do sítě jiného dopravce. Vyberte místo InPost akcí Upravit výdejní místo, nebo použijte kurýrní produkt.
InPost Poland delivers within Poland onlyInPost Poland posílá jen na adresy a výdejní místa v Polsku. Pošlete objednávku jiným dopravcem.
InPost cannot use the receiver's phone number …InPost přijímá polské číslo (9 číslic, s +48 nebo bez) nebo číslo s předvolbou ze zemí, které InPost uvádí, například +420 777 123 456. Opravte telefon v doručovací adrese objednávky a vytvořte štítek znovu.
Order … has no e-mail addressInPost posílá kód pro vyzvednutí na e-mail i telefon zákazníka. Doplňte k objednávce e-mail.
InPost Kurier needs street, house number, postcode and cityOpravte adresu v Shopify a vytvořte štítek znovu.
… needs the parcel dimensionsVyplňte v nastavení dopravce Výchozí délka balíku v milimetrech, Výchozí šířka balíku v milimetrech a Výchozí výška balíku v milimetrech.
Order … weighs … kgPokud je hmotnost špatně, opravte Hmotnost zásilky (kg) v panelu štítků. Jinak použijte jiný produkt nebo dopravce.
InPost collects cash on delivery only in PLNPošlete objednávku jiným dopravcem, nebo nastavte pole Dobírka na 0, pokud je objednávka už zaplacená.
InPost does not accept new shipments for this account (debt collection)Zaplaťte poslední fakturu od InPostu, nebo dobijte předplacený účet v Manageru Paczek.
InPost did not confirm the shipment … so Globe cancelled itNic se neodeslalo. Vytvořte štítek znovu za pár minut.
… Check … before creating the label againInPost zásilku včas nepotvrdil, nebo Globe nedokázal přečíst jeho odpověď, ale zásilka může existovat. Než objednávku exportujete znovu, zkontrolujte Manager Paczek.
Štítek v PDF chybíGlobe vytiskne ostatní štítky a vypíše chybějící zásilky. Tisk zopakujte později, nebo si štítek stáhněte v Manageru Paczek.