[Intum](https://intum.pl/pomoc.md) / [Faktury](https://intum.pl/pomoc/faktury.md)

# [Integracja faktur z Fakturownią](https://intum.pl/pomoc/faktury/integracja-z-fakturownia.md) | [API](#api)

## Wystawianie faktur przez Fakturownię

Możesz wystawiać faktury bezpośrednio w Fakturowni, nie wychodząc z Intuma. Po kliknięciu "Nowa faktura" system przekieruje Cię do Fakturowni z automatycznie uzupełnionymi danymi klienta.

### Konfiguracja

1. Upewnij się, że masz dodany konektor typu **Fakturownia** w module Konektory
2. Przejdź do **Sprzedaż > Ustawienia** (albo **Ustawienia konta > Sprzedaż**)
3. W sekcji "Fakturowanie" zaznacz **Twórz faktury przez Fakturownię**

Od tego momentu przycisk "Nowa faktura" w module Sprzedaż pokazuje listę podłączonych kont Fakturowni. Klikasz w wybrane konto i otwiera się formularz nowej faktury w Fakturowni.

Jeśli tworzysz fakturę z poziomu karty klienta (przycisk "Dodaj fakturę" w menu +), dane nabywcy - nazwa, NIP, adres, email, telefon - wypełnią się automatycznie.

Możesz podłączyć kilka kont Fakturowni dodając osobne konektory - np. jedno konto na faktury krajowe, drugie na zagraniczne.

## Automatyczna synchronizacja nowych faktur

Aby faktury wystawione w Fakturowni automatycznie pojawiały się w Intum, trzeba skonfigurować webhooki w Fakturowni.

### Krok 1 - znajdź URL webhooka

URL webhooka ma format:

```
https://twoja-domena.intum.com/connect/connector/KOD_KONEKTORA/receive_invoice_webhook
```

Gdzie `KOD_KONEKTORA` to kod Twojego konektora Fakturowni (np. `fakturownia1`). Kod konektora znajdziesz w jego ustawieniach w module Konektory.

Jeśli masz kilka konektorów Fakturowni, każdy ma osobny URL webhooka.

### Krok 2 - dodaj webhooki w Fakturowni

1. Zaloguj się do Fakturowni
2. Przejdź do **Ustawienia > API > Webhooki** (lub wejdź na adres `/webhooks`)
3. Dodaj dwa webhooki:

**Webhook na nowe faktury:**
- URL: `https://twoja-domena.intum.com/connect/connector/KOD_KONEKTORA/receive_invoice_webhook`
- Rodzaj zdarzenia: `invoice:create`

**Webhook na aktualizacje faktur:**
- URL: ten sam co wyżej
- Rodzaj zdarzenia: `invoice:update`

### Krok 3 - gotowe

Od teraz każda faktura wystawiona w Fakturowni automatycznie pojawi się w Intum - razem z pozycjami, danymi sprzedawcy i nabywcy. Aktualizacje (np. zmiana statusu na "opłacona") też się zsynchronizują.

Faktura w Intum zostanie automatycznie powiązana z klientem CRM na podstawie NIP-u.

## Kilka kont Fakturowni

Jeśli korzystasz z kilku kont Fakturowni (np. dla różnych spółek), dodaj osobny konektor dla każdego konta. Webhooki w każdym koncie Fakturowni powinny wskazywać na URL odpowiedniego konektora.

Przy wystawianiu faktury z Intuma zobaczysz listę wszystkich podłączonych kont i wybierzesz odpowiednie.

## Synchronizacja historycznych faktur

Webhooki synchronizują tylko nowe faktury i aktualizacje. Jeśli chcesz zaimportować faktury wystawione wcześniej, użyj synchronizacji zbiorczej w ustawieniach konektora.

---

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

- [Faktury](https://intum.pl/pomoc/faktury/faktury.md)