Import XML hurtownia AQform.com / PrestaShop

Źródła XML i dopasowanie katalogu do sklepu

• Wiele źródeł danych: każde źródło ma własną nazwę, konfigurację połączenia, status aktywności i przypisany adapter, czyli mechanizm odczytujący jego strukturę XML.
• Ustawienia ogólne i indywidualne: wybrane parametry importu można nadpisywać dla konkretnego źródła, między innymi zakres cen, zasady aktualizacji, pobieranie zdjęć i sposób postępowania z brakującymi produktami.
• Dodawanie produktów i aktualizacja istniejących: moduł zapisuje powiązania między produktami źródłowymi a kartami produktów w PrestaShop i korzysta z nich podczas kolejnych importów.
• Dopasowanie do własnego katalogu: istniejące produkty można rozpoznawać po wybranym polu: indeksie produktu, EAN-13, UPC lub MPN, o ile dane pole jest dostępne w używanej wersji sklepu. Skuteczność dopasowania zależy od zgodności i jednoznaczności identyfikatorów.
• Mapowanie kategorii: kategorie źródłowe można powiązać z kategoriami sklepu lub tworzyć je podczas importu. Konfiguracja obejmuje kategorię domyślną oraz aktywność powiązań.
• Mapowanie producentów, dostawców, cech i atrybutów: osobne ekrany pomagają przypisać dane źródłowe do odpowiednich elementów katalogu PrestaShop. Dostępne są również operacje automatycznego dopasowania według nazw.

Import danych produktu i kontrola aktualizacji

• Nazwy i opisy: import nazwy, opisu pełnego i krótkiego, z osobnymi przełącznikami ich aktualizacji. Dane muszą być dostarczane przez źródło i obsługiwane przez jego adapter.
• Identyfikatory i parametry fizyczne: obsługa indeksu, EAN-13, UPC, MPN, masy i wymiarów produktu, zależnie od danych źródłowych oraz dostępności pól w PrestaShop.
• Ceny i dostępność: aktualizacja ceny sprzedaży, ceny zakupu, ilości oraz statusu aktywności produktu w zakresie obsługiwanym przez źródło. Moduł pozwala także skonfigurować teksty dostępności i komunikaty dotyczące czasu dostawy.
• Zdjęcia produktów: pobieranie zdjęć z adresów przekazanych w danych, możliwość wyłączenia ich pobierania oraz ograniczenia liczby importowanych zdjęć. Aktualizację zdjęć można kontrolować osobno dla produktów importowanych i dopasowanych do istniejącego katalogu.
• Cechy techniczne: przypisywanie cech do produktów oraz wybór między zastępowaniem ich zestawu a scalaniem. Scalanie aktualizuje cechy obecne w imporcie i pozostawia pozostałe cechy produktu.
• Kombinacje produktów: pełny import może tworzyć i aktualizować warianty na podstawie obsługiwanej struktury kombinacji, ich atrybutów, identyfikatorów, ilości oraz wpływu na cenę i masę.
• Osobne zasady dla produktów dopasowanych: inne ustawienia aktualizacji można zastosować do kart utworzonych przez importer, a inne do produktów rozpoznanych w istniejącym katalogu po identyfikatorze.

Przy aktualizacji kombinacji moduł dopasowuje warianty według zestawów atrybutów, dodaje nowe i może usuwać istniejące warianty nieobecne w przekazanym zestawie. Dostępna jest też opcja usunięcia dotychczasowych kombinacji podczas pierwszego dopasowania produktu. Wybór tych ustawień ma znaczenie dla sklepów, które utrzymują własne warianty.

Reguły cenowe i wybór importowanego asortymentu

• Przeliczanie cen: reguły obsługują dodawanie i odejmowanie kwoty, mnożenie oraz zwiększanie lub zmniejszanie ceny o procent. Zwiększenie o procent oznacza narzut na cenę źródłową.
• Warunki reguł: cenę można uzależnić od przedziału ceny wejściowej, kategorii, producenta i dostawcy. Reguły mogą być ogólne lub przypisane do konkretnego źródła.
• Priorytety: importer wybiera jedną pasującą regułę cenową według priorytetu, a przy równym priorytecie uwzględnia szczegółowość jej warunków.
• Dopłata i zaokrąglanie: po zastosowaniu reguły można dodać skonfigurowaną kwotę, a na końcu zaokrąglić cenę netto lub brutto do pełnej jednostki.
• Powiązanie stawek z podatkami sklepu: konfiguracja pozwala przypisać obsługiwane stawki VAT z danych źródłowych do grup reguł podatkowych istniejących w PrestaShop.
• Filtry importu: dostępne są dolny i górny próg ceny źródłowej oraz ustawienia importowania produktów bez zdjęć i z ilością równą zero.
• Produkty znikające z XML: po zakończeniu pełnego importu można pozostawić je bez zmian, wyłączyć, ustawić ilość produktu bazowego na zero lub połączyć wyłączenie z wyzerowaniem tej ilości.

Przygotowanie treści i pól SEO produktów

