¶ Karta přepravce
Na stránce Přepravci lze provádět konfiguraci přepravců, které společnost používá pro dodání zboží svým zákazníkům.
Pro přepravce je potřeba vyplnit tyto pole:
- Kód – zadat kód přepravce. Lze zadat libovolný text, který označuje daného přepravce.
- Název – zadat název přepravce.
- Balíkobot – kód poskytovatele – výběr ze seznamu. Pokud chceme přidat přepravce, který není v tomto seznamu, pak pro něho není připravena v NAV komunikace s Balíkobotem. V tomto případě je nutné kontaktovat dodavatele, aby komunikaci s přepravcem dopracoval.
Vyplněním tohoto pole se automaticky vyplní následující pole, jejichž hodnotu nelze měnit: Balíkobot – kód poskytovatele API, Balíkobot - ID sestavy pro štítky, Balíkobot – ID codeunit. Hodnota v těchto polích je vyplněna dodavatelem modulu Balíkobot a není důvod ji měnit. - Balíkobot – Výchozí kód jednotky balení – výběr z
Balíkobot – jednotek balení. Pokud je zde vyplněna hodnota, pak se v Řádcích balení na dokladu či Pultu balení tato jednotka použije jako výchozí. Pole může být prázdné. - Balíkobot – kód API klíče – zde lze zadat API klíč pro daného přepravce, pole může být prázdné. Viz detail v kapitole API klíče.
- Balíkobot – použít obsah skladového balíku – pokud je pole zatržené, pak se pro daného přepravce musí vytvářet obsah skladového balení.
Toto pole je na stránce Přepravce zobrazeno pokud je v Nastavení Balíkobotu v poli Použít skladový obsah balíku hodnota
Přepravce.
- Výchozí obsah balení – zde lze zadat text, který se bude přenášet do pole Content v Balikobot - Přehled balení.
- Balíkobot - tisknout štítky na pozadí – v případě hodnoty Ano se nevyužívá při tisku PDF reader.
Pole Balíkobot – ID reportu pro tisk štítků, které se automaticky vyplní, pokud je zadána hodnota do pole Balikobot – Kód poskytovatele, uvádí číslo sestavy pro tisk štítků přepravce. Jedná se v podstatě o fiktivní sestavu, aby bylo možné tisk směrovat na specifickou tiskárnu ve Výběrech tiskáren. Příslušnou sestavu je potřeba nastavit uživatelům na stránce Výběry tiskáren, která se nachází v Oblasti / Správa / Správa IT / Obecné / Výběry tiskáren.
Tiskárna je pro konkrétního uživatele dohledána dle těchto priorit seřazených od nejvyšší po nejnižší:
- Pro konkrétního „ID uživatele“ a konkrétní „ID sestavy“.
- Pro prázdného „ID uživatele“ a konkrétní „ID sestavy“.
- Pro konkrétního „ID uživatele“ a prázdné „ID sestavy“.
- Pro prázdného „ID uživatele“ a prázdné „ID sestavy“.
Pro daného přepravce lze služby přepravce, adresy přepravce, manipulační jednotky přepravce a popř. i další číselníky importovat – není potřeba je zadávat ručně. Import číselníků funguje pouze pokud je v Nastavení Balíkobotu vyplněno pole Výchozí kód API klíče. Pokud je toto pole prázdné, pak import služeb nefunguje – zobrazí se chybová hláška.
Detailněji je správa jednotlivých číselníků popsána v kapitolách níže.
¶ Služby přepravce
Služby přepravce je možno nastavit ručně nebo je stáhnout z Balíkobotu, což je pohodlnější způsob.
Import z Balíkobotu se provádí tlačítkem Importovat služby, které je v pásu karet na stránce přepravce.
Po kliknutí na tuto akci lze u vybraných přepravců (PPL, DPD, Geis) zvolit, zda se mají importovat standardní služby pro přepravu zásilky z expedičního místa k zákazníkovi nebo B2A služby, které zajišťují přepravu do zákazníka do expedičního místa – v BC je používána na dokladu objednávka prodejní vratky.
Import služeb pro typ importu B2A tedy funguje pouze u vybraných dopravců (PPL, DPD, Geis), u ostatních vrací import buď stejné služby jako u typu standard nebo nevrací nic.
Po výběru typu služby lze zvolit import všech služeb daného přepravce a nebo jen těch, které jsou aktivní (tedy ty, které má společnost u daného přepravce aktivní). Při vyplnění kódu služby se doplní prefix B2A (kromě DPD, tam jsou, stejně jako pro standardní služby, již předpřipravené kódy).
Poté se stáhnou všechny / pouze aktivní služby z Balíkobotu a seznam se objeví uživateli.
V poli Navrhovaný kód se pro každou službu, kterou chceme importovat, zadá její kód. Do tohoto pole lze zadat libovolný textový řetězec. Tento kód se zobrazuje na dokladech, ze kterých se vytváří balíky pro Balíkobot. Měl by tedy být zadán tak, aby byl odpovídající dané službě tak, aby se s ním uživatelům dobře pracovalo.
Přiřazení navrhovaného kódu služby na naimportované služby přepravce se provádí zvolením akce Přiřadit položky:
Výsledek je ten, že do pole Kód služby se přenesla hodnota, která byla zadána v předchozím kroku v poli Navrhovaný kód a dále je zatrženo pole Přiřazeno.
Ručně je potřeba označit služby, které se používají pro paletové zásilky, zatržítkem v poli Balíkobot – služba pro palety na stránce služby přepravce. Toto označení se používá pro rozlišení paletových a nepaletových služeb při objednání přepravy u přepravce.
V poli Balíkobot – typ balíku je hodnota Standard či B2A. Standardní služby se používají na dokladech, které slouží pro dodání zásilky z expedičního místa k zákazníkovi (např. prodejní objednávka, dodávka ze skladu, ...). B2A služby se používají k dodání od zákazníka do expedičního místa (na dokladu objednávka prodejní vratky).
Lze také použít akci Kopírovat kódy Balíkobotu, která se nachází v pásu karet. Touto akcí dojde ke zkopírování hodnoty v poli Kód do pole Navrhovaný kód. U některých přepravců (jako např. DPD v našem příkladu) jsou hodnoty v poli Kód pouze čísla, která nemají vypovídající informaci o službě přepravce, takže je v těchto případech vhodnější zadat hodnotu do pole Navrhovaný kód ručně.
Pro produkční API klíč neprobíhá kontrola pro přepravce PPL, zda je vyplněno pole Kód služby na dokladu, ze kterého se vytvářejí štítky pro přepravce a balíky pro Balíkobot. Je to dáno historicky. Pokud je pole Kód služby prázdný, pak se automaticky naplní hodnotou
PPL Private.
Pro testovací API klíč pro přepravce PPL probíhá kontrola, zda je vyplněné pole Kód služby standardně jako u jiných přepravců.
¶ Doplňkové služby
¶ Stažení číselníku Doplňkových služeb
Lze stáhnout číselník možností služeb, pokud to přepravce umožňuje (např. Česká pošta).
Stažení se provede tak, že se pro daného přepravce otevře stránka služby přepravce pomocí akce Služby přepravců (1) na stránce přepravce. Na ní se se zvolí v pásu karet akce Doplňkové služby (2). Otevře se stránka Balíkobot – doplňkové služby a na této stránce v pásu karet se pomocí akce Import doplňkových služeb (3) lze provést stažení číselníku možností služeb daného přepravce.
V BC jsou implementovány dva druhy doplňkových služeb:
- První druh je ten, že pro doplňkovou službu je v datové větě pro Balíkobot samostatné pole.
- Druhý typ je ten, že se doplňkové služby v datové větě pro Balíkobot exportují v poli Services (65) a to tak, že je v tomto poli číslo doplňkové služby přepravce (viz. např. seznam doplňkových služeb ČP). Pokud chceme exportovat více doplňkových služeb, pak jsou odděleny znakem plus.
¶ První typ doplňkové služby - přepravce má pro doplňkovou službu samostatné číslo exportovaného pole
Doplňkové služby nelze importovat do BC z Balíkobotu, musí se nastavit ručně. Na stránce přepravců je potřeba zvolit akci Doplňkové služby. Na této stránce lze pomocí akce Nový v pásu karet založit řádek pro novou doplňkovou službu.
Na řádku se vyplňují tyto pole:
- Kód služby – zadat kód, může být libovolný textový řetězec.
- Popis služby – zadat krátký popis služby, může být libovolný textový řetězec.
- Číslo exportovaného pole – hodnota se zjistí tak, že na stránce Balíkobot – Balíky se zobrazí lupa přes Ctrl + F1 a najde se příslušné pole značící doplňkovou službu, u kterého je v závorce uvedeno číslo pole.
- Použít ručně zadaný kód – pokud je pole zatržené, pak lze zadat ručně hodnotu, která se bude exportovat v datové větě pro Balíkobot. Např. proměnná Balíkobotu
full_age_datavyžaduje zadání roku narození adresáta. Hodnota se zadává na dokladu, na kterém je tato doplňková služba použita.
Seznam podporovaných doplňkových služeb je uveden v technické dokumentaci Balíkobotu - níže je uveden příklad pro přepravce DPD.
¶ Příklad konfigurace
Konfigurace je vysvětlena na příkladu přepravce DPD. Přepravce DPD podporuje tyto doplňkové služby, pro které jsme zjistili dle postupu výše popsaného, číslo exportovaného pole:
- Ověření plnoletosti – proměnná Balíkobot:
require_full_age, číslo exportovaného pole:61 - Platba kartou – proměnná Balíkobot:
credit_card, číslo exportovaného pole:63 - Večerní doručení – proměnná Balíkobot:
del_evening, číslo exportovaného pole:21 - Připojištění – proměnná Balíkobot:
del_insurance, číslo exportovaného pole:20 - SMS notifikace – proměnná Balíkobot:
sms_notification, číslo exportovaného pole:64
Konfigurace v BC:
¶ Druhý typ - přepravce pro doplňkovou službu používá číslo exportovaného pole 65 - services
Popis konfigurace je vysvětlen na příkladu přepravce Česká pošta.
Pro tohoto přepravce lze stáhnout číselní možností služeb. Pro tyto záznamy však neexistuje samostatné číslo exportovaného pole v datové větě pro Balíkobot, ale všechny se exportují pod kódem 65 – Services.
Konfigurace v BC: je nutné vyplnit pole:
- Kód služby – zadat kód, může být libovolný textový řetězec.
- Popis služby – zadat krátký popis služby, může být libovolný textový řetězec.
- Kód exportované služby – zadat hodnotu 65
- Exportovaný kód – dle číselníku daného přepravce. Tento kód se pak bude exportovat v datové větě pro Balíkobot.
Pokud bude v poli 65 zadáno více hodnot, pak budou oddělení znakem +. např. 7+11.
Pokud pro přepravce je stažený číselník doplňkový služeb, pak lze provést přiřazení možnosti služby: otevřít stránku Doplňkové služby, zvolit akci Přiřadit doplňkové služby. Otevře se stránka Balíkobot – doplňkové služby, na ní se označí záznam, který chceme naimportovat. Stránka se zavře pomocí tlačítka OK - tím se i potvrdí výběr doplňkové služby.
V našem příkladu je výsledek ten, že pro kód doplňkové služby
11se založil záznam v tabulce doplňkových služeb:
Pokud je typ doplňková služba typu Boolean - viz Dokumentace Balíkobot, pak se v definici
Doplňkové službyneuvádí v poli Exportovaný kód hodnota, ale pokud je doplňková služba zadána na dokladu, pak se v datové větě exportuje hodnotatrue, v opačném případěfalse.
¶ Vytvořit výchozí služby
V BC lze pro přepravce provést import výchozích doplňkových služeb pomocí akce Vytvořit výchozí služby. Po zvolení této akce jsou založeny doplňkové služby pro daného přepravce. Tyto služby lze upravovat, smazat či přidat další.
¶ Dobírka
Dobírka není v BC služba přepravce a ani doplňková služba.
V tabulce Způsob platby pro záznam dobírky je nutné nastavit v poli Balíkobot – typ metody hodnotu Dobírka.
Pokud zákazník chce platit na dobírku, pak je nutné na prodejní objednávce zvolit kód způsobu platby, který má v poli Balíkobot - typ metody zadánu hodnotu Dobírka – tedy v našem příkladu na prodejní objednávce bude zadána v poli Kód způsobu platby hodnota Dobírka.
¶ Adresy přepravce
Adresy (pobočky) (= adresy výdejních míst) je možno zobrazit pomocí akce Adresy (pobočky), která se nachází v pásu karet na stránce seznamu přepravců.
Import z Balíkobotu se provádí pomocí průvodce, který se spustí ze stránky služeb přepravce, pro kterého chceme import adres poboček provést. Na této stránce zvolíme službu (1), pro kterou chceme import adres poboček provést, a poté v pásu karet se zvolí akce Importovat adresy (pobočky) (2). Poté se otevře průvodce. Na úvodní stránce je zobrazen přepravce a služba, pro kterou budeme import provádět. Hodnoty nelze měnit.
Na další stránce lze pro některé přepravce zvolit kód země, pro který budeme import adres provádět.
Na další stránce lze zvolit, zda chceme jednorázový import spustit na pozadí pomocí položky fronty úloh nebo na klientovi, tedy na pracovní stanici uživatele.
Pokud se rozhodneme provést import na pozadí, musíme zadat datum a čas zahájení, popř. můžeme zvolit okamžité spuštění.
Na další stránce můžeme povolit automatickou aktualizaci adres poboček přepravce – tzn. zadat parametry pro založení položky fronty úloh.
V položkách fronty úloh si můžeme ověřit, že položka pro automatické stahování adres přepravce je skutečně založená. Její nastavení lze změnit.
Poté se průvodce ukončí tlačítkem Dokončit.
Při opakovaném importu se nejprve provede smazání všech adres a pak se znovu všechny naimportují – postup je takový z toho důvodu, že adresy se průběžně mění, nové vznikají a také zanikají u daného přepravce.
V případě, kdy přepravce adresy přepravce nepodporuje, pak se zobrazí při importu adres přepravce chyba:
¶ Manipulační jednotky
Pro přepravce, který používá manipulační jednotky (např. TOPTRANS), lze provést import manipulačních jednotek.
Postup importu manipulačních jednotek:
- Postavit se na stránce Přepravce na záznam přepravce, pro kterého chceme provést import manipulačních jednotek. (1)
- V pásu karet na stránce Přepravce zvolit akci Manipulační jednotky. (2)
- Otevře se stránka Balíkobot - manipulační jednotky, na ní v pásu karet zvolit akci Importovat man.jednotky. (3)
- V následujícím okně potvrdit volbu Pouze aktivní, dát OK. (4) Poté se provede import
manipulačních jednotekpro zvoleného přepravce.
U naimportovaných měrných jednotek, které se budou používat v Řádcích balení či Pultu balení, je nutné vyplnit pole Kód jednotky balení – výběr z hodnot Balíkobot – jednotky balení.
Pokud bychom toto mapování neprovedli, pak by se pro daného přepravce neexportovala
manipulační jednotka- při tvorbě balíku by se zobrazila chyba, balík by nebylo možné vytvořit.
