메뉴
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.