Integracja Flobo z Fakturownią

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?

Integracja API krok po kroku

  1. Rozpoczęcie integracji

Integrację z programem do fakturowania znajdziemy w zakładce Ustawienia konta na liście rozwijanej, która pojawia się po najechaniu na e-mail użytkownika (prawy górny róg).

Następnie należy przejść do zakładki Moduły i wybrać opcję “Fakturownia” z rozwijanej listy.

fakturownia

  • pod listą znajduje się przycisk Autoryzuj
  • po naciśnięciu przycisku Autoryzuj pojawi się miejsce na token


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.

  1. Generowanie tokena – klucza API w Fakturowni
    • zaloguj się do Twojego konta Fakturownia
    • przejdź do: Ustawienia → Ustawienia konta → Integracja
    • kliknij w przycisk “Zobacz ApiTokeny”

      zobacz api tokeny
    • na stronie Tokeny API kliknij w Dodaj nowy Token
    • wybierz Token z prefiksem oraz nadaj nazwę swojemu tokenowi (np. Flobo)

      Api token
    • 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)
  2. Dodanie klucza we Flobo
    Skopiowany do schowka token wklej w pole Token (patrz punkt 1).
  3. Zapisanie zmian
    Kliknij w przycisk Autoryzuj
  4. Sprawdzenie integracji
    Po poprawnym zapisaniu zmian zobaczysz Status: Poprawne.
    W miejscu przycisku Autoryzuj pojawi się przycisk Usuń autoryzację.

    fakturownia poprawna integracja
  5. Usuwanie integracji
    W razie potrzeby możesz usunąć dodaną integrację. Wystarczy, że naciśniesz przycisk Usuń autoryzację.
  6. 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.

    działy fakturownia

    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.

    odświeżenie działów
  7. 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.

  1. Przejdź do podstrony z fakturami
    Strona z fakturami: https://panel.flobo.io/faktury/
    Na górnym pasku powinieneś zobaczyć informację o integracji z Fakturownią.

  2. Kliknij w przycisk “Importuj”
    W formularzu “Import Faktur z Fakturowni” wybierz interesujący Cię okres (np. ostatnie 30 dni lub wszystkie)
  3. Kliknij w przycisk “Prześlij”
    W przypadku prawidłowo przeprowadzonego importu, pojawi się informacja “Pomyślne zaimportowano”, a faktury pojawią się na liście faktur.
    import pomyślny

Podpowiedź: Przy kolejnych importach możesz również zaznaczyć checkbox “Importuj tylko nowe”. System zaimportuje tylko nowe faktury, który pojawiły się od czasu poprzedniego importu