Autodiely

Plugin Autodiely nájde náhradné diely k vozidlu podľa VIN, overí ceny a dostupnosť v e-shope CoraHB a spravuje tam košík, objednávky aj ich históriu daného servisu.

Nainštalujte parts v Nastavenia → Pluginy → Dostupné pluginy. Vyžaduje Elowen 0.30.4 alebo novší. Nástroje sa prideľujú podľa účtov, takže účet bez pridelenia žiadny nevidí.

Nastavenia inštancie

Administrátor vyplní dve voliteľné časti v Nastavenia → Prístupy → Autodiely.

• PartsLink24: ID účtu, používateľské meno a heslo. Ide o presný katalóg OEM, ktorý sa používa na hľadanie podľa VIN a schémy. Nechajte prázdne, ak chcete používať iba TecDoc.
• TecDoc (Profiauto): používateľské meno a heslo. TecDoc pokrýva vozidlá, ktoré PartsLink24 nemá. Nechajte prázdne, ak chcete používať iba PartsLink24.

Na hľadanie podľa VIN nastavte aspoň jednu z nich. Obe heslá sa ukladajú na serveri a znova sa nezobrazia. Plugin tieto hodnoty číta pri štarte démona, takže zmena sa prejaví po reštarte.

Prihlásenie do CoraHB pre každý účet

Každý účet servisu zadá svoje používateľské meno a heslo do CoraHB vo svojich nastaveniach, v časti Môj účet → Účet CoraHB. Ceny, dostupnosť, košík, objednávky aj ich história používajú toto prihlásenie. V rovnakých nastaveniach sú aj Preferované značky, zoznam značiek, ktorým dať prednosť, keď sedí viac rovnocenných dielov; najpreferovanejšia je prvá.

Keď účet prihlásenie do CoraHB nemá, každý nástroj e-shopu to odmietne a oznámi. Odosielateľ v chate, ktorý nie je prepojený s účtom Elowen, tiež žiadne prihlásenie nemá.

Hľadanie dielov podľa VIN

Asistent použije PartsVin so 17-miestnym VIN. VIN nesmie obsahovať písmená I, O ani Q.

1. Dekódovanie. Nástroj určí vozidlo a jeho katalóg. Najprv skúsi PartsLink24 a potom prejde na TecDoc. Parametrom source s hodnotou pl24 alebo tecdoc môžete katalóg zvoliť sami.
2. Prehliadanie. PartsLink24 vypíše hlavné skupiny, podskupiny a presné diely OEM. TecDoc vypíše kategórie a ich diely.
3. Hľadanie. Pri PartsLink24 zadajte do search anglický názov dielu a dostanete rovno zodpovedajúce diely OE. Pri TecDoc rovnaké kľúčové slovo vráti zodpovedajúce kategórie na výber.
4. Schéma. PartsDiagram vráti asistentovi obrázok schémy. Asistent ho môže ukázať pomocou ShareImage. Pozície v schéme sa nezvýrazňujú.

Výsledky obsahujú čísla OE, s ktorými hľadanie v e-shope nájde zodpovedajúce náhrady.

Výsledky hľadania v e-shope sa používateľovi zobrazujú aj ako karty produktov pod odpoveďou asistenta, ale iba pre čísla artiklov, ktoré odpoveď spomína. Každá karta ukazuje cenu a dostupnosť: počet skladom, cestu dodávky od dodávateľa, alebo že diel nie je skladom. Karty nemajú fotografiu. Diely nájdené podľa VIN dostanú kartu s číslom OE a názvom, keď ich odpoveď spomína.

Hľadanie v e-shope

PartsShopSearch vyhľadá číslo artiklu alebo OE (režim kódu, predvolený), alebo pri univerzálnych produktoch, ako sú oleje, chémia a náradie, názov (textový režim).

• Jedno hľadanie vráti až 30 výsledkov na stránku, v predvolenom stave 10.
• Dávkové hľadanie prijme niekoľko čísel naraz a ku každému vráti krátky výber možností skladom, v predvolenom stave 5, najviac 10.
• Filtre pokrývajú značky, maximálnu cenu bez DPH, iba položky skladom a poradie triedenia.
• Pri najlepšom výsledku z náhrad navyše nástroj vráti jeho krížové odkazy OE.

Košík

