Instrukcja integracji z hurtownią QOLTEC NTEC

(1)

Instrukcja integracji z hurtownią QOLTEC | NTEC

ver. 18052021

(2)

Spis treści

1. Wstęp ... 3

2. Integracja z hurtownią poprzez Sky-Shop ... 4

3. Integracja z hurtownią poprzez Baselinker... 9

4. Integracja bezpośrednia poprzez plik XML ... 10

5. Wsparcie ... 14

(3)

1. Wstęp

Gratulujemy Państwu wyboru jakim jest integracja z naszą hurtownią. Dzięki integracji będą Państwo mogli zoptymalizować koszty oraz zaoszczędzić czas związanych z tworzeniem i udostępnianiem naszych produktów w Państwa systemie. Mamy nadzieję, że ten dokument pomoże w szybkim i sprawnym wprowadzeniu tego rozwiązania.

Informujemy również, że niniejsza instrukcja jest dokumentem o przeznaczeniu wewnętrznym i jej rozpowszechnianie bądź udostępnianie w całości albo w części podmiotom trzecim jest zabronione.

(4)

2. Integracja z hurtownią poprzez Sky-Shop

Posiadając sklep internetowy na oprogramowaniu Sky-Shop możesz skorzystać z modułu integracji który oferuje między innymi funkcje:

- automatyczne pobieranie i wstawienie do sklepu z wybranych hurtowni wszystkich danych produktów: zdjęć, opisów, cen, parametrów, ilości itp.,

- powiązywanie kategorii produktów z hurtowni i sklepu,

- osobne marże na kategorie i na producentów oraz marża główna, - priorytety marż,

- reguły marż (w zależności od cen produktów), - wybór form dostaw + reguły dostaw,

- automatyczne aktualizacje stanów magazynowych i dostępności, - aktualizacje tylko wybranych kategorii produktów,

- ustawienie częstotliwości aktualizacji,

- możliwość ustawienia osobnych parametrów integracji dla każdej hurtowni.

Wszystkie ustawienia można dostosować do każdej hurtowni osobno.

Poniżej zamieszczamy instrukcję integracji poprzez SKY-SHOP

(5)

1. Jeżeli nie posiadasz jeszcze sklepu w SKY-SHOP załóż sklep darmowej wersji 14-dniowej za pomocą (później zdecydujesz czy ta forma Ci odpowiada):

https://konto.sky-shop.pl/zaloz_sklep/?shop_ref=059501d6b3739

2. Wykonaj integrację z hurtownią NTEC.PL: przejść do menu:

Hurtownie -> Lista zintegrowanych hurtowni.

3. Na liście dostępnych hurtowni odszukaj NTEC.pl i kliknij ikonę edycji.

4. W nowym oknie zakładki Konfiguracja, pole Klucz wklej otrzymany od opiekuna naszej firmy personalny klucz do integracji. Jeżeli jeszcze go nie posiadasz skontaktuj się z nami poprzez email: b2b@QOLTEC.COM

(6)

5. Niezbędnym elementem pierwszej konfiguracji hurtowni jest oznaczenie opcji

„Pobieraj tylko z powiązanych kategorii” na „Nie” – inaczej podczas próby pobrania asortymentu pojawi się komunikat błędu.

6. Ustal jak często mają odbywać się automatyczne aktualizacje oraz przypisać domyślny VAT dla pobieranych produktów.

(7)

7. Ustaw parametry podstawowe konfiguracji połączenia z hurtownią:

(8)

8. Zdefiniuj powiązania kategorii hurtowni z kategoriami w Twoim sklepie (zakładka Powiązania kategorii):

9. Od teraz możesz korzystać z integracji i mieć dostęp do bieżąco aktualizowanych danych takich jak:

• stany magazynowe,

• ceny przypisane do Twojego konta,

• kartoteki produktów zawierające zdjęcia produktów oraz opisy produktów.

(9)

3. Integracja z hurtownią poprzez Baselinker

1. Wykonaj integrację z hurtownią QOLTEC: przejść do menu:

Integracje -> Dodaj integrację Dodaj z grupy Hurtownie :

2. W oknie ustawienia integracji wstaw w pole Klucz API wklej otrzymany od opiekuna naszej firmy personalny klucz do integracji. Jeżeli jeszcze go nie posiadasz skontaktuj się z nami poprzez email: b2b@QOLTEC.COM

