📥 KSeF Incoming
Moduł odbierania faktur zakupowych z Krajowego Systemu e-Faktur
Wersja 18.2.0 dla Odoo 18
📋 Spis treści
1. Wymagania wstępne
ℹ️ Przed instalacją upewnij się, że:
- Masz zainstalowany moduł KSeF 2 Integration (ksef_2_patched)
- Masz skonfigurowane tokeny dostępu do KSeF w ustawieniach firmy
- Posiadasz aktywną sesję w Krajowym Systemie e-Faktur
Zależności modułu:
- account - moduł księgowości Odoo
- mail - moduł poczty Odoo
- ksef_2_patched - moduł KSeF 2 Integration
2. Instalacja modułu
1 Skopiuj moduł do katalogu addons
Rozpakuj archiwum ksef_incoming.zip do katalogu z dodatkami Odoo (np. /mnt/extra-addons/)
2 Zaktualizuj listę aplikacji
Przejdź do: Aplikacje → Zaktualizuj listę aplikacji
3 Zainstaluj moduł
Wyszukaj "KSeF Incoming" i kliknij Zainstaluj
3. Konfiguracja
3.1 Konfiguracja firmy
Przejdź do: Ustawienia → Użytkownicy i firmy → Firmy
Otwórz swoją firmę i znajdź zakładkę "KSeF Incoming":
| Pole | Opis | Zalecane ustawienie |
| Auto-fetch KSeF Invoices | Włącza automatyczne pobieranie faktur (wymaga dodania cron ręcznie) | Według potrzeb |
| Auto-create Vendors | Automatycznie tworzy kartoteki dostawców dla nieznanych NIP | ✅ Włączone |
| Default Purchase Journal | Domyślny dziennik dla tworzonych faktur zakupowych | Wybierz dziennik zakupów |
| Last KSeF Fetch | Data ostatniego pobierania (tylko odczyt) | - |
⚠️ Ważne! Upewnij się, że w zakładce "KSeF" (z modułu ksef_2_patched) masz skonfigurowane:
- KSeF Environment (środowisko: Test/Demo/Produkcja)
- KSeF Context Identifier (NIP firmy)
- KSeF Access Token (token dostępu)
- KSeF Refresh Token (token odświeżania)
4. Pobieranie faktur z KSeF
4.1 Ręczne pobieranie
1 Przejdź do listy faktur przychodzących
Księgowość → KSeF Incoming → Incoming Invoices
2 Uruchom pobieranie
Kliknij przycisk "Fetch from KSeF" w menu akcji (⚙️) lub na górnym pasku
3 Poczekaj na zakończenie
System pobierze nowe faktury z KSeF i wyświetli powiadomienie z liczbą pobranych dokumentów
✅ Co się dzieje podczas pobierania:
- System otwiera sesję z KSeF
- Pobiera listę faktur, gdzie Twoja firma jest nabywcą
- Dla każdej faktury pobiera pełny XML
- Parsuje dane i tworzy rekordy w Odoo
- Automatycznie próbuje dopasować dostawców po NIP
- Zamyka sesję KSeF
4.2 Automatyczne pobieranie (opcjonalne)
Aby skonfigurować automatyczne pobieranie, dodaj zaplanowane działanie:
Ustawienia → Techniczne → Automatyzacja → Zaplanowane działania
- Model: ksef.incoming.invoice
- Metoda: cron_fetch_incoming_invoices
- Interwał: według potrzeb (np. co 4 godziny)
5. Przetwarzanie faktur
5.1 Widok listy
Lista faktur przychodzących zawiera następujące informacje:
- Nazwa - numer faktury i numer KSeF
- Numer KSeF - unikalny identyfikator w systemie KSeF
- Numer faktury - oryginalny numer faktury od dostawcy
- Data faktury - data wystawienia
- Nazwa sprzedawcy - nazwa dostawcy
- NIP sprzedawcy - numer NIP dostawcy
- Kwota - wartość brutto faktury
- Dostawca - dopasowany partner w Odoo
- Status - aktualny status przetwarzania
- Faktura zakupowa - link do utworzonej faktury
5.2 Widok formularza
Formularz szczegółowy zawiera dodatkowe informacje:
- Pełne dane sprzedawcy i nabywcy
- Data rejestracji w KSeF
- Załączony plik XML z KSeF
- Ewentualne komunikaty błędów
6. Statusy faktur
| Status | Znaczenie | Wymagane działanie |
| New | Nowa faktura, dostawca nie został dopasowany | Ręcznie przypisz dostawcę lub utwórz nowego |
| Matched | Dostawca został automatycznie dopasowany po NIP | Zweryfikuj dopasowanie i utwórz fakturę zakupową |
| Imported | Faktura zakupowa została utworzona w Odoo | Brak - proces zakończony |
| Error | Wystąpił błąd podczas przetwarzania | Sprawdź komunikat błędu i napraw problem |
7. Tworzenie faktur zakupowych
1 Otwórz fakturę KSeF
Kliknij na wybraną fakturę w liście, aby otworzyć formularz szczegółowy
2 Sprawdź dostawcę
Upewnij się, że pole "Vendor" jest wypełnione. Jeśli nie, wybierz lub utwórz dostawcę
3 Utwórz fakturę zakupową
Kliknij przycisk "Create Vendor Bill"
4 Zweryfikuj i zatwierdź
System otworzy utworzoną fakturę zakupową. Sprawdź dane, uzupełnij konta i zatwierdź
ℹ️ Automatyczne uzupełnianie:
- Linie faktury są tworzone na podstawie danych z XML
- Oryginalny plik XML jest załączany do faktury zakupowej
- Numer referencyjny zawiera oryginalny numer faktury
8. Często zadawane pytania
❓ Dlaczego nie widzę żadnych faktur po pobraniu?
Możliwe przyczyny:
- Brak nowych faktur w KSeF od ostatniego pobierania
- Nieprawidłowe tokeny dostępu - sprawdź konfigurację KSeF
- Faktury już zostały wcześniej pobrane (sprawdź wszystkie statusy)
❓ Dostawca nie został automatycznie dopasowany. Dlaczego?
Automatyczne dopasowanie działa po NIP. Sprawdź czy:
- Dostawca istnieje w systemie z poprawnym NIP
- NIP jest w formacie z prefiksem PL lub bez
- W polu VAT nie ma literówek ani spacji
❓ Jak włączyć automatyczne tworzenie dostawców?
Przejdź do konfiguracji firmy i włącz opcję "Auto-create Vendors" w zakładce KSeF Incoming.
❓ Czy mogę pobrać faktury z określonego okresu?
Obecnie moduł pobiera faktury od daty ostatniego pobierania. Dla pierwszego pobierania sięga 30 dni wstecz.
❓ Co się stanie jeśli faktura już istnieje?
System sprawdza duplikaty po numerze KSeF - ta sama faktura nie zostanie pobrana dwukrotnie.
📥
Automatyczne pobieranie
Faktury są pobierane bezpośrednio z KSeF
🔍
Dopasowanie NIP
Automatyczne rozpoznawanie dostawców📄
Parsowanie XML
Ekstrakcja danych z e-Faktur💼
Integracja z księgowością
Tworzenie faktur zakupowych
KSeF Incoming Invoices - Moduł dla Odoo 18
Autor: Marius Johannes Kuc | www.odoo.com.pl/ksef_inkoming
Odoo Community © 2025 - Wszelkie prawa zastrzeżone
