DHL Express API

Globe Pickup Points integruje s DHL Express přes MyDHL API, což umožňuje celosvětovou expresní přepravu přímo ze Shopify. S touto integrací můžete:

Exportovat objednávky do DHL Express a okamžitě získat sledovací číslo
Tisknout přepravní štítky přímo v Shopify
Doručovat na adresu zákazníka nebo na DHL Express Service Point
Odesílat kompletní celní data (HS kódy, podmínky DDP nebo DAP) u mezinárodních zásilek

DHL Express zapínáme jednotlivým obchodům na vyžádání. Pokud jej při přidávání nového dopravce nevidíte, kontaktujte podporu a my jej pro váš obchod zapneme.

Aktivace integrace DHL Express 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 DHL Express.
Vyberte Prostředí — Produkce pro ostré zásilky, nebo Vývoj (test) pro testovací prostředí MyDHL. Testovací a produkční přihlašovací údaje se liší.
Zadejte Uživatelské jméno a Heslo — vaše přihlašovací údaje k DHL Express API z Developer Portálu DHL nebo od vašeho account manažera DHL.
Zadejte Číslo účtu — účet DHL Express, na který se zásilky fakturují.
Vyplňte údaje o odesílateli, které se použijí na každém štítku: Název odesílatele, Adresa odesílatele (ulice a číslo), Město odesílatele, PSČ odesílatele, Země odesílatele, Telefon odesílatele a Email odesílatele. V seznamu zemí jsou nabízeny pouze země podporované touto integrací.
Zadejte Výchozí popis obsahu zásilky — krátký popis obsahu zásilky pro celní účely (například Zboží nebo Oblečení). Toto pole je povinné: objednávka bez popisu, ať už výchozího, nebo na úrovni objednávky, se neexportuje.
Volitelně nastavte v pokročilých nastaveních Výchozí HS kód a Výchozí hmotnost (kg), které se použijí, když je produkty nemají.
Podle potřeby nastavte Automaticky splnit objednávky, Automaticky označit objednávky číslem sledování a Vlastní tag po exportu.
Namapujte vaše Shopify dopravní metody na služby DHL Express povolené na vašem účtu.

Export a tisk štítků

Objednávky lze exportovat do DHL Express a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě. Obecný postup najdete v průvodci Vytváření přepravních štítků.

Každá objednávka se odesílá jako jeden balík. DHL vrací sledovací číslo a PDF se štítkem ve stejné odpovědi, takže štítky jsou připraveny k tisku ihned po exportu. Pokud je zapnuto Automaticky splnit objednávky, vytvoří se plnění se sledovacím číslem a odkazem na sledování DHL.

Jedna věc, kterou tato integrace nedělá: neobjednává svoz kurýrem. Zásilky se vytvářejí bez požadavku na svoz — svoz si s DHL domluvte jako obvykle.

Typy služeb

Služba	Popis
DHL Express Worldwide	Standardní expresní doručení z domu do domu
DHL Express Worldwide – Service Point (D2SVP)	Doručení na DHL Express Service Point
DHL Express 12:00	Doručení s garantovaným časem do 12:00
DHL Express 10:30	Doručení s garantovaným časem do 10:30
DHL Express 9:00	Doručení s garantovaným časem do 09:00
DHL Economy Select	Ekonomická služba

Globe vybírá z vámi zvolené služby kód produktu DHL, který odpovídá dané trase — vnitrostátní, v rámci EU, nebo celosvětové. Služba přesto musí být aktivní na vašem účtu DHL; DHL zamítá zásilky s produkty, které nemáte sjednané.

Service Point vs. doručení na adresu

Service Point (D2SVP) — zásilka je doručena na DHL Express Service Point, který zákazník vybral při objednávce. Globe odesílá 6znakové ID pobočky MyDHL spolu s doplňkovou službou DHL Service Point, takže štítek nese označení SPD. Service Point se nastavuje jako příjemce a vlastní adresa zákazníka se odesílá jako kupující, což DHL u této služby vyžaduje.
Doručení na adresu — všechny ostatní služby doručují na doručovací adresu zákazníka.