3. Od teraz możesz korzystać z integracji i mieć dostęp do bieżąco aktualizowanych danych takich jak:

• stany magazynowe,

• ceny przypisane do Twojego konta,

• kartoteki produktów zawierające zdjęcia produktów oraz opisy produktów.

4. Integrację w Baselinker możesz też uzyskać poprzez podłączenie integracji własnego sklepu SKY-SHOP

(10)

4. Integracja bezpośrednia poprzez plik XML

Moduł pobierania plików XML znajduje się pod adresem:

https://xml.qoltec.pl/client

Oczekuje on zmiennej POST o kluczu 'code' i wartości takiej, jak klucz danego klienta (wartość klucza każdy klient otrzymuje od nas indywidualnie).

Odpowiada wywoływanym plikiem XML.

Przykład wywołania CURL w PHP:

<?php

$ch = curl_init();

curl_setopt($ch,CURLOPT_URL,"https://xml.qoltec.pl/clint/");

curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch,CURLOPT_POSTFIELDS,"code=LM8YLGcA9LAmDBq1PKr TtOIT6SelbUoR");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$xml = curl_exec($ch);

curl_close ($ch);

//mamy xmla w zmiennej $xml;

echo $xml;

?>

(11)

Struktura wygenerowanego pliku XML Legenda:

nazwy elementów nazwy atrybutów wartości danych

Rodzic elementów kategorii głównych, zawiera elementy w postaci:

<cat id="id_kategorii">Nazwa_kategorii</cat>

</categories>

Rodzic elementów podkategorii, zawiera elementy kategorii podrzędnych w postaci:

<cat id="id_podkategorii"parent="id_kategorii_nadrzędnej">Nazwa_podk tegorii</cat>

</subcategories>

Rodzic elementów parametrów, zawiera elementy nazw i id parametrów w postaci:

<feat id="id_parametru">Nazwa_parametru</feat>

</featurestext>

Rodzic elementów parametrów, dla których typ w bazie danych oznaczony jest jako 'textarea' zawiera elementy nazw i id parametrów w postaci:

<feat id="id_parametru">Nazwa_parametru</feat>

</featurestextarea>

(12)

Produkty posiadają strukturę następującą:

<url>link do produktu</url>

<name>nazwa produktu</name>

<price>cena netto klienta</price>

<quan>ilość produktów przeliczona wg ustawień dla tego klienta</quan>

<uom>jednostka miary</uom>

<vat> stawka VAT</vat>

<shortdescription>krótki opis </shortdescription>

Rodzic elementów szczegółowych opisów, zawiera elementy w postaci:

<description name="nagłówek sekcji opisu">tresć opisu</description>

</descriptions>

Rodzic elementów danych technicznych, zawiera elementy w postaci:

<feature id="id nazwy danych - podane wyżej">wartość danych</feature>

</features>

Rodzic elementów obrazów, zawiera elementy w postaci:

<img>nazwa pliku obrazu</img>

Aby pobrać dany obraz należy odczytać katalog obrazów z atrybutu "photo" elementu

<products>. Pierwszy obraz na liście elementów jest obrazem głównym.

</images>

(13)

Element zawiera wszyskie id kategorii podrzędnych, do których należy produkt, oddzielone przecinkami.

</categories>

<table>serializowana ewentualna tabela produktu (jeżeli istnieje)</table>

Rodzic elementów dodatkowych danych produktu (jeżeli istnieją). Zawiera elementy w postaci:

<data>

<title>tytuł/nagłówek danych</title>

</data>

</shortdata>

<files>

Rodzic elementów plików do pobrania dla produktu (jeżeli istnieją). Zawiera elementy w postaci:

<file><title>Tytuł pliku</title>nazwa pliku do pobrania</file>

Aby pobrać plik należy odczytać główny katalog plików z atrybutu "files" elementu

<products>.

</files>

</product>

</products>

(14)

5. Wsparcie

W przypadku pytań lub niejasności, na które nie udało się Państwu znaleźć odpowiedzi, prosimy o dokładne opisanie problemu i kontakt z Państwa opiekunem handlowym. Postaramy się rozwiązać problem w możliwie najkrótszym czasie.

W celu uzyskania osobistego klucza do integracji skontaktuj się z nami poprzez:

email: B2B@QOLTEC.COM

Instrukcja integracji z hurtownią QOLTEC NTEC