[Intum Pomoc V1](https://intum.intum.pl/kb/intum-kb-v1.md) / [Integracje](https://intum.intum.pl/kb/intum-kb-v1/integracje.md) # [Integracja z Fakturownia.pl](https://intum.intum.pl/kb/intum-kb-v1/integracje/integracja-z-fakturownia-pl.md) | [API](#api) Integracja systemów Sugester i Fakturownia.pl pozwala na wygodną automatyzację procesów księgowo-sprzedażowych. Dzięki niej możesz na bieżąco synchronizować bazę kontrahentów oraz automatycznie pobierać wystawione dokumenty finansowe. Co ważne, system pozwala na **podpięcie kilku osobnych kont z Fakturowni** do jednego profilu w Sugesterze, co jest idealnym rozwiązaniem, jeśli prowadzisz kilka marek lub spółek. Cały proces konfiguracji przeprowadzasz w panelu Sugestera. ## Krok 1: Aktywacja integracji w systemie 1. Kliknij ikonę aplikacji (**cztery kropki** w prawym górnym rogu ekranu). 2. W sekcji **Konto** wybierz **Integracje i dodatki**. 3. Znajdź na liście kafelek **Integracja z Fakturownia.pl**. ![](fef4cf7461d7-Screenshot - 2026-07-20T154049.896.png) 1. Kliknij przycisk **Zainstaluj**, a następnie **Uruchom**. ## Krok 2: Podpięcie konta Fakturowni Po uruchomieniu dodatku kliknij przycisk **+ Dodaj konto** (lub *Dodaj pierwsze konto*). Na ekranie pojawi się formularz, w którym należy uzupełnić następujące dane: ![](d41d2e1757c7-Screenshot - 2026-07-20T154210.274.png) ![](aadd19500d49-Screenshot - 2026-07-20T154430.696.png) - **Nazwa** - Twoja własna nazwa dla tego połączenia (np. *Moja Firma Sp. z o.o.*). - **URL konta Fakturowni** - pełny adres Twojej subdomeny w Fakturowni (np. `[https://mojafirma.fakturownia.pl](https://mojafirma.fakturownia.pl)`). - **Token API** - klucz autoryzacyjny, który pobierzesz ze swojego konta w Fakturowni (szczegóły poniżej). - **Kod konektora** - generuje się automatycznie (np. `fakturownia1`). **Nie zmieniaj go!** > **Skąd wziąć Token API z Fakturowni?** Zaloguj się do swojego panelu w Fakturownia.pl, a następnie przejdź do: **Ustawienia -> Ustawienia konta -> Integracje** i skopiuj stamtąd wygenerowany **Kod autoryzacyjny API**. Po uzupełnieniu pól kliknij **Dodaj i połącz**. Twoje konto pojawi się na liście jako aktywne. ![](1889529af2d6-image - 2026-07-20T155304.345.png) ## Krok 3: Konfiguracja synchronizacji i pobierania danych Po kliknięciu w podpięte konto na liście uzyskasz dostęp do zaawansowanych ustawień przepływu danych: ### 1. Ustawienia importu faktur Rozwiń tę sekcję, aby zaznaczyć, z których konkretnie typów dokumentów wystawianych w Fakturowni (np. Faktura VAT, Proforma, Paragon, Faktura Zaliczkowa) system ma automatycznie generować dokumenty w Sugesterze. ![](02056a271ef5-image - 2026-07-20T155559.373.png) ### 2. Synchronizacja danych (Dane historyczne i bieżące) - **Guziki „Importuj” (Import faktur / Import klientów)** - służą do jednorazowego, ręcznego zaciągnięcia danych historycznych, które zgromadziłeś w Fakturowni przed uruchomieniem integracji. - **Automatycznie synchronizuj zmiany na klientach** - zaznaczenie tego checkboxa sprawi, że każda bieżąca zmiana na karcie klienta w Sugesterze (utworzenie, edycja, usunięcie) zostanie natychmiast automatycznie wprowadzona również w Fakturowni. ![](743a1b35d683-image - 2026-07-20T155324.628.png) ### 3. Webhooki - pobieranie nowych danych w tle W tej sekcji decydujesz, jakie zdarzenia mają być przesyłane z Fakturowni do Sugestera na bieżąco. Klikając przycisk **Włącz** przy *Pobieraniu faktur* lub *Pobieraniu klientów*, aktywujesz tzw. webhooki (system sam zajmie się ich konfiguracją). Dzięki temu każda nowa faktura w Fakturowni od razu pojawi się w Twoim CRM-ie. ## Jak wystawiać faktury? Dwa modele pracy Wszystkie zaimportowane i pobrane dokumenty znajdziesz w sekcji **Sprzedaż -> Faktury**. To, w jaki sposób będą wystawiane nowe dokumenty, zależy od jednego ustawienia: ### Model A: Wystawianie bezpośrednio w Fakturowni (Zalecane) Jeśli w menu *Sprzedaż -> Ustawienia sprzedaży* zaznaczysz opcję **„Twórz faktury przez Fakturownię”**: ![](ef526425505b-Screenshot - 2026-07-20T160600.715.png) - Wchodząc w Sugesterze w zakładkę *Sprzedaż -> Faktury* i klikając **Dodaj**, system automatycznie i płynnie przeniesie Cię do okna wystawiania dokumentu bezpośrednio w Fakturowni. ### Model B: Wystawianie w Sugesterze i automatyczna wysyłka Jeśli pozostawisz ten checkbox **odznaczony**: - Fizycznie wystawiasz dokument wewnątrz panelu Sugestera. Jeśli w konfiguracji integracji masz włączone odpowiednie webhooki, nowo zapisana w Sugesterze faktura zostanie automatycznie przesłana i odnotowana w Twojej Fakturowni. --- ## 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** --- ## Powiązane - [Wystawianie faktur w Intum przez Fakturownia.pl](https://intum.intum.pl/kb/intum-kb-v1/faktury/integracja-z-fakturownia.md)