Instrukcja wdrożenia  - Kalkulator kablowy

Wtyczka Kalkulatora Kablowego (dalej KK) jest przeznaczona do obsługi sprzedaży kabli o unikalnych
długościach na platformie B2B ONe. Po kliknięciu przycisku dodania produktu do koszyka lub
modyfikatora ilości zaznaczonego produktu wtyczka zostanie uruchomiona przez ONe.

Definicje

Kabel: produkt, którym chcemy zarządzać za pomocą tej wtyczki

Unikalna długość: produkt kablowy, który ma swój unikalny stockId (numer partii/lotu) .W niektórych kontekstach długości fabryczne są używane jako "drum_cable" (w atrybucie cable_type).

stockId (batch, lot): unikalny identyfikator długości, który jest unikalną długością kabla, jeden kawałek kabla może mieć np. 3 m lub 60 m lub inne długości, ale tylko jeden na raz i w jednym kawałku!

Długość fabryczna: produkt kablowy, w którym stockId może zawierać kilka sztuk, ale każdy kawałek ma równą długość. W niektórych kontekstach długości fabryczne są używane jako "roll" (w atrybucie cable_type).

Bęben: opakowanie, bęben przytrzymuje kabel, chroniąc go przed urazami. 

Cięcie: usługa, gdy pracownik tworzy nowy stockId dla ciętego kabla.

Drum algorithm: algorytm, który oblicza, który bęben jest odpowiedni dla danej długości kabla

Pojemność bębna: maksymalna długość kabla, jaką może pomieścić bęben

Przygotowanie danych o produktach w systemie PIM.

1. Przygotować trzy etykiety, które będą na potrzeby KK określać:
   a. Produkty kabowe (np. “Kabel”)
   b. Opakowania / bębny (np. “Bęben”)
   c. Usługę cięcia (np. “Cięcie”).
   UWAGA: W późniejszych krokach konfiguracji możemy zdecydować jakie nazwy
   etykiet określają poszczególne kategorie produktów, obowiązuje pełna dowolność
   nazewnictwa etykiet.
2.  Oznaczyć kable, opakowania (bębny) oraz usługi cięcia które mają być widoczne w KK
   etykietami. Etykiety Mark the cables, packaging (drums) and cuts with different labels.
3.  Założyć artybut alfanumeryczny cable_type i opisać nim wszystkie produkty kablowe, które
   mają być obslugiwane przez KK. Dopuszczalne wartości atrybutu to:
   a. drum_cable – kabel sprzedawany na bębnach
   b. roll – kabel sprzedawany w rolkach / odcinkach fabrycznych.
4. Opcjonalnie można utworzyć dodatkowe etykiety decydujące o uruchamianiu KK dla
   poszczególnych produktów kablowych odpowiednio na froncie klienckim oraz po stronie
   panelu handlowca. Nazewnicto etykiet dowolne, podobnie jak w przypadku punktu 1 można
   to skonfigurować dalej w samym KK. UWAGA – może to być też jedna, wspólna etykieta, jest
   to tylko kwestia konfiguracji samego KK.
5. Opcjonalnie można utworzyć atrybut alfanumeryczny (np. cableAlgorithmAcronym), w
   którym zapisać można identyfikator reguły bębnowej dla danego kabla bębnowego. Nazwa
   atrybutu jest dowolna, można ją później skonfigurować w panelu administracyjnym KK.
   Przkładowy wkład do API wygląda wtedy następująco:                                                                           {
   "productId": "cable1234",
   "attributes":
   [
   {
   "attributeId": "cableAlgorithmAcronym",
   "type": "ALPHANUMERIC",
   "description": "drum algorythm",
   "value": {
   "code": "C10",
   "label": "C10"
   }
   }
   ]
   }

Przygotowanie integracji zapasów produktów

Integrator powinien zarządzać stockId dla kabli o unikalnych długościach jak wyżej, gdzie jedna sztuka długości ma swój unikalny stockId.

