Jak skonfigurować integrację z inFakt

Czym jest integracja z inFakt?

inFakt to polski serwis do wystawiania faktur online, który po połączeniu z Lernavo automatycznie generuje faktury dla Twoich uczestników. Integracja działa w tle - po każdym udanym zakupie kursu lub pakietu, system automatycznie tworzy fakturę i wysyła ją na e-mail uczestnika.

Główne korzyści

• Automatyzacja: Faktury generowane automatycznie po każdej płatności
• Zgodność z prawem: Pełna zgodność z polskimi przepisami VAT
• Oszczędność czasu: Brak konieczności ręcznego wystawiania faktur
• Profesjonalizm: Uczestnicy otrzymują faktury natychmiast po zakupie
• Wygoda: Dostęp do wszystkich faktur w panelu Lernavo i inFakt
• Integracja księgowa: inFakt łączy się z wieloma programami księgowymi

Jak to działa?

Proces jest prosty i w pełni zautomatyzowany:

1. Uczestnik kupuje kurs lub pakiet w Twojej szkole
2. Po udanej płatności, Lernavo automatycznie wysyła dane do inFakt poprzez API
3. inFakt generuje fakturę z Twoimi danymi jako sprzedawcy
4. PDF faktury jest zapisywany w systemie Lernavo
5. Uczestnik otrzymuje fakturę na e-mail w ciągu 1-2 minut

Co potrzebujesz przed rozpoczęciem?

1. Aktywna subskrypcja Lernavo

Upewnij się, że Twój plan w Lernavo zawiera funkcję integracji. Możesz to sprawdzić w panelu Ustawienia → Twój plan.

2. Konto w serwisie inFakt

Musisz posiadać aktywne konto w inFakt z pełną konfiguracją. Jeśli jeszcze nie masz konta:

• Załóż konto na stronie: https://www.infakt.pl/
• Skonfiguruj dane swojej firmy (sprzedawcy) - te dane będą widoczne na fakturach
• Uzupełnij wszystkie wymagane informacje (NIP, adres, dane kontaktowe)
• Skonfiguruj ustawienia domyślne faktur (numeracja, VAT, terminy)

3. Czas na konfigurację

Połączenie integracji w Lernavo zajmie Ci tylko 5-10 minut, jeśli masz już skonfigurowane konto inFakt.

Zanim połączysz integrację w Lernavo, musisz mieć przygotowane konto w serwisie inFakt. Ta sekcja zawiera podstawowe informacje - szczegóły znajdziesz w dokumentacji inFakt.

Krok 1: Założenie konta (jeśli nie masz)

• Odwiedź stronę: https://www.infakt.pl/
• Kliknij przycisk "Załóż konto" lub "Zarejestruj się"
• Wypełnij formularz rejestracyjny i potwierdź adres e-mail
• Zaloguj się do panelu inFakt

Krok 2: Konfiguracja danych firmy

W panelu inFakt musisz skonfigurować swoje dane jako sprzedawcy. Te informacje będą widoczne na wszystkich fakturach generowanych dla uczestników:

• Pełna nazwa firmy
• Numer NIP
• Adres siedziby firmy
• Dane kontaktowe (telefon, e-mail)
• Numer konta bankowego (opcjonalnie)

Krok 3: Ustawienia faktur

Skonfiguruj podstawowe ustawienia dotyczące faktur:

• Format numeracji faktur
• Domyślne stawki VAT (zazwyczaj 23% dla kursów online)
• Terminy płatności
• Metody płatności

Aby połączyć Lernavo z inFakt, potrzebujesz klucza API. Klucz API to specjalny kod, który pozwala Lernavo bezpiecznie komunikować się z Twoim kontem inFakt.

Jak wygenerować klucz API?

1. Zaloguj się do panelu inFakt na stronie https://konto.infakt.pl/zaloguj
2. Przejdź do Ustawienia → API
3. Nadaj nazwę kluczowi, np. "Lernavo Integracja"
4. WAŻNE: Wybierz odpowiednie uprawnienia (szczegóły poniżej)
5. Kliknij "Zapisz" lub "Wygeneruj"
6. Skopiuj wygenerowany klucz (będzie pokazany tylko raz!)

