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 Konto > Integracje i dodatki (/account/apps). Znajdź “Integracja z Fakturownia.pl” i kliknij Zainstaluj.
Po instalacji w tym samym miejscu pojawi się przycisk Uruchom - klikasz go i przechodzisz do aplikacji.
Alternatywnie do tego samego miejsca dostaniesz się z Sprzedaż > Ustawienia - na dole jest sekcja Integracje i dodatki z linkiem “Dodaj integrację”.
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.
Skrót: aktywacja przez Fakturownię
Jeśli wcześniej aktywowałeś Intum z poziomu samej Fakturowni (np. włączając w Fakturowni Ustawienia > Ustawienia konta - sekcja Inne na dole strony), to Token API jest najczęściej już ustawiony w Intumie automatycznie - nie musisz go nigdzie kopiować.
Dodatkowo po włączeniu Modułu CRM (lub innych modułów Intuma) w Fakturowni, w górnym menu Fakturowni pojawi się link do CRM i pozostałych aktywnych modułów Intuma. Klikasz w link i przechodzisz prosto do Intuma w kontekście tego konta.
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 w Intumie
Jeśli chcesz żeby z poziomu Intuma móc wystawiać faktury (otwierane w Fakturowni z uzupełnionymi danymi klienta) - patrz Wystawianie faktur w Intum przez Fakturownia.pl.
Gdzie to znaleźć
- Instalacja i lista integracji: Konto > Integracje i dodatki (
/account/apps) - Skrót w module sprzedaży: Sprzedaż > Ustawienia > sekcja “Integracje i dodatki”
- Bezpośredni link do aplikacji po instalacji:
/a/fakturownia-integration - Aktywacja po stronie Fakturowni: Fakturownia > Ustawienia > Ustawienia konta > sekcja Inne (na dole strony) - tam włączasz Moduł CRM i pozostałe moduły Intuma
Ręczna integracja (zaawansowane)
Standardowa instalacja przez Konto > Integracje i dodatki ustawia wszystko automatycznie - łącznie z webhookami. Tę sekcję czytaj tylko jeśli z jakiegoś powodu chcesz skonfigurować integrację ręcznie, przez moduł Konektory.
Konektor Fakturowni i URL webhooka
Zamiast aplikacji ze sklepu integracji możesz dodać konektor typu Fakturownia w module Konektory. Każdy konektor ma swój kod (np. fakturownia1) - znajdziesz go w ustawieniach konektora.
URL webhooka dla synchronizacji faktur ma format:
https://twoja-domena.intum.com/connect/connector/KOD_KONEKTORA/receive_invoice_webhook
Jeśli masz kilka konektorów Fakturowni, każdy ma osobny URL.
Webhooki po stronie Fakturowni
- Zaloguj się do Fakturowni
- Przejdź do Ustawienia > API > Webhooki (lub wejdź na
/webhooks) - Dodaj dwa webhooki wskazujące na ten sam URL konektora:
- rodzaj zdarzenia
invoice:create- dla nowych faktur - rodzaj zdarzenia
invoice:update- dla zmian (np. zmiana statusu na “opłacona”)
- rodzaj zdarzenia
Każda faktura z Fakturowni trafi do Intum razem z pozycjami i danymi stron. Faktura zostanie automatycznie powiązana z klientem CRM po NIP-ie.
Synchronizacja historycznych faktur
Webhooki obsługują tylko nowe i zmienione faktury. Faktury sprzed włączenia webhooków zaimportujesz przez synchronizację zbiorczą w ustawieniach konektora.