Integracja PrestaShop z WAPRO: od pliku CSV do obsługi zamówień w Laravel

Od pliku CSV do wspólnej obsługi sprzedaży. Pokazujemy, jak rozwijaliśmy integrator PrestaShop i WAPRO w Laravel: produkty, zamówienia, statusy, dokumenty i sygnalizowanie problemów.

Integracja PrestaShop z WAPRO zaczyna się często od prostego pytania: czy da się przestać przepisywać produkty i zamówienia między systemami? W tym projekcie odpowiedzią stała się dedykowana aplikacja Laravel. Połączyliśmy import katalogu z plików CSV, kilka sklepów PrestaShop oraz obsługę magazynu i zamówień w WAPRO. Najwięcej pracy wymagało uzgodnienie, co oznaczają dane i w którym momencie mają zmieniać się w poszczególnych systemach.

Opisujemy wdrożenie dla firmy rozwijającej sprzedaż w kilku sklepach internetowych. Projekt rozpoczął się od powtarzalnego importu produktów. Później rozwinął się o stany magazynowe, zamówienia, mapowanie statusów i przewoźników, dokumenty sprzedażowe oraz informację o weryfikacji numeru VAT w VIES. To historia budowania wspólnego procesu obsługi sprzedaży, krok po kroku.

Dlaczego sam import produktów przestał wystarczać?

Punktem wyjścia był arkusz z danymi produktów, eksportowany do CSV. Firma już z niego korzystała i chciała zachować wygodny sposób aktualizacji oferty. Potrzebowała jednak możliwości wielokrotnego importowania danych do nowych sklepów PrestaShop. Jednorazowe przeniesienie katalogu rozwiązałoby tylko część problemu.

Przy każdym kolejnym imporcie wracały pytania: które produkty należy dodać, które zaktualizować, do jakiego sklepu mają trafić i jak połączyć ich kategorie oraz atrybuty z tymi, które istnieją w danym PrestaShop? Osobnym zagadnieniem były zdjęcia. Plik z opisami nie zawierał kompletnej galerii, a zespół nie chciał dodawać tych samych fotografii niezależnie w kolejnych sklepach.

Do tego dochodził WAPRO, używany po stronie magazynowej i obsługi zamówień. Produkt opisany w arkuszu oraz towar w ERP nie zawsze miały ten sam identyfikator. Zanim zaczęliśmy synchronizować dane, trzeba było ustalić relacje między nimi. Automatyzowanie nieuzgodnionych zasad mogłoby jedynie szybciej powielać błędne informacje.

Jaką rolę otrzymał integrator w Laravel?

Zbudowaliśmy osobny panel pośredniczący między katalogiem, sklepami i WAPRO. Aplikacja daje zespołowi miejsce do importowania produktów, powiązania kategorii i atrybutów, obsługi zdjęć oraz konfiguracji przepływu zamówień. Ustawienia dla konkretnego sklepu określają m.in. pobierane statusy, powiązania przewoźników i automatyczną wysyłkę zamówień do WAPRO.

Laravel stanowi zaplecze dedykowanej aplikacji. Sklepy pozostają miejscem sprzedaży, a WAPRO zachowuje swoją rolę w obsłudze towarów i dokumentów. Integrator łączy te elementy i odwzorowuje reguły, których nie da się opisać samym poleceniem „połącz sklep z ERP”.

Główne przepływy danych

  • Katalog: plik CSV → integrator → wybrane sklepy PrestaShop.
  • Dostępność: WAPRO → integrator → powiązane produkty w sklepach.
  • Zamówienia: PrestaShop → integrator → WAPRO, zgodnie z konfiguracją pobierania i wysyłki.
  • Statusy: przepływ według mapowania oraz wybranego kierunku synchronizacji.
  • Dokumenty: powiązane dokumenty sprzedażowe z WAPRO → obsługa w PrestaShop.
  • Weryfikacja VIES: informacja o numerze VAT zamówienia → szczegóły w integratorze i oznaczenie kontrahenta w WAPRO.

To schemat funkcjonalny. Poszczególne informacje nie muszą przechodzić całej drogi jednocześnie. Rozdzielenie etapów ma znaczenie zwłaszcza wtedy, gdy zamówienie pojawiło się już w panelu integratora, ale nie zostało jeszcze przekazane do ERP.

Najpierw identyfikatory, potem synchronizacja

Jednym z istotnych ustaleń było połączenie pozycji z pliku z indeksami towarów w WAPRO. Identyfikator w arkuszu służył innemu celowi niż indeks magazynowy. Nie można było zakładać, że jednakowa nazwa albo podobny opis wystarczą do poprawnego przypisania stanu.

Przykład jest prosty: kilka podobnych wariantów może mieć bardzo zbliżone opisy, a jednocześnie stanowić różne pozycje w sprzedaży. Jeżeli połączymy je wyłącznie po nazwie, informacja o dostępności może trafić do niewłaściwej oferty. Dlatego istotna była jawna relacja między rekordem katalogowym a pozycją ERP.

