Contracts

Skill dithiothreitol/jdg-ksiegowy/.claude/skills/contracts

AI Asystent Księgowy dla JDG (Polska) — faktury, KSeF 2.0, JPK_V7M/EWP, ZUS, ryczałt. OpenClaw + Ollama + Claude.

Install

npx -y skills add dithiothreitol/jdg-ksiegowy --skill contracts

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Cykliczne kontrakty JDG — automatyczne wystawianie faktur miesięcznych, oznaczanie płatności, import CSV z banku. Użyj gdy user pyta "faktury automatyczne", "kontrakt cykliczny", "auto-fakturowanie", "subskrypcja klienta", "powtarzające się faktury", "oznacz jako zapłacone", "import wyciągu", "CSV bank", "które faktury nie zostały zapłacone".

SKILL.md

2.3 KB, as published. Nobody here has run it

Cykliczne kontrakty + śledzenie płatności

1. Auto-fakturowanie

# Uruchom na dziś (z crona lub ręcznie)
python3 skills/contracts/scripts/run_contracts.py

# Symulacja na konkretny dzień
python3 skills/contracts/scripts/run_contracts.py --date 2026-04-30

2. Oznacz fakturę jako zapłaconą

python3 skills/contracts/scripts/mark_paid.py "A1/04/2026"
python3 skills/contracts/scripts/mark_paid.py "A1/04/2026" --date 2026-04-25

3. Import CSV z banku

# Podgląd dopasowań (bez zapisu)
python3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv

# Automatyczne oznaczenie zapłaconych po dopasowaniu
python3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv --auto-mark

Obsługiwane formaty CSV:

mBank: nagłówek #Data operacji;Opis operacji;...;Kwota;Waluta
Generyczny: date/data, amount/kwota, description/opis

4. Dodawanie kontraktu (Python API)

from jdg_ksiegowy.registry.db import ContractRecord, save_contract, init_db
import uuid

init_db()
save_contract(ContractRecord(
    id=str(uuid.uuid4()),
    buyer_name="Firma XYZ",
    buyer_nip="5260250274",
    buyer_address="ul. Przykładowa 1, 00-001 Warszawa",
    buyer_email="[email protected]",
    description="Obsługa IT — miesięczna",
    net_amount=2000,
    vat_rate=23,
    cycle="monthly",
    day_of_month=-1,   # -1 = ostatni dzień roboczy
))

Parametry kontraktu

Pole	Opis
`cycle`	`monthly` (jedyne obsługiwane)
`day_of_month`	`-1` = ostatni dzień roboczy, `1-28` = konkretny dzień
`auto_send_ksef`	Oznaczenie (wysyłkę KSeF wywołujesz osobno skill `ksef`)
`auto_send_email`	Oznaczenie (email wysyłasz osobno skill `invoice-send`)

Cron (codziennie rano)

0 7 * * * cd /opt/jdg && python3 skills/contracts/scripts/run_contracts.py >> logs/contracts.log 2>&1