KSeF a magazyn e-faktur — jak archiwizować, wyszukiwać i kontrolować faktury w systemie ERP
Od lipca 2026 KSeF stanie się obowiązkowy dla większości firm w Polsce. To nie tylko "wysyłanie faktur do urzędu" — to fundamentalna zmiana w obiegu dokumentów. Każda faktura musi być przechowana w KSeF przez 10 lat, a Ty musisz mieć do niej dostęp 24/7. Ręczne pobieranie PDF z KSeF i zapisywanie na dysku to droga donikąd. W tym artykule pokażę Ci, jak zbudować magazyn e-faktur w Odoo ERP, który automatycznie pobiera faktury z KSeF, indeksuje je, umożliwia wyszukiwanie i kontrolę, a także integruje się z obiegiem faktur zakupowych.
Czym jest magazyn e-faktur?
Magazyn e-faktur to system, który:
- Przechowuje wszystkie faktury z KSeF (sprzedaż i zakup)
- Umożliwia wyszukiwanie po dowolnym kryterium (NIP, data, kwota, kontrahent)
- Zapewnia dostęp 24/7 przez 10 lat (wymóg prawny)
- Integruje się z księgowością i ERP
- Umożliwia eksport dla audytu i kontroli skarbowej
Bez magazynu: ręczne pobieranie PDF z KSeF, zapisywanie na dysku, chaos w nazwach plików, brak wyszukiwania, ryzyko utraty danych.
Z magazynem w Odoo: automatyczne pobieranie, indeksowanie, wyszukiwanie w 1 klik, pełna integracja z księgą.
Wymagania prawne KSeF
Ustawa o KSeF nakłada obowiązki:
KSeF zapewnia przechowywanie, ale Ty musisz mieć własny magazyn na wypadek awarii KSeF i dla wygody pracy.
Architektura magazynu w ERP
Magazyn e-faktur w Odoo składa się z:
1. Vendor Bill Model (faktury zakupowe)
- Standardowy model Odoo do faktur zakupowych
- Pola: NIP dostawcy, data, kwota, numer faktury
- Załącznik: PDF z KSeF
- Status: do akceptacji, zaksięgowana
2. Customer Invoice Model (faktury sprzedażowe)
- Faktury wysłane do KSeF
- KSeF ID (numer z KSeF)
- Timestamp wysłania
- Status KSeF (accepted, rejected)
3. KSeF Archive Model (magazyn)
- Wszystkie faktury (sprzedaż i zakup) w jednym miejscu
- Pełne metadane z KSeF
- Linki do PDF i XML
- Historia pobrania z KSeF
Automatyczne pobieranie z KSeF
KSeF API umożliwia pobieranie faktur:
Faktury sprzedażowe
Wysyłasz fakturę do KSeF → otrzymujesz KSeF ID → zapisujesz w Odoo.
Faktury zakupowe
Codzienny job pobiera faktury z KSeF:
- Połacz z KSeF API (token z e-Urząd Skarbowy)
- Pobierz listę faktur dla Twojego NIP
- Dla każdej faktury: pobierz PDF i XML
- Zapisz w Odoo jako Vendor Bill
- Powiadom księgową o nowej fakturze
W Odoo możesz to zautomatyzować przez:
- Scheduled Action (cron) — codzienne pobieranie
- n8n webhook — real-time powiadomienia
- Python script — custom integracja
Indeksowanie i wyszukiwanie
Kluczowa funkcja magazynu: szybkie wyszukiwanie.
Indeksowane pola
- NIP kontrahenta
- Numer faktury
- Data wystawienia
- Data sprzedaży
- Kwota netto/brutto
- Kwota VAT
- Kontrahent (nazwa)
- KSeF ID
- Treść faktury (OCR z PDF)
Przykłady wyszukiwania
- "Pokaż wszystkie faktury od NIP 1234567890"
- "Faktury z marca 2026 powyżej 10 000 zł"
- "Wyszukaj fakturę nr FV/2026/03/123"
- "Pokaż faktury z słowem 'konsulting' w treści"
Odoo ma wbudowane wyszukiwanie full-text, które działa na wszystkich polach i załącznikach (po OCR).
Kontrola i audit
Podczas kontroli skarbowej musisz udostępnić faktury. Magazyn w Odoo ułatwia to:
Raporty dla kontroli
- Eksport wszystkich faktur z okresu (PDF + XML)
- Raport VAT-7 z podsumowaniem
- Rejestr sprzedaży i zakupów
- Lista kontrahentów z obrotami
Audit Trail
- Kto i kiedy pobrał fakturę z KSeF
- Kto i kiedy zmodyfikował księgowanie
- Historia statusów faktury
- Logi integracji z KSeF
W Odoo możesz włączyć tracking zmian na modelu faktur — każda modyfikacja jest logowana.
Integracja z obiegiem faktur
Magazyn e-faktur to nie tylko archiwum — to początek procesu księgowego.
Workflow faktury zakupowej
- Pobranie z KSeF: Automatyczne, codziennie
- Weryfikacja: Czy faktura zgadza się z zamówieniem?
- Akceptacja: Manager zatwierdza
- Księgowanie: Księgowa przypisuje konta
- Płatność: Harmonogram płatności
Automatyzacje
- Match faktury do zamówienia (3-way match)
- Powiadomienie o fakturze powyżej X zł
- Eskalacja, jeśli brak akceptacji po 3 dniach
- Automatyczne księgowanie dla powtarzających się faktur
Wdrożenie krok po kroku
Krok 1: Konfiguracja KSeF w Odoo (1 dzień)
- Uzyskaj token do KSeF API (e-Urząd Skarbowy)
- Skonfiguruj połączenie w Odoo
- Przetestuj wysyłkę faktury
Krok 2: Stworzenie modelu magazynu (2-3 dni)
- Stwórz model KSeF Archive
- Skonfiguruj pola i indeksy
- Podłącz do istniejących faktur
Krok 3: Automatyczne pobieranie (2 dni)
- Napisz skrypt pobierający z KSeF
- Skonfiguruj cron (codziennie o 6:00)
- Testuj na fakturach z ostatnich 30 dni
Krok 4: Wyszukiwanie i raporty (2 dni)
- Skonfiguruj widoki wyszukiwania
- Stwórz raporty dla kontroli
- Przetestuj eksport PDF/XML
Krok 5: Integracja z obiegiem (3-5 dni)
- Skonfiguruj workflow akceptacji
- Ustaw powiadomienia
- Przeszkól zespół
Podsumowanie
Magazyn e-faktur w Odoo ERP to nie opcja — to konieczność w erze KSeF. Korzyści:
- ✅ Automatyczne pobieranie faktur z KSeF
- ✅ Centralne archiwum z dostępem 24/7
- ✅ Szybkie wyszukiwanie po dowolnym kryterium
- ✅ Pełna integracja z księgowością
- ✅ Gotowość na kontrolę skarbową
Nie czekaj na lipiec 2026 — wdróż magazyn teraz, przetestuj i miej spokój przed obowiązkowym KSeF.
FAQ
Tak, KSeF przechowuje faktury przez 10 lat. Ale musisz mieć własny magazyn na wypadek awarii KSeF i dla wygody pracy (wyszukiwanie, integracja z ERP).
Zalecamy codzienne pobieranie (np. o 6:00 rano). Możesz też pobierać w czasie rzeczywistym przez webhook, jeśli KSeF udostępnia taką funkcję.
KSeF wymaga formatu FA(2) XML. Dla wygody pracy warto przechowywać też PDF (generowany z XML). Odoo może przechowywać oba formaty.
Dlatego musisz mieć własny magazyn! Podczas kontroli udostępniasz faktury z swojego systemu, nie z KSeF. KSeF to źródło, ale nie jedyne miejsce przechowywania.
Potrzebujesz pomocy z KSeF i Odoo?
Wdrożymy magazyn e-faktur, zautomatyzujemy pobieranie i przygotujemy Cię na kontrolę.
Darmowa konsultacja