W rozmowach pojawiły się także produkty pełniące rolę prezentacji oferty, bez odpowiednika w magazynie, oraz oznaczenia dostępności w samym pliku. Takie przypadki wymagają osobnej decyzji biznesowej: czy produkt ma być widoczny, czy można go zamówić i które źródło rozstrzyga konflikt? To reguły do uzgodnienia przed uruchomieniem automatu, a nie szczegóły, które warto pozostawić domyślnemu zachowaniu integracji.

Powtarzalny import i wspólna obsługa katalogu

Pierwsza wersja panelu pozwalała importować pliki oraz wiązać kategorie i atrybuty z odpowiednikami w PrestaShop. Listy wyboru korzystają z danych sklepu. Zespół może więc wskazać relacje między strukturą z pliku a strukturą konkretnego kanału sprzedaży.

Importer obsługiwał dane rozdzielane przecinkami i średnikami. Dla użytkownika arkusza to ważna różnica: dwie poprawne wersje CSV mogą wyglądać inaczej po otwarciu w edytorze, mimo że zawierają te same informacje. Ujednolicenie sposobu interpretacji pliku pozwalało zachować istniejący proces przygotowywania danych.

Zdjęcia otrzymały własną obsługę w panelu. Raz dodane fotografie mogą być przekazywane do sklepów, do których przypisany jest produkt. Nie opisujemy tego jako automatycznego odtwarzania kompletnej galerii z dowolnego pliku. W tym projekcie dane tekstowe oraz zarządzanie zdjęciami wymagały rozróżnienia.

Przy wdrażaniu poprawiliśmy również informację o zakończeniu importu. Proces mógł trwać kilka minut, a krótkotrwały komunikat znikał, zanim osoba obsługująca panel wróciła z innej zakładki. Zmieniliśmy go na trwałe powiadomienie. Drobna zmiana interfejsu rozwiązywała bardzo praktyczny problem: użytkownik powinien wiedzieć, czy operacja się zakończyła.

Zamówienie w integratorze i zamówienie w WAPRO to dwa etapy

W obsłudze zamówień rozdzieliliśmy pobieranie danych ze sklepu od przekazywania ich do WAPRO. Panel otrzymał konfigurację statusów, po których zamówienia mają być pobierane, oraz możliwość włączania automatycznej wysyłki do ERP dla danego sklepu.

To rozróżnienie pomaga diagnozować sytuacje, które z perspektywy sprzedawcy wyglądają podobnie. „Nie widzę zamówienia w WAPRO” może oznaczać, że sklep nie spełnił warunków pobrania, dane zatrzymały się na kolejnym etapie albo wymagana jest korekta konfiguracji. Sam odczyt listy zamówień w jednym systemie nie wyjaśnia całej drogi.

Osobno mapowaliśmy przewoźników. Sposób dostawy wybrany w sklepie musi odpowiadać właściwej wartości po stronie systemu docelowego. Dzięki temu obsługa zamówienia zachowuje informację potrzebną przy dalszej realizacji, zamiast polegać wyłącznie na podobieństwie nazw metod dostawy.

Co się dzieje, gdy pracownik zmieni status szybciej niż integracja pobierze zamówienie?

W trakcie używania systemu pojawił się przypadek bardzo szybkiej zmiany statusu nowego zamówienia na „Wysłane”. Proces pobierania nie zawsze zdążył wcześniej odczytać zamówienie w statusie przewidzianym w konfiguracji. Rozwiązaniem nie mogło być poleganie na tym, że pracownik za każdym razem odczeka odpowiednio długo.

Rozszerzyliśmy konfigurację o osobne określenie, dla których pobieranych statusów należy zmienić status po imporcie. Pozwoliło to uwzględnić także zamówienia już wysłane, bez cofania ich do „Przygotowanie w toku”. W dokumentacji odbioru potwierdzono dodanie statusu wysyłki do pobierania przy wyłączonej zmianie tego statusu.

Ten przykład dobrze pokazuje różnicę między mapowaniem nazw a odwzorowaniem procesu. „Pobierz zamówienie” oraz „zmień jego status” są osobnymi operacjami. Ich bezwarunkowe połączenie mogłoby nadpisywać pracę zespołu lub powodować niepotrzebne powiadomienia w sklepie.

Równie ważny jest kierunek synchronizacji. To, że podobny status istnieje po obu stronach, nie oznacza automatycznie, że powinien być zapisywany w obie strony. Panel otrzymał możliwość określania kierunku powiązań statusów. Konkretne ustawienia zależą od uzgodnionego sposobu pracy sprzedawcy.

Dokumenty sprzedażowe i dodatkowa informacja dla obsługi

Integrację rozwinęliśmy również o przekazywanie dokumentów sprzedażowych powiązanych z zamówieniami. Po stronie WAPRO znaczenie ma wygenerowanie odpowiedniego dokumentu PDF i jego relacja z zamówieniem pobranym ze sklepu. Po stronie PrestaShop potrzebna jest obsługa udostępnienia dokumentu przy właściwym zamówieniu klienta.

