Funkcje
Przegląd możliwości walidacji offline KSeF Guard
Walidacja XSD
Weryfikacja struktury XML względem oficjalnego schematu FA(3) Ministerstwa Finansów. Wykorzystuje silnik libxml2 — standardowy silnik walidacji XML. Precyzyjne komunikaty błędów ze wskazaniem dokładnej lokalizacji w pliku XML.
128 Reguł walidacji
Reguły merytoryczne oparte na art. 106e ustawy o VAT, rozporządzeniu MF oraz oficjalnej broszurze informacyjnej FA(3). 71 obowiązkowych, reszta to najlepsze praktyki, heurystyczne, bezpieczeństwo, wsadowe i wywnioskowane. Każda reguła zawiera dwujęzyczny opis problemu/rozwiązania i cytaty źródłowe weryfikowane SHA-256.
Brak kursu waluty dla faktury w walucie obcej
Exchange rate missing for foreign currency invoice
Faktura wystawiona w walucie obcej zawiera kwoty VAT w walucie obcej (P_14_*W), ale brakuje kursu przeliczeniowego. Wymagane jest wskazanie kursu w polu KursWalutyZ (globalny kurs faktury) lub KursWaluty (kurs per wiersz).
Uzupełnij kurs waluty w polu KursWalutyZ (kurs globalny dla całej faktury) lub KursWaluty (kurs per wiersz). Kurs powinien odpowiadać wymogom Art. 31a — średni kurs NBP z ostatniego dnia roboczego przed dniem powstania obowiązku podatkowego.
„Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w dziale VI ustawy. W przypadku, gdy kwoty stosowane do określenia podstawy opodatkowania są określone w walucie obcej, podaje się kurs waluty właściwy dla danego wiersza faktury.”
5 formatów eksportu
Text i Summary (Free). CSV, JSON i PDF (Standard+). PDF zawiera cytaty prawne, ocenę ryzyka i źródła. Wszystkie formaty dwujęzyczne — polski i angielski.
| # | Status | Plik | Błędy | Ostrz. | XSD | Risk | Str. |
|---|---|---|---|---|---|---|---|
| 1 | FAIL | FA_2026_01_0201.xml | 1 | 1 | 0 | 25 | 1 |
| 2 | FAIL | FA_2026_02_0042.xml | 3 | 1 | 0 | 65 | 2 |
| 3 | FAIL | FA_2026_02_0099.xml | 1 | 1 | 0 | 25 | 4 |
| 4 | FAIL | FA_2026_02_0187.xml | 2 | 1 | 0 | 25 | 6 |
| 5 | PASS | FA_2026_03_0001.xml | 0 | 0 | 0 | 0 | 7 |
| 6 | FAIL | FA_2026_03_0156.xml | 2 | 0 | 1 | 40 | 9 |
| file_name | file_status | risk_score | violation_type | code | severity | classification |
|---|---|---|---|---|---|---|
| FA_2026_01_0201.xml | FAIL | 25 | RULE | KSEF-BUS-044 | error | GOV_MANDATED |
| FA_2026_02_0042.xml | FAIL | 65 | RULE | KSEF-BUS-003 | error | GOV_MANDATED |
| FA_2026_02_0099.xml | FAIL | 25 | RULE | KSEF-BUS-030 | error | GOV_MANDATED |
| FA_2026_02_0187.xml | FAIL | 25 | RULE | KSEF-BUS-006 | error | GOV_MANDATED |
| FA_2026_03_0001.xml | PASS | 0 | - | - | - | - |
| FA_2026_03_0156.xml | FAIL | 40 | XSD | FA3-XSD-E001 | error | - |
Operacje wsadowe
Przetwarzanie do 5000 plików dziennie (Standard) lub bez limitu (Pro). Rekurencyjne skanowanie folderów z regułami krzyżowymi: duplikaty numerów, niespójności NIP i problemy z chronologią. Plan Free: 10 plików/dzień.
Profile konfiguracji
Trzy wbudowane presety: essential (tylko reguły obowiązkowe), recommended (zbalansowany) i maximum (wszystkie reguły, ostrzeżenia promowane do błędów). Nadpisywanie reguł przez .ksef-guard.yml (Pro).
# Place in project root or ~/.config/ksef-guard/
# CLI auto-discovers: walks up from cwd → user config dir
preset: recommended # essential | recommended | maximum
rules: # per-rule: "error" | "warning" | "off"
KSEF-BUS-140: "off" # disable zero-amount heuristic
KSEF-BUS-193: "warning" # demote to warning
KSEF-BUS-044: "error" # enforce line arithmetic
z rejestru
preset:
rules:
--preset
--disable-rule
Integracja CI/CD
Jeden plik binarny, zero zależności — pobierz, uruchom, gotowe. Zawiera gotowe szablony GitHub Actions i GitLab CI. Automatycznie wykrywa .ksef-guard.yml w repozytorium. Kody wyjścia rozróżniają błędy XSD od naruszeń reguł biznesowych.
on: [push, pull_request]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Download ksef-guard
run: |
curl -fsSL -o kg.tar.gz
ksefguard.pl/dl/linux-amd64.tar.gz
tar xzf kg.tar.gz
- name: Validate invoices
run: |
./ksef-guard validate
--preset maximum
--output results.txt
./invoices/
- uses: actions/upload-artifact@v4
if: always()
with:
name: ksef-results
path: results.txt
White-label PDF
Raporty PDF z własnym logo i nagłówkiem firmy (Pro). Branding KSeF Guard ukryty — idealne do przekazywania klientom i audytorom.
Historia sesji
Automatyczne zapisywanie wyników walidacji (wszystkie plany; Free przechowuje ostatnie 5 sesji, Standard 25, Pro 100). Przeglądaj poprzednie sesje, śledź wskaźniki i powtarzające się naruszenia, przywracaj pełne wyniki jednym kliknięciem.
Przestań zgadywać. Zacznij walidować.
Za darmo do 10 faktur dziennie. Bez rejestracji. Dane faktur zostają na Twoim komputerze.
Pobierz za darmo