Integracja ze sklepem internetowym Woocommerce (plugin do wordpress)

Wstęp

Aplikacja umożliwia integrację Symfonia Handel (H50 i HMF) ze sklepami internetowymi opartymi na Woocommerce (plugin do Wordpress)

Opis funkcjonalny:

Konfiguracja obejmuje:

• podanie danych dostępowych do każdego sklepu (adres sklepu, dane do API czyli klucz klienta i klucz prywatny)
• przypisanie typu i serii zamówienia obcego w Symfonii Handel do danego sklepu
• mapowanie metod płatności w sklepach woocomerce z rejestrami i formami płatności w Handel
• ustawienie czy zamówienia mają być tworzone w buforze czy od razu wystawiane

Jest możliwość uruchomienia ręcznego importu z poziomu Symfonii Handel (z dowolnego komputera na którym będzie zainstalowany nasz dodatek)

• ze wskazaniem zakresu znaczników czasu zamówień (np od 2025.06.13 12:00:00 do 2025.06.13 18:00:00)

Istnieje możliwość włączenia automatycznego importu (np. na serwerze) co określony interwał, np. co 5 minut

• automat za każdym razem będzie wczytywał zamówienia od znacznika czasu z ostatniego importu do 'teraz'
• automatyczny import nie jest wymagany, możemy wdrożyć tylko ręczny import
• automatyczny import do prawidłowego działania wymaga uruchomionego Handlu z zalogowanym użytkownikiem, co blokuje jedną licencję Symfonii Handel

Jest możliwość włączenia ręcznego/automatycznego eksportu stanów towarów z Symfonii do sklepu Woocomerce.

• towar w Woocomerce muszą mieć SKU taki sam jak kod towaru w Symfonii aby mieć aktualizowany stan
• integracja aktualizuje stan po każdym użyciu towaru na dokumencie sprzedażowym, magazynowym, zamówieniowym
• możliwe jest ręczne oznaczenie wybranych towarów do zaktualizowania ich stanów na sklepie
• warunkiem poprawnego działania eksportu stanów jest włączenie odpowiednich procedur w programie oraz dostęp do jednego katalogu sieciowego (ustawionego w konfiguracji) na wszystkich stanowiskach z Symfonią

Co ustawiamy na importowanych na zamówieniach:
(pod spodem są wymieniane pola symfoniowego zamówienia z opisem co będzie do niego wpisywane podczas importu)

Nabywca - zakładamy uzgadnianie kontrahenta po kodzie
W przypadku nieznalezienia odpowiedniego kontrahenta w Symfonii zostanie założony nowy.
Będzie miał uzupełnione:

• skrót
• nazwa
• adres
• kod pocztowy
• miasto
• kraj
• telefon
• email

Odbiorca - analogicznie jak nabywca z tą różnicą, że z woocomerce będziemy pobierać dane wysyłkowe (Shipping)

Data wystawienia i sprzedaży - pole 'Date created'

Rejestr i forma płatności - na podstawie metody płatności ze sklepu, zgodnie z konfiguracją dodatku

Notatka dokumentu - notatka zamówienia ze sklepu

Pozycje zamówienia standardowe:
Towary są uzgadniane wg kodu towaru w Symfonii z polem 'SKU' pozycji zamówienia ze sklepu
W przypadku nieznalezienia odpowiedniego towaru dana pozycja zamówienia będzie bez uzgodnionego towaru (będą uzupełnione wszystkie pola poza kodem):

• Opis: Opis z pozycji zamówienia ze sklepu
• Ilość: Ilość z pozycji zamówienia ze sklepu
• Jm: Jednostka miary towaru w Symfonii lub na sztywno 'szt' w przypadku nieuzgodnienia towaru
• Cena: Koszt z pozycji zamówienia ze sklepu

Pozycje zamówienia wysyłkowe:
Towary będą uzgadniane wg kodu towaru w Symfonii z nazwą metody wysyłki zamówienia ze sklepu
W przypadku nieznalezienia odpowiedniego towaru dana pozycja zamówienia będzie bez uzgodnionego towaru (będą uzupełnione wszystkie pola poza kodem):

