菜单
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".
用 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.
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.
Generuje miesięczną deklarację VAT JPK_V7M (Jednolity Plik Kontrolny) jako XML z faktur z rejestru SQLite. Użyj gdy user prosi "wygeneruj JPK", "JPK za marzec", "deklaracja VAT za miesiąc", "przygotuj JPK_V7M", "rozliczenie VAT do urzędu".
| name | doctor |
| description | 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". |
Waliduje .env i obecność plików (certyfikaty, klucze) przed wysyłką do KSeF/MF. Nie dotyka sieci.
# Raport tekstowy
python3 skills/doctor/scripts/check.py
# Format JSON
python3 skills/doctor/scripts/check.py --format json
# Exit code != 0 gdy są błędy (do CI)
python3 skills/doctor/scripts/check.py --fail-on-error
[SELLER] — dane sprzedawcy z .env:
SELLER_NIP (z walidacją sumy kontrolnej)SELLER_NAME, SELLER_ADDRESS, SELLER_BANK_ACCOUNT/NAMESELLER_EMAIL, SELLER_FIRST_NAME/LAST_NAME, SELLER_BIRTH_DATE, SELLER_TAX_OFFICE_CODE (dla JPK)[KSEF]:
KSEF_ENV (test/demo/prod), pochodny URL APIKSEF_NIP + KSEF_TOKEN[MF] (bramka JPK):
MF_ENV (test/prod), pochodny URLMF_PESEL (z walidacją), MF_CERT_PATH/MF_CERT_URL[SMTP] — wysyłka email (opcjonalne):
SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD[OCR] — provider i klucze:
OCR_PROVIDER (auto/ollama/claude), ANTHROPIC_API_KEY jeśli claudeJeśli wszystko OK → możesz ruszać z wysyłkami:
# Dry-run na sandboxie KSeF
python3 skills/ksef/scripts/submit.py --dry-run --invoice-file faktury/A1.xml
# Dry-run JPK (sandbox MF)
python3 skills/jpk-submit/scripts/submit.py --dry-run data/jpk/JPK_V7M_04_2026.xml