Přeskočit na obsah

Speedy API

Globe Pickup Points se napojuje na bulharského balíkového dopravce Speedy, který v Bulharsku provozuje síť DPD. S touto integrací můžete:

  • Exportovat objednávky do Speedy přímo ze Shopify
  • Tisknout přepravní štítky přímo v Shopify
  • Posílat zásilky v rámci Bulharska na adresu zákazníka, na pobočku Speedy nebo do boxu Speedy
  • Posílat zásilky na dobírku v EUR, i na pobočky a do boxů

Aktivace integrace Speedy API

Sekce “Aktivace integrace Speedy API”
  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 Speedy.
  2. Zadejte Uživatelské jméno a Heslo k API Speedy. Speedy je vydává zákazníkům se smlouvou: požádejte o ně svého obchodního zástupce Speedy.
  3. V poli Služba Speedy vyberte službu ze své smlouvy se Speedy: Standard 24 hodin (505) nebo Standard 24 hodin – balík (515). Obě služby jsou určené pro zásilky v rámci Bulharska a obě doručují na adresy, na pobočky i do boxů.
  4. V poli Dopravu platí vyberte, kdo platí Speedy za doručení: Odesílatel (moje smlouva se Speedy) nebo Příjemce (platí při doručení).
  5. Pokud zásilky nosíte na pobočku nebo do boxu Speedy, zadejte ID této pobočky nebo boxu do pole Pobočka Speedy, kde zásilky podáváte (například 77). Pokud je kurýr vyzvedává na vaší adrese, nechte pole prázdné.
  6. Volitelně klikněte na Zobrazit pokročilá nastavení:
    • Klientské ID odesílatele: pokud má vaše smlouva se Speedy více adres odesílatele, zadejte klientské ID té, ze které chcete posílat. Když pole necháte prázdné, posílá se z výchozí adresy vašeho účtu Speedy.
    • Client system ID: nechte prázdné, pokud vám Speedy nepřidělil client system ID.
    • Výchozí hmotnost (kg): výchozí hmotnost zásilky v kilogramech. Když pole necháte prázdné, nepoužije se.
  7. 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í: přidá číslo zásilky Speedy k objednávce jako tag.
    • Vlastní tag po exportu: tag, který se k objednávce přidá po každém úspěšném exportu štítku.
  8. Své dopravní metody v Shopify namapujte na typy služeb Speedy popsané v části Typy služeb. Pro dopravní metodu s výdejními místy použijte Speedy (office or locker if selected, otherwise address) nebo Speedy to office or locker. Nepoužívejte pro ni Speedy to address: zásilka by šla na adresu zákazníka.

Pole Pobočka Speedy, kde zásilky podáváte, Klientské ID odesílatele a Client system ID přijímají jen číslice. Globe neposílá do Speedy žádnou adresu odesílatele. Odesílatelem je výchozí adresa vašeho účtu Speedy, nebo adresa odesílatele, kterou nastavíte v poli Klientské ID odesílatele.


Objednávky můžete exportovat do Speedy 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ů.

Globe pro každou objednávku vytvoří jednu zásilku Speedy s jedním balíkem. Číslo zásilky Speedy je zároveň sledovací číslo. Globe ho uloží a štítek stahuje ze Speedy při každém tisku, takže štítek můžete později vytisknout znovu. Na štítku je vytištěno číslo objednávky v Shopify.

Když je zapnuté automatické splnění objednávek, uloží se ke splnění číslo zásilky, Speedy jako dopravce a sledovací odkaz https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.

Štítky Speedy v Globe jsou pro doručení v rámci Bulharska. Před odesláním objednávky Globe zkontroluje údaje, které Speedy vyžaduje:

  • Telefonní číslo příjemce, pro každé doručení: na adresu, na pobočku i do boxu. Speedy ho přijímá ve tvaru +359… nebo s 0 na začátku. Zahraniční čísla fungují ve tvaru s +.
  • Jméno příjemce, alespoň 3 znaky. Pokud má název firmy alespoň 3 znaky, příjemcem je firma a zákazník je uveden jako kontaktní osoba.
  • Pro doručení na adresu: ulici a město nebo čtyřmístné PSČ. Město může být napsané latinkou i cyrilicí. Ulice a řádek adresy 2 mohou mít dohromady nejvýše 200 znaků.

Objednávka, která kontrolou neprojde, se do Speedy neodešle. Ostatní objednávky dávky se zpracují dál.

Integrace Speedy nesynchronizuje stavy doručení zpět do Shopify. Globe zásilky Speedy neruší. Zrušte je ve svém účtu Speedy.


Typ služby vyberte při exportu objednávky, nebo ho v nastavení dopravce přiřaďte k dopravní metodě:

Typ službyKam zásilka jde
Speedy (office or locker if selected, otherwise address)Na pobočku nebo do boxu Speedy, které zákazník vybral v pokladně. Objednávka bez výdejního místa jde na adresu zákazníka.
Speedy to addressVždy na adresu zákazníka, i když má objednávka výdejní místo.
Speedy to office or lockerNa pobočku nebo do boxu Speedy z objednávky. Objednávka bez výdejního místa se odmítne.

Výdejní místo jiné sítě nebo místo DPD mimo Bulharsko zastaví export se službou Speedy (office or locker if selected, otherwise address) i se službou Speedy to office or locker. Globe takovou objednávku nepošle ani na adresu zákazníka. Pro doručení na adresu vytvořte štítek se službou Speedy to address.

Služba vybraná v poli Služba Speedy platí pro všechny tři typy služeb.


