Nastavení propojení

Balíkobot se k mPOHODĚ připojuje přes její oficiální API pomocí přístupového tokenu. Propojení se skládá ze dvou kroků: nejdřív v mPOHODĚ vytvoříte klienta API pro Balíkobot a pak jeho Client ID a Client Secret zadáte do Balíkobotu.

Vytvoření klienta API v mPOHODĚ

Klienta API vytváří administrátor firmy v mPOHODĚ. V mPOHODĚ otevřete agendu API (app.mpohoda.cz/otevrene-api), v části Přístup pomocí přístupového tokenu kliknete na Nový klient a klienta pojmenujete, např. Balíkobot. mPOHODA vám zobrazí Client ID a Client Secret – oba údaje si zkopírujte.

API je dostupné jen ve variantě mPOHODA Pro. Bez ní mPOHODA připojení odmítne a Balíkobot vypíše hlášku, že funkce je dostupná pouze ve variantě Pro.

Client ID a Client Secret jsou přístupové údaje k vašim dokladům – nikomu je neposílejte. Kdyby se dostaly někam, kam nemají, klienta v agendě API v mPOHODĚ zrušte, vytvořte nového a jeho údaje zadejte do Balíkobotu.

Nastavení v Balíkobotu

V Balíkobotu nejdříve v menu Nastavení/Napojení zvolíte mPOHODA a potvrdíte změnu napojení. Pak na záložce mPOHODA vyplníte:

• Client ID – identifikace klienta API z předchozího kroku.
• Client Secret – heslo klienta API z předchozího kroku. V nastavení se zobrazuje skrytě.

Poté kliknete na Kontrola spojení. Balíkobot se přihlásí do mPOHODY, ověří přístup k přijatým objednávkám a vydaným fakturám a vypíše jejich počet a také to, kolik požadavků na API vám v tomto měsíci zbývá.

Při prvním připojení si Balíkobot sám zjistí ID firmy v mPOHODĚ a zobrazí ho v nastavení. Podle něj ukládá údaje o zásilkách, takže zásilky každé firmy jsou oddělené. Do tohoto pole nic nevyplňujete.

Pokud vedete v mPOHODĚ více firem, vytvořte si v Balíkobotu pro každou firmu jeden profil, viz kap. Profily. Klienta API vytvoříte v každé firmě zvlášť a každý profil má tedy vlastní Client ID a Client Secret.

Načítání dokladů

Ve stejné záložce v části Načítání dokladů si nastavíte, jak se mají doklady z mPOHODY načítat:

• Filtrovat doklady podle data vystavení a Výchozí rozsah datumů – předvyplní filtr Od a Do na hlavní obrazovce, např. jen dnešní doklady nebo doklady za poslední týden. Filtr si tam pak můžete kdykoli změnit.
• Výchozí stav přijatých objednávek – stav, který se ve filtru na hlavní obrazovce nastaví po spuštění Balíkobotu. Na výběr je Nevyřízené a částečně vyřízené (výchozí), Nevyřízené, Částečně vyřízené, Vyřízené a Všechny.

Měsíční limit požadavků na API

mPOHODA Pro umožňuje 8 000 požadavků na API za měsíc, každé rozšíření mCAL přidává dalších 8 000. Do limitu se počítá každý požadavek, který Balíkobot pošle, i ten, který mPOHODA odmítne. Kolik požadavků vám zbývá, uvidíte po kliknutí na Kontrola spojení.

Orientačně Balíkobot spotřebuje:

• načtení objednávek nebo faktur – 1 požadavek na každých 50 dokladů upravených od data Od ve filtru; při prvním načtení po spuštění Balíkobotu navíc několik požadavků na číselníky (způsoby platby, měny),
• vyhledání dokladu podle čísla (např. čtečkou čárových kódů) – 1 až 2 požadavky,
• se zapnutou kontrolou expedice – při každém načtení 1 požadavek navíc na EAN položek z ceníku,
• vystavení faktury z objednávky – 1 požadavek, stažení PDF faktury do e-mailu další 1, viz Vystavení vydané faktury z přijaté objednávky,
• PDF faktury do e-mailu při expedici z vydaných faktur – 1 požadavek, u faktury, která se v tomto spuštění Balíkobotu nenačítala, 2, viz Poslání PDF faktury mailem.

Filtr podle data mějte zapnutý. Bez něj Balíkobot při každém načtení prochází všechny doklady v mPOHODĚ, což je pomalé a spotřebuje hodně požadavků.

Když limit vyčerpáte, mPOHODA další požadavky do konce měsíce odmítá. Balíkobot v tom případě vypíše, kdy se limit obnoví.