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

Emite los eventos 030–051; no genera facturas. 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)

Emitir eventos de factura

Construye un InvoiceResponseEvent y reutiliza RadianSoftware. La guía de emisión incluye ejemplos de acuse 030, reclamo 031, recibo 032 y aceptaciones 033/034.

prepared = client.prepare_radian_event(event=event, software=software)
print(prepared.code, prepared.cude)
result = client.send_radian_event(prepared)

La preparación es local. El consumidor aporta las declaraciones y el envío es explícito, con el mismo ambiente del artefacto preparado.

Emitir eventos RADIAN

prepare_radian_event(event=..., software=...) y send_radian_event(prepared) cubren aval 035, inscripción 036, endosos 037–040/047, limitaciones 041/042, terminación de mandato 044, pagos 045/046, protesto 048 y derechos económicos 049–051. La guía con ejemplos por familia detalla modelos, variantes y validaciones. La misma pareja de métodos prepara y envía los eventos de factura 030–034 y el mandato 043.

Preparar y enviar un mandato

Construye un MandateEvent y un RadianSoftware siguiendo el ejemplo completo. La preparación firma el XML y crea el ZIP en memoria sin contactar DIAN:

prepared = client.prepare_radian_event(event=event, software=software)
print(prepared.cude)
# Envío explícito del mismo ZIP preparado:
result = client.send_radian_event(prepared)
if result is not None:
    print(result.is_valid, result.status_code, result.messages)

Producción es el ambiente predeterminado; usa Environment.HABILITATION para habilitación. Cada consulta o emisión 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

emails = client.get_exchange_emails()
if emails is not None and emails.csv is not None:
    for row in emails.csv:
        print(row)

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.