• Opis: nazwa metody wysyłki zamówienia ze sklepu
• Ilość: zawsze 1
• Jm: zawsze 'szt'
• Cena: wartość wysyłki zamówienia ze sklepu

Instalacja

Funkcjonalność wymaga zainstalowanej aplikacji HPP oraz wgrania raportów uruchomieniowych do programu Symfonia Handel
Wymagane raporty:

• proctm.sc - Procedura OnTimer
• procmg.sc - Procedury dokumentu magazynowego
• procsp.sc - Procedury dokumentu sprzedaży
• proczo.sc - Procedury zamówienia obcego
• extr04.sc - ExtRun::WystawZo (BLOT)
• hpp_runtime.sc - NET Runtime (BLOT)
• hpp_eitg_woo00.sc - Integracja Woocomerce - Ustawienia NET (BLOT)
• hpp_eitg_woo01.sc - Integracja Woocomerce - Import zamówień (BLOT)
• hpp_eitg_woo02.sc - NET Runtime - Integracja Woocomerce (BLOT)
• hpp_eitg_woo03.sc - Kolejkuj towary do eksportu cen Woocomerce (BLOT)
• hpp_eitg_woo04.sc - Integracja Woocomerce - Eksport stanów (BLOT)

Włączenie procedur

Aby komunikaty o ostatniej cenie się pokazywały należy włączyć procedury.
Przechodzimy do Ustawienia -> Parametry pracy -> Wykonywanie procedur i 'dla dokumentów sprzedaży' oraz 'dla zamówienia obcego' przełączamy na 'TAK'

Konfiguracja

Po zalogowaniu się do Symfonii jako użytkownik z uprawnieniami administratora należy przejść do:
Kartoteki -> Raporty -> Symfonia.Pro -> HPP -> "Integracja Woocomerce - Ustawienia NET (BLOT)"
Następnie należy kliknąć PPM i wybrać "Wykonaj raport".

Pokaże się nam okno "Wybór relacji Woocomerce", na którym wybieramy relację ze sklepem.
Każda relacja w konektorze przechowuje konfigurację integracji z jednym sklepem na Woocomerce.

Jeśli utworzyliśmy wcześniej relację to będzie ona dostępna na rozwijalnej liście.
W przypadku ustawiania integracji z nowym sklepem należy wpisać na oknie unikalną nazwę nowej relacji.
Kliknięcie Usuń spowoduje skasowanie wybranej relacji.
Na koniec klikamy Kontynuuj.

Pokaże się nam okno "Ustawienia konektora Woocomerce - relacja '<nazwa relacji>' "

W tytule okna będzie uzupełniona nazwa relacji w ramach której uruchomiliśmy okno konfiguracji.

W sekcji Konfiguracja API należy uzupełnić adres strony na której jest Woocomerce.
Następnie należy podać klucz klienta oraz klucz prywatne, wygenerowane w panelu Woocomerce (instrukcja).

Po uzupełnieniu tych danych możemy Przetestować połączenie przyciskiem na dole w celu sprawdzenia czy wprowadzone przez nas dane są poprawne.
Konektor spróbuje pobrać 1 zamówienie z systemu, jeśli mu się uda to zostanie wyświetlony komunikat Połączenie poprawne!.
W przeciwnym wypadku pojawi się komunikat błędu.

W sekcji Parametry importowanych zamówień należy ustawić jaki ma być typ oraz seria importowanych zamówień. Trzeba również podać kod działu na którym zamówienia mają być wystawiane.
Jeśli zaznaczymy Czy dokumenty mają być wystawiane to integracja będzie automatycznie wystawiać importowane zamówienia. Niezaznaczenie tej opcji spowoduje, że importowane zamówienia będą trafiać do bufora.

W sekcji Mapowanie płatności trzeba podać dla każdej płatności z Woocomerce jaki ma być rejestr i forma płatności zamówień o danej formie płatności.
Robimy to poprzez kliknięcie + pod tabelkę, następnie w nowym wierszu uzupełniamy nazwę formy płatności w Woocomerce, a obok wybieramy z rozwijalnych list rejestr i formę płatności w Symfonii.
Kliknięcie - spowoduje usunięcie zaznaczonego mapowania.

