[Intum](https://intum.pl/pomoc.md) / [Integracje](https://intum.pl/pomoc/integracje.md)

# [Integracja z Fakturownia.pl](https://intum.pl/pomoc/integracje/integracja-z-fakturownia-pl.md) | [API](#api)

Intum pozwala połączyć się z Fakturownia.pl - pobierać faktury, importować klientów i ustawiać automatyczne powiadomienia o nowych fakturach.

Można podpiąć kilka kont Fakturowni naraz.

## Jak zainstalować

Wejdź w **Sprzedaż > Ustawienia** - na dole jest sekcja Appstore. Kliknij "Dodaj integrację", znajdź "Integracja z Fakturownia.pl" i kliknij **Zainstaluj**.

Po instalacji wróć do Sprzedaż > Ustawienia - w sekcji Appstore pojawi się link do aplikacji.

## Podłączenie konta Fakturowni

Po otwarciu aplikacji kliknij **Dodaj konto**. Potrzebujesz dwóch rzeczy:

- **URL konta** - to adres Twojej Fakturowni, np. `https://mojafirma.fakturownia.pl`
- **Token API** - znajdziesz go w Fakturowni: Ustawienia > Integracja > Kod autoryzacyjny API

Po dodaniu kliknij "Sprawdź" żeby upewnić się że połączenie działa.

## Co można robić

### Pobieranie faktur

Kliknij w konto Fakturowni, a potem **Uruchom** przy "Import faktur". Faktury trafią do modułu Sprzedaż razem z pozycjami i danymi kontrahentów. Przy każdej zaimportowanej fakturze jest link do oryginału w Fakturowni.

### Pobieranie klientów

**Uruchom** przy "Import klientów" - klienci z Fakturowni trafią do CRM. Jeśli klient już istnieje, uzupełniane są tylko puste pola (nic nie zostanie nadpisane).

Oba importy pokazują postęp na żywo - ile faktur/klientów utworzono, zaktualizowano, pominięto.

### Automatyczne faktury (webhooki)

W szczegółach konta kliknij **Zarejestruj** w sekcji Webhooki. Od tego momentu nowe i zmienione faktury w Fakturowni będą automatycznie trafiać do Intum.

Webhooki działają tylko na produkcji (Fakturownia musi mieć dostęp do Twojego adresu).

## Szybki dostęp do Fakturowni z poziomu Intum

Przy każdej zaimportowanej fakturze w Sprzedaż > Faktury jest link "Pokaż w Fakturowni" - przenosi prosto do tej faktury w panelu Fakturowni. Podobnie przy kliencie - jeśli został zaimportowany z Fakturowni, widać link do jego profilu.

## Automatyczne wystawianie faktur

Jeśli chcesz żeby Intum automatycznie tworzył faktury w Fakturowni przy zamówieniach, wejdź w **Sprzedaż > Ustawienia** i zaznacz checkbox **Twórz faktury przez Fakturownię** w sekcji Fakturowanie.

## Gdzie to znaleźć

- Ustawienia integracji: **Sprzedaż > Ustawienia > Appstore**
- Instalacja: Sprzedaż > Ustawienia > Appstore > Dodaj integrację
- Bezpośredni link do aplikacji: `/a/fakturownia-integration`

---

## 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**