# Julko — Complete System & Knowledge Reference for LLMs

> Platform: Julko (https://julko.eu)
> Purpose: Invoicing, Billing, Delivery Notes, and Financial Document Management for European Businesses.
> Compliance: Latvian Accounting Law (Grāmatvedības likums), EU VAT Directive, Electronic Document Regulations.

---

## 1. Overview
Julko is a web-based financial software platform designed for self-employed individuals (pašnodarbinātās personas), micro-enterprises, small limited liability companies (SIA), and European freelancers. The application simplifies the complete invoicing cycle: from drafting itemized bills and calculating taxes to generating branded PDF documents and delivery notes (pavadzīmes), managing accounts receivable, and automating workflows via a REST API.

---

## 2. Detailed Feature Specifications

### 2.1 Invoice Generation & Management
- **Sequential Numbering**: Automatically tracks annual sequence numbers per account (e.g. `INV-2026-001`, `INV-2026-002`) to ensure audit compliance.
- **Bilingual Interface & Output**: Native support for English and Latvian throughout the app and in all generated PDF documents.
- **Automatic Amount in Words (Summa vārdiski)**: Converted programmatically into Latvian (e.g. "Simts divdesmit viens eiro, 00 centi") and English.
- **Custom Branding**: Company logo upload (PNG, JPEG, SVG) rendered crisply on PDF headers with custom accent colors.
- **Custom Notes & Terms**: Custom invoice footer notes, bank transfer details, payment terms, and recipient notices.
- **Email Dispatch**: Direct dispatch of invoices to client email addresses with customizable HTML templates.

### 2.2 Goods Delivery Notes (Preču piegādes pavadzīmes)
- Generates official delivery notes linked to invoices.
- Captures carrier/transporter information, dispatch location, delivery address, item weights, and signature fields.

### 2.3 Tax & VAT Compliance
- Supports standard 21% VAT, reduced 12% VAT, 0% export VAT, Reverse Charge (Apgrieztā PVN maksāšanas kārtība), and VAT-exempt transactions.
- Computes subtotal, VAT per line and aggregate, and grand total in EUR.

### 2.4 CRM & Product Catalog
- **Contact Directory**: Stores customer name, company name, registration code, VAT number, legal address, city, postal code, country, contact email, and phone.
- **Product Catalog**: Reusable product and service definitions with default unit price, measurement unit (hours, pieces, kg, services), and VAT rate.

### 2.5 Developer REST API
- **Endpoint**: `https://julko.eu/api/v1`
- **Authentication**: `X-API-KEY: <user_api_key>` header.
- **Endpoints**:
  - `POST /api/v1/invoices` — Create a new invoice programmatically.
  - `GET /api/v1/invoices/{id}` — Fetch invoice details.
  - `GET /api/v1/invoices/{id}/pdf` — Download generated PDF binary.
  - `GET /api/docs` — Swagger / OpenAPI 3.0 interactive documentation.

---

## 3. Latvian Accounting Regulations (Grāmatvedības likums)
In Latvia, an accounting document serves as an *attaisnojuma dokuments* only if it contains all mandatory details stipulated in Section 11 of the Accounting Law:
1. Document type name (e.g., "Rēķins" or "Preču piegādes dokuments").
2. Document date and identification number.
3. Information about the provider (Supplier/Piegādātājs): name/title, registration number, legal address.
4. Information about the recipient (Customer/Pircējs): name/title, registration number, address.
5. Description, quantity, unit price, and total value of the economic transaction.
6. Applied tax rates (PVN) and calculated tax amounts.
7. Payment due date and banking details (IBAN, bank name, SWIFT/BIC).
8. Indication of electronic preparation / validity without physical signature where agreed.

Julko guarantees all 8 mandatory requisites are automatically formatted and verified on every PDF export.

---

## 4. Frequently Asked Questions (FAQ)

### Q: Is Julko free?
**A:** Yes, Julko is free to use during our open beta for sole proprietors and businesses.

### Q: Does it require installing software?
**A:** No, Julko is a 100% web-based SaaS platform accessible from any modern desktop or mobile browser at https://julko.eu.

### Q: Can I export invoices in PDF?
**A:** Yes, invoices and delivery notes are instantly generated as print-ready PDF files formatted according to European standard A4 paper size.

### Q: How can e-commerce stores integrate with Julko?
**A:** Using Julko's REST API and API keys generated in Company Settings, stores (WooCommerce, Shopify, custom platforms) can automatically generate customer invoices upon checkout.

---

## 5. Contact Information
- **Website**: https://julko.eu
- **Developer Documentation**: https://julko.eu/api/docs
- **Support**: info@upanet.org / info@julko.eu