> For the complete documentation index, see [llms.txt](https://help.bizmachine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bizmachine.com/api-a-integrace/raynet-integrace.md).

# Jak nastavit integraci Raynetu s Prospectorem

*Aktualizováno: 30. června 2026*

## Jak nastavit integraci Raynetu s Prospectorem

Raynet CRM obsahuje přímou integraci s Prospectorem - nevyžaduje žádný integrační nástroj třetí strany. Integraci můžete nastavit přímo v Raynetu.

Tento průvodce vás provede aktivací integrace, přehledem synchronizovaných dat a nastavením automatického přenosu Klientů.

Po aktivaci integrace se na kartách Klientů zobrazí Index aktivity, záložka s plným profilem firmy z Prospectoru, možnost obohatit Klienta o firemní data a štítky z Prospectoru.

***

### Co budete k aktivaci potřebovat

* **Přístup do Raynetu s rolí administrátora** - aktivaci integrace provádí pouze administrátor.
* **Prospector API klíč** - vygenerujete v Prospectoru v Nastavení » API. Jak na to: [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md)
* **Aktivovaný API endpoint Prospectoru** - endpoint aktivujeme na vyžádání; kontaktujte <support@bizmachine.com>

***

### Část 1 - Aktivace integrace

#### 1. Domluvte aktivaci API endpointu

Integrace využívá Prospector API - pro její fungování musí mít váš účet aktivovaný příslušný API endpoint. Kontaktujte nás na <support@bizmachine.com>, abychom vám ho nastavili. Současně s tímto krokem doporučujeme ze <support@bizmachine.com> nechat vytvořit v Prospectoru [integrační účet](/api-a-integrace/integracni-ucet.md), aby byla integrace oddělená od uživatelských přístupů.

#### 2. Otevřete nastavení Raynetu

V Raynetu v pravém horním rohu klikněte na své jméno a vyberte **Nastavení**.

#### 3. Přejděte na nastavení Prospectoru

V levém menu otevřete **Rozšíření** » **Informace o firmách** » **Prospector** » **Aktivovat**.

![Levé menu v Nastavení Raynetu s otevřenou cestou Rozšíření - Informace o firmách - Prospector](/files/XXndM5rai9Wwm4OeXT6H)

#### 4. Zadejte API klíč a aktivujte

Do pole zadejte váš Prospector API klíč a klikněte na **Aktivovat**.

![Nastavení Prospector v Raynetu s polem pro zadání Prospector API klíče a tlačítkem Aktivovat](/files/GEA7wJFk3E4yy2dbQuJI)

#### 5. Integrace je aktivní

Po aktivaci jsou k dispozici:

* Index aktivity na kartě Klienta
* záložka **Údaje z Prospectoru** na kartě Klienta
* panel **Prospector** s automaticky synchronizovanými poli
* akce **Aktualizovat z Prospectoru** na detailní kartě i v seznamovém pohledu Klientů
* akce **Hromadná aktualizace** všech Klientů
* synchronizované štítky z Prospectoru

***

### Co integrace umí

#### Index aktivity

V pravém panelu na kartě Klienta se zobrazuje Index aktivity firmy. Po najetí na panel se v tooltipu zobrazí kritéria, ze kterých index vychází.

![Pravý panel na kartě Klienta v Raynetu s Indexem aktivity a tooltipem zobrazujícím kritéria](/files/aqABvMOFXKU7G6oL6JUw)

#### Záložka Údaje z Prospectoru

Po kliknutí na panel Indexu aktivity se otevře samostatná záložka **Údaje z Prospectoru** se všemi dostupnými informacemi o firmě. Jedná se o náhled celého firemního Prospector profilu.

![Záložka Údaje z Prospectoru na kartě Klienta v Raynetu s plným profilem firmy z Prospectoru](/files/qV3p7QjAzvqkKr7A6VMi)

#### Panel Prospector se synchronizovanými poli

Po zapnutí integrace se na kartě **Custom fields** automaticky vytvoří volitelná pole seskupená do panelu **Prospector**. Tato pole lze využít k filtrování Klientů. Data v těchto polích není možné editovat přímo v Raynetu - aktualizují se výhradně z Prospectoru.

![Panel Prospector na kartě Klienta v Raynetu se synchronizovanými Prospector poli](/files/mZXiP6FeD5WABwGriMKe)

**Základní atributy firmy**

Tato data se synchronizují do standardních polí karty Klienta:

* Primární adresa (ulice, město, PSČ, souřadnice, země)
* Primární kontakt (e-mail, telefon, web)
* Facebook, LinkedIn, Twitter
* Název, právní forma, počet zaměstnanců, obor
* IČ, DIČ, datum založení, plátce DPH, spisová značka
* Štítky - přenesou se všechny štítky, které má firma v Prospectoru. Každý dostane prefix **BP:** pro snazší identifikaci.

**Pole panelu Prospector**

Volitelná pole v panelu **Prospector** jsou filtrovatelná:

* Datum zániku
* Institucionální sektor
* Justice (odkaz na justice.cz)
* Aktiva celkem, Aktiva měna, Aktiva rok
* Zdraví
* Počet propojených společností
* Prospector (odkaz přímo na profil firmy v Prospectoru)
* Prospector kategorie
* Vlastní popis činnosti
* Obrat, Obrat měna, Obrat rok
* Rizika
* Počet e-shopů
* Počet poboček
* Počet osobních kontaktů

#### Vyhledávání při zakládání nového Klienta

Při zakládání nového Klienta probíhá automatické vyhledání firmy v Prospectoru podle zadaného IČ - v poli IČ je to znázorněno animací. Pokud se data z Prospectoru liší od hodnot z našeptávače, zobrazí se panel s rozdíly a výběrem, která data pro uložení použít.

#### Filtr Aktualizováni z Prospectoru

V seznamovém pohledu Klientů je k dispozici chytrý filtr **Aktualizováni z Prospectoru** - zobrazí Klienty vytvořené nebo aktualizované s daty z Prospectoru (nebo naopak bez nich).

![Seznamový pohled Klientů v Raynetu s chytrým filtrem Aktualizováni z Prospectoru](/files/7kEGXMSyFgoDX4KMNHbR)

***

### Kdy se data aktualizují

> Aby mohla být firma v Raynetu aktualizována nebo spárována s Prospectorem, musí mít vyplněné minimálně **IČO** a **Země** (Česká republika, Slovensko nebo Polsko). Bez těchto údajů obohacení ani spárování proběhnout nemůže.

Synchronizovaná pole se aktualizují v těchto situacích:

* **Vytvoření Klienta** - data se stáhnou automaticky při uložení nového záznamu.
* **Akce Aktualizovat z Prospectoru** na detailní kartě Klienta - ruční aktualizace jednoho záznamu (vpravo nahoře **...** » **Aktualizovat z Prospectoru**).
* **Akce Aktualizovat z Prospectoru** v seznamovém pohledu Klientů - aktualizace vybraných záznamů (označte firmy v seznamu » **Editovat** » **Aktualizovat z Prospectoru**).
* **Hromadná aktualizace** v Nastavení rozšíření - dostupné pro všechny Klienty nebo jen pro ty, kteří dosud nebyli aktualizováni z Prospectoru.
* Přidáním již existujícího klienta do štítku **Pošli do Raynet** v Prospectoru (je třeba, aby byl nastavený automatický přenos klientů - viz [Část 2](#část-2---nastavení-automatického-přenosu-klientů)).

#### Hromadná aktualizace

Pro jednorázovou aktualizaci většího počtu Klientů přejděte na **Nastavení » Rozšíření » Informace o firmách » Prospector » Jednorázové aktualizace**. Máte na výběr:

* **Aktualizovat všechny Klienty** - aktualizuje všechny záznamy bez ohledu na to, zda již data z Prospectoru mají.
* **Aktualizovat Klienty bez dat z Prospectoru** - aktualizuje pouze záznamy, které dosud nebyly obohaceny daty z Prospectoru.

![Nastavení jednorázové hromadné aktualizace Klientů z Prospectoru v Raynetu](/files/Lg3NnBAZU9dbH1CtgFcn)

***

### Část 2 - Nastavení automatického přenosu Klientů

Automatický přenos je volitelná funkce. Umožňuje přenést firmy z Prospectoru do Raynetu jako nové Klienty na základě přiřazení štítku v Prospectoru.

Nastavení najdete ve stejné sekci jako aktivaci: **Nastavení » Rozšíření » Informace o firmách » Prospector**.

![Nastavení automatického přenosu Klientů z Prospectoru v nastavení Raynetu](/files/JMtssLPitMINwd5tpdMN)

Před nastavením přenosu je potřeba v Prospectoru vytvořit dva štítky - jeden pro firmy určené k přenosu a jeden pro firmy, které již přeneseny byly. Pojmenování je libovolné, v tomto návodu používáme názvy **Pošli do Raynet** a **V Raynet**. Po vytvoření se štítky zobrazí v rozbalovacích nabídkách níže.

Vyplňte tato pole:

**Vlastník nových záznamů** - vyberte uživatele, pod kterým budou vznikat nově vytvořené záznamy Klientů (s jeho nastavenou úrovní bezpečnosti).

**K přenosu** - vyberte Prospector štítek, který identifikuje firmy určené k přenosu. Do Raynetu se automaticky přenese každá firma, kterou tímto štítkem v Prospectoru označíte. Štítek vyberte zvlášť pro české, slovenské a polské firmy.

**Přeneseno** - vyberte Prospector štítek, kterým se budou v Prospectoru automaticky označovat firmy, které se již do Raynetu přenesly. Štítek vyberte zvlášť pro české, slovenské a polské firmy.

> Pokud firma v Raynetu ještě neexistuje, při přenosu se automaticky založí jako nový Klient a obohatí o data z Prospectoru. Pokud Klient v Raynetu již existuje, přenos pouze aktualizuje jeho data na nejnovější hodnoty z Prospectoru.

***

### Řešení potíží

**Data se nezobrazují na kartě Klienta.** Ověřte, že jste API klíč zadali správně a klikli na Aktivovat. Zkuste v Prospectoru vygenerovat nový klíč a v nastavení Raynetu ho aktualizovat.

**Raynet hlásí chybu při uložení API klíče.** Zkontrolujte, že kopírujete celý klíč bez mezer na začátku nebo konci.

**Firma označená štítkem se nepřenesla do Raynetu.** Ověřte, že máte v sekci **K přenosu** vybrán štítek pro správnou zemi firmy (CZ, SK nebo PL). Název štítku musí přesně odpovídat štítku v Prospectoru.

**Záložka Údaje z Prospectoru se nenačítá.** Zkontrolujte, zda je API klíč stále platný. Pokud problém přetrvává, kontaktujte podporu na <support@bizmachine.com>.

***

### Co dál

* [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md)
* [Co je to integrační účet?](/api-a-integrace/integracni-ucet.md)
* [CRM integrace - přehled](/api-a-integrace/crm-integrace.md)
* [Jak fungují štítky v Prospectoru](/seznamy-a-export/stitky-workflow.md)
