Endora Commerce

Integracja z UnoPim PIM

UnoPim to open-source’owy PIM na Laravelu, rozwijany przez Webkul. Endora Commerce pobiera z niego treści produktowe do katalogu sklepu, więc dział produktowy pracuje w jednym miejscu, a kupujący widzą to samo, co jest w PIM-ie.

Czym jest UnoPim i komu pasuje

UnoPim to system PIM z wbudowanym DAM, udostępniany na licencji MIT i instalowany na własnej infrastrukturze (PHP oraz MySQL, MariaDB lub PostgreSQL). Model danych jest typowy dla tej klasy narzędzi: atrybuty zebrane w rodziny, drzewo kategorii, produkty proste i konfigurowalne z wariantami, a do tego kanały, wersje językowe i waluty. Zespół produktowy dostaje wskaźnik kompletności kart, import i eksport plików CSV i XLSX oraz historię zmian.

W praktyce wybierają go firmy, które wyrosły z arkuszy i pól opisowych w ERP, chcą mieć pełną kontrolę nad instalacją i mają pod ręką kompetencje PHP. Dla dystrybutora lub producenta z katalogiem technicznym to sposób na uporządkowanie parametrów i zdjęć, zanim trafią do sklepu.

Co płynie z UnoPim do sklepu

Kierunek jest jeden: z PIM do katalogu Endora Commerce. Sklep niczego nie zapisuje z powrotem w UnoPim.

  • Treści produktowe: opisy, atrybuty i kategorie trafiają do katalogu sklepu.
  • Zdjęcia: media produktowe synchronizują się razem z kartą produktu.
  • Harmonogram: regularna synchronizacja utrzymuje sklep aktualnym bez ręcznego przepisywania.

Integracja dotyczy treści. Cenniki, stany magazynowe i warunki handlowe klientów to w Endora Commerce osobne moduły, zwykle zasilane z systemu ERP, na przykład przez Comarch ERP Optima.

Przebiegi importu i to, co widzi administrator

Konektor UnoPim jest osobnym pakietem modułu z własną sekcją w panelu administracyjnym. Importy są zapisywane jako przebiegi opisane słownikiem wspólnym dla wszystkich konektorów PIM:

  • tryb: pełny albo przyrostowy,
  • wyzwalacz: m.in. ręczny lub z harmonogramu,
  • status: w kolejce, w toku, zakończony, zakończony z uwagami, nieudany, pominięty,
  • liczniki: ile pozycji rozpatrzono, utworzono, zaktualizowano, pominięto, wycofano i ile zakończyło się błędem,
  • uwagi o trzech poziomach ważności: informacja, ostrzeżenie, błąd.

Status „zakończony z uwagami” jest osobnym stanem, innym niż „nieudany”: import może się zakończyć, a lista uwag pokazuje, czemu warto się przyjrzeć po stronie danych.

Ochrona pól przed nadpisaniem

Nie każda wartość musi pochodzić z PIM. Handlowiec potrafi dopisać w sklepie lepszy opis albo ułożyć galerię inaczej, niż zrobił to dział produktowy. Dlatego w edytorze produktu administrator z uprawnieniem do zapisu w katalogu ma przełącznik ochrony podpisany jako UnoPim: chronione pole nie zostanie nadpisane przy kolejnym imporcie, a przebieg odnotuje je w osobnym liczniku.

Wspólna dla konektorów PIM gramatyka ochrony obejmuje nazwę i opis (także per język), pojedyncze atrybuty, pola SEO, pozycje galerii, załączniki, przypisania do kategorii oraz ceny w konkretnym cenniku.

Co przygotować po stronie UnoPim

ElementNa co zwrócić uwagę
Dane dostępowe do APIREST API UnoPim korzysta z OAuth: potrzebne są identyfikator i sekret klienta oraz login i hasło użytkownika API.
Uprawnienia użytkownika APIOd wersji 3.0 UnoPim egzekwuje uprawnienia także przy odczycie, więc konto musi widzieć produkty, kategorie, atrybuty i media.
Dostępność sieciowaInstancja UnoPim musi być osiągalna z serwera, na którym działa Endora Commerce.
Aktualizacje UnoPimWersja 3.0 zastąpiła wspólne klucze podpisujące OAuth kluczami per instalacja, co unieważnia wcześniej wydane tokeny. Po takiej aktualizacji sprawdź połączenie.

Szczegóły opisuje dokumentacja uwierzytelniania API UnoPim.

Jeden aktywny PIM i zmiana systemu

Na jednej instalacji można mieć zainstalowanych kilka konektorów PIM, ale aktywny jest tylko jeden naraz. Próba włączenia drugiego kończy się komunikatem wskazującym, który konektor jest już aktywny. Świeża instalacja nie ma aktywnego żadnego: wybiera go administrator na ekranie modułów.

Przełączenie nie niszczy danych. Produkty zaimportowane wcześniej zostają w katalogu, a konfiguracja połączenia, mapowania, ochrony pól i historia przebiegów każdego konektora są zachowane i wracają po ponownym włączeniu. To ułatwia migrację do UnoPim z innego systemu albo w drugą stronę.

UnoPim czy inny PIM

UnoPim jest rozsądnym wyborem, gdy zależy Ci na licencji MIT, własnym hostingu i stosie PHP. Jeśli firma pracuje już w Akeneo, Pimcore albo Ergonode, nie ma powodu zmieniać PIM-u dla samego sklepu: każdy z nich ma własny konektor. Pełną listę połączeń znajdziesz na stronie integracji.

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.