菜单
Wystawia fakturę VAT dla JDG — generuje DOCX (do wysyłki/druku) i XML FA(3) (do KSeF), zapisuje do rejestru SQLite i zwraca numer faktury + ścieżki plików. Użyj gdy user prosi o "wystaw fakturę", "wygeneruj fakturę", "fakturę dla...", "faktura za usługę/konsultację/miesiąc".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generowanie pliku JPK_V7M (Jednolity Plik Kontrolny — deklaracja VAT) za miesiac
Wyslka faktury XML FA(3) do Krajowego Systemu e-Faktur (KSeF)
Synchronizuje terminy podatkowe JDG (ryczałt, ZUS, VAT+JPK) i przypomnienia o fakturach — z kwotami — do dedykowanego kalendarza Google "JDG Podatki". Idempotentne (tworzy/aktualizuje/usuwa). Użyj gdy user mówi "synchronizuj kalendarz", "dodaj terminy do kalendarza", "wrzuć podatki do Google Calendar", "przypomnienia w kalendarzu", "kalendarz podatkowy", lub gdy pyta czemu nie widzi terminów/kwot w kalendarzu.
Preflight-check konfiguracji JDG przed wysyłką faktur / JPK do sandboxów. Sprawdza dane sprzedawcy, KSeF, bramkę MF, SMTP, OCR, Google Calendar. Użyj gdy user pyta "czy wszystko skonfigurowane", "diagnostyka", "preflight", "co mam brak", "czy działa konfiguracja", "audyt setupu".
Generowanie faktur VAT — DOCX do wyslki/druku + XML FA(3) dla KSeF
Dodaje fakturę zakupu (koszt) do rejestru SQLite — zapisuje sprzedawcę, NIP, kwoty, kategorię, datę wpływu. Obsługuje wprowadzanie ręczne ORAZ OCR z pliku (PDF/JPG/PNG) przez lokalny Pixtral 12B z fallbackiem na Claude Haiku 4.5. Na ryczałcie koszty NIE pomniejszają podatku, ale VAT naliczony idzie do JPK_V7M jako odliczalny. Użyj gdy user mówi "dodaj fakturę zakupu", "zarejestruj koszt", "wprowadź wydatek", "kupiłem laptopa za...", "fakturę za hosting/SaaS/internet/paliwo", "dorzuć fakturę kosztową", "zeskanuj fakturę", "wczytaj PDF-a z fakturą", lub gdy user przesyła plik faktury.
| name | invoice |
| description | Wystawia fakturę VAT dla JDG — generuje DOCX (do wysyłki/druku) i XML FA(3) (do KSeF), zapisuje do rejestru SQLite i zwraca numer faktury + ścieżki plików. Użyj gdy user prosi o "wystaw fakturę", "wygeneruj fakturę", "fakturę dla...", "faktura za usługę/konsultację/miesiąc". |
Generuje fakturę w dwóch formatach jednocześnie:
DOCX — do wysyłki mailem lub drukuXML FA(3) — wymagany format KSeF (obowiązkowy od 1.04.2026)Zapisuje rekord do data/registry.sqlite i pliki do data/faktury/YYYY/MM/.
Zanim odpalisz skrypt, upewnij się że masz:
Opcjonalnie: buyer-address, buyer-email, description, period (DD.MM.YYYY-DD.MM.YYYY).
Jeśli czegoś brakuje — dopytaj usera, nie zgaduj.
python3 skills/invoice/scripts/generate.py \
--buyer-name "Firma ABC Sp. z o.o." \
--buyer-nip "1234567890" \
--buyer-address "ul. Przykladowa 1, 00-001 Warszawa" \
--description "Konsultacja w zakresie AI i automatyzacji" \
--netto 10500 \
--period "01.04.2026-30.04.2026"
Skrypt zwraca JSON na stdout:
{
"number": "A1/04/2026",
"netto": "10500.00",
"vat": "2415.00",
"brutto": "12915.00",
"docx_path": "data/faktury/2026/04/faktura_A1_04_2026.docx",
"xml_path": "data/faktury/2026/04/faktura_A1_04_2026.xml",
"payment_due": "2026-05-01",
"status": "generated"
}
Pokaż userowi numer faktury, kwotę brutto, termin płatności i ścieżki plików (jako klikalne markdown linki).
Jeśli user chce od razu wysłać do KSeF — użyj skilla ksef, przekazując xml_path zwrócone tutaj.
Skrypt sam czyta dane sprzedawcy: SELLER_NAME, SELLER_NIP, SELLER_ADDRESS, SELLER_BANK_ACCOUNT, SELLER_BANK_NAME. Jeśli skrypt zwróci błąd o braku zmiennej — powiedz userowi że trzeba uzupełnić .env.