[Intum](https://intum.pl/pomoc.md) / [CRM](https://intum.pl/pomoc/crm.md)

# [Import klientów z Fakturowni](https://intum.pl/pomoc/crm/import-klientow-z-fakturowni.md) | [API](#api)

## Co to robi

Import pobiera klientów z Twojego konta w Fakturowni i tworzy ich jako klientów CRM w Intum. Jeśli klient o danym ID z Fakturowni już istnieje w CRM (po polu external_id), import uzupełni tylko te pola, które są puste - nie nadpisze danych, które już ręcznie uzupełniłeś.

Możesz uruchamiać import wielokrotnie - za każdym razem zostaną dodani tylko nowi klienci, a u istniejących uzupełnione puste pola.

## Wymagania

Potrzebujesz aktywnego modułu InConnector oraz konta w Fakturowni z tokenem API.

## Krok 1 - Włącz moduł InConnector

Jeśli nie masz jeszcze modułu InConnector, włącz go w ustawieniach konta:

1. Przejdź do **Ustawienia** > **Moduły**
2. Znajdź moduł **InConnector** i go aktywuj
3. Po aktywacji w menu pojawi się sekcja **InConnector**

## Krok 2 - Dodaj connector Fakturowni

Connector to połączenie z Twoim kontem w Fakturowni. Jeśli masz już connector z kodem `fakturownia1`, przejdź do kroku 3.

1. Przejdź do **InConnector** > **Connectory** > **Nowy**
2. Wypełnij:
   - **Kod** - wpisz `fakturownia1` (dokładnie taki, bez zmian)
   - **URL** - adres Twojego konta, np. `https://twojafirma.fakturownia.pl`
   - **Token API** - token z Fakturowni (znajdziesz go w Fakturowni w Ustawienia > API)
3. Zapisz connector

## Krok 3 - Dodaj flow importu

1. Przejdź do **InConnector** > **Flows** > **Nowy**
2. W polu **Rodzaj** wybierz `noe/connect/flow/fakturownia_integration_rflow`
3. Nadaj nazwę, np. "Import klientów z Fakturowni"
4. Zapisz

## Krok 4 - Uruchom import

1. Otwórz zapisany flow
2. Kliknij **Start**
3. Import pobierze klientów z Fakturowni i utworzy ich w CRM

Postęp importu możesz śledzić w procesach flow (przycisk "Procesy Flow" na stronie flow).

## Ważne

- Import nie nadpisuje istniejących danych klientów - uzupełnia tylko puste pola
- Klienci są rozpoznawani po external_id (ID klienta z Fakturowni)
- Możesz uruchamiać Start wielokrotnie - nowi klienci zostaną dodani, istniejący nie będą nadpisani
- Jeśli używasz innego kodu connectora niż `fakturownia1`, wpisz go w polu **fields** flow jako `{"fakturownia_connector_code": "twoj_kod"}`

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**