Přeskočit na obsah

FAN Courier API

Globe Pickup Points se napojuje na rumunskou kurýrní společnost FAN Courier, která má boxy FANbox, výdejní místa PayPoint a pobočky FAN. S touto integrací můžete:

  • Exportovat objednávky do FAN Courier přímo ze Shopify
  • Tisknout přepravní štítky přímo v Shopify
  • Posílat zásilky v rámci Rumunska na adresu zákazníka, do boxu FANbox, na PayPoint nebo na pobočku FAN
  • Vybírat dobírku v RON
  • Sledovat zásilky na sledovací stránce FAN Courier

Aktivace integrace FAN Courier API

Sekce “Aktivace integrace FAN Courier 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 FAN Courier.
  2. Zadejte Uživatelské jméno do selfAWB a Heslo do selfAWB, tedy uživatelské jméno a heslo, kterými se přihlašujete do selfAWB. FAN Courier dává přístup k API zákazníkům s podepsanou smlouvou. Pokud smlouvu máte, ale přihlášení do selfAWB ne, napište na selfawb@fancourier.ro.
  3. Zadejte Client ID (pobočka) pobočky FAN Courier, ze které posíláte. Najdete ho v selfAWB. Adresa pobočky se na každém štítku uvádí jako odesílatel. Pokud má váš účet jen jednu pobočku, nechte pole prázdné a Globe použije tuto pobočku.
  4. ePOD (štítky 10,5x14,8 cm) zapněte jen tehdy, když máte ve smlouvě s FAN Courier aktivní ePOD. S ePOD tiskne FAN Courier štítek 10,5×14,8 cm pro termotiskárny a doručení potvrzuje e-mailem místo na papíře. Bez ePOD je štítkem formulář AWB ve formátu A5.
  5. Podle potřeby nastavte možnosti plnění a označování objednávek:
    • Automaticky splnit objednávky: splní objednávku v Shopify s číslem AWB a odkazem pro sledování, s e-mailem o odeslání objednávky nebo bez něj.
    • Automaticky označit objednávky číslem sledování: přidá číslo AWB jako tag objednávky.
    • Vlastní tag po exportu a Vlastní tag po tisku: přidají váš tag po každém úspěšném exportu nebo tisku.
  6. Zvolte Výchozí formát tisku (viz Tisk štítků).
  7. Klikněte na Zobrazit pokročilá nastavení a nastavte:
    • Rozměry zásilky (cm): délka x šířka x výška, například 30x20x10. FAN Courier vyžaduje rozměry u každého AWB a Globe je posílá u všech zásilek z tohoto účtu. Když pole necháte prázdné, pošle se 30x20x10.
    • Výchozí hmotnost (kg): výchozí hmotnost zásilky v kilogramech. Když zůstane prázdné, nepoužije se.
  8. Své dopravní metody v Shopify namapujte na typy služeb FAN Courier (viz Typy služeb). Mapování je volitelné a typ služby můžete změnit při vytváření štítku.

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

Pro každou exportovanou objednávku Globe vytvoří jeden AWB s jedním balíkem. Štítky FAN Courier v Globe pokrývají jen doručení v rámci Rumunska. Číslo AWB je sledovací číslo a zásilky se sledují na adrese https://www.fancourier.ro/awb-tracking/?tracking=<AWB number>.

Každý AWB Globe sestaví z údajů objednávky a z vašeho nastavení:

  • Odesílatel: vaše pobočka FAN Courier. Dopravu platí odesílatel.
  • Hmotnost: povinná. Nastavte hmotnosti produktů v Shopify, zadejte hmotnost do pole Hmotnost zásilky (kg) v panelu štítků, nebo nastavte Výchozí hmotnost (kg). FAN Courier eviduje jen celé kilogramy, proto Globe hmotnost zaokrouhlí na nejbližší kilogram, nejméně na 1 kg.
  • Rozměry: Rozměry zásilky (cm) z nastavení dopravce, každá strana zaokrouhlená nahoru na celé centimetry.
  • Telefon: povinný. Rumunská čísla se posílají v národním tvaru, například 0723456789.
  • Adresa: pro doručení na adresu potřebuje doručovací adresa ulici a rumunskou župu. Šestimístné PSČ se pošle, pokud ho adresa obsahuje.
  • Číslo objednávky: tiskne se na štítek a posílá se jako nákladové středisko AWB, které FAN Courier uvádí v přehledu přepravních listů.

