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