Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z Pimcore PIM

Pimcore nie narzuca gotowego modelu produktu: budujesz go sam z klas, wariantów i atrybutów. Endora Commerce przyjmuje rekordy, które wysyła Pimcore, i pokazuje je kupującym bez ręcznego przepisywania między systemami.

Pimcore w firmie z dużym katalogiem technicznym

Pimcore to platforma do zarządzania danymi, w której PIM działa obok MDM i DAM. Produkt jest tam obiektem danych (Data Object), a jego strukturę wyznacza definicja klasy, którą projektuje zespół wdrożeniowy. Stąd popularność Pimcore u producentów i dystrybutorów, u których karta produktu ma setki parametrów, a każda grupa asortymentu ma inny zestaw cech.

Dla integracji ze sklepem ma to jedną ważną konsekwencję: nie istnieje „standardowy produkt Pimcore”. Dwie instalacje mogą opisywać to samo łożysko zupełnie innymi klasami i polami. Integracja z Endora Commerce zaczyna się więc od przeglądu Twojego modelu danych, a nie od włączenia przełącznika.

Co przechodzi z Pimcore do sklepu

Dane płyną w jednym kierunku: Pimcore pozostaje źródłem prawdy o produkcie, a katalog sklepu go odzwierciedla. To Pimcore wysyła dane, a sklep je przyjmuje. Endora Commerce nie odpytuje Datahub, nie przegląda folderów Pimcore i nie synchronizuje obiektów po identyfikatorze: każdy rekord przychodzi kompletny, już zmapowany na strukturę katalogu, i podpisany wspólnym sekretem HMAC przez HTTPS.

  • Treści i parametry: produkty z opisami i parametrami, kategorie, atrybuty i zestawy atrybutów.
  • Media produktowe: zdjęcia oraz dokumenty, na przykład karty techniczne, podpinają się pod produkt w sklepie. Sklep pobiera je wyłącznie z publicznego adresu Pimcore i z dodatkowych adresów HTTPS, które dopuścisz, na przykład CDN. Plik, którego nie da się pobrać, jest odnotowany w raporcie, a produkt i tak trafia do katalogu.
  • Komplet naraz: każdy rekord niesie pełny zestaw danych produktu, a nie osobno treści, osobno media.

Na start Pimcore wysyła pełną dostawę, z paska narzędzi obiektu konfiguracyjnego albo poleceniem konsoli. Dopóki się nie zakończy, rekordy bieżące są odrzucane, chyba że świadomie ją pominiesz, bo katalog jest już zgodny. Potem każdy zapis w Pimcore wysyła rekord bieżący po zatwierdzeniu zmiany, więc praca w Pimcore nie czeka na sklep. Ponowienie tej samej wysyłki nie zapisuje danych drugi raz.

Jak pojęcia Pimcore przekładają się na przygotowanie wdrożenia

Mapowanie ustawia się w Pimcore, w pakiecie integracyjnym Endory. Pakiet korzysta z podpisanych słowników sklepu: atrybutów, zestawów atrybutów, kategorii, języków, kanałów sprzedaży i cenników. W panelu sklepu nie ma ekranów mapowania klas ani atrybutów.

W PimcoreCo trzeba ustalić przed startem
Klasa produktu i jej polaKtóre pola stają się nazwą, opisem i atrybutami w sklepie
Warianty z dziedziczeniemWariant dziedziczy wartości z obiektu nadrzędnego: które pola są wspólne, a które różnią warianty
Classification StoreAtrybuty zależne od kategorii, dodawane bez zmiany klasy: które grupy cech ma zobaczyć kupujący
Pola zlokalizowaneKtóre języki trafiają do sklepu i co zrobić, gdy tłumaczenia brakuje
Zasoby (Assets)Które zdjęcia tworzą galerię, a które pliki są załącznikami do pobrania

Co przygotować po stronie Pimcore