Teraz, gdy masz już klucz API z inFakt, możesz połączyć integrację w panelu Lernavo. Ten proces jest prosty i zajmie tylko kilka minut.

Sprawdź przed rozpoczęciem

• ✅ Masz aktywne konto inFakt
• ✅ Skonfigurowałeś dane firmy w inFakt
• ✅ Wygenerowałeś klucz API z odpowiednimi uprawnieniami
• ✅ Skopiowałeś klucz API do schowka

Krok 1: Otwórz panel integracji

1. Zaloguj się do panelu administracyjnego Lernavo
2. W menu bocznym kliknij Ustawienia
3. Wybierz zakładkę Integracje

Krok 2: Znajdź kartę inFakt

Na stronie integracji zobaczysz kartę "inFakt" z następującymi informacjami:

• Logo inFakt
• Opis: "Polski serwis do wystawiania faktur"
• Status: "Niepołączone" (jeśli jeszcze nie połączyłeś)
• Przełącznik (toggle) po prawej stronie

Krok 3: Aktywuj integrację

1. Kliknij przełącznik (toggle) na karcie inFakt
2. Zobaczysz pole do wprowadzenia klucza API

Krok 4: Wprowadź klucz API

1. W polu "Klucz API" wklej skopiowany wcześniej klucz z inFakt
2. Upewnij się, że skopiowałeś cały klucz (bez spacji na początku/końcu)
3. Kliknij przycisk "Połącz"

Krok 5: Weryfikacja połączenia

Po kliknięciu "Połącz", system Lernavo automatycznie sprawdzi, czy klucz API jest prawidłowy:

• Testuje połączenie z inFakt
• Weryfikuje uprawnienia klucza
• Sprawdza, czy może tworzyć faktury

✅ Sukces - połączenie udane

Jeśli wszystko jest poprawnie skonfigurowane:

• Zobaczysz zielony komunikat: "Integracja pomyślnie połączona!"
• Karta inFakt zmieni status na "Połączone"
• Pojawi się zielony wskaźnik połączenia

❌ Błąd - połączenie nieudane

Jeśli zobaczysz komunikat o błędzie, sprawdź:

• Czy klucz API został skopiowany w całości
• Czy klucz ma odpowiednie uprawnienia (api:invoices:write i api:invoices:read)
• Czy klucz nie wygasł lub nie został usunięty w inFakt
• Czy Twoje konto inFakt jest aktywne

Po połączeniu integracji, faktury są generowane w pełni automatycznie. Dowiedz się, jak dokładnie działa ten proces i gdzie znajdziesz wygenerowane faktury.

Automatyczne generowanie faktur

Faktury są tworzone automatycznie po każdej udanej płatności za kurs lub pakiet:

• Działa dla wszystkich kursów i pakietów w Twojej szkole
• Proces odbywa się w tle (asynchronicznie)
• Generowanie zajmuje zwykle 1-2 minuty
• Nie musisz podejmować żadnych działań

Proces generowania krok po kroku

Jakie dane są używane na fakturze?

Dane sprzedawcy (Twoje dane)

Pobierane z konfiguracji Twojego konta inFakt:

• Nazwa firmy
• NIP
• Adres
• Dane kontaktowe

Dane kupującego (dane uczestnika)

Pobierane z formularza zakupowego w Lernavo:

• Imię i nazwisko
• Adres e-mail
• Adres (jeśli podany)
• NIP (jeśli uczestnik kupuje jako firma)

Dane produktu i płatności

• Nazwa kursu lub pakietu
• Cena brutto i netto
• Stawka VAT
• Metoda płatności
• Data płatności

Gdzie znajdziesz faktury w Lernavo?

Wygenerowane faktury są dostępne w kilku miejscach:

W panelu administracyjnym:

1. Przejdź do zakładki Sprzedaż w menu bocznym
2. Znajdź stronę "Ostatnie płatności"
3. Kliknij, aby otworzyć szczegóły płatności
4. Przejdź do kolumny "Faktura"
5. Zobaczysz informacje o fakturze i przycisk pobierania PDF

W panelu uczestnika:

