Przed rozpoczęciem procesu konfiguracji platformy B2B ważne jest włączenie usługi Symfonia ERP WebAPI, co stanowi niezbędny krok do skutecznej wymiany danych pomiędzy platformą B2B a oprogramowaniem Symfonia Handel.
Aby prawidłowo uruchomić usługę WebAPI, zalecamy skorzystanie z dokładnych wskazówek dostępnych pod adresem: link do instrukcji.
Dodatkowo, konieczne jest aktywowanie logowania zmian dla każdego zasobu. Aby to osiągnąć, skorzystaj z konfiguratora WebAPI, przechodząc do zakładki "Synchronizacja". Następnie dla każdego dostępnego zasobu zaznacz opcję "Loguj zmiany". Po dokonaniu tych ustawień, zapisz zmiany i ponownie uruchom usługę WebAPI.
Po pomyślnym zakończeniu wymienionych kroków, platforma B2B musi zostać skonfigurowana w celu ustanowienia wstępnego połączenia z oprogramowaniem Symfonia ERP Handel. Procedurę tę można zrealizować, przechodząc przez kolejne etapy w panelu administracyjnym platformy B2B.
{info.fa-lightbulb-o} Wskazówka: Format pola 'GUID' przyjmuje postać: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'. Natomiast pole 'Web API' powinno zawierać adres URL usługi WebAPI, przykładowo: 'https://nazwa-uslugi.wirtualnasymfonia.pl:9000'.
Po pomyślnym wykonaniu opisanych kroków, konieczne jest dostosowanie ustawień importu i eksportu danych. Aby to zrealizować, należy przejść w panelu administracyjnym platformy B2B do zakładki "Symfonia" i dalej do sekcji "Konfiguracja".
{info.fa-lightbulb-o} Wskazówka: Jeżeli w konfiguracji platformy brakuje pewnych danych, takich jak rejestry płatności, typy zamówień, usługi lub wymiary, kliknij ikonę klucza w prawym górnym rogu panelu administracyjnego, a następnie wybierz opcję "Wyczyść cache". To działanie spowoduje odświeżenie danych, eliminując ewentualne braki.
W sekcji "Ustawienia eksportu" mieści się konfiguracja procesu przesyłania danych z platformy B2B do Symfonia ERP Handel. Poniżej znajdują się kluczowe pola tej konfiguracji:
To pole służy do wyboru rodzaju zamówienia, do którego zostanie wyeksportowane zamówienie złożone na platformie B2B. Każde zamówienie z platformy pojawi się w Symfonia Handel jako zamówienie o wybranym typie.
W tym polu należy wybrać serie numeracji do eksportowanych zamówień złożonych na platformie B2B.
Analogicznie do punktu 'Symfonia - typ dokumentu zamówienia', jednak dotyczy zamówień złożonych w walutach innych niż PLN.
W tym polu należy wybrać serie numeracji do eksportowanych zamówień złożonych na platformie B2B, w walucie obcej.
To pole umożliwia wybór działu, do którego zostaną przypisane eksportowane zamówienia.
Wartość tego pola determinuje status, jaki musi posiadać zamówienie złożone na platformie, aby zostało wyeksportowane. Tylko zamówienia o wybranych statusach zostaną przekazane do Symfonia Handel
Te pola są związane z mapowaniem rodzajów płatności dostępnych na platformie B2B do rejestrów płatności dostępnych w Symfonia ERP Handel. Na przykład, jeśli na platformie istnieje rodzaj płatności "Gotówka", administrator określa, do którego rejestru płatności w Symfonii przypisać zamówienie, gdy klient wybierze gotówkę jako formę płatności.
Dla każdej płatności na platformie, należy wybrać również domyślną forme płatności z Symfonia Handel.
Są to pola konfiguracji związane z mapowaniem wysyłek, analogicznie do mapowania rejestrów płatności. Dla każdej wysyłki dostępnej na platformie należy przypisać usługę pobraną z Symfonia ERP Handel. W przypadku braku przypisania, wysyłka zostanie dodana do eksportowanego zamówienia jako pozycja bez kodu.
W sekcji "Ustawienia importu" znajdują się kluczowe konfiguracje dotyczące przesyłania danych z Symfonia ERP Handel do platformy B2B. Poniżej przedstawiamy szczegółowe opisy dostępnych pól konfiguracyjnych:
W tym polu należy wybrać magazyny które powinny być brane pod uwagę przez platforme przy importowaniu stanów magazynowych.
To pole umożliwia wybór, jakiego typu zamówienia należy importować z Symfonia Handel do platformy B2B. Administrator będzie mógł precyzyjnie określić, jakie zamówienia mają być uwzględniane w procesie importu.
Wybierając dział, definiowane jest źródło, z którego mają być importowane ceny podczas odświeżania koszyka.
Wybierając odpowiedni wymiar z Symfonia ERP Handel, administrator definiuje pole, w którym przechowywane są informacje o kategorii danego towaru. Struktura kategorii zagnieżdżonych powinna być zgodna z formatem: "Kategoria/Podkategoria/Podkategoria".
To pole pozwala na wybór wymiaru towaru z Symfonia ERP Handel, który zawiera informacje na temat producenta danego produktu (towaru). Ustawienie to wpływa na spójność i precyzję danych dotyczących producenta.
Wybierz wymiary towaru, które odpowiadają polom wyświetlanym na karcie produktu na platformie B2B, dostosowując prezentację informacji o produktach.
Pole to określa datę w formacie '2023-12-22T13:28:12'. Jest to data ostatniego wykonanego importu faktur. Kolejne zaimportowanie faktur będzie brało pod uwagę tę datę i z Symfonia Handel zostaną uwzględnione wyłącznie te faktury, które zostały zmienione, dodane lub usunięte po wskazanej tutaj dacie.
Wybierając tę opcję, zaimportowane zostaną wszystkie kategorie zdefiniowane w słowniku kategorii, nawet te, do których nie przypisano żadnego produktu. Wyłączenie tej opcji spowoduje import kategorii podczas importowania produktów, co oznacza, że na platformie pojawią się tylko te kategorie, które mają przynajmniej jeden produkt oznaczony jako B2B. Kategorie są importowane przez importer "SymfoniaProducts"
Wybranie tej opcji spowoduje importowanie zdjęć do produktów w trakcie działania importera "SymfoniaProducts".
Importowanie zdjęć produktów może następować na dwa sposoby. Domyślną opcją, jest pobieranie wyłącznie nowych zdjęć, jednakże jeśli zdarza się, że zdjęcia produktu są podmienionane na nowe, należy wybrać opcję "Nadpisuj i pobieraj zdjęcia na nowo za każdym razem", co umożliwi nadpisywanie zdjęć.
Jeśli chciałbyś, aby na platformę importowały się wyłącznie cenniki z wybranych przez ciebie działów, skorzystaj z tego pola. Pozostaw pole puste aby importować wszystkie cenniki, bez względu do jakiego działu należą. Odznaczenie działu nie spowoduje usunięcia cennika z platformy, jeśli został już wcześniej zaimportowany.
Ustawienia ogólne to zakładka w której znajdują się pola ogólnej konfiguracji połączenia z Symfonia ERP Handel oraz platformą B2B. Poniżej znajduje się wyjaśnienie dostępnych pól.
Zaznacz, aby w podstronie zarządzania koszykiem znajdował się przycisk "Odśwież ceny". Jego kliknięcie przez klienta spowoduje pobranie cen z Symfonia ERP Handel i zaktualizowanie cen pozycji w koszyku. Umożliwi to przeliczenie cen z uwzględnieniem niestandardowych rabatów.
Należy wybrac jedną z trzech opcji
Wybranie tej opcji spowoduje wyświetlanie na kartach produktu przycisku który odświeży cenę dla kontrahenta który aktualnie odwiedza kartę produktu.
Opcja ta sprawi, że po odświeżeniu ceny, kontrahent będzie widział odświeżoną cenę nawet po ponownym odwiedzeniu platformy. Cena pozostanie zapisana w sesji jego przeglądarki. Wybranie tej opcji nie jest zalecane, jeśli korzystamy z rabatów ilościowych.
W celu zaimportowania danych z programu Symfonia Handel po skonfigurowaniu ustawień importu i eksportu, należy przejść do ręcznej inicjacji importu danych poprzez panel administracyjny platformy. W tym celu, nawiguj do zakładki "Wymiana danych" i wybierz "Importery".
Wyróżniamy trzy odrębne importery przeznaczone do importu danych różnego typu:
Przeznaczony do importu następujących zasobów:
Aby dostosować działanie tego importera, należy kliknąć przycisk "Akcje", a następnie "Edytuj". W oknie edycji pojawi się formularz konfiguracji importera. W polu "Harmonogram" wybierz odpowiednią opcję, na przykład "Co godzinę", aby skonfigurować automatyczne uruchamianie importera co godzinę. Pozostaw pole puste, aby nie uruchamiać importera automatycznie. W polu "Zasoby do zaimportowania" wybierz konkretne zasoby, które mają być importowane przez tego importera.
{warning.fa-lightbulb-o} Uwaga: Zaleca się ograniczenie importowanych zasobów do minimum, aby zminimalizować czas działania importera. Wybranie wszystkich zasobów może prowadzić do spowolnienia platformy, zwłaszcza jeśli ilość danych do zaimportowania jest znaczna. Optymalna konfiguracja importerów jest kluczowa dla efektywnego funkcjonowania sklepu internetowego.
Przeznaczony do importu cenników, pozycji cennika oraz przypisywania cenników do kontrahentów.
Podobnie jak w przypadku importera "Symfonia", w oknie edycji tego importera, istnieje możliwość ustanowienia harmonogramu, według którego proces importu będzie się regularnie uruchamiał. Po wyzwolenia importera, na platformę zostaną zaimportowane aktywne cenniki wraz z ich pozycjami. Z pozycji cennika importowany jest tylko jeden typ ceny. W celu skonfigurowania tego parametru, należy przejść do sekcji "Ustawienia importu", w zakładce "Symfonia", w lewym menu panelu administracyjnego. Tutaj, w opcji "Typ ceny importowany do pozycji cenników", należy wybrać preferowany typ ceny, przy czym dostępny jest wybór jedynie typu netto.
Przeznaczony do importu towarów na platformę.
Przed uruchomieniem importera "SymfoniaProducts", konieczne jest upewnienie się, że platforma została poprawnie skonfigurowana. W tym celu, należy przejść do zakładki "Symfonia" -> "Konfiguracja" dostępną w lewym menu panelu administracyjnego. Szczególną uwagę należy zwrócić na ustawienia dotyczące wymiaru kategorii, producenta oraz atrybutów. Uruchomienie importera skutkuje pobraniem wszystkich towarów oznaczonych flagą B2B.
W procesie importu danych, szczególnie przy uruchamianiu ich po raz pierwszy, istotne jest przestrzeganie odpowiedniej kolejności uruchamiania importerów. Warto zwrócić uwagę na zależności między nimi, zwłaszcza w przypadku importera "SymfoniaPriceLists", który jest ściśle związany z poprawnym importem produktów za pomocą importera "SymfoniaProducts". To zależność wynika z faktu, że pozycje cenników są bezpośrednio powiązane z konkretnymi towarami.
Pierwszym krokiem powinno być uruchomienie importera "SymfoniaProducts", który zajmuje się poprawnym importem towarów. Następnie, należy uruchomić "SymfoniaUsers" w celu zaimportowania kontrahentów. Produkty oraz Kontrahenci (Użytkownicy) powinni być zaimportowani jako pierwsi, ponieważ importery "Symfonia" oraz "SymfoniaPriceLists" importują zasoby będące zależne od kontrahentów oraz produktów.
Kolejnym krokiem jest uruchomienie importera "Symfonia", który zaimportuje inne istotne dane, takie jak kontrahenci, faktury, zamówienia czy stany magazynowe.
Ostatecznym krokiem jest uruchomienie importera "SymfoniaPriceLists", który pobierze cenniki wraz z pozycjami, a także przypisze je do odpowiednich kontrahentów zaimportowanych do platformy B2B przez importer "Symfonia".
Podsumowując, optymalna kolejność wyzwalania importerów przy importowaniu nowych danych lub danych wprowadzanych po raz pierwszy powinna być następująca:
Po poprawnym uruchomieniu importerów po raz pierwszy, kolejność przestaje mieć znaczenia.
Aby uruchomić proces eksportu zamówień, należy przejść do sekcji "Wymiana danych" w panelu administracyjnym, a następnie "Eksportery". Kolejnym krokiem jest kliknięcie "Akcje" -> "Uruchom". Eksporter "Symfonia" zbierze wszystkie zamówienia, które są gotowe do eksportu, a następnie przesyła je do Symfonii Handel zgodnie z wcześniej skonfigurowanymi ustawieniami w konfiguratorze.
Dla jeszcze większej wygody, istnieje możliwość ustawienia harmonogramu, według którego eksporter "Symfonia" automatycznie uruchamia się z określoną częstotliwością. W celu skonfigurowania harmonogramu, należy wybrać "Akcje", a następnie "Edytuj". W polu "Harmonogram" wybierz preferowaną częstotliwość, po czym kliknij "Zapisz". Dzięki temu eksporter będzie działać automatycznie, zgodnie z dostosowanymi parametrami.
{warning.fa-lightbulb-o} Uwaga: Aby uzyskać informacje dotyczące działania eksportera, należy przejść do panelu administracyjnego i wybrać zakładkę "Logi" -> "Logi". W przypadku, gdy zamówienie nie zostanie wyeksportowane z jakiegoś powodu, zostanie to wyświetlone w dostępnych logach.
W celu stworzenia zagnieżdżonej struktury kategorii dla importowanych towarów na platformę, należy zdefiniować odpowiedni wymiar, który będzie przechowywał informacje tekstowe dotyczące kategorii danego produktu. Przykładową wartością dla wymiaru kategorii może być:
Elektronika/Smartfony/Apple
Ukośnik działa jako separator, umożliwiając oddzielenie kolejnych poziomów kategorii. Produkt o takiej strukturze kategorii zostanie przypisany do kategorii "Apple". Kategoria "Apple" stanie się podkategorią "Smartfony", a ta z kolei będzie podkategorią "Elektroniki". Jeżeli takie kategorie nie istnieją jeszcze na platformie, zostaną automatycznie utworzone.