W sekcji Eksport stanów należy wybrać magazyny, z których ma być odczytywany stan handlowy w danej relacji.

Należy również wskazać Katalog konektora.
Służy on do zapisywania informacji o użyciu poszczególnych towarów na dokumentach w Symfonii na przestrzeni dnia, dzięki czemu integracja wie którym towarom w Woocomerce należy zaktualizować stan.
Katalog ten może być wspólny dla każdej relacji.
Generowane w nim będą pliki potrzebne do prawidłowego działania konektora. Zalecane jest by we wskazanym katalogu nie przechowywać żadnych innych plików.

Na koniec klikamy Zapisz by zapisać dokonany na oknie konfiguracji zmiany i zamknąć okno.
Kliknięcie Anuluj spowoduje zamknięcie okna bez zapisania dokonanych zmian.

Uruchomienie funkcjonalności

Import zamówień

Ręczny import uruchamiamy poprzez otworzenie kartoteki zamówień obcych i wybranie spod PPM opcji "Integracja Woocomerce - Import zamówień (BLOT)".
Pokaże nam sie okno "Wybór relacji Woocomerce" na którym musimy wybrać istniejącą relację.
Po kliknięciu Kontynuuj pojawi nam się okno "Import zamówień Woocomerce".

Na oknie wybieramy zakres z którego będą wczytane zamówienia. Zakres możemy podać z dokładnością do sekundy.

Aby wykonać import należy kliknąć Importuj.

Program najpierw sprawdzi ile jest zamówień w danym okresie.
Jeśli nie będzie żadnego to wyświetli się odpowiedni komunikat i import zostanie zakończony. W przeciwnym razie zostanie wyświetlony komunikat o ilości zamówień.
Użytkownik w tym miejscu może zdecydować czy kontynuować import.
W zależności od wyboru zamówienia zostaną lub nie zaimportowane.

Na koniec wyświetli się komunikat o ilości poprawnie zaimportowanych zamówień.

Eksport stanów

Eksport stanów uruchamiamy poprzez otworzenie kartoteki towarów i wybranie spod PPM opcji "Integracja Woocomerce - Eksport stanów (BLOT)".
Pokaże nam sie okno "Wybór relacji Woocomerce" na którym musimy wybrać istniejącą relację.
Po kliknięciu Kontynuuj pojawi nam się okno "Eksport stanów Woocomerce - '<nazwa relacji>'".

Należy na nim ustawić 'Cykl synchronizacji', czyli co jaki okres czasu Integracja ma aktualizować stany na Woocomerce.
Minimalny czas to 1 sekunda.

Aby włączyć automatyczny eksport należy przestawić suwak w pozycję Włączone.
Automatyczny eksport powinien być uruchomiony na serwerze, który będzie chodził nieprzerwanie.

Przycisk Ręczne wywołanie eksportu spowoduje natychmiastową aktualizację stanów.

Jeśli aktualnie wykonywany jest eksport to na oknie pojawi się napis "Wykonywanie eksportu...".

W głównej części okna zapisywane są logi z eksportu, czyli moment uruchomienia eksportu i ilość zaktualizowanych towarów.
W przypadku problemu z eksportem pojawi się wiersz z informacją o towarze który spowodował błąd (id w Woocomerce, SKU) jak i treść błędu.

Możliwe jest również ręczne oznaczenie wybranych towarów do eksportów ich stanów.
W tym celu należy w Symfonii uruchomić kartotekę towarów, zaznaczyć interesujące nas towary i wybrać spod PPM "Kolejkuj TW do eksportu stanów Woocomerce (BLOT)". Sprawi to, że wszystkie zaznaczone towary będą miały zaktualizowany stan w sklepie Woocomerce.
Opcja ta przydatna jest w szczególności podczas wdrożenia eksportu stanów, jak również w przypadku niespodziewanych problemów/błędów.