Autodíly

Plugin Autodíly najde náhradní díly k vozidlu podle VIN, ověří ceny a dostupnost v e-shopu CoraHB a spravuje tam košík, objednávky i jejich historii daného servisu.

Nainstalujte parts v Nastavení → Pluginy → Dostupné pluginy. Vyžaduje Elowen 0.30.4 nebo novější. Nástroje se přidělují podle účtů, takže účet bez přidělení žádný nevidí.

Nastavení instance

Administrátor vyplní dvě volitelné části v Nastavení → Přístupy → Autodíly.

• PartsLink24: ID účtu, uživatelské jméno a heslo. Jde o přesný katalog OEM, který se používá pro hledání podle VIN a schémata. Nechte prázdné, pokud chcete používat jen TecDoc.
• TecDoc (Profiauto): uživatelské jméno a heslo. TecDoc pokrývá vozidla, která PartsLink24 nemá. Nechte prázdné, pokud chcete používat jen PartsLink24.

Pro hledání podle VIN nastavte aspoň jednu z nich. Obě hesla se ukládají na serveru a znovu se nezobrazí. Plugin tyto hodnoty čte při startu démona, takže se změna projeví po restartu.

Přihlášení do CoraHB pro každý účet

Každý účet servisu zadá své uživatelské jméno a heslo do CoraHB ve svém nastavení, v části Můj účet → Účet CoraHB. Ceny, dostupnost, košík, objednávky i jejich historie používají toto přihlášení. Ve stejném nastavení jsou i Preferované značky, seznam značek, kterým dát přednost, když sedí víc rovnocenných dílů; nejpreferovanější je první.

Když účet přihlášení do CoraHB nemá, každý nástroj e-shopu to odmítne a oznámí. Odesílatel v chatu, který není propojený s účtem Elowen, také žádné přihlášení nemá.

Hledání dílů podle VIN

Asistent použije PartsVin se 17místným VIN. VIN nesmí obsahovat písmena I, O ani Q.

1. Dekódování. Nástroj určí vozidlo a jeho katalog. Nejdřív zkusí PartsLink24 a pak přejde na TecDoc. Parametrem source s hodnotou pl24 nebo tecdoc můžete katalog zvolit sami.
2. Procházení. PartsLink24 vypíše hlavní skupiny, podskupiny a přesné díly OEM. TecDoc vypíše kategorie a jejich díly.
3. Hledání. U PartsLink24 zadejte do search anglický název dílu a dostanete rovnou odpovídající díly OE. U TecDoc stejné klíčové slovo vrátí odpovídající kategorie k výběru.
4. Schéma. PartsDiagram vrátí asistentovi obrázek schématu. Asistent ho může ukázat pomocí ShareImage. Pozice ve schématu se nezvýrazňují.

Výsledky obsahují čísla OE, se kterými hledání v e-shopu najde odpovídající náhrady.

Výsledky hledání v e-shopu se uživateli zobrazují i jako karty produktů pod odpovědí asistenta, ale jen pro čísla artiklů, která odpověď zmiňuje. Každá karta ukazuje cenu a dostupnost: počet skladem, cestu dodávky od dodavatele, nebo že díl není skladem. Karty nemají fotografii. Díly nalezené podle VIN dostanou kartu s číslem OE a názvem, když je odpověď zmiňuje.

Hledání v e-shopu

PartsShopSearch vyhledá číslo artiklu nebo OE (režim kódu, výchozí), nebo u univerzálních produktů, jako jsou oleje, chemie a nářadí, název (textový režim).

• Jedno hledání vrátí až 30 výsledků na stránku, ve výchozím stavu 10.
• Dávkové hledání přijme několik čísel najednou a ke každému vrátí krátký výběr skladem dostupných možností, ve výchozím stavu 5, nejvýš 10.
• Filtry pokrývají značky, maximální cenu bez DPH, jen skladem dostupné položky a pořadí řazení.
• U nejlepšího výsledku z náhrad navíc nástroj vrátí jeho křížové odkazy OE.

Košík