• Słownik zmian tekstowych: zamiana określonych fragmentów w nazwach, opisach pełnych i krótkich oraz polach meta title i meta description. Reguły mogą korzystać z prostych zamian lub wyrażeń regularnych.
• Szablony nazw: konfiguracja pozwala budować nazwy z dostępnych danych, takich jak nazwa źródłowa, indeks, producent, dostawca czy EAN. Słownik udostępnia podgląd przekształcenia na przykładowym tekście.
• Własne fragmenty opisów: możliwość dodania treści przed i po opisie pełnym lub krótkim, z ustawieniami językowymi i indywidualnymi dla źródła.
• Pola SEO: obsługa tytułu i opisu meta przekazanych przez adapter oraz tworzenie przyjaznego fragmentu adresu produktu na podstawie nazwy. Przy aktualizacji istniejących produktów pola SEO są powiązane z ustawieniem aktualizacji nazwy.
• Dane wielojęzyczne: import może wykorzystać wersje językowe dostarczone przez źródło i adapter. Jeżeli ich brakuje, mechanizm może powielić dostępną treść w innych językach; nie wykonuje automatycznego tłumaczenia.

Automatyzacja importu i nadzór nad operacjami

• Import etapami w panelu: osobne operacje pobrania XML, przygotowania kategorii, producentów, dostawców, cech i atrybutów oraz importu produktów.
• Przetwarzanie partiami: konfigurowalna liczba produktów w partii oraz odczyt rekordów przez XMLReader. Pozwala to dostosować przebieg importu do zasobów serwera; czas wykonania zależy również od zdjęć i rozmiaru danych.
• Postęp, pauza i wznowienie: panel pokazuje postęp i liczniki operacji. Pauza pozwala dokończyć trwającą partię, a następnie wstrzymuje kolejne; zapisany postęp umożliwia wznowienie pracy.
• Pomijanie niezmienionych rekordów: importer porównuje skróty danych produktów. Wymuszenie aktualizacji pozwala ponownie przetworzyć rekordy także po zmianie ustawień, mimo niezmienionego XML.
• Szybka aktualizacja: osobna operacja pobiera dane przez adapter i aktualizuje ceny oraz ilości produktów bazowych już powiązanych z danym źródłem. Nie tworzy nowych kart produktów ani nie aktualizuje opisów, zdjęć i stanów poszczególnych kombinacji.
• CRON: adresy wywołań z kluczem dostępu pozwalają uruchamiać operacje dla wskazanego źródła. Harmonogram należy skonfigurować na serwerze lub w zewnętrznej usłudze, z uwzględnieniem pobierania danych i przetwarzania kolejnych partii.
• Historia i eksport logów: zapis sesji, podsumowania operacji, ostrzeżenia i błędy, filtrowanie wpisów oraz eksport dziennika do CSV.
• Wybór sklepów docelowych: konfiguracja pozwala wskazać sklepy w instalacji multistore, do których mają trafiać produkty. Część danych produktu i ustawień pozostaje wspólna zgodnie z ich zakresem w PrestaShop i module.

Korzyści dla obsługi sklepu

• Mniej ręcznego przepisywania: dane katalogowe, zdjęcia i dostępność trafiają do kart produktów w ramach skonfigurowanego importu.
• Kontrola nad własnymi treściami: wyłączenie aktualizacji nazw lub opisów pozwala zachować wybrane materiały przygotowane w sklepie podczas pełnego importu.
• Powtarzalne zasady cenowe: ta sama konfiguracja wyliczania cen może być stosowana przy kolejnych aktualizacjach źródła.
• Łatwiejsze ustalanie przyczyn problemów: postęp, podsumowania i logi pomagają rozróżnić dodane, zaktualizowane oraz pominięte rekordy i sprawdzić błędy importu.

Jak przygotować import XML do PrestaShop?

1. Przygotuj dostęp do XML i potwierdź, że jego struktura oraz potrzebne pola są obsługiwane przez adapter źródła.
2. Utwórz źródło, ustaw połączenie i wskaż sklepy docelowe.
3. Pobierz dane i przygotuj powiązania kategorii, producentów, dostawców, cech oraz atrybutów potrzebnych dla danego katalogu.
4. Ustal reguły cenowe, filtry i zakres nadpisywania danych, a następnie uruchom import produktów.
5. Sprawdź wynik na kartach produktów i w logach, po czym skonfiguruj cykliczne wywołania odpowiednich operacji CRON.

Zakres działania i wymagania

Struktura źródła wymaga dopasowania. Samo rozszerzenie XML nie oznacza zgodności pliku z importerem. Inny układ danych może wymagać przygotowania lub zmiany adaptera; zakres importu zależy od pól rzeczywiście dostarczanych przez źródło. Moduł nie jest importerem arkuszy XLSX ani plików CSV.

Pełny import i szybka aktualizacja mają różny zakres. Przełączniki nadpisywania pól dotyczą pełnej ścieżki importu. Szybka aktualizacja przez adapter zapisuje cenę i ilość produktu bazowego niezależnie od tych przełączników. Obsługa wielu źródeł nie oznacza automatycznego sumowania ich stanów ani wybierania najtańszej oferty.

Moduł zasila katalog produktów; nie przekazuje zamówień do hurtowni i nie rezerwuje towaru u dostawcy. Aktualność danych zależy od publikacji XML oraz częstotliwości uruchamiania importu. Opisy i pola meta są przetwarzane według danych i reguł, bez generowania treści przez AI.