Globe neopakuje požadavek na AWB, u kterého vypršel časový limit, protože FAN Courier už mohl AWB vytvořit. Co v takovém případě dělat, najdete v části Řešení problémů.


Typ služby vyberte v poli Typ při vytváření štítku, nebo ho namapujte na své dopravní metody:

Typ službyKam doručuje
FAN Courier (pickup point if selected, otherwise address)Na místo FAN Courier, které zákazník vybral v pokladně. Objednávka bez výdejního místa jde na adresu zákazníka.
FAN Courier Standard (address)Na adresu zákazníka, i když má objednávka výdejní místo.
FAN Courier pickup point (FANbox, PayPoint or FAN office)Na místo FAN Courier uvedené v objednávce. Objednávka bez něj se odmítne.

U prvního a třetího typu služby se objednávka, jejíž výdejní místo patří do jiné sítě, odmítne a Globe ji nepošle ani na adresu zákazníka. Pokud ji chcete poslat na adresu, zvolte FAN Courier Standard (address). Když je objednávka s výdejním místem nastavená na FAN Courier Standard (address), panel štítků před exportem zobrazí upozornění.

Globe vybírá službu FAN Courier podle cíle a podle toho, jestli je objednávka na dobírku:

CílSlužbaSlužba s dobírkou
Adresa zákazníkaStandardCont Colector
Pobočka FANStandardCont Colector
FANboxFANboxFANbox Cont Colector
PayPointCollectPointCollectPoint Cont Colector

Zásilky na výdejní místo jdou na vlastní místa FAN Courier, která si zákazník vybírá v pokladně z výdejních míst FAN Courier v Globe.

MístoID začíná naMax. hmotnostMax. rozměry
FANbox (výdejní box)F30 kg44×45×40 cm
PayPointP10 kg60×90×60 cm
Pobočka FANSbez limitubez limitu
  • Před vytvořením AWB Globe ověří, že hmotnost a Rozměry zásilky (cm) nepřekračují tyto limity. Každá strana se zaokrouhlí nahoru na celé centimetry a balík se může libovolně natočit, aby se vešel. U poboček FAN Globe žádný limit hmotnosti ani rozměrů nekontroluje.
  • AWB obsahuje ID místa spolu s župou a obcí, které FAN Courier pro místo uvádí a které Globe dohledá při vytváření štítku. Ulice zákazníka se neposílá.
  • Doručení do boxu FANbox potřebuje kvůli kódu pro vyzvednutí rumunské mobilní číslo zákazníka (07xxxxxxxx) a e-mail.

FAN Courier vybírá dobírku jen v RON, nejvýše 10 000 RON na objednávku. Ostatní objednávky na dobírku Globe odmítne dřív, než vznikne AWB.

Když byla objednávka zadaná s platební metodou na dobírku, Globe vyplní částku dobírky z objednávky. Můžete ji změnit v poli Dobírka v panelu štítků.

Objednávky na dobírku používají variantu služby Cont Colector (viz Typy služeb), která vybrané peníze vyplácí na bankovní účet pobočky FAN Courier, ze které posíláte.

CílDobírka
Adresa zákazníkaPodporována
Pobočka FANPodporována
FANboxZákazník platí v boxu kartou. Platba kartou (mPOS) musí být aktivní ve vaší smlouvě s FAN Courier, jinak FAN Courier AWB odmítne.
PayPointOdmítne se, když PayPoint nepřijímá platby. Globe to zkontroluje dřív, než vytvoří AWB.

Štítky FAN Courier lze tisknout v následujících formátech. Výchozí formát nastavíte v poli Výchozí formát tisku.

Možnost tiskuCo se vytiskne
10.5x14.8 cm (ePOD, else A5)AWB s ePOD jako štítek 10,5×14,8 cm, ostatní AWB jako formulář AWB A5
A5Formulář AWB A5
A4Formulář AWB A5 na stránce A4

Každá možnost tisku má na archu jednu tiskovou pozici, takže se počáteční pozice nevybírá. AWB je typu ePOD, pokud vznikl při zapnuté volbě ePOD (štítky 10,5x14,8 cm). Když váš výběr kombinuje AWB s ePOD a ostatní AWB, Globe je vytiskne do jednoho PDF a stránky stejné velikosti seskupí za sebou.

Globe stahuje štítky od FAN Courier při každém tisku. Pokud FAN Courier některé nevrátí, Globe vytiskne zbytek a vypíše chybějící AWB. Objednávky s chybějícím štítkem se nepočítají jako vytištěné a nedostanou Vlastní tag po tisku.