Każdy uczestnik ma dostęp do swoich faktur w sekcji "Historia zamówień" po zalogowaniu się do platformy.

Co otrzymuje uczestnik?

Po udanym zakupie, uczestnik automatycznie otrzymuje:

• E-mail z potwierdzeniem zakupu
• Fakturę w formacie PDF jako załącznik do e-maila
• Link do pobrania faktury w swoim panelu uczestnika
• Możliwość pobrania faktury w dowolnym momencie

Dostęp do faktur w inFakt

Wszystkie faktury wygenerowane przez Lernavo są również widoczne w Twoim panelu inFakt:

• Pełna lista faktur z możliwością filtrowania
• Możliwość edycji, korekty lub anulowania faktur
• Eksport faktur do programów księgowych
• Raporty i zestawienia

Po połączeniu integracji możesz zarządzać nią bezpośrednio z panelu Lernavo. Dowiedz się, jak sprawdzać status, testować połączenie i rozłączać integrację.

Sprawdzanie statusu integracji

Aby sprawdzić status integracji:

1. Przejdź do Ustawienia → Integracje
2. Znajdź kartę "inFakt"
3. Sprawdź wskaźnik statusu:

• Zielony wskaźnik + "Połączone" = integracja aktywna i działa poprawnie
• Szary wskaźnik + "Niepołączone" = integracja nieaktywna

Rozłączanie integracji

Jeśli z jakiegoś powodu chcesz tymczasowo lub na stałe rozłączyć integrację:

1. Przejdź do Ustawienia → Integracje
2. Na karcie inFakt kliknij przełącznik (toggle), aby go wyłączyć
3. Pojawi się okno potwierdzenia
4. Potwierdź rozłączenie

Ponowne połączenie integracji

Możesz w dowolnym momencie ponownie aktywować rozłączoną integrację:

1. Kliknij przełącznik na karcie inFakt
2. Wprowadź klucz API (jeśli system go nie zapisał)
3. Lub połączenie zostanie przywrócone automatycznie, jeśli klucz jest nadal ważny

Monitorowanie generowania faktur

Zalecamy regularne sprawdzanie, czy faktury są generowane poprawnie:

• Przeglądaj listę płatności w Sprzedaż -> Ostatnie płatności
• Sprawdzaj, czy w kolumnie "faktury" jest widoczny przycisk do pobrania
• Jeśli zobaczysz faktury ze statusem "Błąd", sprawdź szczegóły
• W razie problemów, skontaktuj się z pomocą techniczną

Lernavo pozwala na wygodne przeglądanie wszystkich wygenerowanych faktur bezpośrednio w panelu administracyjnym. Dowiedz się, gdzie znajdziesz faktury i jak je pobrać.

Dostęp do faktur w panelu administracyjnym

Krok 1: Otwórz zakładkę "Sprzedaż"

1. Wybierz Ostatnie płatności
2. Zobaczysz listę wszystkich płatności w Twojej szkole
3. Możesz filtrować płatności według:
   • Statusu płatności
   • Daty
   • Użytkownika
   • Numeru zamówienia

Krok 2: Otwórz szczegóły płatności

1. Znajdź interesującą Cię płatność na liście
2. Kliknij na wiersz płatności, aby otworzyć szczegóły
3. Zobaczysz panel ze szczegółowymi informacjami

Krok 3: Przejdź do sekcji "Informacje o fakturze"

Informacje o fakturze w zakładce

W zakładce "Faktura" zobaczysz:

• Status faktury - utworzona / przetwarzanie / błąd
• Numer faktury
• Data utworzenia - kiedy faktura została wygenerowana
• Przycisk pobierania PDF - do pobrania faktury
• Przycisk do wygenerowania faktury - w przypadku kiedy faktura nie została wygenerowana (na przykład z powodu, podpięcia integracji dopiero po rozpoczęciu sprzedaży)

Pobieranie faktury PDF

1. W kolumnie "Faktura" kliknij przycisk "Pobierz PDF"
2. Faktura otworzy się w nowej karcie przeglądarki lub zostanie pobrana
3. To ten sam plik PDF, który otrzymał uczestnik na e-mail

Zarządzanie fakturami w inFakt

