Żagiel S.A. ul. Zana 39A 20-601 Lublin tel. (081) 469 05 75 ekredyt@zagiel.com.pl ekredyt Żagiel Instrukcja integracji systemów Ecommerce z ekredyt Żagiel Wykonali: Arkadiusz Krakiewicz Dariusz Wójtowicz Sławomir Kozik 22 listopada 2007 (Wersja 1.6)
Spis treści 2 1. Założenia ogólne... 4 2. Uwagi wstępne... 5 3. Specyfikacja parametrów wejściowych ekredyt... 6 4. Objaśnienia... 7 4.1 Banner Jak kupić na raty... 7 4.2 Kanał SymRat... 8 4.3 Link dedykowany... 9 4.4 Kanał ALLEGRO... 10 4.5 Kanał BASE i ORDER... 11 4.5.1 Jakie są różnice?...11 4.5.2 Kanał BASE...11 4.5.3 Kanał ORDER...12 5. Przykłady kodu... 13 5.1 Przycisk Oblicz ratę w opisie produktu... 13 5.1.1 Kod JavaScript...13 5.1.2 Wykorzystanie kodu JavaScript...13 5.2 Przycisk Oblicz ratę w podglądzie koszyka... 14 5.2.1 Kod JavaScript...14 5.2.2 Wykorzystanie kodu JavaScript...14 5.3 Przycisk Oblicz ratę w potwierdzeniu zamówienia.... 15 5.3.1 Kod JavaScript...15 5.3.2 Wykorzystanie kodu JavaScript...15 5.4 Tekst Zapoznałem się z procedurą... oraz jego walidacja... 16 5.4.1 Kod JavaScript...16 5.4.2 Wykorzystanie kodu JavaScript...16 5.5 Tworzenie formularza w kanale BASE... 17 5.5.1 Formatowanie danych...17 5.5.2 Dynamiczne tworzenie formularza ekredyt Żagiel...17 5.5.3 Wygląd utworzonego formularza...19 5.6 Tworzenie formularza w kanale ORDER... 20 5.6.1 Formatowanie danych...20 5.6.2 Dynamiczne tworzenie formularza ekredyt Żagiel...20 5.6.3 Wygląd utworzonego formularza...22 6. Materiały promocyjne... 23 7. Pomoc techniczna... 23
Jeżeli chcesz sprzedawać na raty przez: 3 z a p o z n a j s ię tyl k o z p u n k t a m i 1 2 3 4.4 Wszystkie oprócz punktu 4.4 1 2 3 4.3 Sprzedaż na raty przez serwis Allegro Serwis aukcji internetowych. Sprzedaż i kupno towarów oraz usług, poprzez aukcje z licytacją lub po stałych cenach. Dobry pomysł na rozpoczęcie sprzedaży ratalnej w Internecie. Dzięki sprzedaży ratalnej Twoje oferty będą jeszcze bardziej atrakcyjne dla potencjalnych klientów. Sprzedaż na raty przez własny sklep internetowy Twój własny sklep internetowy lub każdy inny system Ecommerce, mający na celu sprzedaż towarów lub usług przez Internet. Twoi klienci dzięki systemowi ekredyt będą mogli kupować na raty bez wychodzenia z domu! Dzięki sprzedaży ratalnej twój obrót wzrośnie. Sprzedaż na raty w rozmowie indywidualnej z klientem Jeżeli nie posiadasz sklepu internetowego lub nie prowadzisz sprzedaży na aukcjach internetowych ten sposób sprzedaży ratalnej jest właśnie dla Ciebie. Indywidualnie ustalasz cenę na określony przez klienta towar. Jedynym Twoim zadaniem jest wysłanie e-mail em linku www do klienta z odpowiednią nazwą i ceną towaru. Po kliknięciu na link klient sam uzupełnia wniosek o przyznanie kredytu ratalnego w systemie ekredyt Żagiel. Ten sposób sprzedaży często jest także używany przy indywidualnych negocjacjach cen z klientem, pomimo sprzedaży poprzez sklep lub aukcje.
1. Założenia ogólne Zaprezentowany tutaj kod jest tylko przykładem możliwości użycia gotowych rozwiązań w językach HTML, JavaScript oraz PHP na stronach Państwa systemów Ecommerce. Ma to na celu zobrazowanie oraz ułatwienie integracji z naszym modułem płatności kredytowej ekredyt Żagiel, ułatwiając Państwa klientom zakup produktów w sklepie internetowym (systemie Ecommerce). Fragmenty kodu zawarte w tym dokumencie służą za przykład. W związku z tym mogą Państwo dowolnie modyfikować istniejące tutaj rozwiązania. Głównym celem jest zachowanie poprawnego sposobu działania wykonanej przez Państwa integracji z modułem ekredyt Żagiel oraz ułatwienia zakupu na raty od strony klienta. Firma Żagiel S.A. nie ponosi odpowiedzialności w wyniku nieprawidłowego lub błędnego użycia zaprezentowanego kodu. 4
2. Uwagi wstępne 5 2.1 Po ukończeniu integracji w dowolnym kanale wymagana jest autoryzacja oraz akceptacja dokonanej integracji przez pracowników Żagiel S.A. Dokonuje się tego, informując pracownika firmy Żagiel S.A. odpowiedzialnego za integrację systemów Ecommerce z systemem ekredyt. 2.2 Należy pamiętać, iż przy kopiowaniu tekstu z dokumentu może nastąpić zmiana znaków. Często dotyczy to zamiany apostrofów na inne ich odpowiedniki, braku podkreśleń lub polskich znaków. Rozwiązaniem jest sprawdzenie poprawności wklejonego kodu, lub wykorzystanie go z pliku kod.txt http://www.zagiel.com.pl/kalkulator/kody/kod.txt 2.3 Zakup na raty w systemie ekredyt Żagiel jest możliwy powyżej 100 zł zamówienia. Zgodnie z tym przycisk Oblicz ratę powinien wyświetlać się dla produktu, koszyka lub zamówienia, których wartość wynosi co najmniej 100 zł. 2.4 Należy mieć na uwadze wliczenie ewentualnych kosztów przesyłki do umowy ratalnej. 2.5 Format ceny produktów nie może zawierać przecinka, ani odstępów jako separatorów tysięcy od setek itd Prawidłowo: 100 100.00 599.99 Błędnie: 1 200 1 200.99 100,99 2.6 Należy pamiętać o odpowiednim sformatowaniu nazw produktów, które są umieszczane w formularzu wysyłanym do systemu ekredyt Żagiel. Odnosi się to do występowania apostrofów w nazwie produktu np.: Telewizor 32 CRT. Umieszczenie w nazwie apostrofu powoduje błędne zamknięcie pola: <input type="text"... value="telewizor 32" CRT"> 2.7 W formatowaniu ceny i nazwy produktu pomogą nam gotowe funkcje clean_... [Patrz punkt 5.5.1] 2.8 Numer sklepu, który należy używać podczas przeprowadzania testów: 28011111. 2.9 Sugerujemy, aby dokonywali Państwo integracji sklepu w testowym środowisku niedostępnym dla klienta. 2.10 W celu pełnego zobrazowania przebiegu zakupu na raty stworzyliśmy przewodnik graficzny: http://www.zagiel.com.pl/kalkulator/instrukcja.html 2.11 Wszelkie błędy, uwagi lub poprawki należy zgłaszać na adres: ekredyt@zagiel.com.pl Chcemy dołożyć wszelkich starań, aby nasza dokumentacja oraz pomoc techniczna spełniała Państwa oczekiwania odnośnie integracji sklepów, lub innych systemów Ecommerce z systemem sprzedaży ratalnej przez Internet ekredyt Żagiel.
3. Specyfikacja parametrów wejściowych ekredyt 6 Nazwa parametru Typ Opis action VARCHAR2(20) Akcja po stronie serwera Żagiel (Domyślnie dla kalkulatora i generatora: getklientdet_si_rata) (Domyślnie dla kanału ORDER i BASE: getklientdet_si) shopno VARCHAR2(8) Ośmiocyfrowy numer rozliczeniowy sklepu numer znajduje się na umowie shopname VARCHAR2(25) Nazwa sklepu shophttp Adres http sklepu, na który nastąpi przekierowanie po zakończeniu procesu VARCHAR2(100) w trybie BASE shopmailadress VARCHAR2(100) Adres e-mail sklepu shopphone VARCHAR2(30) Telefon kontaktowy sklepu goodsvalue NUMBER(7) Wartość koszyka goodsno VARCHAR2(20) Liczba towarów w koszyku goodsid(n) VARCHAR2(30) Identyfikator ze sklepu n-tego towaru (goodsid1,goodsid2... goodsid(n)) goodsname(n) VARCHAR2(300) Nazwa n-tego towaru (goodsname1,goodsname2... goodsname(n)) goodsvalue(n) NUMBER(9) Cena n-tego towaru (goodsname1,goodsname2... goodsname(n)) IDZamowienieSklep VARCHAR2(20) Nr zamówienia wygenerowanego przez sklep ImieSklep VARCHAR2(25) Imię klienta NazwiskoSklep VARCHAR2(35) Nazwisko klienta EmailSklep VARCHAR2(100) Adres e-mail klienta TelKontaktSklep VARCHAR2(15) Telefon do klienta UlicaSklep VARCHAR2(60) Ulica zamieszkania klienta NrDomuSklep VARCHAR2(15) Nr domu klienta NrMieszkaniaSklep VARCHAR2(15) Nr mieszkania klienta MiejscowoscSklep VARCHAR2(50) Miejscowość zamieszkania klienta KodPocztowySklep NUMBER(5) Kod pocztowy klienta wniosekzapisany VARCHAR2(50) Adres, na który przekierować aplikacje po złożeniu wniosku o kredyt ratalny wniosekanulowany VARCHAR2(50) Adres, na który przekierować aplikację w przypadku rezygnacji klienta ze złożenia wniosku o kredyt ratalny Prosimy nie modyfikować parametrów, dla których przewidziana jest wartość domyślna. Zmiana parametru domyślnego spowoduje błędy w integracji.
4. Objaśnienia 7 4.1 Banner Jak kupić na raty Na potrzeby systemu ekredyt opracowana została instrukcja wyjaśniająca proces dokonywania zakupów. Kierowana jest do internautów i potencjalnych klientów, którzy planują skorzystać z systemu ratalnego Żagiel S.A. W jasny sposób tłumaczy jak dokonać zakupów na raty w kilku prostych krokach. W celu ułatwienia publikowania instrukcji, opracowany został zestaw bannerów dostępnych na stronie www.zagiel.com.pl/kalkulator/bannery.htm. Każdy z naszych partnerów powinien umieścić na swojej stronie jeden z dostępnych bannerów i podlinkować pod niego adres - http://www.zagiel.com.pl/kalkulator/jak_kupic_aukcje.html - http://www.zagiel.com.pl/kalkulator/jak_kupic_indywidualnie.html - http://www.zagiel.com.pl/kalkulator/jak_kupic.html Przykład zamieszczenia bannera... Bannery mają za zadanie skierować klienta do treści instrukcji, która znajduje się pod w/w adresami. Treść instrukcji może ulegać zmianom w związku z tym bardzo ważne jest, aby bannery odwoływały się do materiału źródłowego znajdującego się na serwerze www firmy Żagiel S.A. Więcej informacji o materiałach promocyjnych znajdą Państwo w punkcie 6 na stronie 23.
4.2 Kanał SymRat 8 Kanał SymRat służy do przeprowadzenia symulacji spłaty kredytu przez klienta. Klient, chcąc zorientować się ile wyniesie miesięczna rata kredytu, przed złożeniem zamówienia klika na przycisk Oblicz ratę. W tym momencie otwiera się nowe okno, które przechwytuje przekazaną cenę (pojedynczego towaru, całego koszyka lub zamówienia) ze sklepu i na jej podstawie wylicza parametry kredytu ratalnego. ekredyt na podstawie otrzymanych parametrów dokonuje obliczenia wysokości raty kredytu. Sklep internetowy musi udostępnić link, przycisk lub klawisz, którego naciśnięcie spowoduje otwarcie nowego okna, w którym zostanie uruchomiona aplikacja ekredyt. Przykład: [Patrz punkt 5.1 lub 5.2] Przykładowy link: http://www.zagiel.com.pl/kalkulator/index_smart.php?action=getklientdet_si_rata&shopno=28011111&goodsvalue=1849 Dobrym rozwiązaniem dla okna symulatora rat jest otwarcie go za pomocą JavaScript u. Pozwoli to na ustalenie rozmiaru nowo otwartego okna oraz innych jego właściwości. Dzięki takiemu rozwiązaniu symulacja rat nie zasłoni całego okna sklepu, a tylko mały jego fragment, co ułatwi klientowi nawigację. W kanale SYMRAT sklep internetowy przekazuje zestaw parametrów zawierających: dane sklepu (action, shopno) wartość koszyka towarów (goodsvalue) tryb przesyłania danych - GET
4.3 Link dedykowany 9 Ten kanał sprzedaży jest przeznaczony dla pojedynczych transakcji pomiędzy sprzedawcą a klientem. Stosuje się go w przypadkach gdy: pełna integracja sklepu internetowego z systemem ekredyt nie jest możliwa negocjowana jest indywidualna cena towaru z klientem Polega on na ustaleniu indywidualnej ceny na określone towary. Często jest on używany przy negocjacjach cen, kiedy klient kupując przez system sklepu nie będzie miał możliwości zmiany ceny. Instrukcja dla klienta chcącego zapoznać się z procedurą zakupu na raty: http://www.zagiel.com.pl/kalkulator/jak_kupic_indywidualnie.html Link dedykowany działa podobnie do kanału SymRat i Allegro. Zanim klient wyśle wniosek o przyznanie kredytu ratalnego, system ekredyt umożliwia symulację wyliczenia spłaty kredytu ratalnego. Przebieg procesu: Poniżej zamieszamy przebieg procesu obsługi klienta za pomocą linku indywidualnego 1) Wygenerowanie linku za pomocą generatora Generator linków : http://www.zagiel.com.pl/kalkulator/generator/generator.html 2) Skopiowanie zawartości z pola: Link do formularza kredytowego, który należy przesłać klientowi (wyślij e-mailem) 3) Wysłanie e-mailem wygenerowanego linku do klienta z ewentualną informacją jak wygląda droga zakupu na raty [Patrz punkt 4.1] 4) Klient za pośrednictwem poczty e-mail otrzymuje link wygenerowany przez pracownika sklepu. 5) Przesłany link kieruje go do systemu ekredyt Żagiel w celu złożenia wniosku o kredyt ratalny. Link dedykowany generujemy poprzez Generator linków : http://www.zagiel.com.pl/kalkulator/generator/generator.html Pewną niedogodnością jest fakt, że tekst opisujący towar nie może zawierać polskich liter. W kanale sprzedaży Link dedykowany Sprzedaż indywidualna, w przesyłanym adresie www przekazywany jest zestaw parametrów zawierających: dane sklepu (action, shopno) wartość koszyka towarów (goodsvalue) tryb przesyłania danych - GET
4.4 Kanał ALLEGRO 10 W kanale ALLEGRO sklep internetowy przekazuje zestaw parametrów zawierających: dane sklepu (action, shopno) parametry opisujące pojedynczy towar wystawiony w danej aukcji Allegro (goodsvalue) tryb przesyłania danych GET Instrukcja dla klienta chcącego zapoznać się z procedurą zakupu na raty: http://www.zagiel.com.pl/kalkulator/jak_kupic_aukcje.html Pewną niedogodnością jest fakt, iż tekst opisujący towar nie może zawierać polskich liter. W przypadku gdy klient chce kupić na raty więcej niż jedną sztukę wystawionego towaru, należy skorzystać z opcji Link dedykowany. [Patrz punkt 4.3] Przebieg procesu: Aby oferować swoim klientom sprzedaż ratalną w systemie Żagiel na aukcji internetowej, należy wykonać poniższe kroki: 1) Wygeneruj dwa przyciski oraz link do formularza ratalnego poprzez Generator linków : http://www.zagiel.com.pl/kalkulator/generator/generator.html 2) Wklej wygenerowany kod HTML z pól Kod HTML wyświetlający przycisk do instrukcji zakupów na raty (umieść na aukcji) Kod HTML wyświetlający przycisk do symulatora rat (umieść na aukcji) w opis aukcji 3) Gdy klient wygra aukcje wyślij mu e-mail em wygenerowany link z pola: Link do formularza kredytowego, który należy przesłać klientowi (wyślij mailem) Dodatkowo można wykorzystać gotowe materiały promocyjne ze strony: http://www.zagiel.com.pl/kalkulator/bannery_allegro.htm
4.5 Kanał BASE i ORDER 11 4.5.1 Jakie są różnice? Kanał BASE jest uproszczeniem kanału ORDER. Zasadniczą różnicą między nimi jest brak przekazania w kanale BASE numeru zamówienia sklepu. Oprócz tego BASE może, lecz nie musi przekazywać żadnych informacji o kliencie. Skutkiem tego jest to, iż klient po złożeniu zamówienia i przeniesieniu do systemu SymRat (ekredyt) musi uzupełnić swoje dane ręcznie. Kanał ORDER ułatwia to klientowi poprzez zebranie z bazy sklepu (lub tymczasowych zmiennych) danych klienta. Te dwa kanały pokrywają się przekazywanymi parametrami. 4.5.2 Kanał BASE Kiedy należy użyć kanału BASE? Użycie kanału BASE jest przydatne, gdy strona z potwierdzeniem już złożonego zamówienia nie posiada do przekazania numeru zamówienia oraz danych klienta. Taki przypadek mamy np. w silniku oscommerce, gdzie po złożeniu zamówienia klient zostaje przeniesiony już na stronę bez jakichkolwiek danych o zakupie towaru. Problem ten możemy rozwiązać, generując formularz w kanale BASE już na stronie zanim klient potwierdzi zamówienie ( checkout_confirmation.php ). Ten sposób nie posiada typowej strony przejściowej, którą możemy nazwać bramką do systemu SymRat Żagiel. [Patrz punkt 5.5] Dodatkowe informacje... Klient przed potwierdzeniem zamówienia musi zapoznać się z regulaminem udzielenia kredytu ratalnego [Patrz punkt 5.4] W trybie BASE sklep internetowy przekazuje zestaw parametrów zawierających: dane sklepu dane opisujące koszyk towarów tryb przesyłania danych POST ekredyt na podstawie otrzymanych parametrów dokonuje obliczenia wysokości raty kredytu oraz umożliwia klientowi wprowadzenie niezbędnych danych do złożenia wniosku o przyznanie kredytu ratalnego. Na wyjściu system: zapisuje dane klienta w bazie danych poprzez przeglądarkę informuje klienta iż ma czekać na kontakt konsultanta Żagiel wysyła maila z wnioskiem o przyznanie kredytu ratalnego dla danego klienta do Centrum Obsługi wysyła maila do sklepu z prośbą o rezerwację towaru
12 4.5.3 Kanał ORDER Kiedy należy użyć kanału ORDER? Użycie kanału ORDER jest przydatne, gdy strona z potwierdzeniem już złożonego zamówienia posiada numer zamówienia oraz dane klienta. Taki przypadek możemy mieć, gdy jedna strona z podziękowaniami dla klienta za dokonanie zakupów, nadaje numer zamówienia i jednocześnie usuwa produkty z koszyka, które możemy wcześniej jeszcze przechwycić. Tę stronę możemy nazwać stroną przejściową (bramką) do systemu SymRat Żagiel. [Patrz punkt 5.6] Dodatkowe informacje Klient przed potwierdzeniem zamówienia musi zapoznać się z regulaminem udzielenia kredytu ratalnego [Patrz punkt 5.4] W trybie ORDER sklep internetowy przekazuje zestaw parametrów zawierających: dane sklepu dane opisujące koszyk towarów nr zamówienia wygenerowany system sklepu dane klienta zebrane podczas składania zamówienia link na który ma nastąpić przekierowanie w przypadku złożenia przez klienta wniosku o kredyt ratalny link na który ma nastąpić przekierowanie w przypadku rezygnacji ze złożenia przez klienta wniosku o kredyt ratalny w celu, aby sklep uzgodnił z klientem inny sposób płatności dla danego zamówienia tryb przesyłania danych POST ekredyt na podstawie otrzymanych parametrów dokonuje obliczenia wysokości raty kredytu oraz umożliwia klientowi wprowadzenie niezbędnych danych do złożenia wniosku o przyznanie kredytu ratalnego z uwzględnieniem danych wprowadzonych na poziomie sklepu internetowego i przekazanych do ekredyt jako parametry. Na wyjściu system: zapisuje dane klienta w bazie danych w przypadku, gdy klient wysłał wniosek o przyznanie kredytu ratalnego o przekierowuje na pobrany w parametrze link do sklepu internetowego z informacją, że operacja złożenia wniosku zakończyła się pomyślnie o wysyła maila z wnioskiem o przyznanie kredytu ratalnego dla danego klienta do Centrum Obsługi o wysyła maila do sklepu z prośbą o rezerwację towaru w przypadku rezygnacji klienta o przekierowuje na pobrany w parametrze link do sklepu internetowego z informacją, że klient zrezygnował ze złożenia wniosku o przyznanie kredytu ratalnego i konieczny jest kontakt z nim w celu ustalenia innego sposobu płatności
13 5. Przykłady kodu 5.1 Dodanie przycisku Oblicz ratę do strony z opisem produktu 5.1.1 W sekcji <head> </head> strony www umieszczamy następujący kod <script> <!-- function PoliczRate(koszyk) { window.open('http://www.zagiel.com.pl/kalkulator/index_smart.php?action=getklientdet_si_ra ta&shopno=twoj_numer_sklepu_zagiel&goodsvalue='+koszyk, 'Policz_rate', 'width=630,height=500,directories=no,location=no,menubar=no,resizable=yes,scrollbars=yes,s tatus=no,toolbar=no'); //--> </script> 5.1.2 Użycie 1) powyższej funkcji JavaScript <?php if ($cena_produktu >= 100) { echo ' TEN PRODUKT KUPISZ U NAS NA R A T Y <br /> <a OnClick="PoliczRate('. $cena_produktu. ');" style="cursor: pointer;"> <img src="przycisk_oblicz_rate.gif" title="oblicz ratę" alt="oblicz ratę" border="0" /> </a> '; else { echo ' Zakup na raty dostępny jest <b>od 100 zł</b> wartości produktu lub całego zamówienia. ';?> Uwagi: 1) Można użyć podanego fragmentu np. obok przycisku Kup ten produkt ( Dodaj do koszyka ). Oczywiście wybór miejsca jest dowolny. Ważne, aby przycisk był widoczny dla klienta. Należy pamiętać, iż zakup na raty jest możliwy powyżej 100 zł całości zamówienia lub ceny pojedynczej sztuki produktu. W funkcji JavaScript w miejsce TWOJ_NUMER_SKLEPU_ZAGIEL należy wpisać swój numer sklepu nadany przez Żagiel S.A. dla sklepu internetowego (nie stacjonarnego). W czasie procesu integracji i testów należy używać numeru testowego: 28011111.
14 5.2 Dodanie przycisku Oblicz ratę do strony z podglądem koszyka produktów (przed ostatecznym złożeniem zamówienia) 5.2.1 W sekcji <head> </head> strony www umieszczamy następujący kod <script> <!-- function PoliczRate(koszyk) { window.open('http://www.zagiel.com.pl/kalkulator/index_smart.php?action=getklientdet_si_ra ta&shopno=twoj_numer_sklepu_zagiel&goodsvalue='+koszyk, 'Policz_rate', 'width=630,height=500,directories=no,location=no,menubar=no,resizable=yes,scrollbars=yes,s tatus=no,toolbar=no'); //--> </script> 5.2.2 Użycie 2) powyższej funkcji JavaScript <?php if ($wartosc_koszyka >= 100) { echo ' Jeżeli chciałbyś zakupić wybrane produkty na <b>raty w systemie Żagiel</b>, możesz wstępnie obliczyć wysokość miesięcznej raty... <br /> <a OnClick="PoliczRate('. $wartosc_koszyka. ');" style="cursor: pointer;"> <img src="przycisk_oblicz_rate.gif" title="oblicz ratę" alt="oblicz ratę" border="0" /> </a> '; else { echo ' Zakup na raty dostępny jest <b>od 100 zł</b> wartości całego zamówienia. ';?> Uwagi: 2) Można użyć podanego fragmentu np. obok przycisku Aktualizuj koszyk, Złóż zamówienie. W funkcji JavaScript w miejsce TWOJ_NUMER_SKLEPU_ZAGIEL należy wpisać swój numer sklepu nadany przez Żagiel S.A. dla sklepu internetowego (nie stacjonarnego). W czasie procesu integracji i testów należy używać numeru testowego: 28011111.
5.3 Dodanie przycisku Oblicz ratę do strony z potwierdzeniem zamówienia Wyświetlenie przycisku Oblicz ratę oraz tekstu Zapoznałem się z warunkami powinno zależeć (oprócz od wartości zamówienia), także od metody płatności, którą klient wybrał. 5.3.1 W sekcji <head> </head> strony www umieszczamy następujący kod <script language="javascript"> <!-- function PoliczRate(koszyk) { window.open('http://www.zagiel.com.pl/kalkulator/index_smart.php?action=getklientdet_si_ra ta&shopno=twoj_numer_sklepu_zagiel&goodsvalue='+koszyk, 'Policz_rate', 'width=630,height=500,directories=no,location=no,menubar=no,resizable=yes,scrollbars=yes, status=no,toolbar=no'); //--> </script> 5.3.2 Użycie powyższej funkcji JavaScript <?php if ($wartosc_koszyka >= 100) { echo ' <a OnClick="PoliczRate('. $wartosc_koszyka. ');" style="cursor: pointer;"> <img src="przycisk_oblicz_rate.gif" title="oblicz ratę" alt="oblicz ratę" border="0" /> </a> ';?> 15 Uwagi: W funkcji JavaScript w miejsce TWOJ_NUMER_SKLEPU_ZAGIEL należy wpisać swój numer sklepu nadany przez Żagiel S.A. dla sklepu internetowego (nie stacjonarnego). W czasie procesu integracji i testów należy używać numeru testowego: 28011111.
5.4 Dodanie tekstu Zapoznałem się z procedurą... do strony z potwierdzeniem zamówienia (przed ostatecznym złożeniem zamówienia) oraz walidacja w/w tekstu (pola) 16 5.4.1 W sekcji <head> </head> strony www umieszczamy następujący kod <script language="javascript"> <!-- function nowe_okno() { window.open('http://www.zagiel.com.pl/kalkulator/jak_kupic.html', 'nowe_okno', 'width=600,height=500,directories=no,location=no,menubar=no,resizable=yes,scrollbars=yes,s tatus=no,toolbar=no'); function validate_zagiel() { if (document.id_formularza_zamowienia.id_nazwy_pola_raty_zgoda.checked==false){ alert ("Zanim złożysz zamówienie, zapoznaj się z procedurą udzielenia kredytu ratalnego ekredyt Żagiel."); return false; else { return true; //--> </script> 5.4.2 Użycie powyższej funkcji JavaScript Niżej podany kod należy wstawić blisko przycisku z ostatecznym potwierdzeniem zamówienia np. obok Potwierdź zamówienie. Zapoznałem się <a OnClick="nowe_okno();" style="cursor: pointer;"><b><u>z procedurą udzielenia kredytu ratalnego ekredyt Żagiel</u></b></a> <input type="checkbox" id="id_nazwy_pola_raty_zgoda" /> W sekcji formularza z zamówieniem 3) wstawiamy wywołanie funkcji JavaScript, która będzie miała za zadanie przeprowadzenie walidacji pola typu checkbox zanim zostanie wysłane zamówienie. Zaznaczenie tego pola jest równoznaczne z tym, iż klient zapoznał się z warunkami podjęcia kredytu ratalnego (jest to wymagane). <form action="..."... onsubmit="return validate_zagiel()"> Musimy także umieścić wywołanie walidacji przy kliknięciu Potwierdź zamówienie. Powyższy fragment zostanie użyty dla kanału ORDER. Dla kanału BASE treść znacznika <form > różni się. Przykład graficzny znajduje się pod punktem 5.3.2. Uwagi: 3) Formularz, który będzie wysyłany do Państwa systemu sklepu. Klient przed złożeniem zamówienia musi zaznaczyć pole checkbox o treści Zapoznałem się z procedurą udzielenia kredytu ratalnego ekredyt Żagiel., aby zamówienie mogło wpłynąć do naszego systemu.
5.5 Tworzenie formularza w kanale BASE 17 5.5.1 Formatowanie danych Funkcja "clean_..." ma zadanie odpowiednio sformatować treść w formularzu, który zostanie przesłany do systemu Żagla. Wymagania te są ujęte w punkcie 2 tego dokumentu. <?php function clean_cena($data) { $data = preg_replace('/,/', '.', $data); // Ewentualna zamiana przecinka na kropkę w cenie. return $data; function clean_produkt($data) { $data = preg_replace ('/"/', '', $data); // Usuwanie apostrofów z nazwy produktu. return $data;?> Przykład użycia w/w funkcji znajduje się poniżej. 5.5.2 Dynamiczne tworzenie formularza ekredyt Żagiel Formularz ten będzie przesyłany do systemu Żagla. Jest on niewidoczny 4) dla klienta. <div style="display: none;"> <form name="frzagiel" action="http://www.zagiel.com.pl/kalkulator/index_smart.php" method="post" target="_blank" onsubmit="if (this.raty_zgoda.checked == false) { alert('zanim złożysz zamówienie, zapoznaj się z procedurą udzielenia kredytu ratalnego Raty Żagiel.'); return false else { window.open('http://www.adres_strony_sklepu.pl/ potwierdzenie_zlozenia_zamowienia.php', '_self');"> <?php // pierwsza pętla zbiera wszystkie produkty z koszyka. Zmienna $produkty jest tablicą zawierającą następujące informacje o produkcie: nazwa, ilość, cena, id w systemie sklepu for ($i=0, $id=1, $n=sizeof($produkty); $i<$n; $i++) { $z = $produkty[$i]['ilosc']; // np. 5 szt. Telewizora XXX // druga pętla rozbija produkt na pojedyncze sztuki np. 5x1szt. Telewizora XXX for ($x=1, $id2=$id; $x <= $z; $id2++, $x++) { echo ' <input name="goodsid'. $id2. '" readonly="readonly" type="hidden" value="'. $produkty[$i]['id']. '" /> <input name="goodsname'. $id2. '" readonly="readonly" type="hidden" value="'. clean_produkt($produkty[$i]['nazwa']). '" /> <input name="goodsvalue'. $id2. '" readonly="readonly" type="hidden" value="'. clean_cena($produkty[$i]['cena']). '" /> '; $id++; (ciąg dalszy na następnej stronie)
//koniec drugiej pętli 18 //koniec pierwszej pętli echo ' <input name="goodsid'. $id2. '" readonly="readonly" type="hidden" value="kosztprzesylki" /> <input name="goodsname'. $id2. '" readonly="readonly" type="hidden" value="koszt Przesyłki" /> <input name="goodsvalue'. $id2. '" readonly="readonly" type="hidden" value="'. $cena_wysylki. '" /> <input type="hidden" name="action" value="getklientdet_si" /> <input type="hidden" name="shopno" value="'. $twoj_numer_sklepu_zagiel. '" /> <input type="hidden" name="shopname" value="'. $nazwa_sklepu_bez_apostrofow. '" /> <input type="hidden" name="shophttp" value="'. $www_sklepu. '" /> <input type="hidden" name="goodsno" value="'. $id2. '" /> <!-- liczba towarów w koszyku pobierana jest z ostatniej wartości zmiennej $id2 --> <input type="hidden" name="shopmailadress" value="'. $email_sklepu. '" /> <input type="hidden" name="shopphone" value="'. $telefon_sklepu. '" /> </form> </div> ';?> W otwierającym formularz znaczniku <form... onsubmit="..."> można zauważyć specyficzny sposób działania przekierowania użytkownika na stronie. Działa to w ten sposób, iż po złożeniu zamówienia klient zostaje przeniesiony na nowo otwartą stronę systemu ekredyt Żagiel, do której zostaną przekazane wszystkie dane z formularza. Natomiast w starej stronie (sklepu), na której klient składał zamówienie, zostanie wyświetlona domyślna strona sklepu informująca klienta o prawidłowym złożeniu zamówienia. Oczywiście można zastąpić powyższy schemat działania na wzór kanału ORDER, lecz tutaj zwróciliśmy uwagę na silniki sklepów, które nie posiadają jednej strony przejściowej, z treścią dla klienta oraz obsługą wpisu nowego zamówienia do bazy danych (np. oscommerce). Uwagi: 4) Formularz ten jest niewidoczny dla klienta, ponieważ ma za zadanie tylko przesłanie informacji (ujętych w punkcie 5.5.3) do systemu ekredyt Żagiel. Wartością id produktu w formularzu może być id towaru wyciągane z bazy danych sklepu, które nadawane jest funkcją AUTO_INCREMENT w bazie danych. Funkcję clean_produkt lub clean_cena można także wykorzystać do formatowania innych ciągów znaków, które będą wstawiane w pola formularza. W funkcji PHP w miejsce $twoj_numer_sklepu_zagiel należy wpisać swój numer sklepu nadany przez Żagiel S.A. dla sklepu internetowego (nie stacjonarnego). W czasie procesu integracji i testów należy używać numeru testowego: 28011111.
5.5.3 Wygląd utworzonego formularza Zakładamy, że klienta zamawia: 2 x Komputer nurkowy 1 x Płetwy na pasek pierwsza pętla zbiera wszystkie produkty z koszyka, natomiast druga pętla rozbija wszystkie towary (w ilości większej niż jeden) na pojedyncze sztuki. W takim wypadku ostateczny wygląd przesyłanego formularza do ekredyt będzie miał postać: 19 <form name="frzagiel" action="http://www.zagiel.com.pl/kalkulator/index_smart.php" method="post"> <input type="hidden" name="goodsid1" readonly="readonly" value="242" /> <input type="hidden" name="goodsname1" readonly="readonly" value="komputer nurkowy" /> <input type="hidden" name="goodsvalue1" readonly="readonly" value="1122.00" /> <input type="hidden" name="goodsid2" readonly="readonly" value="242" /> <input type="hidden" name="goodsname2" readonly="readonly" value="komputer nurkowy" /> <input type="hidden" name="goodsvalue2" readonly="readonly" value="1122.00" /> <input type="hidden" name="goodsid3" readonly="readonly" value="332" /> <input type="hidden" name="goodsname3" readonly="readonly" value="płetwy na pasek" /> <input type="hidden" name="goodsvalue3" readonly="readonly" value="220.99" /> <input type="hidden" name="goodsid4" readonly="readonly" value="kosztprzesylki" /> <input type="hidden" name="goodsname4" readonly="readonly" value="koszt Przesyłki" /> <input type="hidden" name="goodsvalue4" readonly="readonly" value="0.00" /> <input type="hidden" name="action" value="getklientdet_si" /> <input type="hidden" name="shopno" value="28011111" /> <input type="hidden" name="shopname" value="test Sklep" /> <input type="hidden" name="shophttp" value="http://www.test.sklep.pl/" /> <input type="hidden" name="goodsno" value="4" /> <input type="hidden" name="shopmailadress" value="test@sklep.pl" /> <input type="hidden" name="shopphone" value="+48 (81) 469 05 75" /> </form>
5.6 Tworzenie formularza w kanale ORDER 20 5.6.1 Formatowanie danych Funkcja "clean_..." ma za zadanie odpowiednio formatować treść, która będzie zamieszczona w formularzu, który następnie zostanie przesłany do systemu Żagla. Wymagania te są ujęte w punkcie 2 tego dokumentu. <?php function clean_cena($data) { $data = preg_replace('/,/', '.', $data); // Ewentualna zamiana przecinka na kropkę w cenie. return $data; function clean_produkt($data) { $data = preg_replace ('/"/', '', $data); // Usuwanie apostrofów z nazwy produktu. return $data;?> Przykład użycia w/w funkcji znajduje się poniżej. 5.6.2 Dynamiczne tworzenie formularza ekredyt Żagiel Formularz ten będzie przesyłany do systemu Żagla. Jest on niewidoczny 4) dla klienta. Jego budowa jest ujęta i w pełni wyjaśniona w specyfikacji Żagla dotyczącej integracji sklepu. <div style="display: none;"> <form name="frzagiel" action="http://www.zagiel.com.pl/kalkulator/index_smart.php" method="post"> <?php // pierwsza pętla zbiera wszystkie produkty z koszyka. Zmienna $produkty jest tablicą zawierającą niżej podane informacje o produkcie. for ($i=0, $id=1, $n=sizeof($produkty); $i<$n; $i++) { $z = $produkty[$i]['ilosc']; // np. 5 szt. Telewizora XXX // druga pętla rozbija produkt na pojedyncze sztuki np. 5x1szt. Telewizora XXX for ($x=1, $id2=$id; $x <= $z; $id2++, $x++) { echo ' <input name="goodsid'. $id2. '" readonly="readonly" type="hidden" value="'. $produkty[$i]['id']. '" /> <input name="goodsname'. $id2. '" readonly="readonly" type="hidden" value="'. clean_produkt($produkty[$i]['nazwa']). '" /> <input name="goodsvalue'. $id2. '" readonly="readonly" type="hidden" value="'. clean_cena($produkty[$i]['cena']). '" /> '; $id++; //koniec drugiej pętli //koniec pierwszej pętli (ciąg dalszy na następnej stronie)
echo ' 21 <input name="goodsid'. $id2. '" readonly="readonly" type="hidden" value="kosztprzesylki" /> <input name="goodsname'. $id2. '" readonly="readonly" type="hidden" value="koszt Przesyłki" /> <input name="goodsvalue'. $id2. '" readonly="readonly" type="hidden" value="'. clean_cena($cena_wysylki). '" /> <input name="idzamowieniesklep" type="hidden" value="'. $numer_zamowienia. '" /> <input name="imiesklep" type="hidden" value="'. $imie_klienta. '" /> <input name="nazwiskosklep" type="hidden" value="'. $nazwisko_klienta. '" /> <input name="emailsklep" type="hidden" value="'. $email_klienta. '" /> <input name="telkontaktsklep" type="hidden" value="'. $telefon_klienta. '" /> <input name="ulicasklep" type="hidden" value="'. $ulica_klienta. '" /> <input name="miejscowoscsklep" type="hidden" value="'. $miasto_klienta. '" /> <input name="kodpocztowysklep" type="hidden" value="'. $kod_pocztowy_klienta. '" /> <input name="wniosekzapisany" type="hidden" value="'. $www_potwierdzenie. '" /> <input name="wniosekanulowany" type="hidden" value="'. $www_anulowanie. '" /> <input type="hidden" name="action" value="getklientdet_si" /> <input type="hidden" name="shopno" value="'. $twoj_numer_sklepu_zagiel. '" /> <input type="hidden" name="shopname" value="'. $nazwa_sklepu_dowolna. '" /> <input type="hidden" name="shophttp" value="'. $www_sklepu. '" /> <input type="hidden" name="goodsno" value="'. $id2. '" /> <!-- liczba towarów w koszyku pobierana jest z ostatniej wartości zmiennej $id2 --> <input type="hidden" name="shopmailadress" value="'. $email_sklepu. '" /> <input type="hidden" name="shopphone" value="'. $telefon_sklepu. '" /> </form> </div> ';?> Uwagi: 4) Formularz ten jest niewidoczny dla klienta, ponieważ ma za zadanie tylko przesłanie informacji (ujętych w punkcie 5.6.3) do systemu ekredyt Żagiel. Wartością id produktu w formularzu może być id towaru wyciągane z bazy danych sklepu, które nadawane jest funkcją AUTO_INCREMENT w bazie danych. Funkcję clean_produkt lub clean_cena można także wykorzystać do formatowania innych ciągów znaków, które będą wstawiane w pola formularza. W funkcji PHP w miejsce $twoj_numer_sklepu_zagiel należy wpisać swój numer sklepu nadany przez Żagiel S.A. dla sklepu internetowego (nie stacjonarnego). W czasie procesu integracji i testów należy używać numeru testowego: 28011111.
5.6.3 Wygląd utworzonego formularza Zakładamy, że klienta zamawia: 2 x Komputer nurkowy 1 x Płetwy na pasek pierwsza pętla zbiera wszystkie produkty z koszyka, natomiast druga pętla rozbija wszystkie towary (w ilości większej niż jeden) na pojedyncze sztuki. W takim wypadku ostateczny wygląd przesyłanego formularza do ekredyt będzie miał postać: 22 <form name="frzagiel" action="http://www.zagiel.com.pl/kalkulator/index_smart.php" method="post"> <input type="hidden" name="goodsid1" readonly="readonly" value="242" /> <input type="hidden" name="goodsname1" readonly="readonly" value="komputer nurkowy" /> <input type="hidden" name="goodsvalue1" readonly="readonly" value="1122.00" /> <input type="hidden" name="goodsid2" readonly="readonly" value="242" /> <input type="hidden" name="goodsname2" readonly="readonly" value="komputer nurkowy" /> <input type="hidden" name="goodsvalue2" readonly="readonly" value="1122.00" /> <input type="hidden" name="goodsid3" readonly="readonly" value="332" /> <input type="hidden" name="goodsname3" readonly="readonly" value="płetwy na pasek" /> <input type="hidden" name="goodsvalue3" readonly="readonly" value="220.99" /> <input type="hidden" name="goodsid4" readonly="readonly" value="kosztprzesylki" /> <input type="hidden" name="goodsname4" readonly="readonly" value="koszt Przesyłki" /> <input type="hidden" name="goodsvalue4" readonly="readonly" value="0.00" /> <input type="hidden" name="action" value="getklientdet_si" /> <input type="hidden" name="idzamowieniesklep" value="5900" /> <input type="hidden" name="imiesklep" value="jan" /> <input type="hidden" name="nazwiskosklep" value="kowalski" /> <input type="hidden" name="emailsklep" value="test@klient.pl" /> <input type="hidden" name="telkontaktsklep" value="0814690575" /> <input type="hidden" name="ulicasklep" value="zana" /> <input type="hidden" name="nrdomusklep" value="39a" /> <input type="hidden" name="nrmieszkaniasklep" value="22" /> <input type="hidden" name="miejscowoscsklep" value="lublin" /> <input type="hidden" name="kodpocztowysklep" value="20-725" /> <input type="hidden" name="wniosekzapisany" value="http://www.test.sklep.pl/wniosek_zapisany.php?id_zamowienia=" /> <input type="hidden" name="wniosekanulowany" value="http://www.test.sklep.pl/wniosek_anulowany.php?id_zamowienia=" /> <input type="hidden" name="shopno" value="28011111" /> <input type="hidden" name="shopname" value="test Sklep" /> <input type="hidden" name="shophttp" value="http://www.test.sklep.pl/" /> <input type="hidden" name="goodsno" value="4" /> <input type="hidden" name="shopmailadress" value="test@sklep.pl" /> <input type="hidden" name="shopphone" value="+48 (81) 469 05 75" /> </form>
6. Materiały promocyjne W poniższym linku znajdą Państwo materiały promujące sprzedaż ratalną w systemie Żagiel przez Internet. Stworzyliśmy mały przewodnik graficzny oraz bannery dla odpowiednich kanałów sprzedaży. www.zagiel.com.pl/kalkulator/bannery.htm 23 7. Pomoc techniczna W razie jakichkolwiek pytań lub problemów dotyczących integracji z naszym systemem ratalnym służymy pomocą. Poniedziałek Piątek 8 00 16 00 Arkadiusz Krakiewicz 081 469 05 75 akrakiewicz@zagiel.com.pl Dariusz Wójtowicz 081 469 05 53 dwojtowicz@zagiel.com.pl Sławomir Kozik 081 469 05 72 skozik@zagiel.com.pl