Integracja nie korzysta z Datahub: w sklepie nie podajesz adresu GraphQL ani klucza API Datahub. Przed uruchomieniem przygotuj:

  1. Pakiet integracyjny Endory zainstalowany w projekcie Pimcore przez Composera. W nim konfigurujesz mapowanie, folder z produktami i korzeń drzewa kategorii.
  2. Adres wysyłki do Endory, skopiowany z ekranu połączenia w panelu sklepu i wklejony w konfiguracji pakietu. Pakiet sam dopisuje do niego adresy próby połączenia, pełnych dostaw i rekordów bieżących.
  3. Wspólny sekret HMAC, ten sam po obu stronach. Sklep zapisuje go w postaci zaszyfrowanej i nie pokazuje ponownie.
  4. Domyślny, aktywny kanał sprzedaży w sklepie, wymagany do włączenia połączenia.
  5. Środowisko testowe Pimcore z reprezentatywną próbką katalogu, na której da się sprawdzić mapowanie przed produkcją.

Rzeczy, o które warto zapytać wcześniej

  • Nazwa i języki. Pakiet wymaga numeru SKU i zlokalizowanego pola nazwy. Każdy język z Pimcore trafia do języka sklepu o tym samym kodzie, a w domyślnym języku sklepu nazwa musi być uzupełniona.
  • Widoczność nowych produktów. Domyślnie produkty przychodzą jako nieaktywne i nie pojawiają się w sprzedaży, dopóki ich nie włączysz. Możesz też wybrać, żeby zawsze były aktywne albo żeby ich status w sklepie odpowiadał statusowi publikacji w Pimcore. Wycofanie lub cofnięcie publikacji w Pimcore dezaktywuje produkt w sklepie, ale go nie usuwa.
  • Ceny. Ceny bez przypisanego cennika są pomijane, chyba że zmapujesz je jako zwykłe atrybuty.
  • Jakość SKU. Produkty identyfikuje SKU i numeryczny identyfikator Pimcore, więc numery muszą być unikalne i stabilne.
  • Lokalne poprawki w sklepie. Wspólna warstwa konektorów PIM w platformie definiuje jednolity sposób ochrony pól, czyli wyłączania lokalnie dopracowanej wartości z nadpisywania przy imporcie. Obejmuje on nazwę, opis, atrybuty (także per język i kanał sprzedaży), metadane SEO, pozycje galerii, załączniki i przypisanie do kategorii. Zapytaj, które z tych pól chcesz redagować w sklepie.

Jeden aktywny PIM na instalacji

Platforma pozwala zainstalować kilka konektorów PIM, ale aktywny może być tylko jeden. Na świeżej instalacji żaden nie jest włączony: operator wybiera go w panelu, a próba włączenia drugiego kończy się odmową z nazwą konektora, który już działa. Zmiana PIM nie kasuje danych, produkty zaimportowane wcześniej zostają w katalogu.

Warto też wiedzieć, że konektor nie importuje stanów magazynowych, a sklep nie pobiera danych z Pimcore według harmonogramu. Zmiany docierają wtedy, gdy wyśle je Pimcore. Historia dostaw w panelu pokazuje każdy przebieg z wynikiem, licznikami i problemami na poziomie pojedynczych rekordów, a o nieudanym przebiegu administratorzy dostają powiadomienie.

Kiedy Pimcore, a kiedy inny PIM

Pimcore jest naturalnym wyborem, gdy już w nim pracujesz albo potrzebujesz własnego modelu danych i zarządzania zasobami w jednym narzędziu. Jeśli dopiero porządkujesz dane produktowe i zależy Ci na lżejszym starcie, zobacz UnoPim. Gotowy model rodzin i atrybutów oferuje Akeneo, a Ergonode to PIM rozwijany w Polsce.

Chcesz sprawdzić, jak Twój model klas przełoży się na katalog sklepu? Napisz do nas i pokaż przykładową kartę produktu.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.