Publikowanie ogłoszeń w No Fluff Jobs

Wybierz adres feedu No Fluff Jobs

Kit udostępnia feed XML będący pełną migawką ogłoszeń, którą No Fluff Jobs może pobierać dla twojego konta. Wybierz adres zgodny ze sposobem hostowania portalu kariery:

https://startupkit.app/careers/your-company/jobs/nofluffjobs
https://careers.your-company.com/jobs/nofluffjobs

Pierwszy adres dotyczy portalu kariery hostowanego przez Kit. Drugi jest przeznaczony dla konta z własną domeną kariery. Otwórz Rekrutacja > Ustawienia > Portal kariery, żeby zbudować, skopiować i sprawdzić dokładny adres dla swojego konta.

Zawęź feed

Na ekranie ustawień możesz dodać filtry do adresu URL. Konfiguracja jest zapisana bezpośrednio w adresie, więc możesz przekazać NFJ zawężony feed bez zmieniania ani powielania ogłoszeń w Kit.

Filtr	Przykład	Działanie
Kraj	country=PL	Uwzględnia ogłoszenia, w których krajem zapisanym w danych jest Polska. Dla pracy zdalnej Kit używa wymaganego kraju pobytu kandydata.
Tryb pracy	work_mode=REMOTE	Uwzględnia tylko pracę zdalną. ONSITE uwzględnia tylko pracę stacjonarną.
Wykluczony dział	exclude_department[]=Marketing	Pomija dział o dokładnie takiej nazwie, bez szukania słów kluczowych w tytule. Powtórz parametr, żeby wykluczyć kilka działów.

Filtry można łączyć. Na przykład feed ograniczony do Polski i bez działu Marketing może mieć taki adres:

https://startupkit.app/careers/your-company/jobs/nofluffjobs?country=PL&exclude_department%5B%5D=Marketing

Adres bez filtrów obejmuje wszystkie opublikowane ogłoszenia, które spełniają wymagania NFJ dotyczące pól. Filtry nie sprawią, że niekompletne ogłoszenie zacznie spełniać wymagania. Jedynie zawężają migawkę ogłoszeń, które już je spełniają.

Sprawdź, czy ogłoszenie spełnia wymagania

Ogłoszenie pojawi się w feedzie, jeśli jest opublikowane, można na nie aplikować, ma włączoną publikację na zewnętrznych portalach z ofertami, przechodzi przez wybrane filtry w adresie URL i zawiera:

• opis z konkretną treścią;
• dodatnie minimalne i maksymalne wynagrodzenie;
• obsługiwaną walutę oraz okres rozliczenia za godzinę, dzień, miesiąc lub rok;
• obsługiwaną formę współpracy;
• miasto i kraj zapisane w osobnych polach, jeśli praca nie jest zdalna.

Kit mapuje ogłoszenia z umową o pracę na pełny lub niepełny etat na typ wynagrodzenia permanent w NFJ, staże na intern, a ogłoszenia B2B i te z ogólną formą Contract (w polskim interfejsie Umowa zlecenie) na typ wynagrodzenia B2B. Różni je forma zatrudnienia: w ogłoszeniu B2B Kit jej nie ujawnia, a w ogłoszeniu z formą Contract wysyła permanent.

Kit wysyła jedną lokalizację i jeden przedział wynagrodzenia, ponieważ tylko te uporządkowane wartości znajdują się obecnie w ogłoszeniu. Nie próbuje odczytywać z opisu liczby dni pracy hybrydowej, dodatkowych lokalizacji, osobnych przedziałów dla kolejnych form współpracy, poziomu doświadczenia, poziomów znajomości języków, czasu trwania umowy ani danych kontaktowych osoby rekrutującej.

Jak działa migawka

Głównym elementem XML jest zawsze <offers>. Każde ogłoszenie spełniające wymagania jest jednym elementem <offer> ze stałym identyfikatorem, tytułem, widocznym wynagrodzeniem, adresami URL widoku dla kandydata i formularza aplikacyjnego, trybem pracy, formą współpracy, oczyszczonym opisem, kategorią oraz lokalizacją wymaganą dla pracy stacjonarnej.

