Jak biuro nieruchomości wgrywa cały katalog z CRM do Seeki
Ostatnia weryfikacja: 2026-04-14
Biuro nieruchomości może przenieść cały katalog z CRM do Seeki przez API ingest. W panelu biura generuje klucz, wysyła paczkę ofert w jednym z obsługiwanych formatów, a każda oferta zostaje przetworzona i opublikowana na rynkach europejskich, które obsługujemy, bez pisania własnego kodu. Panel pokazuje postęp każdej pozycji, raportuje przyczyny błędów i pozwala ponowić nieudane wiersze bez ładowania całej paczki od nowa.
Ten artykuł to orientacja, jakiej życzylibyśmy każdemu kierownikowi operacyjnemu biura nieruchomości, gdy pierwszy raz patrzy na Seeki. Przeprowadza przez cały import, od „mamy tysiące ofert w CRM" do „są aktywne na portalu we wszystkich obsługiwanych językach", i opisuje, czego oczekiwać na każdym etapie.
5 kroków onboardingu
- Wygeneruj klucz API. Zaloguj się do panelu biura i w sekcji klucze API utwórz klucz. Klucz jest przypisany do twojego biura.
- Przygotuj dane. Zmapuj eksport z CRM do obsługiwanego formatu feedu. Przyjmujemy Seeki-JSON (nasz kanoniczny schemat), OpenImmo (europejski standard OASIS, powszechnie używany w CRM-ach DACH) oraz Idealista XML-ML (powszechny w Hiszpanii i Portugalii).
- Wyślij paczkę. Wyślij plik na endpoint ingest. Bardzo duże katalogi są wysyłane partiami.
- Monitoruj panel importów. Każda oferta ma własny wiersz z aktualnym statusem, przyczyną błędu i przyciskiem ponów.
- Oferty są publikowane. Gdy oferta zostanie przetworzona, staje się aktywna we wszystkich obsługiwanych językach i wyszukiwalna w stronach krajowych oraz w wyszukiwarce AI.
Większość pracy mieści się w kroku 2. Kroki 3 do 5 odbywają się po stronie Seeki.
Co dzieje się z ofertą po jej otrzymaniu
Oferta nie pojawia się na portalu w momencie, gdy twój POST zwróci 200. Każda pozycja jest asynchronicznie walidowana, uzupełniana o dane pochodne, oceniana i publikowana. Większość ofert kończy się w ciągu sekund. Jeśli oferta ma możliwy do naprawienia problem (brak pola obowiązkowego, URL zdjęcia, który się nie wczytuje, adres, którego nie potrafimy umieścić na mapie), zostaje oznaczona w panelu jako nieudana z konkretną przyczyną, a reszta paczki idzie dalej.
Nie musisz wiedzieć, co dzieje się pod maską. To, co powinieneś wiedzieć, to że panel mówi dokładnie, gdzie znajduje się każda oferta, i że poprawa jednego błędnego rekordu nie wymaga wgrywania całego feedu od nowa.
Ręczne wprowadzanie, import webowy i ingest API
Trzy sposoby publikacji w Seeki, każdy dla zupełnie innej skali.
| Podejście | Nakład konfiguracji | Czas na ofertę | Dla kogo | Skaluje się do |
|---|---|---|---|---|
| Ręczne wprowadzanie | Brak, wystarczy zalogować się | 10 do 20 minut | Kilka ofert premium, biura testujące platformę | Dziesiątki |
| Import webowy (wklej / wgraj) | Niski, jednorazowe mapowanie | Sekundy na ofertę | Średniej wielkości biura bez deweloperów | Setki do kilku tysięcy |
| Ingest API | Przedpołudnie pracy integracyjnej | Poniżej sekundy na ofertę | Biura z CRM, częstymi aktualizacjami, ofertą w wielu krajach | Dziesiątki tysięcy |
Decyzja jest zwykle pragmatyczna: jeśli twój CRM już eksportuje OpenImmo albo masz dewelopera, który wyprodukuje Seeki-JSON, droga API jest najtańsza. Jeśli prowadzisz butikowe biuro z kilkudziesięcioma ofertami premium, ręczne wprowadzanie wystarczy.
Co pokazuje panel importów
W panelu pracownik operacyjny biura spędza po pierwszym imporcie najwięcej czasu. Na górze jest podsumowanie każdego importu (łącznie, udane, w toku, nieudane), a tabela poniżej pokazuje co dzieje się z każdym rekordem. Filtrujesz na nieudane, przeglądasz kolumnę z przyczyną, poprawiasz dane w CRM i klikasz ponów w dotkniętych wierszach. Nie trzeba ponownie wgrywać całego feedu z powodu kilku błędnych rekordów.
Gdy oferta publikuje się, wiersz prowadzi prosto do strony publicznej, więc możesz sprawdzić jej wygląd w docelowym języku.
Zarządzaj importami tutaj zaraz po wygenerowaniu klucza.
Subskrypcja i dostęp
Ingest API to płatna funkcja dla biur. Onboarding zawiera krok subskrypcji obsłużony przez Stripe: wybierasz pakiet, wpisujesz dane karty lub fakturowania i klucz API się aktywuje. Subskrypcja jest rozliczana miesięcznie z opcją przedpłaty rocznej. Jeśli subskrypcja wygaśnie, ingest zostaje wstrzymany. Istniejące oferty pozostają opublikowane, ale nowe importy są odrzucane do czasu uregulowania płatności. Aktualny pakiet, zużycie i ewentualne ostrzeżenia o odnowieniu pokazuje panel na ekranie przeglądowym.
Poza subskrypcją nie pobieramy opłaty za ofertę. Przepustowość zależy od pakietu. Jeśli naprawdę potrzebujesz bardzo wysokiej przepustowości równoległej, skontaktuj się z nami przed zakupem, abyśmy dobrali odpowiedni plan.
Najczęstsze pytania
Jaki format payloadu jest obsługiwany?
Trzy formaty. Seeki-JSON to nasz kanoniczny schemat, płaski i dobrze udokumentowany schemat JSON obejmujący wszystkie pola oferty i URL-e zdjęć. OpenImmo (europejski standard OASIS używany szeroko w CRM-ach DACH) jest przyjmowany jako XML lub jako paczka zip z XML-em i plikami zdjęć. Idealista XML-ML jest przyjmowany od biur hiszpańskich i portugalskich, których CRM już mówi tym dialektem. Sekcja kluczy API w panelu prowadzi do pełnej referencji schematu i interaktywnej piaskownicy.
Jak obsługiwane są duplikaty?
Oferty identyfikowane są kombinacją twojego ID biura i zewnętrznego ID oferty, czyli identyfikatora, którego już używa twój CRM. Gdy ponownie wyślesz ofertę z tym samym zewnętrznym ID, Seeki traktuje ją jako aktualizację, nie nową ofertę. Dzięki temu rutynowe odświeżanie katalogu (codzienne, godzinne lub przy każdej zmianie w CRM) działa bez własnej logiki deduplikacji.
Czy mogę aktualizować oferty masowo?
Tak. Endpoint ingest jest taki sam dla tworzenia i aktualizacji. Ponowne wysłanie oferty ze zmienionymi polami odświeża aktywny rekord. Jeśli chcesz aktualizować tylko podzbiór, wyślij tylko te oferty. Seeki nie tknie ofert, których w paczce nie ma. Aby usunąć ofertę, oznacz ją w CRM jako nieaktywną i wyślij ze statusem sprzedane lub wycofane. Zostanie zarchiwizowana z wyszukiwania.
Co z biurami spoza UE z ofertami w UE?
API nie sprawdza, gdzie ma siedzibę twoje biuro. Sprawdza, czy kraj oferty jest jednym z rynków europejskich, na których działa Seeki. Biuro z Londynu czy Nowego Jorku trzymające oferty hiszpańskie czy czeskie używa tego samego endpointu ingest. Struktura podatkowa i kontraktowa po twojej stronie pozostaje twoją odpowiedzialnością. Umowa z Seeki dotyczy usługi inseratu.
Jak szybko nowe oferty się pojawiają?
Oferta zwykle kończy się w ciągu sekund. Łączny czas od twojego POST do publicznie wyszukiwalnej oferty zależy od wielkości paczki i bieżącego obciążenia, ale małe paczki są zazwyczaj publikowane end-to-end poniżej minuty na ofertę. Tłumaczenia na inne języki generowane są przy pierwszym wyświetleniu. Oferta jest więc w pełni wyszukiwalna w języku źródłowym natychmiast i pojawia się w przetłumaczonej formie, gdy ktoś po raz pierwszy otworzy ją w innej lokalizacji.
Co jeśli oferta nie przejdzie walidacji?
Zostaje oznaczona w panelu jako nieudana z konkretną przyczyną: brakujące pole obowiązkowe, niedostępny URL zdjęcia, cena poniżej progu wiarygodności i tym podobne. Reszta paczki idzie dalej. Popraw dane w CRM, ponownie wyeksportuj i albo wyślij całą paczkę, albo ponów nieudane wiersze z panelu. Za ponawianie nie ma kary, a deduplikacja po zewnętrznym ID chroni przed przypadkowymi duplikatami.
Kolejne kroki
Jeśli twoje biuro jest gotowe, droga jest krótka: wygeneruj klucz, wyślij małą paczkę testową z eksportu CRM, obserwuj ją w panelu, a potem uruchom pełny feed. Świadomie utrzymujemy najmniejszą możliwą odległość między „mam CSV" a „oferty są aktywne w całej Europie". Operacyjną złożoność ma wchłaniać platforma, a nie odsyłać ci ją z powrotem.
Gdy będziesz gotowy, strona onboardingu przeprowadzi cię przez utworzenie klucza, płatność i pierwszy import w jednym przepływie.