Jeśli napotkasz problem z integracją inFakt, poniżej znajdziesz rozwiązania najczęstszych problemów.

Problem 1: Nie mogę połączyć integracji

Objawy:

• Błąd po wprowadzeniu klucza API
• Komunikat "Nieprawidłowy klucz API"
• Komunikat "Niewystarczające uprawnienia"

Możliwe przyczyny:

• Klucz API został skopiowany nieprawidłowo (np. ze spacjami)
• Klucz nie ma wymaganych uprawnień
• Klucz wygasł lub został usunięty w inFakt
• Konto inFakt jest nieaktywne

Rozwiązanie:

1. Sprawdź, czy skopiowałeś cały klucz API (bez dodatkowych spacji)
2. Wygeneruj nowy klucz API w inFakt z TYLKO tymi uprawnieniami:
   • api:invoices:write
   • api:invoices:read
3. Spróbuj ponownie połączyć w Lernavo
4. Jeśli problem się powtarza, skontaktuj się z pomocą inFakt: https://pomoc.infakt.pl/hc/pl

Problem 2: Faktura nie została wygenerowana

Objawy:

• Płatność jest pomyślna, ale brak faktury
• Status faktury to "Błąd"
• W zakładce "Faktura" brak informacji

Możliwe przyczyny:

• Integracja nie jest aktywna
• API inFakt jest tymczasowo niedostępne
• Brak skonfigurowanych danych firmy w inFakt
• Problem z danymi kupującego (np. nieprawidłowy format NIP)

Rozwiązanie:

1. Sprawdź status integracji w Ustawienia → Integracje
2. Upewnij się, że integracja jest "Połączona" (zielony wskaźnik)
3. Zaloguj się do inFakt i sprawdź, czy dane firmy są kompletne
4. Sprawdź szczegóły błędu w zakładce "Faktura" szczegółów płatności
5. Jeśli problem się powtarza, skontaktuj się z pomocą Lernavo: info@lernavo.com

Problem 3: Uczestnik nie otrzymał faktury e-mailem

Objawy:

• Faktura została wygenerowana (status "Utworzona")
• Uczestnik nie otrzymał e-maila z fakturą

Możliwe przyczyny:

• E-mail trafił do folderu SPAM
• Nieprawidłowy adres e-mail uczestnika
• Opóźnienie w dostarczeniu e-maila

Rozwiązanie:

1. Poproś uczestnika o sprawdzenie folderu SPAM/Wiadomości-śmieci
2. Sprawdź adres e-mail uczestnika w szczegółach płatności
3. Pobierz PDF faktury z panelu Lernavo i wyślij uczestnikowi ręcznie
4. Uczestnik może pobrać fakturę samodzielnie ze swojego panelu ("Moje zakupy")
5. Możesz ponownie wysłać fakturę z panelu inFakt

Problem 4: Błąd "Niewystarczające uprawnienia"

Objawy:

• Nie można połączyć integracji
• Komunikat: "Insufficient permissions" lub "Niewystarczające uprawnienia"

Przyczyna:

Klucz API nie ma wymaganych uprawnień do tworzenia i odczytywania faktur.

Rozwiązanie:

1. Zaloguj się do panelu inFakt
2. Przejdź do Ustawienia → Klucze API
3. Usuń stary klucz
4. Wygeneruj nowy klucz
5. WAŻNE: Zaznacz TYLKO te uprawnienia:
   • api:invoices:write
   • api:invoices:read
6. Skopiuj nowy klucz
7. Wróć do Lernavo Ustawienia → Integracje
8. Połącz ponownie z nowym kluczem

Problem 5: Chcę zmienić dane na fakturach

Scenariusz:

Zauważyłeś błąd w danych firmy (np. adres, NIP) które pojawiają się na fakturach.

Rozwiązanie:

1. Zaloguj się do panelu inFakt
2. Przejdź do ustawień danych firmy
3. Zaktualizuj dane
4. Zapisz zmiany

Gdzie szukać pomocy?

Aby w pełni wykorzystać integrację z inFakt i uniknąć problemów, zastosuj się do poniższych najlepszych praktyk.

Bezpieczeństwo klucza API

