One by Allegro API

Globe Pickup Points integruje s One by Allegro (dříve WEDO), českým dopravcem, který doručuje do automatických boxů, na výdejní místa Intime a na adresy, a to prostřednictvím API OneDelivery 3.0. S touto integrací můžete:

Exportovat objednávky do One by Allegro přímo ze Shopify
Tisknout přepravní štítky přímo v Shopify
Doručovat do automatického boxu, na výdejní místo nebo na adresu zákazníka
Vybírat dobírku

Aktivace integrace One by Allegro 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 One by Allegro.
Zadejte ID tokenu a API heslo. Oba údaje najdete v klientské zóně One by Allegro v nastavení API. Pokud je nemáte, kontaktujte podporu One by Allegro (eshop-onecz@allegro.com).
Kliknutím na Otestovat připojení ověřte, že jsou přihlašovací údaje přijaty, ještě než uložíte.
Vyplňte adresu odesílatele — Odesílatel — název firmy, Odesílatel — ulice, Odesílatel — číslo popisné, Odesílatel — město a Odesílatel — PSČ. Adresa odesílatele se tiskne na každý štítek, používá se pro svoz zásilek a odesílá se s každou zásilkou (One by Allegro nepoužívá výchozí adresu uloženou u vašeho účtu). Integrace vždy odesílá jako zemi odesílatele Česko.
Vyplňte Výchozí délka balíku v milimetrech, Výchozí šířka balíku v milimetrech a Výchozí výška balíku v milimetrech. Tato pole jsou povinná — One by Allegro zamítá zásilky bez rozměrů balíku.
Volitelně nastavte Výchozí hmotnost (kg), která se použije, když produkt nemá v Shopify uvedenou hmotnost.
Podle potřeby nakonfigurujte možnosti plnění a označování objednávek.
Namapujte vaše Shopify dopravní metody na One by Allegro.

Export a tisk štítků

Objednávky lze exportovat do One by Allegro 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ů.

Z každé exportované objednávky vznikne jedna zásilka s jedním balíkem. Vrácené číslo balíku se používá jako sledovací číslo a odkaz pro sledování vede na stránku pro sledování One by Allegro. Pokud je zapnuté automatické plnění, objednávka se v Shopify splní se sledovacím číslem a názvem dopravce One by Allegro.

API přijímá v popisu zásilky a v referenčních polích pouze písmena, číslice, mezery, čárky a tečky. Globe je automaticky ošetří — popis má tvar Order <název objednávky> a název objednávky se používá jako referenční číslo 1, zkrácený na 20 znaků.

Způsoby doručení

One by Allegro určuje způsob doručení při exportu podle Typ produktu, který vyberete. Výchozí hodnota je AUTO, u které by většina obchodníků měla zůstat.

Typ produktu	Chování
AUTO	Použije výdejní místo One by Allegro vybrané při objednávce — z automatického boxu se stane BOX, z pobočky PUDO. Pokud objednávka nemá místo One by Allegro, zásilka jde na doručovací adresu.
TO_DOOR	Doručení na adresu zákazníka. Případně vybrané výdejní místo se ignoruje.
BOX	Doručení do automatického boxu One Box. Vyžaduje místo One by Allegro na objednávce.
PUDO	Doručení na obsluhované výdejní místo (pobočka Intime). Vyžaduje místo One by Allegro na objednávce.

Pokud výslovně zvolíte BOX nebo PUDO a objednávka nemá výdejní místo One by Allegro, export se u dané objednávky zamítne. Kódy míst pocházejí z výdejního místa, které zákazník vybral ve výběru Globe — viz Přidání výdejních míst.

Všechny zásilky se exportují se službou Standard. Česká a slovenská telefonní čísla příjemců se automaticky převádějí do mezinárodního formátu (+420 / +421), aby bylo možné odesílat SMS upozornění dopravce.

Hmotnost a rozměry balíku

One by Allegro zamítá zásilky bez rozměrů balíku, takže výchozí hodnoty v nastavení dopravce jsou povinné, nikoli volitelné.

Hmotnost — přebírá se ze Shopify objednávky. Pokud objednávka nemá hmotnost, použije se Výchozí hmotnost (kg) z nastavení dopravce. Pokud není k dispozici ani jedna, export dané objednávky selže.
Rozměry — vždy se přebírají z polí Výchozí délka / šířka / výška balíku v milimetrech. Pokud je kterékoli z nich prázdné nebo nulové, export selže se zprávou, abyste je doplnili.

Dobírka (COD)

One by Allegro podporuje dobírku. Pokud objednávka používá platební metodu na dobírku, částka dobírky se přebírá z objednávky a odesílá se se zásilkou v měně objednávky. V nastavení dopravce není samostatné pole pro bankovní účet — výplaty se řeší přes vaši smlouvu s One by Allegro.

Stav doručení

Synchronizace stavů doručení není k dispozici. One by Allegro není součástí synchronizace stavů doručení v Globe, takže se stavy zásilek nezapisují zpět do Shopify. Sledovací číslo a odkaz pro sledování se k plnění připojují i tak, takže zákazníci mohou zásilku sledovat na stránce dopravce.

Tisk štítků

One by Allegro vrací štítky jako jediné PDF pokrývající celou tištěnou dávku, a to v jednom ze dvou formátů:

Formát	Popis
PDF_A6	Jeden štítek na stránku (výchozí)
PDF_A4	Jeden štítek na stránku A4

API OneDelivery neumí tisknout od zvolené pozice na archu, takže u tohoto dopravce nelze částečně použité archy se štítky znovu využít.

Vratky a rušení zásilek

Štítky pro vrácení nejsou v této integraci podporovány.
Zásilky nelze zrušit. API OneDelivery nemá endpoint pro zrušení ani smazání. Jakmile je objednávka exportována, zásilka zůstává ve vašem účtu One by Allegro — buď zásilku prostě nepředávejte, nebo ji vyřešte v portálu One by Allegro.

Řešení problémů

Problém	Řešení
`Failed to authenticate with One by Allegro`	Zkontrolujte ID tokenu a API heslo v nastavení dopravce a použijte Otestovat připojení. Odpověď 401 znamená neplatné přihlašovací údaje.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	Typ produktu je nastaven na BOX nebo PUDO, ale objednávka nemá výdejní místo One by Allegro. Použijte AUTO nebo TO_DOOR, případně zkontrolujte, že zákazník při objednávce vybral místo One by Allegro.
`Order … has no weight`	Nastavte hmotnost produktu v Shopify, zadejte hmotnost ručně při exportu, nebo vyplňte Výchozí hmotnost (kg).
`default package dimensions are not set`	Vyplňte výchozí délku, šířku a výšku (v milimetrech) v nastavení One by Allegro — API je vyžaduje u každé zásilky.
Příjemce nedostává upozornění od dopravce	Automatickou předvolbu země dostávají pouze česká a slovenská čísla. U ostatních zemí uložte na objednávku telefonní číslo v plném mezinárodním formátu.
`One by Allegro did not return a PDF label`	API vrátilo něco jiného než PDF. Zkuste tisk znovu; pokud selhává opakovaně, kontaktujte podporu One by Allegro s číslem zásilky.
Objednávka exportována omylem	Zásilky nelze přes API smazat. Zásilku nepředávejte a vyřešte ji v portálu One by Allegro.

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