📥 KSeF Incoming

Moduł odbierania faktur zakupowych z Krajowego Systemu e-Faktur

Wersja 18.4.17 dla Odoo 18

Nowości w wersji 18.4.17

• Termin płatności na fakturach przychodzących — moduł odczytuje termin z e-faktury KSeF (FA3) i przenosi go na fakturę zakupu w Odoo. Nowe filtry na liście: po terminie, termin do 7 dni, bez terminu.
• Odporne pobieranie — faktury, których pliku nie udało się pobrać za pierwszym razem (limit zapytań KSeF), są automatycznie uzupełniane przy kolejnym pobraniu. Żadna faktura nie ginie.
• Uzupełnienie terminów wstecz — jednorazowa akcja dodaje termin płatności do faktur zaimportowanych przed tą aktualizacją.

📋 Spis treści

• 1. Wymagania wstępne
• 2. Instalacja modułu
• 3. Konfiguracja
• 4. Pobieranie faktur z KSeF
• 5. Przetwarzanie faktur
• 6. Statusy faktur
• 7. Tworzenie faktur zakupowych
• 8. Często zadawane pytania

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":

⚠️ 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:

1. System otwiera sesję z KSeF
2. Pobiera listę faktur, gdzie Twoja firma jest nabywcą
3. Dla każdej faktury pobiera pełny XML
4. Parsuje dane i tworzy rekordy w Odoo
5. Automatycznie próbuje dopasować dostawców po NIP
6. 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

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