radiankore

Librería Python de Deikore SAS para consultar servicios de DIAN y eventos RADIAN con certificado digital PFX/P12. Python >=3.13, API síncrona y licencia MIT.

	Estado
Documentación
Calidad y pruebas
Paquete

Instalación

pip install radiankore
# Con uv:
uv add radiankore

Si necesitas compilar las dependencias de firma, consulta la guía de instalación.

Métodos disponibles

No genera facturas ni envía eventos. Los resultados utilizan dataclasses inmutables y campos opcionales cuando corresponda.

Consultar eventos

from radiankore import DianClient, Environment

client = DianClient(
    certificate_path="/ruta/segura/certificado.pfx",
    password="password-de-ejemplo",
    environment=Environment.PRODUCTION,
)

result = client.get_invoice_events("CUFE-DE-LA-FACTURA")
for event in result.events:
    print(event.id, event.code, event.description, event.date, event.time)

Producción es el ambiente predeterminado; usa Environment.HABILITATION para habilitación. Cada consulta cierra sus conexiones automáticamente y puedes reutilizar el cliente sin volver a cargar el certificado.

Otras consultas

from pathlib import Path

from radiankore.catalogs import IdentificationType

status = client.get_status("CUFE-O-TRACK-ID")
if status is not None:
    print(status.is_valid, status.status_code, status.messages)

acquirer = client.get_acquirer(
    identification_type=IdentificationType.NIT,
    identification_number="000123456",
)
if acquirer is not None:
    print(acquirer.name, acquirer.email)

document = client.get_document_info("UUID-DEL-DOCUMENTO")
if document is not None:
    for item in document.documents:
        if item is not None:
            print(item.uuid, item.totals)

notes = client.get_reference_notes("CUFE-O-TRACK-ID")
if notes is not None:
    for note in notes.notes:
        print(note.code, note.description)

xml = client.get_xml_by_document_key("CLAVE-DEL-DOCUMENTO")
if xml is not None and xml.document_xml is not None:
    Path("documento.xml").write_bytes(xml.document_xml)

La documentación completa incluye contratos, modelos, errores y ejemplos por operación. Para contribuir, consulta CONTRIBUTING.