Ten etap obejmował także sprawdzenie widoczności dokumentów oraz etykiet w polskiej i angielskiej wersji sklepu. Integracja nie kończy się na samym pobraniu pliku: dokument powinien trafić do właściwego miejsca, w postaci zrozumiałej dla odbiorcy.

Kolejnym rozszerzeniem była informacja o weryfikacji numeru VAT w VIES. Wynik jest widoczny w szczegółach zamówienia w integratorze i przekazywany jako oznaczenie kontrahenta w WAPRO. Wymaganie dotyczyło przekazania informacji do obsługi, bez automatycznej zmiany ceny o VAT.

Jak pokazać zespołowi, że zamówienie wymaga uwagi?

W późniejszym etapie dodaliśmy powiadomienie e-mail o problemie z obsługą zamówienia oraz wyróżnienie jego wiersza w panelu. W archiwum prac zachowało się także potwierdzenie rzeczywistego odebrania takiego powiadomienia. To ważny element utrzymania systemu, ponieważ brak widocznego komunikatu może zostać pomylony z brakiem nowych zamówień.

Automatyzacja powinna ułatwiać codzienną pracę także wtedy, gdy coś wymaga sprawdzenia. Czytelna informacja pozwala ustalić, którego zamówienia dotyczy problem i na jakim etapie szukać przyczyny. Nie zastępuje diagnozy, ale daje zespołowi punkt wyjścia do działania.

Co ten projekt faktycznie zmienił?

Firma otrzymała wspólne narzędzie do powtarzalnego importu katalogu, publikowania danych w sklepach oraz przekazywania zamówień do WAPRO. Kategorie, atrybuty, zdjęcia, statusy i przewoźnicy stały się elementami jawnej konfiguracji. Kolejne rozszerzenia obejmowały dokumenty, VIES i sygnalizowanie problemów.

Wartością wdrożenia jest konkretny zakres dostarczonych funkcji i możliwość dopasowania ich do sposobu pracy firmy. Przebieg projektu pokazuje, dlaczego rozwój integracji wymaga znajomości codziennej obsługi sklepu oraz dalszego wsparcia po pierwszym uruchomieniu. Rozmowy z zespołem, obserwacja działania i kolejne poprawki pozwalają uwzględniać sytuacje, które trudno przewidzieć na podstawie samej listy pól w pliku.

Co przygotować przed podobną integracją PrestaShop i ERP?

Dobry opis potrzeb powinien pokazywać drogę produktu i zamówienia. Na początek wystarczą przykładowy plik bez danych poufnych oraz opis obecnego sposobu pracy. Przydatna jest odpowiedź na kilka pytań:

  1. Gdzie powstają dane? Osobno dla opisów, cen, dostępności, zdjęć i dokumentów. Jeden system nie musi być źródłem wszystkich informacji.
  2. Jak rozpoznajemy produkt? Jakie identyfikatory ma w pliku, sklepie i ERP? Co robimy z pozycjami bez powiązania?
  3. Które sklepy uczestniczą w procesie? Czy mają wspólny katalog, inne języki i odrębne ustawienia sprzedaży?
  4. Kiedy pobieramy zamówienie? Jak traktujemy płatność przy odbiorze, szybką wysyłkę i późniejszą zmianę statusu?
  5. Kto może zmieniać stan procesu? Które statusy wynikają z pracy magazynu, a które ze sklepu lub płatności?
  6. Jak zauważymy problem? Kto odbiera powiadomienia, gdzie sprawdza szczegóły i kto odpowiada za dalszą obsługę?

W planie odbioru warto uwzględnić ponowny import znanego produktu, brak powiązania z ERP, zmianę stanu, kilka metod dostawy oraz zamówienie, którego status zmienia się bardzo szybko. Dokument należy sprawdzić przy właściwym zamówieniu i w odpowiedniej wersji językowej. Takie scenariusze zbliżają test do codziennej pracy zespołu.

Potrzebujesz połączyć sklep z WAPRO albo uporządkować istniejącą integrację?

Zobacz realizację integratora PrestaShop i WAPRO oraz zakres dedykowanych aplikacji Laravel i integracji. Pomagamy zarówno przy budowie nowego rozwiązania, jak i przy rozwoju systemu, który już obsługuje sprzedaż. Dalszą opiekę można ustalić w ramach wsparcia technicznego.

Opisz nam swój proces: używane systemy, źródło produktów, liczbę sklepów oraz problem, który chcesz rozwiązać. Na tej podstawie ustalimy, od którego przepływu warto zacząć i jak podzielić wdrożenie na etapy.

O autorze

Leszek Iwaniec jest właścicielem Projectic. Zajmuje się wdrożeniami sklepów internetowych, aplikacjami dedykowanymi i wsparciem technicznym. Na blogu opisuje problemy oraz rozwiązania związane z PrestaShop, Laravel i integracjami systemów. Materiały opierają się na doświadczeniach z projektów zespołu.

Powrót