• Trzymaj klucz w tajemnicy - nigdy nie udostępniaj go nikomu
• Używaj tylko wymaganych uprawnień - zaznacz tylko api:invoices:write i api:invoices:read
• Regeneruj w razie wycieków - jeśli podejrzewasz, że klucz wyciekł, natychmiast wygeneruj nowy
• Regularnie sprawdzaj - co kilka miesięcy testuj, czy połączenie nadal działa

Zarządzanie danymi

• Aktualizuj dane firmy - regularnie sprawdzaj czy dane w inFakt są aktualne
• Weryfikuj stawki VAT - upewnij się, że stawki VAT są zgodne z obowiązującymi przepisami
• Archiwizuj faktury - pobieraj kopie ważnych faktur na własny dysk
• Regularne kopie zapasowe - inFakt robi to automatycznie, ale możesz także eksportować dane

Doświadczenie uczestników

• Profesjonalne dane - zadbaj o poprawność i kompletność danych firmy w inFakt
• Poprawne stawki VAT - sprawdź, jakie stawki VAT stosują się do Twoich kursów
• Monitoruj generowanie - regularnie sprawdzaj, czy faktury są tworzone bez problemów
• Szybka reakcja - jeśli uczestnik zgłosi brak faktury, zareaguj szybko

Monitorowanie

• Sprawdzaj status - co tydzień przeglądaj listę płatności i statusy faktur
• Reaguj na błędy - jeśli zobaczysz faktury ze statusem "Błąd", natychmiast sprawdź przyczynę
• Panel inFakt - regularnie loguj się do inFakt i sprawdzaj statystyki
• Śledzenie dostarczalności - monitoruj, czy e-maile z fakturami są dostarczane

Jak długo trwa generowanie faktury?

Faktury są generowane asynchronicznie w tle. W większości przypadków proces zajmuje 1-2 minuty od momentu udanej płatności. W rzadkich przypadkach (np. przy dużym obciążeniu API) może to potrwać dłużej.

Czy mogę edytować wygenerowane faktury?

Tak, ale nie w Lernavo. Pełne zarządzanie fakturami (edycja, korekty, anulowanie) odbywa się w panelu inFakt. Możesz otworzyć panel bezpośrednio logując się na https://konto.infakt.pl/zaloguj.

Co z fakturami dla firm (z NIPem)?

System automatycznie rozpoznaje typ kupującego na podstawie danych z formularza zakupowego. Jeśli uczestnik poda NIP podczas zakupu, faktura zostanie wystawiona jako faktura dla firmy. Jeśli nie poda NIP, faktura będzie wystawiona dla osoby fizycznej.

Czy mogę używać własnych szablonów faktur?

Wygląd faktur jest określony przez inFakt i ich standardowe szablony. Można dostosować ich wygląd w ustawieniach inFakt. Szczegóły znajdziesz w dokumentacji inFakt: https://pomoc.infakt.pl/hc/pl.

Czy mogę rozłączyć i ponownie połączyć integrację?

Tak, możesz w dowolnym momencie rozłączyć integrację klikając przełącznik na karcie inFakt w Ustawienia → Integracje. Po rozłączeniu:

• Nowe faktury NIE będą generowane automatycznie
• Wszystkie stare faktury pozostają dostępne w Lernavo i inFakt
• Możesz ponownie połączyć integrację w dowolnym momencie używając tego samego lub nowego klucza API

Czy faktury są dostępne dla uczestników?

Tak, każdy uczestnik ma dostęp do swoich faktur:

• Otrzymuje fakturę PDF na e-mail zaraz po zakupie
• Może pobrać fakturę ze swojego panelu w sekcji "Historia zamówień" w dowolnym momencie
• Może ją wydrukować lub zapisać na swoim komputerze

Jak zmienić dane na już wystawionych fakturach?

Już wystawionych faktur nie można bezpośrednio edytować - to wymóg prawny. Jeśli musisz poprawić fakturę:

1. Zaloguj się do panelu inFakt
2. Znajdź fakturę do poprawy
3. Wystaw fakturę korygującą zgodnie z procedurą inFakt
4. Szczegóły w dokumentacji: https://pomoc.infakt.pl/hc/pl