ProblémŘešení
Uživatelské jméno a heslo nejsou nastavené, nebo je FAN Courier odmítlDo polí Uživatelské jméno do selfAWB a Heslo do selfAWB zadejte uživatelské jméno a heslo, kterými se přihlašujete do selfAWB. Pokud smlouvu máte, ale přihlášení do selfAWB ne, napište na selfawb@fancourier.ro.
FAN Courier není dostupný, nebo přihlášení selhalo s kódem HTTPGlobe se nemohl připojit k FAN Courier, takže žádný AWB nevznikl. Zkuste to později znovu.
Váš účet má několik poboček, Client ID není číslo, nebo FAN Courier nevrátil žádnou pobočkuDo pole Client ID (pobočka) zadejte Client ID pobočky, ze které posíláte, jak ho zobrazuje selfAWB. Použijte jen číslice. Při více pobočkách je zpráva vypíše i s jejich Client ID.
Štítky FAN Courier v Globe pokrývají jen doručení v rámci RumunskaDoručovací adresa je mimo Rumunsko. Objednávky do jiných zemí posílejte jiným dopravcem.
Výdejní místo není FANbox, PayPoint ani pobočka FAN CourierMísto patří do jiné sítě, nebo jeho ID není ID FAN Courier. Akcí Upravit výdejní místo vyberte místo FAN Courier, nebo zvolte FAN Courier Standard (address) a pošlete zásilku na adresu zákazníka.
Objednávka nemá výdejní místo FAN Courier, ale bylo zvoleno doručení na výdejní místo FAN CourierAkcí Upravit výdejní místo vyberte místo FAN Courier, nebo zvolte typ služby s doručením na adresu.
FAN Courier už výdejní místo neuvádí, nebo místo neodpovídá své župě a obciAkcí Upravit výdejní místo vyberte jiné místo FAN Courier.
Objednávka nemá hmotnostNastavte hmotnost produktu v Shopify, zadejte hmotnost do pole Hmotnost zásilky (kg) v panelu štítků, nebo nastavte Výchozí hmotnost (kg) v nastavení dopravce.
Objednávka je příliš těžká, nebo se rozměry zásilky nevejdou do boxu FANbox či na PayPointZkontrolujte limity v části Výdejní místa a svoje Rozměry zásilky (cm). Akcí Upravit výdejní místo vyberte jiné místo, nebo pošlete zásilku na adresu se službou FAN Courier Standard (address).
FAN Courier vybírá dobírku jen v RON, nebo nejvýše 10000 RONViz Dobírka (COD). Takové objednávky posílejte jiným dopravcem.
PayPoint nepřijímá platby, nebo pro FANbox není aktivní platba kartou (mPOS)FANbox vybírá dobírku jen kartou, což vyžaduje platbu kartou (mPOS) ve vaší smlouvě s FAN Courier. PayPoint, který nepřijímá platby, dobírku vybrat nemůže. Akcí Upravit výdejní místo vyberte jiné místo, nebo pošlete zásilku na adresu.
Objednávka nemá telefonní číslo příjemce, nebo doručení do boxu FANbox nemá rumunské mobilní číslo a e-mailDoplňte do objednávky telefonní číslo zákazníka. Doručení do boxu FANbox potřebuje rumunské mobilní číslo (07xxxxxxxx) a e-mailovou adresu.
Župa není rumunská župa, kterou FAN Courier zná, chybí ulice, nebo The selected recipient.locality is invalid.Upravte doručovací adresu v Shopify. Kraj (province) musí být rumunská župa a ulice musí být vyplněná. Pokud FAN Courier nezná město, zkontrolujte jeho pravopis a šestimístné PSČ.
Zpráva vás žádá, abyste před dalším vytvořením štítku zkontrolovali selfAWBFAN Courier mohl AWB vytvořit, aniž by si ho Globe zaznamenal: odpověď nepřišla včas, ztratila se nebo se nedala přečíst, nebo ji Globe nemohl uložit. Než štítek vytvoříte znovu, vyhledejte AWB v selfAWB. Nový export vytvoří druhý AWB.
Jiné zprávy začínající FAN Courier:FAN Courier AWB odmítl a text za dvojtečkou je jeho důvod. Opravte objednávku a vytvořte štítek znovu.
„Printed X of Y FAN Courier labels“ nebo „Error printing FAN Courier labels“FAN Courier nevrátil některé nebo žádné štítky a zpráva uvádí jeho důvod. Při částečném tisku obsahuje PDF štítky, které se vrátily, a zpráva vypíše chybějící AWB.