AB: dostęp do API i zakres importu katalogu
AB udostępnia API z danymi XML. Według publicznej informacji dostawcy dostęp wymaga dodatkowego aneksu do umowy, a opłaty zależą od obrotów w AB. Dokumentację techniczną partner otrzymuje wraz z dostępem. Warunki dostępu do danych ustal z AB przed zakupem integracji.
API dostawcy ma operacje pobierania katalogu, cen i stanów, a także osobne operacje dotyczące zamówień. Oferowany tutaj moduł zasila katalog PrestaShop; przekazywanie zamówień do AB i rezerwacja towaru nie należą do opisanego zakresu.
Do potwierdzenia integracji przygotuj dokumentację udostępnioną Twojemu kontu i próbkę odpowiedzi z potrzebnymi polami. Próba na kopii sklepu powinna objąć identyfikację produktu, cenę netto i VAT, dostępność oraz ponowne pobranie zmienionej ceny lub stanu. Osobno ustal postępowanie z produktem nieobecnym w kolejnym odczycie. To lista do odbioru, bez deklaracji przeprowadzonej próby na API Twojego konta.
Źródło sprawdzone 27.09.2026: AB — prosta integracja. Przygotowanie próby: identyfikatory i aktualizacja importu XML.
Ź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?
- Przygotuj dostęp do XML i potwierdź, że jego struktura oraz potrzebne pola są obsługiwane przez adapter źródła.
- Utwórz źródło, ustaw połączenie i wskaż sklepy docelowe.
- Pobierz dane i przygotuj powiązania kategorii, producentów, dostawców, cech oraz atrybutów potrzebnych dla danego katalogu.
- Ustal reguły cenowe, filtry i zakres nadpisywania danych, a następnie uruchom import produktów.
- 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.
Demo panel administracyjny:
https://moduly-prestashop.eu/pdxmlimport/admin-dev
Demo panel przedni:
https://moduly-prestashop.eu/pdxmlimport