Integrator działa na zasadzie wymiany plików poprzez serwer FTP. Wykorzystywane są 3 pliki:

- duża paczka - pełna informacja o produktach

- mała paczka - tylko stany i ceny produktów - do szybkiej aktualizacji

- zamówienia - plik generowany przez sklep, zawiera zamówienie klientów

Po stronie sklepu musi zostać zrobiona integracja dla trzech "akcji" wykorzystywanych przez Integrator:

Pobieranie pełnej bazy towarowej

Ta akcja jest wykonywana aby dodawać nowe produkty, oraz w pełni zaaktualizować produkty na sklepie. Wykonywane kroki:

1. Integrator przygotowuje plik XML i wrzuca go do wskazanego katalogu FTP
2. Integrator wywołuje wskazaną stronę internetową na sklepie -np. [adres sklepu]/xml_in.php?lic=[klucz], gdzie klucz jest generowany w taki sposób:MD5( MD5(KLUCZ_SKLEPU)+ rok + dzień) * . Zmienna KLUCZ_SKLEPU jest zdefiniowana w konfiguracji sklepu oraz w ustawienia integratora - jest to indywidualny ciąg znaków znany tylko dla sklepu i klienta
3. Wywołanie w poprzednim kroku strony, informuje sklep że pojawiła się paczka z danymi na FTP i powinien ją obsłużyć

Pobieranie małej bazy towarowej (tylko stany i ceny)

Ta akcja jest wykonywana aby zaktualizować produkty na sklepie. Wykonywane kroki:

1. Integrator przygotowuje plik XML i wrzuca go do wskazanego katalogu FTP
2. Integrator wywołuje wskazaną stronę internetową na sklepie -np. [adres sklepu]/xml_in.php?lic=[klucz], gdzie klucz jest generowany w taki sposób:MD5( MD5(KLUCZ_SKLEPU) + rok + dzień) * . Zmienna KLUCZ_SKLEPU jest zdefiniowana w konfiguracji sklepu oraz w ustawienia integratora - jest to indywidualny ciąg znaków znany tylko dla sklepu i klienta
3. Wywołanie w poprzednim kroku strony, informuje sklep że pojawiła się paczka z danymi na FTP i powinien ją obsłużyć

Pobieranie zamówień ze sklepu

Ta akcja jest wykonywana w celu pobrania zamówień ze sklepu i zapisaniu ich w systemie sprzedaży.

1. Integrator uruchamia stronę internetową, np. [adres sklepu]/generuj_zamowienia.php?lic=[klucz_licencji], gdzie klucz jest generowany w taki sposób:MD5( MD5(KLUCZ_SKLEPU) + rok + dzień) * . Zmienna KLUCZ_SKLEPU jest zdefiniowana w konfiguracji sklepu oraz w ustawienia integratora - jest to indywidualny ciąg znaków znany tylko dla sklepu i klienta
2. Wywołanie strony, powoduje że sklep generuje plik XML z nowymi zamówieniami.
3. Po 10 sekundach od wywołania strony, integrator sprawdza czy powstał plik na FTP z zamówieniami - jeśli nie, przerywa pracę
4. Integrator pobiera plik XML i zapisuje po kolei zamówienia w systemie sprzedaży. Po każdym zamówieniu wysyłana jest informacja na sklep:

• w przypadku błędu -  [adres sklepu]/order_error.php?klucz=[klucz]&ID=[id zamówienia] &desc=[opis błędu]
• - w przypadku sukcesu-  [adres sklepu]/ order_confirm.php?klucz=[klucz]&ID=[id zamówienia]  - w tym przypadku sklep powinien zaznaczyć sobie że zamówienie jest pobrane i wpisane do systemu księgoweg

Oba powyższe klucze są generowane w taki sposób: MD5( md5(KLUCZ_SKLEPU) + ID ZAMÓWIENIA + rok + dzień) *

UWAGA!

Do liczenie MD5 należy brać rok w formacie 4cyfrowym (yyyy),dzień w formacie 2cyfrowym (dd). Wszystkie znaki powinny być podwyższone do DUŻYCH ZNAKÓW. Samo MD5 również należy zmienić na DUŻE ZNAKI.