Pobočky i boxy Speedy se adresují svým ID pobočky Speedy. Integrace Speedy přijímá místa Speedy ze dvou seznamů výdejních míst:

  • Výdejní místa DPD v Bulharsku. Každé místo DPD v Bulharsku je pobočka nebo box Speedy. ID místa je BG a za ním ID pobočky Speedy doplněné na pět číslic: BG08009 je pobočka Speedy 8009.
  • Pobočky Speedy ze Zásilkovny (dopravce Zásilkovny BG Speedy PP). Jsou to jen pobočky Speedy, bez boxů. ID místa je ID pobočky Speedy.

Místa DPD v jiných zemích nejsou místa Speedy a odmítnou se.

Boxy Speedy přijímají zásilky do 20 kg. Limit poboček je podle pobočky 32 až 1200 kg. Těžší zásilky Speedy odmítne.


Speedy vybírá dobírku v Bulharsku jen v EUR. Částka dobírky se přebírá z objednávky, pokud objednávka používá platební metodu na dobírku. Dobírka funguje při doručení na adresu, na pobočku i do boxu.

Objednávka s dobírkou v jiné měně, včetně BGN, se zastaví dřív, než se odešle do Speedy.


Štítky Speedy jsou soubory PDF. K dispozici jsou následující formáty:

FormátPočet pozic na archu
10x15 cm1
A6 on A44 (na jednom archu A4)
A41 (štítek v horní polovině stránky A4)

Počáteční pozici na archu A4 nelze zvolit. U formátů 10x15 cm a A4 se štítky tisknou v pořadí, ve kterém jste je vybrali. U formátu A6 on A4 je Speedy seřadí podle čísla zásilky.


Když Speedy zásilku odmítne, u Speedy nic nevznikne a Globe zobrazí zprávu od Speedy s nápovědou pro běžné případy.

ProblémŘešení
Nastavení Speedy je neúplnéVyplňte Uživatelské jméno a Heslo. Pole Pobočka Speedy, kde zásilky podáváte, Klientské ID odesílatele a Client system ID přijímají jen číslice.
Speedy odmítl uživatelské jméno nebo hesloZkontrolujte Uživatelské jméno a Heslo v nastavení integrace. Po této chybě Globe zbývající objednávky dávky neodešle.
Telefonní číslo chybí nebo je ve tvaru, který Speedy nepřijímáDoplňte nebo opravte telefonní číslo v Shopify (+359…, číslo začínající 0, nebo zahraniční číslo s +) a vytvořte štítek znovu.
Speedy potřebuje jméno příjemce o alespoň 3 znacíchOpravte jméno v doručovací adrese v Shopify.
Doručovací adresa je mimo Bulharsko, neúplná nebo příliš dlouháŠtítky Speedy v Globe jsou pro adresy v Bulharsku. Adresa potřebuje ulici a město nebo čtyřmístné PSČ. Ulice a řádek adresy 2 mohou mít dohromady nejvýše 200 znaků, město nejvýše 50.
Invalid siteSpeedy nedokázal spárovat město a PSČ, například proto, že PSČ patří jinému městu. Zkontrolujte město a PSČ v doručovací adrese.
Výdejní místo není pobočka ani box SpeedyMísto patří jiné síti, nebo je to místo DPD mimo Bulharsko. Vyberte pobočku nebo box Speedy akcí Upravit výdejní místo, nebo vytvořte štítek se službou Speedy to address a pošlete zásilku na adresu zákazníka.
Objednávka nemá pobočku ani box Speedy, nebo chybí ID pobočky SpeedyVyberte pobočku nebo box akcí Upravit výdejní místo, nebo vytvořte štítek se službou Speedy to address.
Pobočka nebo box je u Speedy zavřený nebo neznámýVyberte jinou pobočku nebo box Speedy akcí Upravit výdejní místo.
Speedy vybírá dobírku jen v EURObjednávka je v jiné měně. Viz Dobírka (COD). Pokud dobírku odmítne přímo Speedy, zkontrolujte částku a svou smlouvu se Speedy.
„The price cannot be determined for provided shipment parameters“Vaše smlouva se Speedy nemá cenu pro tuto službu a plátce. Změňte v nastavení integrace pole Služba Speedy nebo Dopravu platí.
Objednávka nemá hmotnostNastavte hmotnost produktu v Shopify, zadejte hmotnost při vytváření štítku, nebo vyplňte Výchozí hmotnost (kg).
Speedy omezuje požadavky, nebo se Globe nemohl ke Speedy připojitNic nevzniklo. Zkuste to znovu za minutu.
Speedy neodpověděl včas, spojení se přerušilo, nebo Speedy zásilku nepotvrdilZásilka už může existovat. Než štítek vytvoříte znovu, zkontrolujte svůj účet Speedy.
Globe se zastavil před odesláním objednávky do SpeedyDřívější objednávka dávky neměla jasný výsledek, nebo Globe nemohl uložit její zásilku. Pro tuto objednávku nic nevzniklo, takže její štítek můžete vytvořit znovu.
Speedy zásilku vytvořil, ale Globe ji nemohl uložitŠtítek znovu nevytvářejte: Speedy by vytvořil druhou zásilku. Zásilku uvedenou ve zprávě vytiskněte nebo zrušte ve svém účtu Speedy.
„Printed X of Y Speedy labels“ nebo „Error printing Speedy labels“Zpráva uvádí chybějící čísla zásilek a důvod, například číslo zásilky, které Speedy nezná. Pokud je důvodem problém se spojením, zkuste tisk znovu.