• PartsCartAdd pridá jeden artikel, alebo viac pomocou items. Prijíma množstvo, voliteľné číslo OE na párovanie cez targetOE, poznámku v košíku do 50 znakov a voliteľné groupId z hľadania v e-shope. Keď zodpovedá viac produktov, prvý je preferovaná značka zadaná vo volaní, potom značky z Preferované značky účtu.
• PartsCartRemove odoberie artikle podľa čísla artiklu.
• PartsCart ukáže košík s medzisúčtom bez DPH a celkom s DPH.

Po každej zmene košíka a po každej objednávke sa v chate zobrazí karta košíka. Zdrojom pravdy zostáva košík v CoraHB a karta ho iba zobrazuje.

Objednávka v dvoch krokoch

1. Asistent zavolá PartsOrder bez confirm. Nástroj overí košík v CoraHB a oznámi, či sa dá objednať. Nič sa neodošle.
2. Keď používateľ objednávku výslovne potvrdí, asistent zavolá PartsOrder znova s confirm nastaveným na true. Objednávku odošle iba toto volanie.

Prázdny košík sa odmietne. Pri úspechu nástroj vráti číslo objednávky CoraHB a košík vyprázdni. Ak košík vyprázdniť nemožno, objednávka platí ďalej a výsledok ukáže cartCleared: false. V tom prípade košík v CoraHB skontrolujte. Objednávací nástroj sa nikdy nespúšťa ako krok iba na čítanie.

História objednávok

PartsOrders číta objednávky priamo z CoraHB a nič neukladá lokálne.

• Bez parametrov vypíše objednávky za posledných 90 dní. Parametrom days sa pozriete ďalej do minulosti.
• S internalId zo zoznamu ukáže jednu objednávku podrobne.
• S query hľadá podľa VIN, čísla artiklu, čísla objednávky alebo textu poznámky. Keď dopyt v danom období zodpovedá najviac 10 číslam objednávok, načítajú sa celé iba tieto objednávky. Inak hľadanie načíta prvých 30 objednávok v období, takže keď staršia objednávka chýba, zvýšte days.

Dátové súbory

Medzipamäte sú obyčajné súbory v dátovom adresári pluginu na serveri, nie v databáze. Každý priečinok drží jeden druh dát.

Názvy súborov sú hashe vyhľadávacieho kľúča. Každá položka je súbor .json a obrázok sa ukladá vedľa nej ako súbor .bin. Položky nikdy nevypršia. Keď chcete jednu obnoviť, vymažte jej súbor a najbližšie hľadanie ju znova načíta. Poškodený súbor sa zaloguje, vymaže a znova načíta. Ceny v e-shope, košík ani história objednávok sa nikdy neukladajú.

Strata týchto súborov znamená iba pomalšie hľadanie, pretože dáta sa znova načítajú od dodávateľov.

Natívny zavádzač adresára skillov v core načítava zabalený skill Parts; pridelenie účtom a viditeľnosť skillov zostávajú na hostiteľovi. Podrobnosti nájdete v podrobnostiach implementácie.

Limity

• Jedno prihlásenie PartsLink24 pre celú inštanciu. PartsLink24 dovolí na jedno prihlásenie iba jednu reláciu a každé prihlásenie reláciu od predchádzajúceho prevezme. Kto sa tým istým prihlásením prihlási ručne, pluginovú reláciu ukončí a plugin sa pri ďalšom volaní prihlási znova. Použite prihlásenie, pod ktorým sa nikto ručne neprihlasuje.
• Relácie sú per proces. Démon aj každý beh sub-agenta držia vlastné relácie PartsLink24 a CoraHB. V jednom procese volania pre jeden účet servisu bežia po jednom. Dva behy, ktoré menia košík jedného servisu v tej istej chvíli, sa proti sebe neserializujú, takže po paralelnej práci s košíkom košík skontrolujte.
• Načítavanie z webu sa môže pokaziť. PartsLink24, Profiauto a CoraHB sa čítajú z ich webových stránok. Zmena stránky môže pokaziť hľadanie alebo objednávku, kým sa plugin neaktualizuje. Po neúspešnej objednávke skontrolujte CoraHB, než to skúsite znova.
• Schémy sa nezvýrazňujú. Obrázok ukazuje celú schému a pozíciu na nej nájde používateľ.
• Ceny a dostupnosť sú také, aké CoraHB vráti v okamihu volania.