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”- 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.
- 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.
- 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ů.
- 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í).
- 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é. - 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.
- 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.
- 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.
Export a tisk štítků
Sekce “Export a tisk štítků”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 s0na 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.
Typy služeb
Sekce “Typy služeb”Typ služby vyberte při exportu objednávky, nebo ho v nastavení dopravce přiřaďte k dopravní metodě:
| Typ služby | Kam 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 address | Vždy na adresu zákazníka, i když má objednávka výdejní místo. |
| Speedy to office or locker | Na 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 a boxy Speedy
Sekce “Pobočky a boxy Speedy”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
BGa za ním ID pobočky Speedy doplněné na pět číslic:BG08009je 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.
Dobírka (COD)
Sekce “Dobírka (COD)”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.
Tisk štítků
Sekce “Tisk štítků”Štítky Speedy jsou soubory PDF. K dispozici jsou následující formáty:
| Formát | Počet pozic na archu |
|---|---|
| 10x15 cm | 1 |
| A6 on A4 | 4 (na jednom archu A4) |
| A4 | 1 (š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.
Řešení problémů
Sekce “Řešení problémů”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 heslo | Zkontrolujte 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ích | Opravte 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 site | Speedy 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 Speedy | Mí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 Speedy | Vyberte 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 EUR | Objedná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á hmotnost | Nastavte 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řipojit | Nic nevzniklo. Zkuste to znovu za minutu. |
| Speedy neodpověděl včas, spojení se přerušilo, nebo Speedy zásilku nepotvrdil | Zá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 Speedy | Dří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. |