pykude

Python library for generating KuDE (Kuatia Documento Electrónico) PDF representations from SIFEN XML documents (Paraguay electronic invoicing system).

Inspired by BrazilFiscalReport.

Installation

pip install pykude[all]

Quick Start

from pykude import KudeFe

with open("factura.xml", "r", encoding="utf-8") as f:
    xml = f.read()

kude = KudeFe(xml=xml)
kude.output("kude_factura.pdf")

Auto-detect Document Type

from pykude import auto_kude

kude = auto_kude(xml=xml_content)
kude.output("kude.pdf")

Supported Document Types

Configuration

from pykude.kude_fe import KudeFe, KudeFeConfig, Margins

config = KudeFeConfig(
    logo="path/to/logo.png",
    margins=Margins(top=8, right=8, bottom=8, left=8),
)

kude = KudeFe(xml=xml_content, config=config)
kude.output("kude.pdf")

Ticket Format (80mm thermal printer)

from pykude.kude_ticket import KudeTicket

kude = KudeTicket(xml=xml_content)
kude.output("ticket.pdf")

CLI

# Generate KuDE from XML
pfr kude-fe factura.xml -o kude.pdf

# With logo
pfr kude-fe factura.xml --logo logo.png -o kude.pdf

# Ticket format
pfr kude-fe factura.xml --format ticket -o ticket.pdf

Development

git clone https://github.com/KMEE/pykude.git
cd pykude
pip install -e ".[all,test]"
pytest

License

MIT License - Copyright (c) 2024-2026 KMEE

Author

mileo (mileo@kmee.com.br)