Export na Service Point vyžaduje skutečné místo DHL Express, převzaté z mapy výdejních míst DHL Express (nastavené se stejnými přihlašovacími údaji MyDHL — viz Přidání výdejních míst). Objednávky bez výdejního místa nebo s místem ze sítě jiného dopravce jsou při exportu zamítnuty.

Clo a poplatky

Zásilky, které překračují celní hranici — tedy jiné než vnitrostátní nebo v rámci EU — se exportují s kompletním elektronickým celním prohlášením sestaveným z položek objednávky: popis, množství, jednotková cena, hmotnost, HS kód a země výroby. HS kódy pocházejí z harmonizovaného kódu produktu v Shopify a záložně z vašeho Výchozí HS kód; země výroby pochází ze země původu produktu a záložně z vaší země odesílatele.

V sekci Clo a poplatky v nastavení dopravce:

Nastavení	Účinek
DDP země	Destinace odesílané za podmínek DDP (clo a daně se fakturují vám). Všechny ostatní používají DAP.
Posílat hodnoty bez DPH pro země	U vybraných destinací se deklarovaná hodnota odesílá bez DPH.

U jednotlivé objednávky můžete v dialogu pro tvorbu štítku před exportem přepsat HS kód a Popis obsahu.

Dobírka (COD)

Dobírka se do DHL odesílá jako doplňková služba výběru hotovosti. Částkou je nezaplacená částka objednávky v měně objednávky, vybíraná v hotovosti. Dobírka musí být povolena na vašem účtu DHL Express a musí být dostupná na dané trase — DHL Express ji nabízí jen v omezeném počtu zemí, takže si ji před nasazením v checkoutu ověřte s DHL. Pokud služba není k dispozici, DHL zamítne celou zásilku.

Stav doručení

Synchronizace stavů doručení není u DHL Express k dispozici — stavy se nezapisují zpět do Shopify. Sledovací číslo a odkaz pro sledování se k plnění připojují i tak, takže zásilku lze sledovat na dhl.com. Podporovány nejsou ani štítky pro vrácení.

Tisk štítků

Štítky se generují jako PDF v rozlišení 300 DPI v následujících formátech:

Formát	Počet pozic na archu
A6	1
A6 na A4	4

Při tisku A6 na A4 můžete vybrat počáteční pozici na archu (pozice 1–4) a opakovaně tak použít částečně použité archy. Štítky se ukládají při exportu, takže opakovaný tisk už DHL nevolá.

Řešení problémů

Problém	Řešení
Chyba ověření	Zkontrolujte, že Uživatelské jméno, Heslo a Číslo účtu odpovídají zvolenému Prostředí — testovací údaje v produkci nefungují.
Popis obsahu je povinný	Nastavte v nastavení dopravce Výchozí popis obsahu zásilky, nebo u objednávky vyplňte Popis obsahu.
Service Point: nebylo vybráno výdejní místo	Objednávka používá službu Service Point, ale nemá výdejní místo. Zákazník jej při objednávce nevybral.
Service Point: výdejní místo musí být 6znakové ID pobočky	Vybrané místo nepochází ze sítě DHL Express. Zákazník musí vybrat DHL Express Service Point.
Neznámý typ produktu	Dopravní metoda je namapovaná na službu, která už neexistuje. Namapujte dopravní metodu v nastavení dopravce znovu.
Zásilka zamítnuta DHL	Kompletní chybová zpráva DHL se zobrazí ve výsledku exportu — obvykle jde o produkt nepovolený na vašem účtu, neplatné PSČ nebo chybějící telefonní číslo.
Při tisku nebyla nalezena data štítku	U těchto objednávek chybí uložený štítek. Exportujte objednávky znovu a vygenerujte nové štítky.

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