Edycja ogłoszenia aktualizuje ten sam wpis zamiast tworzyć duplikat. Wstrzymanie, zamknięcie, wycofanie publikacji, wyłączenie publikacji na zewnętrznych portalach z ofertami lub usunięcie ogłoszenia usuwa je z kolejnej migawki. NFJ zwykle traktuje brak ogłoszenia jako dyspozycję zakończenia publikacji, ale tę zasadę można zmienić podczas wdrożenia klienta. Przed uruchomieniem produkcyjnym potwierdź sposób usuwania ogłoszeń z opiekunem po stronie NFJ.

Adresy dla kandydatów zawierają utm_source=nofluffjobs oraz utm_medium=job_feed, dzięki czemu aplikacje wracające do Kit zachowują informację o źródle. Feed obejmuje wyłącznie publiczne dane ogłoszeń. Nie zawiera kandydatów, aplikacji, danych uwierzytelniających ani osobnych pól contactPersonName i contactPersonEmail. Publiczny opis ogłoszenia jest eksportowany zgodnie z treścią przygotowaną w Kit, więc wpisane w nim dane kontaktowe pozostają częścią feedu.

Dokończ wdrożenie integracji z NFJ

1. Otwórz ustawienia Portal kariery i przygotuj zawężony adres URL.
2. Otwórz feed i potwierdź, że zawiera oczekiwane ogłoszenia.
3. Przekaż adres opiekunowi klienta po stronie No Fluff Jobs do walidacji w środowisku testowym.
4. Sprawdź odpowiednie przypadki, zwłaszcza pracę zdalną i stacjonarną, typy wynagrodzenia, strukturę HTML oraz usuwanie ogłoszeń z migawki.
5. Ustal, czy NFJ publikuje automatycznie, prosi o weryfikację przed publikacją czy sprawdza ogłoszenie już po publikacji.
6. Ustal, czy zniknięcie ogłoszenia z feedu powoduje wycofanie jego publikacji.
7. Przejdź na środowisko produkcyjne dopiero po potwierdzeniu przez NFJ, że feed został prawidłowo przetworzony w środowisku testowym.

NFJ opisuje kilka pór pobierania feedu w ciągu dnia. Strefę czasową, zasady działania w dni robocze i proces publikacji dla danego klienta ustala się jednak podczas wdrożenia integracji. Kit nie kontroluje tych ustaleń ani nie obejmuje ich własnym SLA. Poprawna odpowiedź Kit potwierdza tylko, jakie dane zostały zwrócone dla danego żądania.

Jeśli brakuje ogłoszenia

Ekran Rekrutacja > Ustawienia > Portal kariery wymienia wszystkie opublikowane ogłoszenia i przy każdym pokazuje, dlaczego jest w feedzie albo dlaczego się w nim nie znalazło. Sprawdź, czy:

1. Ogłoszenie jest opublikowane, a opcja Publikuj to ogłoszenie na zewnętrznych portalach z ofertami jest włączona.
2. Wybrane filtry kraju, trybu pracy i działu obejmują to ogłoszenie.
3. Minimalne i maksymalne wynagrodzenie są dodatnie, mają obsługiwany okres oraz walutę, a wartość maksymalna nie jest niższa od minimalnej.
4. Ogłoszenie o pracy stacjonarnej ma miasto i kraj zapisane w osobnych polach.
5. Po oczyszczeniu opis nadal zawiera widoczną treść.

Jeśli ogłoszenie pojawia się w XML, ale nie w No Fluff Jobs, przekaż adres feedu i identyfikator ogłoszenia opiekunowi klienta NFJ przypisanemu podczas wdrożenia integracji. Kit nie dysponuje endpointem NFJ pozwalającym sprawdzić stan usługi ani publikacji.

W skrócie

• Zbuduj adres URL filtrowany według kraju, trybu pracy lub działu, jeśli pełny feed konta jest zbyt szeroki.
• Potwierdź obecność każdego oczekiwanego ogłoszenia w XML.
• Zwaliduj feed w środowisku testowym NFJ.
• Ustal z NFJ proces weryfikacji i usuwania ogłoszeń.
• Traktuj obecność w feedzie, pobranie przez NFJ, utworzenie szkicu w NFJ i faktyczną publikację jako cztery osobne stany.