Dokumentacja techniczna RockPay
Transkrypt
Dokumentacja techniczna RockPay
Dokumentacja techniczna RockPay 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). Dokumentacja techniczna RockPay INFORMACJE NA TEMAT STRUKTURY PLIKU XML W SYSTEMIEW SYSTEMIE ROCKPAY ROCKPAYL W SYSTEMIE ROCKPAY Marzec 2015 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). 2 Dokumentacja techniczna RockPay 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: [email protected]. W przypadku wykrycia nieprawidłowości w pliku XML, prezentacja produktów w aplikacji RockPay jest zawieszana do czasu usunięcia błędów przez sklep. 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 [email protected] Życzymy pomyślnego wdrożenia i sukcesów jako Odbiorcy Płatności Transferuj.pl i RockPay. Z wyrazami szacunku, Zespół Transferuj.pl 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). 3 Dokumentacja techniczna RockPay 2 Struktura pliku . 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). 4 Dokumentacja techniczna RockPay 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 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). 5 Dokumentacja techniczna RockPay <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 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 7773061579, REGON 300878437, kapitał zakładowy 4 798 500,00 PLN (wpłacony w całości). 6