Fakturownia to popularna aplikacja do faktur online. Integracja pozwala pobierać faktury i dane klientów z Fakturowni. Integracja bazuje na API – interfejsie programowania aplikacji, dzięki czemu umożliwia wzajemne połączenie różnych, niezależnych od siebie systemów.
Co będzie potrzebne?
- aktywne konto Flobo. Konto z bezpłatnym 14-dniowym okresem testowym możesz założyć tutaj: https://panel.flobo.io/rejestracja
- aktywne konto Fakturownia – minimum konto Start: https://fakturownia.pl/cennik
Integracja API krok po kroku
- Rozpoczęcie integracji
Integrację z programem do fakturowania znajdziemy na ekranach powitalnych Flobo, zaraz po stworzeniu nowego konta lub w zakładce Ustawienia konta, którą można znaleźć pod ikoną koła zębatego w prawy górnym rogu.
Następnie należy przejść do zakładki Program do fakturowania. Zakładka pojawi się w Ustawieniach tylko w przypadku, gdy wybierzemy chęć korzystania z tej usługi (Automatyczna windykacja i/lub Automatyczne rozliczanie faktur).
W zakładce Program do fakturowania należy wybrać jedną z opcji dotyczących Fakturowni.
W przypadku wybrania opcji Mam już konto w Fakturowni należy przycisnąć przycisk Autoryzuj. Następnie pojawi się pole do wpisania tokenu.
W przypadku wybrania opcji Chcę założyć konto w Fakturowni, należy postępować zgodnie z instrukcjami i zaakceptować Regulamin. Integracja w tym przypadku zostanie dodana automatycznie.
Czym jest token?
Do integracji niezbędny będzie token – klucz API – konieczny do pobierania danych z Fakturowni. Należy go wygenerować bezpośrednio na koncie Fakturowni.
- Generowanie tokena – klucza API w Fakturowni
- zaloguj się do Twojego konta Fakturownia
- przejdź do: Ustawienia → Ustawienia konta → Integracja
- kliknij w przycisk “Zobacz ApiTokeny”
- na stronie Tokeny API kliknij w Dodaj nowy Token
- wybierz Token z prefiksem oraz nadaj nazwę swojemu tokenowi (np. Flobo)
- kliknij “Zapisz” → token zapisze się na liście dostępnych tokenów
- skopiuj token do schowka (podpowiedź: mimo, iż token wygląda na wyszarzony, można go bez problemów zaznaczyć kursorem i skopiować do schowka)
- Dodanie klucza we Flobo
Skopiowany do schowka token wklej w pole Token (patrz punkt 1). - Zapisanie zmian
Kliknij w przycisk Autoryzuj - Sprawdzenie integracji
Po poprawnym zapisaniu zmian zobaczysz Autoryzacja: Prawidłowa. - Usuwanie integracji
W razie potrzeby możesz usunąć dodaną integrację. Wystarczy, że naciśniesz przycisk Usuń autoryzację. - Wybierz działy, których faktury chcesz obsługiwać
Wybierz działy Fakturowni, z których Flobo ma pobierać faktury. Możesz to zrobić zaznaczając lub odznaczając checkboxy.
Nie dotyczy kont, na których nie stworzono osobnych działów – w takim przypadku dział główny zostanie wybrany automatycznie.
W przypadku, gdy już po integracji z Flobo, dodasz nowy dział w Fakturowni, możesz zaktualizować listę działów klikając na przycisk widoczny po prawej stronie. - Zapisz zmiany ustawień
Nie zapomnij zapisać zmian klikając w przycisk Zapisz u dołu strony.
Import faktur z Fakturowni
Po poprawnym zapisaniu zmian czas na import faktur z Fakturowni.
Można to zrobić bezpośrednio z okna, które pojawi się po przeprowadzonej autoryzacji.