• PartsCartAdd přidá jeden artikl, nebo víc pomocí items. Přijímá množství, volitelné číslo OE pro párování přes targetOE, poznámku v košíku do 50 znaků a volitelné groupId z hledání v e-shopu. Když odpovídá víc produktů, první je preferovaná značka zadaná ve volání, pak značky z Preferované značky účtu.
• PartsCartRemove odebere artikly podle čísla artiklu.
• PartsCart ukáže košík s mezisoučtem bez DPH a celkem s DPH.

Po každé změně košíku a po každé objednávce se v chatu zobrazí karta košíku. Zdroj pravdy zůstává košík v CoraHB a karta ho jen zobrazuje.

Objednávka ve dvou krocích

1. Asistent zavolá PartsOrder bez confirm. Nástroj ověří košík v CoraHB a oznámí, zda se dá objednat. Nic se neodešle.
2. Když uživatel objednávku výslovně potvrdí, asistent zavolá PartsOrder znovu s confirm nastaveným na true. Objednávku odešle jen toto volání.

Prázdný košík se odmítne. Při úspěchu nástroj vrátí číslo objednávky CoraHB a košík vyprázdní. Pokud košík vyprázdnit nelze, objednávka platí dál a výsledek ukáže cartCleared: false. V tom případě košík v CoraHB zkontrolujte. Objednávací nástroj se nikdy nespouští jako krok jen pro čtení.

Historie objednávek

PartsOrders čte objednávky přímo z CoraHB a nic neukládá lokálně.

• Bez parametrů vypíše objednávky za posledních 90 dní. Parametrem days se podíváte dál do minulosti.
• S internalId ze seznamu ukáže jednu objednávku podrobně.
• S query hledá podle VIN, čísla artiklu, čísla objednávky nebo textu poznámky. Když dotaz v daném období odpovídá nejvýš 10 číslům objednávek, načtou se celé jen tyto objednávky. Jinak hledání načte prvních 30 objednávek v období, takže když starší objednávka chybí, zvyšte days.

Datové soubory

Mezipaměti jsou obyčejné soubory v datovém adresáři pluginu na serveru, ne v databázi. Každá složka drží jeden druh dat.

Názvy souborů jsou hashe vyhledávacího klíče. Každá položka je soubor .json a obrázek se ukládá vedle ní jako soubor .bin. Položky nikdy nevyprší. Když chcete jednu obnovit, smažte její soubor a příští hledání ji znovu načte. Poškozený soubor se zaloguje, smaže a znovu načte. Ceny v e-shopu, košík ani historie objednávek se nikdy neukládají.

Ztráta těchto souborů znamená jen pomalejší hledání, protože data se znovu načtou od dodavatelů.

Nativní zavaděč adresáře skillů v core načítá zabalený skill Parts; přidělení účtům a viditelnost skillů zůstávají na hostiteli. Podrobnosti najdete v podrobnostech implementace.

Limity

• Jedno přihlášení PartsLink24 pro celou instanci. PartsLink24 dovolí na jedno přihlášení jen jednu relaci a každé přihlášení relaci od předchozího převezme. Kdo se stejným přihlášením přihlásí ručně, pluginovou relaci ukončí a plugin se při dalším volání přihlásí znovu. Použijte přihlášení, pod kterým se nikdo ručně nepřihlašuje.
• Relace jsou per proces. Démon i každý běh sub-agenta drží vlastní relace PartsLink24 a CoraHB. V jednom procesu volání pro jeden účet servisu běží po jednom. Dva běhy, které mění košík jednoho servisu ve stejnou chvíli, se proti sobě neserializují, takže po paralelní práci s košíkem košík zkontrolujte.
• Načítání z webu se může rozbít. PartsLink24, Profiauto a CoraHB se čtou z jejich webových stránek. Změna stránky může rozbít hledání nebo objednávku, dokud se plugin neaktualizuje. Po neúspěšné objednávce zkontrolujte CoraHB, než to zkusíte znovu.
• Schémata se nezvýrazňují. Obrázek ukazuje celé schéma a pozici na něm najde uživatel.
• Ceny a dostupnost jsou takové, jaké CoraHB vrátí v okamžiku volání.