Integracja z hurtownią https://www.annapol.com – 52tyś produktów
Integracja poprzez plik XML pozwala Państwu stworzyć swój własny sklep internetowy, ze wszystkimi danymi produktów z bazy Firmy Handlowo Usługowej ANNAPOL znajdujących się na stronie https://www.annapol.com
Produkty są automatycznie importowane do Twojego sklepu wraz z Państwa ustalonymi cenami zakupu (netto).
Oferta w Waszym sklepie będzie automatycznie aktualizowana.
W przypadku uzyskaniu zgody na dostęp do pliku XML zostanie aktywowany indywidualny dostęp do pliku.
Plik po zalogowaniu dostępny będzie w zakładce TWOJE KONTO http://www.annapol.com/account pod pozycją Cennik XML.
DALSZE INFORMACJE DOTYCZĄCA UDOSTĘPNIENIA PLIKU XML WRAZ OPISEM PLIKÓW
Plik zostaje udostępniony na okres próbny 1msc. po tym okresie zostanie dokonana weryfikacja czy wykonaliście Państwo integrację z naszą hurtownią https://www.annapol.com jeżeli Tak, to dostęp do pliku pozostaje aktywny, ale w przypadku braku takiej integracji z Waszym sklepem dostęp do pliku zostanie wyłączony.
Po włączeniu dostępu do plików XML w Panelu Klienta w zakładce Twoje konto dostępne są trzy pliki:
https://www.annapol.com/xml-categories - Tutaj znajdują się kategorie i podkategorie, kompletne drzewko kategorii w trzech językach, ale brak jest 50-60% tłumaczeń na język angielski i niemiecki.
Przykład:
<categories>
<group>
<category id="42" parent="0">
<name language="Polski" code="pl">
<![CDATA[ Motoryzacja ]]>
</name>
</category>
<category id="42" parent="0">
<name language="German" code="de">
<![CDATA[ Auto & Motorrad ]]>
</name>
</category>
<category id="42" parent="0">
<name language="English" code="en">
<![CDATA[ Automotive ]]>
https://www.annapol.com/xml-stock - tutaj znajdują się ceny w złotych i euro (do wyboru), stan magazynowy, cena promocyjna, stawka podatku, ID produktu, model.
Ważna Informacja!
on_request="0" <- produkt normalny i ilość jest powiązana z magazynem z widoczną ceną.
on_request="1" <- produkt w 99% dostępny w magazynie ale nie jest z nim zintegrowany i w pliku XML jego ilość wynosi 0 (stock="0), pomimo, że jest dostępny (można zamawiać) bardzo prosimy podczas dokonywania integracji w miejscu ilość magazynowa wpisać: „Pytać o ilość” lub samemu zdecydować jak to ma być rozwiązane.
Przykłady:
<product id="155497" symbol="AG663" on_request="0" stock="388" price_pln="2.65" price_eur="0.63" special_price_pln="2.38" special_price_eur="0.57" tax="23.0000"/>
<product id="155506" symbol="BLO014708" on_request="1" stock="0" price_pln="84.03" price_eur="20.05" tax="23.0000"/>
https://www.annapol.com/xml-products - tutaj znajdują sie opisy, zdjęcia główne i wszystkie zdjęcia dodatkowe, dodatkowo ID produktu, model, cena w euro i złotych, stawka podatku itp.
Powyższy link/plik jest za duży by otworzyć go z przeglądarki.
Trzeba go pobrać na dysk i odpalić z edytora - np. notepad++
Można spróbować w przeglądarce Mozilla w której udało się nam otworzyć plik
Przykład:
<products><group><product id="52" symbol="WS1010TW" price_pln="9.53" price_eur="2.27" tax="23.0000" stock="246"><name>WS1010TW Głośnik samochodowy 4"/2-drożny/100W</name><description><p><span style="font-size: small;"><span style="font-family: verdana,geneva;">Gonik sam.4"/2WAY/100W WS-1010TW</span></span></p><ul><li style="font-family: verdana,geneva;"><span style="font-size: small;"><span style="font-family: verdana,geneva;">Woofer: 100 mm membrana celuloza lakierowana i zawieszeniu z pianka poliuretanowa</span></span></li><li style="font-family: verdana,geneva;"><span style="font-size: small;"><span style="font-family: verdana,geneva;">Tweeter: 25 mm kopuka z magnesem neodymowym</span></span></li><li style="font-family: verdana,geneva;"><span style="font-size: small;"><span style="font-family: verdana,geneva;">Moc maksymalna: 100 W</span></span></li><li style="font-family: verdana,geneva;"><span style="font-size: small;"><span style="font-family: verdana,geneva;">Pasmo przenoszenia: 30 - 30 000 Hz</span></span></li><li style="font-family: verdana,geneva;"><span style="font-size: small;"><span style="font-family: verdana,geneva;">Impedancja: 4 ohm </span></span></li></ul><p><span style="font-size: small;"><span style="font-family: verdana,geneva;"><br /></span></span></p></description><category><id>2029</id><name>100 mm</name></category><manufacturers_name>Dibeisi</manufacturers_name><images><gfx>https://www.annapol.com/images/WS1010TW ASWSQWQ.jpg</gfx><gfx>https://www.annapol.com/images/ws1010tw_444.jpg</gfx><gfx>https://www.annapol.com/images/ws1010tw_333.jpg</gfx></images><on_request status="0"/></product>
Udostępnienie Bibloteki PHP w celu prostej integracji XML
Dla ułatwienia Państwu integracji z naszą hurtownią została udostępniona prosta Biblioteka PHP , która pozwala otworzyć i zintegrować plik XML, dotyczy to tylko i wyłącznie pliku xml-products (czyli https://www.annapol.com/xml-products.php?user......).
Bibliotekę można pobrać bezpośrednio po zalogowaniu przechodząc do:
a) Sekcji Twoje konto:
b) Lub pobierając bibliotekę bezpośrednio z adresu:
Biblioteka zawiera plik główny: products-xml.class.php oraz przykład wykorzystania, plik example.php a także pliku readme.txt gdzie zawarte są dodatkowe szczegóły techniczne.
Plik example.php zawiera w liniach od 7 do 13 prostą konfigurację:
$config = [
// Expiries downloaded xml file
'expiries' => 60*60,
// URL xml file
'url' => 'https://www.annapol.com/xml-products.php?user=EMAIL_ADDRESS&hash=YOUR_HASH'
];
Zmienna: expiries zawiera czas ważność pliku XML (60*60 oznacza 1 godzin)
Zmienna: url zawiera adres pliku XML podany w zakładce Twoje konto (po zalogowaniu);
Pozostała część kodu przedstawia implementację biblioteki, według następującej kolejności:
1) Wywołanie biblioteki
2) Pobranie pliku XML jeśli go nie ma albo stracił ważność.
3) Pobranie tablicy o produktach w pliku XML w formie ARRAY
4) Wydrukowanie na ekranie pierwszego rekordu z tablicy ARRAY.
DEMO biblioteki wygląda tak https://www.annapol.com/xml-example-library/demo/ Demo jest to przykład zastosowania. Poza tym pozwala sprawdzić czy plik XML jest poprawnie wygenerowany i pokazuje z niego 1 rekord. W tym miejscu po wklejeniu naszego XML https://www.annapol.com/xml-products.php?user............ i naciśnięciu SEND wyświetli sie nam ilość dostępnych produktów.
Każdy programista będzie wiedział jak to wykorzystać.
Dodatkowo informujemy , że obecny plik xml-products (https://www.annapol.com/xml-products.php?user......) został poprawiony i nie powinno być kłopotów z jego otwarciem.
Zalecamy używania przeglądarki Firefox – Mozilla , która najlepiej radzi sobie z otwarciem i zapisaniem plików XML
Ale najlepiej użyć wymienionej Biblioteki PHP
Wszelkie pytania związane z integracją prosimy kierować na integracje@annapol.pl
|
