Propojte Route Planner Teams se Zapierem

Co můžete automatizovat

Integrace Route Planner Teams v Zapieru má jednu akci, jedno vyhledávání a tři spouštěče:

Create Order

Vloží objednávku do složky Doručené na den doručení: adresa, příjemce, telefon, poznámka, časové okno, čas na zastávce, typ zastávky, kód balíku, podpis.

Find Order

Najde objednávku podle External ID nebo ID objednávky, s příjemcem, adresou a stavem.

Order Delivered

Spustí se, když řidič označí objednávku jako doručenou, s časem a potvrzením doručení: odkazy na fotku a podpis, poznámka.

Order Failed

Spustí se, když řidič označí objednávku jako nedoručenou, s důvodem.

Route Completed

Spustí se, když řidič dokončí trasu, s počtem doručených a nedoručených zastávek.

Order Delivered a Order Failed běží pro objednávky, které přišly přes Zapier nebo API. Zastávky, které přidáte sami na webu, je nespouštějí; Route Completed běží pro každou trasu.

Krok 1. Vytvořte klíč API

Zapier se k vašemu týmu přihlašuje klíčem API. Vytvořit ho může vlastník týmu a dispečeři.

1. Otevřete web Route Planner Teams a přejděte do části Tým.
2. Sjeďte k části Integrace a klikněte na Vytvořit klíč API.
3. Do pole Název napište, k čemu klíč je, například Zapier, a klikněte na Vytvořit klíč API.
4. Klikněte na Kopírovat a mějte klíč po ruce pro krok 2. Začíná na rpt_live_ a zobrazí se jen jednou: po Hotovo ukazuje seznam už jen jeho začátek.

Krok 2. Připojte Route Planner Teams v Zapieru

Integrace zatím není ve veřejném katalogu aplikací Zapieru, proto ji přidáte přes odkaz s pozvánkou.

1. Otevřete odkaz s pozvánkou do Route Planner Teams, přihlaste se do Zapieru nebo si založte bezplatný účet a pozvánku přijměte (Accept Invite & Build a Zap).
2. V editoru Zapu přidejte krok, vyhledejte Route Planner Teams a zvolte událost, například Create Order.
3. V kroku účtu připojte nový účet: Zapier si řekne o API key. Vložte klíč z kroku 1 a pokračujte.
4. Připojení nese název vašeho týmu. Další Zapy můžou použít stejné připojení, takže to děláte jen jednou.

Zapier hlásí, že klíč je neplatný? Zkontrolujte, že je zkopírovaný celý — od rpt_live_ po poslední znak — a že nebyl zneplatněn v části Integrace.

Krok 3. Nový řádek v Tabulkách Google se stane objednávkou

Nejčastější Zap: vy nebo zaměstnanci obchodu zapisujete objednávky do tabulky a každý nový řádek se objeví v Doručených. Začněte tabulkou, jejíž první řádek obsahuje názvy sloupců, například:

1. Vytvořte Zap. Spouštěč: Google Sheets, událost New Spreadsheet Row; zvolte tabulku a list.
2. Akce: Route Planner Teams, událost Create Order a připojení z kroku 2.
3. Pole vyplňte sloupci tabulky jako v přehledu. Bez sloupce Datum nechte Delivery Date prázdné: objednávky půjdou na dnešek.
4. Klikněte na Test step: testovací objednávka se objeví ve složce Doručené v části Trasy v den doručení. Pak Zap publikujte.
5. V části Trasy zaškrtněte objednávky ve složce Doručené a klikněte na Přidat do trasy: založte novou trasu, nebo je přidejte do trasy toho dne. Pak trasu jako obvykle optimalizujte a pošlete řidiči — viz Optimalizace s časovými okny a Přiřaďte řidiče a sledujte den.

Jiné zdroje fungují stejně: zvolte spouštěč „nová objednávka“ svého e-shopu (například v Shopify) nebo „nová odpověď“ formuláře a pak Create Order. Objednávku, kterou nepotřebujete, odstraníte tlačítkem Zahodit.

Krok 4. Dejte vědět zákazníkovi nebo tabulce o doručení

Aktualizace od řidičů neobsahují jméno, telefon ani adresu příjemce — jen External ID objednávky, stav, čas a potvrzení doručení. Podle External ID (vašeho čísla objednávky) objednávku najdete ve vlastní tabulce.

1. Vytvořte Zap se spouštěčem Route Planner Teams, událost Order Delivered. Zapier načte vaše poslední doručené objednávky, nebo ukázku, pokud zatím žádné nejsou.
2. Pro záznam doručení přidejte Google Sheets → Create Spreadsheet Row a vyplňte External ID, Delivered At a Proof of Delivery Photo URLs.
3. Pro e-mail zákazníkovi nejprve přidejte Google Sheets → Lookup Spreadsheet Row: hledejte External ID ve sloupci Číslo objednávky. Pak přidejte Gmail → Send Email na adresu ze sloupce E-mail nalezeného řádku.
4. Zap publikujte. Zapier se k aktualizacím přihlásí hned: v části Integrace se pod Webhooky objeví webhook. Vypnutím Zapu zmizí.

Zap se spustí pár sekund poté, co řidič zastávku označí. Stejně to udělejte s Order Failed, abyste zákazníkovi zavolali nebo doručení přeplánovali, a s Route Completed pro denní souhrn.

Odkazy na fotky a podpis platí 7 dní. Chcete-li je uchovat déle, uložte soubory dalším krokem, například na Disk Google. Zapy s více než jednou akcí můžou vyžadovat placený tarif Zapieru.

Dobré vědět

• External ID proti duplicitám. Do External ID dejte číslo objednávky. Když Zap pro stejnou objednávku proběhne dvakrát, druhý běh najde existující objednávku a novou nevytvoří.
• Čas na zastávce. Pole Service Time (minutes) je doba, kterou řidič na této adrese potřebuje, od 0 do 120. Prázdné — Minut na zastávku trasy.
• Časová okna. Vyplňte obě pole Time Window From i Time Window To ve formátu HH:MM, 24hodinově. Optimalizace naplánuje zastávku do okna.
• Data a adresy. Pole Delivery Date má formát RRRR-MM-DD — tak naformátujte sloupec Datum v tabulce; prázdné — dnešek v časovém pásmu vašeho týmu. Posílejte celou adresu s PSČ a městem, nebo Latitude a Longitude. Když se adresa nenajde, Zap ukáže chybu v historii a objednávka nevznikne; nejistá se objeví v Doručených se značkou zkontrolujte adresu.
• Co se počítá. Objednávka s adresou se v části Předplatné počítá do Adresy vyhledané ze seznamů; poslaná se souřadnicemi ne. Zastávka se počítá, když objednávku přidáte do trasy, jako každá jiná zastávka.
• Limity. Každý klíč API zvládne až 600 požadavků za 10 minut a 5 000 za den. Po dosažení limitu Zapier počká a zkusí to znovu.
• Poloha řidiče. Zapněte Sdílet polohu řidiče na zastávce v části Integrace a aktualizace budou obsahovat, kde byl řidič při označení zastávky.
• Chraňte klíč. Kdo má klíč, může vytvářet objednávky a číst vaše doručení. Používejte jeden klíč na službu, a pokud klíč unikne, klikněte v části Integrace na Zneplatnit: Zapy s ním se hned zastaví. Vytvořte nový klíč a účet v Zapieru připojte znovu.

Pro vývojáře: API

Vše, co umí integrace se Zapierem, je dostupné i přes REST API s webhooky — pro váš vlastní e-shop, systém objednávek nebo skripty. Viz dokumentace API (anglicky).