Na przykład:

Powyższy przykład przełożył się na aktualizację ONe stock: 

W trakcie opracowania jest rozszerzenie funkcjonalności o osługę meta danych partii (specyfikacja:
https://docs.google.com/document/d/1TakWn8woNcbMNtgWZYhp-QiV3GBWUQB8/edit )

Konfiguracja typów produktów

W panelu konfiguracyjnym KK podajemy odpowiednie kody etykiet oraz atrybutów utworzonych
systemie PIM celem konfiguracji zachowania KK. Dla referencji można odwołać się do konfiguracji
etykiet w ONe – interesuj nas kod etykiety, nie jej nazwa skonfigurowana w ONe:

Tworzenie algorytmów bębnowych

W panelu konfiguracyjnym KK należy utworzyć reguły wyboru bębnów dla poszczególnych typów kabli.
Jest to konieczne dla automatyczneg określania rozmiaru bębna zależnie od długości ciętych odcinków.
Można przyjąć dowolny klucz tworzenia reguł (przykładowo promień zgięcia lub zewnętrzną średnicę).
Po utworzeniu reguły przypisujemy w jej konfiguracji konkretne rozmiary bębnów do maksymalnej
długości kabla możliwej do nawinięcia na bęben danego rozmiaru. Przykładowo :

Na przykład:

W powyższym arkuszu kalkulacyjnym rozdzielono pojemność bębna w zależności od średnicy zewnętrznej kabla (pierwsza kolumna) i połączono pojemność długości bębna z każdą średnicą zewnętrzną. To przedstawione powyżej przykładowe rozwiązanie nie uwzględnia elastyczności kabla (połączenie średnicy wewnętrznej bębna z promieniem gięcia). Zalecamy tworzenie reguł bębnowych w zależności od promienia gięcia + średnicy zewnętrznej + zależności w logice biznesowej.

Podczas tworzenia reguły bębnowej należy dodać dla niej ExternalId (kod), opis oraz długość luźną (dla obliczenia jak długą długość można dodać do koszyka bez bębna). 

Na liście reguł bębnowych po zaznaczeniu utworzonej reguły bębnowej w widoku szczegółów poniżej na ekranie można dodać nowe bębny do reguły. Dodane bębny znajdują się na liście obok szczegółów reguły. 

Przypisanie algorytmu bębnowego do kabli

W kartotece produktów kablowych widocznym w panelu administracyjnym KK po spozycjonowaniu się
na wybranym produkcie mamy możliwość przypisać utworzoną regułę do kabla. Po przypisaniu reguły
algorytm KK przypisze odpowiedni rozmiar bębna do każdego odcinka kabla.
Jeśli w bazie PIM skonfigurowano atrybut cableAlgorithmAcronym nastąpi próba automatycznego
przypisania reguły o kodzie przekazanym wartością tego atrybutu dla poszczególnych kabli. Jeśli reguła
o podanym kodzie nie została wcześniej utworzona pole nie zostanie ustawione automatycznie.

Wyzwalanie okna KK przy dodawniu kabli do koszyka

W kartotece produktów kablowych widocznym w panelu administracyjnym KK po spozycjonowaniu się
na wybranym produkcie mamy możliwość uruchomienia wyzwalania KK po stronie front- oraz backoffice.
Jeśli w bazie PIM skonfigurowano etykiety sterujące widocznością KK wartości check-boxów zostaną
zainicjowane zależnie od obecności tych etykiet przy poszczególnych produktach.
Zachowaniem KK można sterować w tym aspekcie również definiując wyzwalanie KK dla pakietów
produktów.

Ustawienie klientów do dodawania bębnów za 0

W przyszlości

Konfiguracja algorytmów cięcia kosztów

W przyszlości

Przypisz algorytmy kosztów cięcia do kabli

W przyszlości

Utwórz regułę promocyjną dla unikalnych długości

W przyszlości