Biura nieruchomości rzadko prowadzą oferty w jednym miejscu. Większość ma system CRM, z którego wysyła ogłoszenia na portale. Dlatego import ofert jest w SWO jednym z fundamentów, a nie dodatkiem — i dlatego budujemy go ostrożnie.
Jeden import, wiele źródeł
Import w SWO nie jest napisany pod jeden system. Paczka z ofertami może trafić do nas na dwa sposoby: system CRM wysyła ją na konto FTP biura albo biuro przesyła plik w panelu, w zakładce „Dodaj plik”. Niezależnie od drogi paczka trafia do tego samego procesu: rozpoznajemy format, czytamy go zgodnie ze specyfikacją, sprawdzamy dane i dopiero wtedy aktualizujemy oferty.
Dziś SWO czyta dwa formaty:
- eksport ASARI (asari.WEB / EbiuroV2),
- format Oferty.net / Domy.pl XML — publicznie opisany format, który według dostawców eksportuje wiele systemów CRM.
Zasady, których się trzymamy
Nie zgadujemy. Pole, którego znaczenia nie potwierdza oficjalna specyfikacja, nie trafia do publicznej oferty. Zapisujemy je w archiwum importu, ale kupujący go nie zobaczy.
Powtórny import niczego nie psuje. Ta sama paczka przesłana dwa razy nie zmienia ofert. Paczki jednego biura przetwarzamy po kolei, od najstarszej, żeby starsze dane nie nadpisały nowszych.
Niczego nie usuwamy na ślepo. Wycofanie oferty to zmiana jej statusu, nie skasowanie danych. Oferta, której zabraknie w niepełnym pliku, nie znika z portalu, jeśli format tego nie przewiduje.
Pliki traktujemy jak niezaufane. XML czytamy bez zewnętrznych encji i z limitami rozmiaru, każde zdjęcie dekodujemy i zapisujemy od nowa, a przesłanych plików nigdy nie uruchamiamy.
Uczciwe statusy
Przy każdej integracji piszemy, na jakim jest etapie. Import ASARI i Oferty.net XML jest zbudowany według oficjalnych specyfikacji i przetestowany na danych testowych, ale nie przetworzyliśmy jeszcze prawdziwego eksportu biura — pierwsze uruchomienie sprawdzimy razem z biurem. Integracje Galactica Virgo i EstiCRM są w przygotowaniu. Aktualny stan opisujemy na stronie Integracje.
Ręcznie też można
Import to opcja, nie warunek. Każde biuro może dodawać oferty ręcznie w panelu — także obok importu. Więcej o tym, co dostaje biuro, przeczytasz na stronie SWO dla biur nieruchomości.