Informacja dla informatyków/administratorów systemów oraz zasady SzybkoImport

            Importu ogłoszeń do portalu Szybko.pl mogą dokonywać tylko biura pośredniczące w obrocie nieruchomościami, które mają założone konto portalu www.szybko.pl, zaakceptują regulamin oraz ofertę usługi SzybkoImport, a następnie wypełnią i prześlą zamówienie bądź włączą usługę z poziomu SzybkoPlus, w dziale Zarządzanie w sekcji Usługa SzybkoImport. Po aktywacji i zaakceptowaniu warunków współpracy zostanie utworzone i udostępnione konto FTP. Na jedno konto FTP mogą być przesyłane tylko jednego biura ogłoszenia (przypisanego do konta Szybko.pl). Odczyt ogłoszeń odbywa się co godzinę, w dniach roboczych, w godzinach 7-19.

            Na udostępnione konto FTP powinny być przesyłane pliki zip spełniające specyfikacje:

1.      Opisany poniżej plik SIF – format własny Szybko.pl.

2.      Domiporta po weryfikacji i akceptacji.

3.      Gratka, plik opublikowany pod adresem: (http://misc.gratka.pl/specyfikacja_parsery/pl/specyfikacja-parsery.htm) po weryfikacji i akceptacji.

            Ogłoszenia są odczytywane a następnie weryfikowane/sprawdzane (walidacja) pod kątem spełniania ogólnej struktury importu, jak również pod kątem posiadania minimalnej akceptowalnej zawartości,  a mianowicie:

1.      Unikalnego ID dla każdej oferty.

2.      Lokalizacji (weryfikacja na poziomie Google Maps API oraz słowników Szybko.pl zawierających informacje o miejscowości i adresach pozyskanych z różnych źródeł)

3.      Minimalnej informacji o ogłoszeniu (np. cena, liczba pokoi, metraż. Dokładne specyfikacje są przedstawione w dokumentacji szczegółowej, dotyczącej pliku SIF)

4.      Właściwych cen

5.      Załączania odpowiednich zdjęć

            W przypadku odrzucenia ogłoszenia odpowiednia informacja (LOG), będzie dostępna w panelu sterowania funkcji SzybkoImport. Panel ten znajduje się na stronie www.szybko.pl w SzybkoPlus: Zarządzanie sekcja Szybkoimport (dla każdego importu i ogłoszenia)

            W przypadku błędnego (wg. użytkownika) odrzucenia konkretnego ogłoszenia, należy przesłać mail na adres info@szybko.pl z opisem usterki.

            Szybko.pl zastrzega sobie możliwość odrzucenia w procesie walidacji (weryfikacji/sprawdzania) ogłoszenia bez podania przyczyn z odnośnikiem/opisem (np. NIEAKCEPTOWALNE). Głównymi powodami mogą być :

-        powielenie treści, zdjęć bądź materiałów wideo innych ogłoszeń

-        poziom cen odbiegający w znacznym stopniu od cen rynkowych

-        treść służąca tylko przyciągnięciu uwagi do ogłoszenia/ogłoszeniodawcy

-        niepożądane w inny sposób z punktu widzenia administratorów szybko.pl

-        próba publikacji tej samej oferty jako nowej oferty

-        nagminnie wysyłanie ogłoszenia przy użyciu tzw. eksportu całościowego

-        ogłoszeniodawca narusza elementarne zasady i dobre obyczaje obowiązujące w obrocie nieruchomościami.

               Import w formacie SIF

            Import ogłoszeń na serwer FTP. Nazwa pliku ZIP: Dowolna unikalna dla użytkownika nie zawierająca zastrzeżonych znaków o rozszerzeniu zip. Zalecana: UUUU_RRRRMMDD_GGMMSS.zip

gdzie:

UUUU – numer użytkownika  (Szybko_user_id) nadany w systemie Szybko.pl

RRRRMMDD_GGMMSS – timestamp pliku zip

            Plik ZIP umieszczany na serwerze ftp powinien zawierać w sobie pliki SIF (ODDZIELNE DLA KAŻDEGO OGŁOSZENIA) w formacie i o nazwie opisane poniżej oraz odpowiednio nazwane pliki zdjęć w formacie jpg o maksymalnym rozmiarze 1024x768 pikseli oraz maksymalnej wielkości 1000 kB (większe pliki zostaną przeskalowane)

            W pliku ZIP pliki muszą się znajdować w głównym folderze/katalogu

            Pliki umieszczone w folderach/podkatalogach w pliku zip będą ignorowane jak również pliki jpg które nie zostaną wyszczególnione w plikach SIF

            Dla każdego ogłoszenia przesyłanego powinien być utworzony oddzielny plik SIF o nazwie

UUUU_OOOO_XXXX.SIF gdzie

UUUU – numer użytkownika  (Szybko_user_id) nadany w systemie Szybko.pl

OOOO – numer (nazwa) ogłoszenia w systemie użytkownika z zastrzeżenie że w OOOO nie wystąpią znaki zastrzeżone (opisane dalej)

_XXXX – opcjonalny wyróżnik najlepiej taki aby nowsze ogłoszenie w sortowaniu alfanumerycznym był następne. W przypadku braku opcji odpowiedni timestamp plika ZIP umożliwi odpowiednie przetwarzanie.

Takie podejście (zamiast wielu ogłoszeń w jednym pliku SIF) zabezpiecza od błędów formalnych pojedynczych ogłoszeń nie odrzucając paczki z wieloma ogłoszeniami jako całości.

            Pliki zdjęć powinny mieć dowolną unikalną nazwę w zakresie ogłoszeń użytkownika, nie zawierającą żadnych ze znaków zastrzeżonych.

            Plik SIF jest plikiem spełniającym standard XML o strukturze opisanej w dalszej części opracowania

            W plikach SIF pewne informacje słownikowe (taxonomy) należy umieszczać w postaci identyfikatora (ID) informacji ze słownika opublikowanego przez szybko.pl lub też w postaci tekstowej ze słownika. Użycie innych niż w słowniku zwrotów jest możliwe jednak dopiero po odpowiednim dopasowaniu (przez zarządzających systemem).

            Sposób przekazywania danych słownikowych powinien być określony w tagu:

<sif:taxonomy_coding><sif:taxonomy_coding/>  o wartościach  CODED/NONE

Dostęp do słownika zajduję się pod adresem http://szybkoplus.pl/sif/taxonomy

            Według założeń słownik może być rozbudowywany, jednak NIGDY żaden z dotychczasowych ID nie zmieni znaczenia. Dlatego istotne jest śledzenie nowych wpisów (od ostatniego ID) w słowniku, bez konieczności weryfikacji starych oznaczeń. W razie konieczności zmiany(rozbudowy) starych oznaczeń ID, każdy z użytkowników systemu importu do www.szybko.pl,  zostanie możliwie wcześnie poinformowany, aby można było zmienić sposób działania systemów informatycznych.

Pobierz specyfikację SzybkoImport