Krajowy Integrator Płatności Spółka Akcyjna z siedzibą w Poznaniu, przy ul. Św. Marcin 73/6, wpisana do rejestru przedsiębiorców Krajowego Rejestru Sądowego prowadzonego przez Sąd Rejonowy Poznań Nowe Miasto i Wilda w Poznaniu, VIII Wydział Gospodarczy Krajowego Rejestru Sądowego pod numerem KRS 0000412357, numer NIP
INFORMACJE NA TEMAT STRUKTURY PLIKU XML W SYSTEMIEW SYSTEMIE ROCKPAY ROCKPAYL W SYSTEMIE ROCKPAY Marzec 2015 2
1 Wstęp Szanowni Państwo Do przeprowadzania sprawnej i skutecznej integracji oferty Państwa sklepu z system RockPay, kluczowe jest przygotowanie pliku o określonej strukturze. Przygotowany plik należy umieścić na Państwa serwerze. Następnie adres URL pliku XML należy wpisać w Panelu sprzedawcy systemu Rockpay, do którego dostęp jest możliwy wyłącznie za pośrednictwem Panelu Odbiorcy Płatności systemu Transferuj: https://secure.transferuj.pl/panel/logowanie.htm. System Rockpay nie przetwarza ofert przesłanych za pomocą poczty email. ID produktów w pliku XML muszą być stałe oraz niepowtarzalne raz użyte ID nie może być ponownie wykorzystane dla innego produktu. Dostęp do pliku XML nie może być ograniczony. Plik może być blokowany dla ogółu użytkowników oraz wyszukiwarek internetowych, natomiast musi być dostępny dla określonej przez RockPay adresu IP. Aby uzyskać adres IP, dla którego plik musi być udostępniony, należy skontaktować się drogą mailową z biurem obsługi klienta systemu Transferuj: bok@transferuj.pl. W przypadku wykrycia nieprawidłowości w pliku XML, prezentacja produktów w aplikacji RockPay zawieszana do czasu usunięcia błędów przez sklep. jest Plik XML jest zgodny z formatem pliku wymaganego do integracji z systemem Ceneo. Jeżeli potrzebują Państwo pomocy technicznej związanej z integracją, mogą Państwo kierować pytania na adres pt@transferuj.pl Życzymy pomyślnego wdrożenia i sukcesów jako Odbiorcy Płatności Transferuj.pl i RockPay. Z wyrazami szacunku, Zespół Transferuj.pl 3
2 Struktura pliku. 4
3 Objaśnienie znaczników Każda z ofert znajduje się pomiędzy znacznikami <o> i </o> <?xml version="1.0" encoding="utf-8"?> Kodowanie pliku. Dostępna opcja kodowania to UTF-8. Wymagane <offers xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" version="1"> Część stała pliku xml. Wymagane <group name="other"> Informacja z jakiej branży pochodzą oferty. Opcjonalnie <o id="151" url="http://www.sklep.tel.pl/id=158" price="980.15" avail="1"set="0" weight="3.5" basket="1" stock="2"> Podstawowe informacje o ofercie. id - unikalne i niezmienne id produktu. Maksymalna ilość znaków 100. Wymagane url - url produktu. Maksymalna ilość znaków 2048. Wymagane price - cena produktu. Liczba zmiennoprzecinkowa, separator kropka. Wymagane avail - dostępność produktu. set produkt należący do zestawu. Opcjonalnie weight - waga. Waga oferty w kilogramach, separator kropka, nie może być podana wartość 0 bądź puste pole. Opcjonalnie stock - stan magazynowy. Liczba całkowita dodatnia. Pole nie może być puste. Opcjonalnie <cat> <![CDATA[Komputery/Monitory/Monitory LCD]]> </cat> Informacja o pełnej ścieżce kategorii. Maksymalna ilość znaków 255. Wymagane <name> <![CDATA[Dell UB13H]]> </name> Informacja o dokładnej nazwie produktu. Maksymalna ilość znaków 150. Wymagane 5
<imgs> <main url="http://www.sklep.pl/images/151big.jpg"/> <i url="http://www.sklep.pl/images/152big.jpg"/> <i url="http://www.sklep.pl/images/153big.jpg"/> </imgs> Informacja z linkiem do zdjęć. Maksymalna ilość znaków zdjęcia głównego oraz dodatkowego 255. Opcjonalnie <desc> <![CDATA[Matryca monitora wykonana z niezwykle...]]> </desc> Informacja o opisie produktu. Opcjonalnie <attrs> <a name="producent"> <![CDATA[Dell]]> </a> <a name="kod_producenta"> <![CDATA[UB13H]]> </a> <a name="ean"> <![CDATA[142521534124]]> </a> </attrs> Informacja o atrybutach. Dany produkt może posiadać maksymalnie 10 atrybutów. Atrybuty różnią się w zależności od branży z jakiej oferta pochodzi. Grupa atrybutów znajduję się pomiędzy znacznikami <attrs> i </attrs>, a każdy atrybut znajduje się pomiędzy znacznikami <a> i </a> Wymagane 6