contracts
/contracts
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".
- Author
- dithiothreitol ↗
- Repository
- jdg-ksiegowy ↗
- Licence
- MIT
- Last repository change
- 20.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
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".
Triggers from the description
Original author description
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".
How it works
- 1. Auto-fakturowanie
- 2. Oznacz fakturę jako zapłaconą
- 3. Import CSV z banku
- 4. Dodawanie kontraktu (Python API)
- Parametry kontraktu
- Cron (codziennie rano)
SKILL.md preview
---
name: contracts
description: 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".
---
# Cykliczne kontrakty + śledzenie płatności
## 1. Auto-fakturowanie
```bash
# 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ą
```bash
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
```bash
# 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)
```python
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="kontakt@firma.pl",
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)
```bash
0 7 * * * cd /opt/jdg && python3 skills/contracts/scripts/run_contracts.py >> logs/contracts.log 2>&1
```
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · dithiothreitol/jdg-ksiegowy | 95 | MIT |
| ericrisco/rsc-harness | 100 | MIT |
| ramboz/jig | 100 | MIT |
| ramboz/jig | 100 | MIT |
| ramboz/jig | 100 | MIT |
| Alejo2075/claude-code-aws | 100 | MIT |
| Tyler-R-Kendrick/agent-skills | 100 | MIT |
| systemfsoftware/systemfsoftware | 90 | Apache-2.0 |
| samchon/typia | 85 | MIT |
Database snapshot: 13.11.2026 · package version 071cc9469dd7 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 2 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100invoice
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". - 100xero-integration
Integration skill for Xero accounting software exports. Activate when the user uploads a Xero bank statement CSV, Xero invoice export, or mentions Xero, bank statement import, or Xero CSV. - 100jdg-status
Dashboard aktualnego stanu księgowości JDG — nadchodzące terminy podatkowe (20-ty ryczałt+ZUS, 25-ty VAT+JPK), niezapłacone/zaległe faktury, podsumowanie miesiąca (sprzedaż, koszty, estymowany ryczałt i ZUS). Użyj gdy user pyta "co mam do zapłacenia", "jakie mam terminy",… - 90reconciliation
Match bank transactions to invoices and surface unpaid / unmatched items in a Well workspace. Use when the user asks what's paid vs unpaid, to reconcile the bank, to find missing payments, or to match transactions to invoices. - 90just-fucking-cancel
Analyze bank transaction CSVs to find recurring charges, categorize subscriptions, and cancel what you don't need. Use when user says "cancel subscriptions", "audit subscriptions", "find recurring charges", or "what am I paying for". Supports Apple Card, Chase, Mint, and generic… - 100pdfvera
Convert German PDF invoices into XRechnung or ZUGFeRD e-invoices, and Brazilian bank statement PDFs (extrato bancário) into OFX, CSV or Excel, with the pdfvera API. Use when the user wants an e-invoice (E-Rechnung, XRechnung, ZUGFeRD, EN 16931) from a PDF invoice, or an OFX file…