radiankore 0.1.0__tar.gz

radiankore-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python and local environments
+__pycache__/
+*.py[cod]
+.venv/
+.uv-cache/
+*.egg-info/
+build/
+dist/
+
+# Quality reports and caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Local configuration and signing material
+.env
+.env.*
+!.env.example
+*.p12
+*.pfx
+*.pem
+*.key
+
+# Editor and environment metadata
+.idea/
+.vscode/
+.DS_Store
+.agents/
+.codex/
+.aws/
+
+# Generated documentation
+docs/_build/

radiankore-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deikore SAS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

radiankore-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.5
+Name: radiankore
+Version: 0.1.0
+Summary: Python library for RADIAN events and invoice queries through DIAN.
+Project-URL: Homepage, https://github.com/Deikore/radiankore
+Project-URL: Documentation, https://radiankore.readthedocs.io/
+Project-URL: Repository, https://github.com/Deikore/radiankore
+Project-URL: Issues, https://github.com/Deikore/radiankore/issues
+Project-URL: Changelog, https://github.com/Deikore/radiankore/blob/HEAD/CHANGELOG.md
+Author: Deikore SAS
+License-Expression: MIT
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES
+Keywords: colombia,dian,electronic-invoicing,radian,soap
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: cryptography>=46
+Requires-Dist: httpx>=0.28
+Requires-Dist: lxml>=5
+Requires-Dist: xmlsec>=1.3.17
+Description-Content-Type: text/markdown
+
+# 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 | [![Read the Docs](https://readthedocs.org/projects/radiankore/badge/?version=latest)](https://radiankore.readthedocs.io/) |
+| Calidad y pruebas | [![CI](https://github.com/Deikore/radiankore/actions/workflows/ci.yml/badge.svg)](https://github.com/Deikore/radiankore/actions/workflows/ci.yml) |
+| Paquete | [![PyPI](https://img.shields.io/pypi/v/radiankore)](https://pypi.org/project/radiankore/) [![Python](https://img.shields.io/pypi/pyversions/radiankore)](https://pypi.org/project/radiankore/) [![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/Deikore/radiankore/blob/HEAD/LICENSE) |
+
+## Instalación
+
+```bash
+pip install radiankore
+# Con uv:
+uv add radiankore
+```
+
+Disponible tras la primera publicación en PyPI. Si necesitas compilar las
+dependencias de firma, consulta la
+[guía de instalación](https://radiankore.readthedocs.io/).
+
+## Métodos disponibles
+
+| Método | Operación DIAN | Resultado |
+| --- | --- | --- |
+| `get_status(track_id)` | `GetStatus` | Estado de validación y payloads decodificados |
+| `get_invoice_events(cufe)` | `GetStatusEvent` | Eventos asociados a una factura |
+| `get_acquirer(identification_type=..., identification_number=...)` | `GetAcquirer` | Nombre y correo del adquiriente |
+| `get_document_info(uuid)` | `GetDocumentInfo` | Información, estados, eventos y notas del documento |
+| `get_reference_notes(track_id)` | `GetReferenceNotes` | Notas referenciadas y motivos por línea |
+| `get_xml_by_document_key(document_key)` | `GetXmlByDocumentKey` | XML original del documento como `bytes` |
+
+No genera facturas ni envía eventos. Los resultados utilizan dataclasses
+inmutables y campos opcionales cuando corresponda.
+
+## Consultar eventos
+
+```python
+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
+
+```python
+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](https://radiankore.readthedocs.io/) incluye contratos,
+modelos, errores y ejemplos por operación. Para contribuir, consulta
+[CONTRIBUTING](https://github.com/Deikore/radiankore/blob/HEAD/CONTRIBUTING.md).

radiankore-0.1.0/README.md

@@ -0,0 +1,94 @@
+# 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 | [![Read the Docs](https://readthedocs.org/projects/radiankore/badge/?version=latest)](https://radiankore.readthedocs.io/) |
+| Calidad y pruebas | [![CI](https://github.com/Deikore/radiankore/actions/workflows/ci.yml/badge.svg)](https://github.com/Deikore/radiankore/actions/workflows/ci.yml) |
+| Paquete | [![PyPI](https://img.shields.io/pypi/v/radiankore)](https://pypi.org/project/radiankore/) [![Python](https://img.shields.io/pypi/pyversions/radiankore)](https://pypi.org/project/radiankore/) [![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/Deikore/radiankore/blob/HEAD/LICENSE) |
+
+## Instalación
+
+```bash
+pip install radiankore
+# Con uv:
+uv add radiankore
+```
+
+Disponible tras la primera publicación en PyPI. Si necesitas compilar las
+dependencias de firma, consulta la
+[guía de instalación](https://radiankore.readthedocs.io/).
+
+## Métodos disponibles
+
+| Método | Operación DIAN | Resultado |
+| --- | --- | --- |
+| `get_status(track_id)` | `GetStatus` | Estado de validación y payloads decodificados |
+| `get_invoice_events(cufe)` | `GetStatusEvent` | Eventos asociados a una factura |
+| `get_acquirer(identification_type=..., identification_number=...)` | `GetAcquirer` | Nombre y correo del adquiriente |
+| `get_document_info(uuid)` | `GetDocumentInfo` | Información, estados, eventos y notas del documento |
+| `get_reference_notes(track_id)` | `GetReferenceNotes` | Notas referenciadas y motivos por línea |
+| `get_xml_by_document_key(document_key)` | `GetXmlByDocumentKey` | XML original del documento como `bytes` |
+
+No genera facturas ni envía eventos. Los resultados utilizan dataclasses
+inmutables y campos opcionales cuando corresponda.
+
+## Consultar eventos
+
+```python
+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
+
+```python
+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](https://radiankore.readthedocs.io/) incluye contratos,
+modelos, errores y ejemplos por operación. Para contribuir, consulta
+[CONTRIBUTING](https://github.com/Deikore/radiankore/blob/HEAD/CONTRIBUTING.md).

radiankore-0.1.0/THIRD_PARTY_NOTICES

@@ -0,0 +1,7 @@
+Technical reference material
+
+The files under docs/references/dian are third-party reference material from
+DIAN and the organizations credited in the original documents and schemas.
+The project's MIT license does not relicense those files. Their original
+notices and applicable terms remain in effect. They are excluded from both
+the wheel and source distributions published to PyPI.

radiankore-0.1.0/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "radiankore"
+version = "0.1.0"
+description = "Python library for RADIAN events and invoice queries through DIAN."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE", "THIRD_PARTY_NOTICES"]
+authors = [{ name = "Deikore SAS" }]
+keywords = ["dian", "radian", "colombia", "soap", "electronic-invoicing"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Typing :: Typed",
+]
+dependencies = ["cryptography>=46", "httpx>=0.28", "lxml>=5", "xmlsec>=1.3.17"]
+
+[project.urls]
+Homepage = "https://github.com/Deikore/radiankore"
+Documentation = "https://radiankore.readthedocs.io/"
+Repository = "https://github.com/Deikore/radiankore"
+Issues = "https://github.com/Deikore/radiankore/issues"
+Changelog = "https://github.com/Deikore/radiankore/blob/HEAD/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.15,<2",
+    "pytest>=8.3,<10",
+    "pytest-cov>=6,<8",
+    "ruff>=0.11,<1",
+    "lxml-stubs>=0.5.1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/radiankore"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/README.md", "/LICENSE", "/THIRD_PARTY_NOTICES", "/pyproject.toml"]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+files = ["src", "tests"]
+mypy_path = "src"
+
+[tool.pytest.ini_options]
+minversion = "8.3"
+testpaths = ["tests"]
+addopts = "--strict-config --strict-markers --import-mode=importlib"
+filterwarnings = ["error"]
+
+[tool.coverage.run]
+branch = true
+source = ["radiankore"]
+relative_files = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

radiankore-0.1.0/src/radiankore/__init__.py

@@ -0,0 +1,24 @@
+"""Public interface for the radiankore library."""
+
+from radiankore.certificate import DigitalCertificate, DigitalCertificateError
+from radiankore.client import DianClient
+from radiankore.environment import Environment
+from radiankore.exceptions import (
+    DianError,
+    DianResponseError,
+    DianSignatureError,
+    DianSoapFaultError,
+    DianTransportError,
+)
+
+__all__ = [
+    "DianClient",
+    "DianError",
+    "DianResponseError",
+    "DianSignatureError",
+    "DianSoapFaultError",
+    "DianTransportError",
+    "DigitalCertificate",
+    "DigitalCertificateError",
+    "Environment",
+]

radiankore-0.1.0/src/radiankore/_soap/__init__.py

@@ -0,0 +1 @@
+"""Internal SOAP implementation; consumers should use DianClient."""

radiankore-0.1.0/src/radiankore/_soap/acquirer_response.py

@@ -0,0 +1,18 @@
+"""Map GetAcquirer results independently of invoice event response processing."""
+
+from radiankore._soap.namespaces import ACQUIRER
+from radiankore._soap.parsing import element_text, soap_result
+from radiankore.models.responses import AcquirerResult
+
+
+def parse_acquirer_response(data: bytes) -> AcquirerResult | None:
+    """Return optional acquirer data, preserving any returned business status."""
+    result = soap_result(data, "GetAcquirer")
+    if result is None:
+        return None
+    return AcquirerResult(
+        name=element_text(result, f"{{{ACQUIRER}}}ReceiverName"),
+        email=element_text(result, f"{{{ACQUIRER}}}ReceiverEmail"),
+        status_code=element_text(result, f"{{{ACQUIRER}}}StatusCode"),
+        message=element_text(result, f"{{{ACQUIRER}}}Message"),
+    )

radiankore-0.1.0/src/radiankore/_soap/dian_response.py

@@ -0,0 +1,40 @@
+"""Scalar and binary readers shared by DianResponse operation parsers."""
+
+from lxml import etree
+
+from radiankore._soap.namespaces import ARRAY, RESPONSE
+from radiankore._soap.parsing import decode_base64_text, is_nil
+from radiankore.exceptions import DianResponseError
+
+
+def read_is_valid(result: etree._Element, *, operation: str) -> bool | None:
+    """Read an optional, non-nillable DianResponse validity flag."""
+    node = result.find(f"{{{RESPONSE}}}IsValid")
+    if node is None:
+        return None
+    if is_nil(node):
+        raise DianResponseError(f"IsValid must not be nil in {operation}.")
+    value = (node.text or "").strip()
+    if value not in {"true", "false", "1", "0"}:
+        cause = ValueError("Invalid xs:boolean lexical value.")
+        raise DianResponseError(f"Invalid IsValid in {operation}.") from cause
+    return value in {"true", "1"}
+
+
+def read_messages(result: etree._Element) -> tuple[str | None, ...]:
+    """Preserve message order, repetitions, empty strings and nullable items."""
+    container = result.find(f"{{{RESPONSE}}}ErrorMessage")
+    if container is None or is_nil(container):
+        return ()
+    return tuple(
+        None if is_nil(node) else (node.text or "").strip()
+        for node in container.findall(f"{{{ARRAY}}}string")
+    )
+
+
+def read_binary(result: etree._Element, name: str) -> bytes | None:
+    """Decode one binary field independently, distinguishing absent from empty."""
+    node = result.find(f"{{{RESPONSE}}}{name}")
+    if node is None or is_nil(node):
+        return None
+    return decode_base64_text(node.text or "", field_name=name)