ruraldte 0.1.0

SDK Python del API v1 de RuralDTE — emisión de DTE ante el SII de Chile (emitir = encolar), folios/CAF, webhooks y API keys.

ruraldte (Python)

SDK Python del API v1 de RuralDTE — emisión de documentos tributarios electrónicos (DTE) ante el SII de Chile. Cero dependencias (solo stdlib).

Instalación

pip install ruraldte

Cobertura actual (MVP): documents.emit, documents.list, documents.states, folios, emisores, webhooks y keys. El SDK TypeScript (@ruraldte/sdk) cubre además pagos, cesiones, conectores, intercambio, reportes y más — la API REST los soporta todos aunque este SDK aún no.

import os
from ruraldte import RuralDte, RuralDteError

rd = RuralDte(api_key=os.environ["RURALDTE_API_KEY"])

# Emitir = encolar (202 { "status": "queued" }). El SII confirma asíncrono.
try:
    doc = rd.documents.emit({
        "emisorId": "…",
        "tipo": 33,                 # factura electrónica
        "ambiente": "cert",
        "receptor": {"rut": "11111111-1", "razonSocial": "ACME SpA"},
        "montos": {"total": 1190, "neto": 1000, "iva": 190},  # CLP enteros
    }, idempotency_key="orden-123")
    print(doc["id"], doc["status"])

    # Pollear el desenlace (o suscribir un webhook a dte.aceptado/dte.rechazado).
    print(rd.documents.states(doc["id"]))
except RuralDteError as e:
    print(e.status, e.code, e.detail, "retryable:", e.is_retryable)

Recursos: documents (emit/list/states), folios (stock/request), emisores (list/create/upload_credential), webhooks (list/register/disable), keys (list/create/revoke).

Config: RuralDte(api_key, base_url=…, timeout=30). La key fija el ambiente permitido (rdte_test_* → test/cert, rdte_live_* → prod).

Docs y OpenAPI: https://ruraldte.cl/docs

Tests: python3 -m unittest discover -s tests -t .

MIT © Comunidad Rural SpA