Integracje

Obsługa formatu Oferty.net XML w SWO

SWO czyta publiczny format Oferty.net / Domy.pl XML. Co przenosimy, jak traktujemy usunięcia i zdjęcia, dlaczego brak oferty w pełnym pliku jej nie wycofuje.

Oferty.net / Domy.pl XML to jeden z niewielu formatów wymiany ofert nieruchomości, które mają publiczną specyfikację. SWO czyta go od października 2026 roku. Poniżej opisujemy, co to oznacza dla biura.

Dlaczego ten format

Według publicznych informacji dostawców i opisów branżowych eksport w tym formacie oferuje wiele systemów CRM. Zamiast pisać osobny import dla każdego systemu, SWO ma jeden import formatu i zapisuje, od którego dostawcy przyszła paczka. Jeśli Twój CRM potrafi wysłać oferty w formacie Oferty.net, warto zapytać dostawcę, jak skonfigurować eksport do SWO.

Co przenosimy

Z pliku importujemy to, co definiuje specyfikacja (wersja 0.4.5):

  • rodzaj nieruchomości i transakcji, cenę lub czynsz w PLN, EUR albo USD,
  • powierzchnię, powierzchnię działki domu, liczbę pokoi, piętro, liczbę pięter i rok budowy,
  • tytuł i opis,
  • lokalizację — a ulicę i współrzędne tylko wtedy, gdy eksport zezwala na ich publikację,
  • udogodnienia opisane w specyfikacji, rynek pierwotny i informację o możliwości negocjacji ceny,
  • zdjęcia JPEG i PNG w kolejności z paczki oraz dane agenta.

Trzy zasady warte zapamiętania

Ofertę usuwa jawny znacznik. Plik przyrostowy może zawierać znacznik usunięcia oferty — wtedy wycofujemy ją z SWO.

Brak oferty w pełnym pliku nie wycofuje jej. Specyfikacja nie mówi, że brak oferty oznacza jej wycofanie. Gdybyśmy tak przyjęli, jeden niepełny plik mógłby zdjąć z portalu wszystkie oferty biura. Dlatego ofertę wycofujesz w CRM (znacznikiem usunięcia) albo w panelu SWO.

Zdjęcie, którego zabraknie w kolejnej paczce, zostaje. Tak opisuje to specyfikacja formatu.

Bezpieczeństwo paczek

Paczki ZIP sprawdzamy przed rozpakowaniem: odrzucamy ścieżki wychodzące poza katalog, linki symboliczne, zagnieżdżone archiwa i podejrzane proporcje kompresji. Paczkę czytamy dopiero wtedy, gdy przestaje się zmieniać, więc plik w trakcie wysyłania nie zostanie zaimportowany w połowie.

Stan

Import jest gotowy do testu z biurem: zbudowany według publicznej specyfikacji i przetestowany na danych testowych. Prawdziwy eksport z danego systemu CRM sprawdzimy przy pierwszym uruchomieniu. Szczegóły: Oferty.net XML.