Przygotowanie eksportu XML dla Prestashop

Poniższy artykuł zakłada, że czytający zapoznał się z sekcją podstawowej konfiguracji

W przypadku eksportu XML do Empik, należy pamiętać o kilku ważnych zasadach:
• Konfiguracja pliku XML z Produktami i Ofertami musi być zgodna! (więcej poniżej)
• Nie wolno usunąć/wyłączyć/ukryć z katalogu sklepu produktu, który znajduje się w Empik Marketplace ze stanem > 0.
Aby usunąć produkt z Oferty i uniknąć problemów z Empik, prosimy ustawic stan magazynowy produktu na 0, odczekać aż Carrefour wyłączy produkt, dopiero następnie można bezpiecznie usunąć produkt.

System Empik wymaga nagłówków Content-Length: *, w tym celu plik wpierw musi zostać zapisany w postaci pliku na serwerze.
Oryginalny komunikat systemu: Please note that the seller should also add the HTTP "Content-Length" header in his https page.
(The "Last-Modified" and "Content-Length" headers are mandatory for Mirakl to get the resource)

Zobacz też: Generowanie plików na serwerze

Omówienie opcji

Opcje te są skierowane raczej do zaawansowanych użyktkowników i/lub tych, którzy mają problem z wygenerowaniem XML

Ustawienia Empik

Podwójne koodowanie znaków

Niektóre sklepy mogą posiadać błędy w bazie/kodowaniu. Włączenie tej opcji pozwala w niektórych przypadkach na "naprawę" tego problemu.

Blokuj eksport kategorii

Opcja potrzebna tylko w przypadku, gdy występują problemy

Używanie innego identyfikatora niż ID Presta

Pomimo, że nie zalecamy tej zmiany, umozliwiliśmy ja dla osób, które wiedzą co robią. Aby z tej opcji skorzystać, sklep musi być bardzo dobrze uzupełniony.

Ta opcja muisi być zaznaczona identycznie w obu XML'ach (ofertowym i produktowym). Jeśli nie będą, to parowanie produktów będzie niemożliwe!

Zmiana tych ustawień po wykonaniu eksportu stworzy duplikaty wszystkich (a przynajmniej większości) ofert i produktów.

Użycie identyfikatorów innych niz 'ID Presta' bezwzględnie wymaga posiadania unikalnych EANów lub kodów w sklepie (które nie mogą ulegać zmianie) lub w przypadku kodu producenta (indeks #) wymagają, aby każdy produkt bezwzględnie posiadał niepowtarzalny kod producenta. Jeśli kod producenta/lub ean się powtórzą może to spodować naliczenie przez system Empik Marketplace niepoprawnej ceny/stanu magazynowego

Sekcja dodatkowych tagów XML:

Domyślna wartość

Domyślnie, tagi nie są uzupełnione automatycznie, gdyż każdy sklep posiada je w innym miejscu:

<WymiaryProduktu>
	<Wysokosc></Wysokosc>
	<Szerokosc></Szerokosc>
	<Glebokosc></Glebokosc>
	<Waga></Waga>
</WymiaryProduktu>
<InfoDodatkowe>
	<Linia></Linia>
	<MarkaKosmetyku></MarkaKosmetyku>
	<Plec></Plec>
	<Dla></Dla>
	<Marka></Marka>
	<KolorGlowny></KolorGlowny>
	<KolorSzczegoly></KolorSzczegoly>
	<Material></Material>
	<RodzajSkoryWlosow></RodzajSkoryWlosow>
	<Rodzaj></Rodzaj>
	<Dzialanie></Dzialanie>
	<Pojemnosc></Pojemnosc>
</InfoDodatkowe>

Przykładowa, zmodyfikowana wartość

Poniżej przedstawiamy przykład, jak może wyglądać uzupełniony za pomocą systemu SmartTagów
proszę nie kopiować do sklepu, gdyż nie będzie to działało w żadnym sklepie, każy sklep jest indywidualny

<WymiaryProduktu>
	<Wysokosc>{cecha:n}</Wysokosc>
	<Szerokosc>{cecha:n}</Szerokosc>
	<Glebokosc>{cecha:n}</Glebokosc>
	<Waga>{cecha:n}</Waga>
</WymiaryProduktu>
<InfoDodatkowe>
	<Linia>{cecha:n}</Linia>
	<MarkaKosmetyku>{cecha:n}</MarkaKosmetyku>
	<Plec>{cecha:n}</Plec>
	<Dla>{cecha:n}</Dla>
	<Marka>{cecha:n}</Marka>
	<KolorGlowny>{cecha:n}</KolorGlowny>
	<KolorSzczegoly>{cecha:n}</KolorSzczegoly>
	<Material>{cecha:n}</Material>
	<RodzajSkoryWlosow>{cecha:n}</RodzajSkoryWlosow>
	<Rodzaj>{cecha:n}</Rodzaj>
	<Dzialanie>{cecha:n}</Dzialanie>
	<Pojemnosc>{cecha:n}</Pojemnosc>
</InfoDodatkowe>

Istnieje też możliwość stworzenia samemu dodatkowych tagów za pomocą custom_functions lub haków. Zapraszamy do zapoznania się z sekcją Hook i Custom functions

@todo dodać przykład jak można modyfikować ID w custom fucnctions i zlinkować.

Sekcja konfiguracji panelu Empik:

Poniżej objaśniamy sposób konfiguracji importu plików do Empik:

  1. Protokół: Wybieramy protokół jakim Carrefour ma łączyć się z naszym serwerem
  2. Nazwa hosta: Domena prowadząca do naszej strony
  3. Port: Port wykorzystany do połączenia z naszym serwerem (Zależnie od protokołu: dla HTTP jest to port 80, a dla HTTPS jest to port 443)
  4. Ścieżka: Ścieżka prowadząca do pliku na naszym serwerze
  5. Nazwa użytkownika: Wypełniamy tylko jeśli link do pobierania pliku zabezpieczony jest loginem i hasłem
  6. Hasło: Wypełniamy tylko jeśli link do pobierania pliku zabezpieczony jest loginem i hasłem

Przykład podany na poniższym obrazku wskazuje systemowi Carrefour, że plik zawierający informacje o ofertach można pobrać pod linkiem:

http://example.com/xml/empik-offer.xml

Natomiast plik zawierający informacje o produktach należy przesłać do obsługi Empik drogą mailową.

empik_panel

Sekcja o błędach importu:

Pod poniższym linkiem znajduje się nasze narzędzie do odczytu błędów wyrzucanych przez system Empik w trakcie importu ofert:

Narzędzie odczytu błędów

Instrukcja obsługi zawarta jest na stronie z narzędziem.