ksef-invoice
Skill1 starsChanged 7 days agoMITView on GitHub
Wystawia, waliduje, odczytuje i koryguje e-faktury KSeF (FA(3) XML) - faktury VAT, korekty, zaliczki i rozliczenia - zgodnie ze schematem XSD. Użyj przy e-fakturze, KSeF, korekcie, zaliczce lub odrzuconym pliku XML.
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- ksefuj/skillstheir own version, first seen Oct 20, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- ksefuj/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository7 other files it gives its agents.
- angular-conventionsSkill
- appstore-payouts-to-excelSkill
- clean-git-summarySkill
- conventional-commitSkill
- create-commitSkill
- invoice-processingSkill
- xlsx-toolkitSkill
The file
Files
KSeF Invoice (FA(3))
Skrypt: python scripts/ksef_fa3.py build|validate|read|correct ... (względem katalogu skilla). Wymaga pip install lxml. Schemat XSD FA(3) w wersji 1-0E jest wbudowany w xsd/1-0E/ (sieć z crd.gov.pl tylko jako fallback). Odpowiadaj po polsku, chyba że użytkownik pisze w innym języku.
Dane sprzedawcy: jeśli w katalogu roboczym jest ksef-firma.json, weź z niego seller i iban. Jeśli nie ma, zapytaj raz i zaproponuj zapisanie. Numer faktury: zaproponuj kolejny na podstawie plików XML w folderze (read), poproś o potwierdzenie.
Wybierz type (przykłady w examples/<type>.json):
invoice(VAT): zwykła faktura,lines[].correction(KOR): korekta zwykłej faktury,corrects{number, issue_date, ksef_number},lines_before(stan przed),lines(stan po,[]= korekta do zera),reason,correction_effect(1 w dacie pierwotnej, 2 w dacie korekty - domyślnie, 3 inna). Dla faktury z KSeF użyjksef_fa3.py correct ORYGINAL.xml ZMIANY.json OUT.xml.advance(ZAL): zaliczka,order_lines(całe zamówienie),paid(otrzymana kwota brutto),paid_date. Skrypt sam dzieli wpłatę na stawki VAT.final(ROZ): rozliczenie po zaliczkach,lines(całe zamówienie),advances[]{number, ksef_number, by_rate}.by_rateweź zreadkażdej zaliczki XML.kor_zal(KOR_ZAL): korekta zaliczki, szkielet jakcorrection(correctswskazuje korygowaną zaliczkę,lines_before,lines).kor_roz(KOR_ROZ): korekta faktury rozliczającej, szkielet jakcorrectionplusadvances[]{number, ksef_number} (FakturaZaliczkowa).
Pola wspólne: seller {name, tax_id, address.line1/line2}; buyer (PL NIP, UE country+VAT, inny country+ID, osoba prywatna: bez tax_id); podmiot3[] lub recipient {name, tax_id lub id_wew, address, role: odbiorca (2), jst (8 - ustawia JST=1 w Podmiot2), gv (10 - ustawia GV=1 w Podmiot2) lub 1..11}; lines[] {description, qty, unit, unit_net lub net, vat_rate: 23 8 5 0 KR 0 WDT 0 EX zw np I np II oo, opcjonalnie gtu: GTU_01..GTU_13 (FaWiersz/GTU, w zaliczce ZamowienieWiersz/GTUZ)}; opcjonalnie sale_date, due_date, iban, place, currency+fx_rate, exemption_basis (wymagane dla zw), split_payment, cash_method, self_billing.
Kroki:
- Uzupełnij JSON. Dopytaj o brakujące dane - nigdy nie zmyślaj NIP, numeru, daty, kwoty ani numeru KSeF.
- Zbuduj XML:
ksef_fa3.py build invoice.json FV-1-11-2026.xmlalbo skoryguj oryginał z KSeF:ksef_fa3.py correct FV-1-11-2026.xml zmiany.json FVK-1-11-2026.xml. - Pokaż: typ, numer, nabywcę, netto/VAT/brutto wg stawek (ujemne przy korekcie zmniejszającej), ścieżkę pliku oraz następny krok: wysyłka XML w Aplikacji Podatnika KSeF lub programie księgowym.
Walidacja (plik, katalog lub glob): ksef_fa3.py validate sciezka [--csv raport.csv] - lokalny XSD, sumy względem pozycji, VAT, P_15, NIP, referencje korekt i zaliczek. Wyjaśnij każdy błąd prostym językiem wraz z poprawką.
Odczyt: ksef_fa3.py read plik.xml -> JSON. Przy wielu plikach eksportuj ze skillami invoice-processing i xlsx-toolkit.
Zasady bezwzględne:
- Nieobsługiwane: procedura marży, nowe środki transportu, załączniki. Poinformuj o tym wprost.
- Nigdy nie wysyłaj plików do KSeF, nie proś o token ani certyfikat KSeF.
- Stawka VAT, podstawa zwolnienia, odwrotne obciążenie, kody GTU i data ujęcia korekty to decyzja podatnika lub księgowego - sygnalizuj wątpliwości, nie decyduj za użytkownika.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

