MobyDick - Integracja XML Hurtownie L-ShopTeam

Jak zintegrować swój sklep z ofertą L-ShopTeam?

Integracja z L-ShopTeam składa się z trzech głównych kroków: importu pliku z ofertą, pobrania pliku z cenami oraz dodania zdjęć produktów.

Naszą integrację można pod adresem https://docs.seigi.eu/mobydick/per_hurtownia/lshopteam.html

Ustawienie źródeł informacji o produktach

Aby zaktualizować ofertę produktów w swoim sklepie, są potrzebne dwa pliki CSV z hurtowni L-ShopTeam. Otrzymasz je bezpośrednio od hurtowni:

  • Do stanów magazynowych do pobrania za pomocą FTP
    • Dane FTP możesz uzupełnić w module, w celu automatycznego pobierania.
  • Do produktów, w postaci linku:
    • https://download.l-shop.team/auth/{{tajny-klucz}}/product-data/{{wariant_pliku}}.csv.zip
    • {{tajny-klucz}} i {{wariant_pliku}} to zmienne parametry, indywidualne dla każdego klienta.
    • Plik ten zawiera podstawowe informacje o produktach, ale nie zawiera cen.

Pobieranie cen produktów

L-ShopTeam udostępnia pliki z cenami, ale nie są one dostępne automatycznie w głównym pliku produktowym. Aby uzyskać ceny, należy:

  1. Zalogować się do panelu klienta L-ShopTeam i pobrać odpowiedni plik z cenami.
  2. Plik należy wgrać ręcznie na serwer FTP sklepu.
  3. Cennik zmienia się zazwyczaj raz na kwartał, dlatego aktualizację należy przeprowadzać kilka razy w roku.
  4. Plik CSV z cenami zawiera również informacje o produktach oraz kilkadziesiąt kolumn z różnymi wariantami cen.
  5. Przed wgraniem pliku warto usunąć zbędne kolumny – znacznie przyspieszy to jego ładowanie (waga pliku może spaść z 200MB do poniżej 10MB).
  6. Nazwę kolumny, z której chcemy pobierać cenę, należy wpisać w ustawieniach modułu.
  7. Podpowiedź: Można samodzielnie dodać kolumnę do CSV, w której naliczymy marżę lub narzut, a następnie w module wskazać tę kolumnę jako źródło cen.

Dodawanie zdjęć produktów

L-ShopTeam nie dostarcza adresów URL do pobierania zdjęć. Automatyczne pobieranie zdjęć jest możliwe tylko wtedy, gdy klient wgra pliki na serwer lub skonfiguruje własny serwer zdalny.

Pobieranie zdjęć z portalu L-ShopTeam

Zdjęcia produktów można pobrać ręcznie z portalu: https://shop.l-shop-team.pl/pl/download-service/ (wymagane logowanie).

Struktura katalogów ze zdjęciami dostarczana przez L-ShopTeam

L-ShopTeam dostarcza zdjęcia w strukturze katalogów:

{nazwa_producenta}/{symbol_produktu}/

W każdym folderze znajdują się pliki graficzne, których nazwa odpowiada nazwom w pliku CSV.

Uwaga: Nazwy katalogów producentów często nie odpowiadają nazwom w pliku CSV, dlatego istnieją dwie metody organizacji zdjęć:

  1. Dostosowanie nazw katalogów – upewnienie się, że nazwa producenta w katalogach zgadza się z nazwą producenta w CSV.
  2. Pominięcie grupowania po producencie – umieszczanie zdjęć bezpośrednio w folderach o nazwie symbol_produktu.
  • Ta metoda jest bardziej niezawodna, ponieważ zgodna jest z drugą warstwą hierarchii dostarczaną przez L-ShopTeam.

Metody dodawania zdjęć do sklepu

1. Skorzystanie z domyślnego folderu i ręczne wgranie zdjęć

System domyślnie używa wewnętrznego formatu do szukania folderu zdjęć:

modules/seigimobydick/userfiles/lshopteam/images/{{ArticleNr}}/

2. Definiowanie własnej ścieżki lub URL do pobierania obrazów

Moduł oferuje opcję „Źródło obrazu“, pozwalającą na podanie niestandardowego szablonu ścieżki lub URL do pobierania obrazów podczas integracji. Można używać dynamicznych symboli zastępczych z CSV, np. {{Brand}} lub {{ArticleNr}}.

Przykłady zastosowania:

  • Jeśli zdjęcia znajdują się na serwerze lokalnym:
{główna_ścieżka_sklepu}/zdjecia-lshop/{{ArticleNr}}/
  • Jeśli zdjęcia są dostępne pod zewnętrznym adresem URL:
https://example.com/images/{{ArticleNr}}/

Cykliczna aktualizacja zdjęć

Aby zapewnić zgodność zdjęć z ofertą L-ShopTeam, konieczne jest regularne aktualizowanie bazy zdjęć. W szczególności należy:

  • Sprawdzać, czy nowe produkty mają dostępne zdjęcia i dodawać je do serwera.
  • Aktualizować istniejące zdjęcia, jeśli L-ShopTeam zmienił ich zawartość.
  • Weryfikować, czy struktura katalogów jest zgodna z preferowaną metodą organizacji.

Podsumowanie

  • Plik CSV z produktami nie zawiera cen – należy poprosić hurtownię o ich dodanie.
  • Możesz ręcznie określić nazwę kolumny z cenami lub ustawić domyślną cenę.
  • L-ShopTeam nie dostarcza bezpośrednich URL do zdjęć.
  • Zdjęcia można dodać ręcznie w domyślnym folderze lub zdefiniować własną ścieżkę w module.
  • Struktura katalogów ze zdjęciami może wymagać dostosowania, aby pasowała do nazw w pliku CSV.
  • Plik z cenami wymaga ręcznego pobrania i przetworzenia przed importem, co pozwala na dodanie własnych kalkulacji cenowych.