libredte-lib-sdk 0.2.0__tar.gz → 0.3.0__tar.gz

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.2.0
+Version: 0.3.0
 Summary: SDK Python para la API de LibreDTE Lib (facturacion electronica de Chile).
 Project-URL: Homepage, https://www.libredte.cl
 Project-URL: Source, https://github.com/libredte/libredte-lib-sdk-python
@@ -80,7 +80,7 @@ Uso
     sdk = LibreDTE()  # base_url y api_token también vía env vars, ver abajo
     b = sdk.billing
 
-    parsed_data = {
+    input_data = {
         'Encabezado': {
             'IdDoc': {
                 'TipoDTE': 33,
@@ -125,11 +125,11 @@ Uso
     # b.identifier.caf_validator.validate(caf.xml_base64)
 
     # 1. Borrador.
-    borrador = b.document.builder.build_draft(parsed_data)
+    borrador = b.document.builder.build_draft(input_data)
 
     # 2. Documento real, timbrado y firmado.
     documento = b.document.builder.build_signed(
-        parsed_data, caf_xml=caf.xml_base64, certificate=certificate,
+        input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # 3. Envío al SII (arma el sobre EnvioDTE y luego lo envía).
@@ -220,7 +220,7 @@ necesita para poblar sus propios datos, no operaciones de facturación.
     ejemplos = b.document.examples.list()  # [ExampleSummary(id=..., category=..., case=...), ...]
     ejemplo = b.document.examples.get(ejemplos[0].id)
     documento = b.document.builder.build_signed(
-        ejemplo.parsed_data, caf_xml=caf.xml_base64, certificate=certificate,
+        ejemplo.input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # Catálogos/repositorios reales (comunas, tipos de documento, etc.)

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/README.rst

@@ -36,7 +36,7 @@ Uso
     sdk = LibreDTE()  # base_url y api_token también vía env vars, ver abajo
     b = sdk.billing
 
-    parsed_data = {
+    input_data = {
         'Encabezado': {
             'IdDoc': {
                 'TipoDTE': 33,
@@ -81,11 +81,11 @@ Uso
     # b.identifier.caf_validator.validate(caf.xml_base64)
 
     # 1. Borrador.
-    borrador = b.document.builder.build_draft(parsed_data)
+    borrador = b.document.builder.build_draft(input_data)
 
     # 2. Documento real, timbrado y firmado.
     documento = b.document.builder.build_signed(
-        parsed_data, caf_xml=caf.xml_base64, certificate=certificate,
+        input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # 3. Envío al SII (arma el sobre EnvioDTE y luego lo envía).
@@ -176,7 +176,7 @@ necesita para poblar sus propios datos, no operaciones de facturación.
     ejemplos = b.document.examples.list()  # [ExampleSummary(id=..., category=..., case=...), ...]
     ejemplo = b.document.examples.get(ejemplos[0].id)
     documento = b.document.builder.build_signed(
-        ejemplo.parsed_data, caf_xml=caf.xml_base64, certificate=certificate,
+        ejemplo.input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # Catálogos/repositorios reales (comunas, tipos de documento, etc.)

libredte_lib_sdk-0.3.0/libredte_lib_sdk/billing/document/builder.py

@@ -0,0 +1,83 @@
+# Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
+# SPDX-License-Identifier: MIT
+
+"""Servicio para `billing.document.builder`."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ...client import ApiClient
+from ..trading_parties.models import Certificate
+from .models import Document
+
+
+class DocumentBuilderService:
+    """
+    Construye documentos tributarios (`billing.document.builder`).
+
+    El mismo worker de la API sirve tanto para un borrador como para el
+    documento timbrado y firmado, según qué datos se le pasen — acá se
+    separa en dos métodos explícitos para que la intención de cada
+    llamada quede clara en el código que la usa.
+    """
+
+    _BUILD_OPERATION = 'billing.document.builder::build'
+
+    def __init__(self, client: ApiClient) -> None:
+        """Guarda el `ApiClient` compartido usado para llamar a la API."""
+        self._client = client
+
+    def build_draft(
+        self,
+        input_data: str | dict[str, Any],
+        *,
+        options: dict[str, Any] | None = None,
+    ) -> Document:
+        """
+        Emite el borrador de un DTE a partir de datos de entrada.
+
+        `input_data` es el `Encabezado`/`Detalle` (y demás nodos) del
+        formato DTE del SII como `dict`, incluyendo
+        `Encabezado.IdDoc.Folio` (el SDK no asigna folios: eso lo decide
+        quien llama, típicamente porque lleva el correlativo) — o datos
+        en otro formato (XML/YAML, un formulario, etc.) junto con
+        `options={'parser': {'strategy': '<estrategia>'}}` para indicar
+        cómo parsearlos. Sin `options`, la API asume que `input_data` ya
+        viene en el formato DTE del SII (estrategia `default.json`). Sin
+        CAF ni certificado, el resultado no queda timbrado
+        (`Document.is_timbrado` es `False`).
+        """
+        bag: dict[str, Any] = {'inputData': input_data}
+        if options is not None:
+            bag['options'] = options
+
+        data = self._client.call(self._BUILD_OPERATION, bag=bag)
+        return Document.from_api(data)
+
+    def build_signed(
+        self,
+        input_data: str | dict[str, Any],
+        *,
+        options: dict[str, Any] | None = None,
+        caf_xml: str,
+        certificate: Certificate,
+    ) -> Document:
+        """
+        Genera el DTE real, timbrado y firmado.
+
+        `input_data`/`options` funcionan igual que en `build_draft()`.
+        Requiere un CAF real (XML tal como lo entrega el SII, cubriendo
+        el folio indicado en `input_data`) y el certificado digital del
+        emisor. Para pruebas, ambos se pueden generar con
+        `IdentifierComponent.caf_faker` y
+        `TradingPartiesComponent.mandatario_manager`.
+        """
+        bag: dict[str, Any] = {'inputData': input_data}
+        if options is not None:
+            bag['options'] = options
+        bag['caf'] = caf_xml
+        bag['certificate'] = certificate.to_payload()
+
+        data = self._client.call(self._BUILD_OPERATION, bag=bag)
+        return Document.from_api(data)

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/libredte_lib_sdk/billing/document/examples.py

@@ -17,7 +17,7 @@ class DocumentExamplesService:
     de `libredte-lib-core` (`tests/fixtures/yaml/documentos_ok/`) — uno
     por variante de negocio real (descuentos, impuesto adicional, pago a
     crédito, exportación, etc.), no datos inventados por el SDK.
-    `Example.parsed_data` de `get()` se le pasa tal cual a
+    `Example.input_data` de `get()` se le pasa tal cual a
     `DocumentBuilderService.build_draft()`/`.build_signed()`, típicamente
     reemplazando `Encabezado.IdDoc.Folio` y `Encabezado.Receptor` por los
     propios de quien usa el SDK antes de construir el documento.

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/libredte_lib_sdk/billing/document/models.py

@@ -163,7 +163,7 @@ class Example:
     """
     Un ejemplo de documento, tal como lo devuelve `examples::get()`.
 
-    `parsed_data` es directamente el `parsedData` que esperan
+    `input_data` se pasa directamente al parámetro homónimo de
     `DocumentBuilderService.build_draft()`/`.build_signed()` — mismo
     `Encabezado`/`Detalle` que usa el resto del SDK, sin transformación.
     `expected` son los valores esperados del caso (totales, etc.) que usa
@@ -172,7 +172,7 @@ class Example:
     """
 
     id: str
-    parsed_data: dict[str, Any]
+    input_data: dict[str, Any]
     expected: dict[str, Any]
 
     @classmethod
@@ -180,7 +180,7 @@ class Example:
         """Construye un `Example` desde el `data` que devuelve la API."""
         return cls(
             id=data['id'],
-            parsed_data=data['example'],
+            input_data=data['example'],
             expected=data.get('expected') or {},
         )
 

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/libredte_lib_sdk/billing/document/renderer.py

@@ -32,6 +32,7 @@ class DocumentRendererService:
         *,
         format: str = 'pdf',  # noqa: A002
         renderings: dict[str, int] | None = None,
+        libredte_data: dict[str, Any] | None = None,
     ) -> RenderResult:
         """
         Genera el PDF (u otro formato soportado por la API) de un documento.
@@ -48,16 +49,24 @@ class DocumentRendererService:
         generarse (ej. pedir solo `'cedible'` para un tipo de documento
         sin acuse de recibo). Ver `RenderResult` para cómo se identifica
         cada copia en la respuesta.
+
+        `libredte_data` son datos adicionales que no están en el XML del
+        documento pero sí se usan al renderizar la plantilla — ej.
+        `{'extra': {'dte': {...}, 'historial': [...]}}`: lo que va en
+        `extra.dte` se combina con los datos del documento antes de
+        renderizar; el resto de `extra` (ej. `historial`) queda
+        disponible aparte para la plantilla.
         """
         renderer_options: dict[str, Any] = {'format': format}
         if renderings is not None:
             renderer_options['renderings'] = renderings
 
-        data = self._client.call(
-            self._RENDER_OPERATION,
-            bag={
-                'xmlDocument': document_xml_base64,
-                'options': {'renderer': renderer_options},
-            },
-        )
+        bag: dict[str, Any] = {
+            'xmlDocument': document_xml_base64,
+            'options': {'renderer': renderer_options},
+        }
+        if libredte_data is not None:
+            bag['libredteData'] = libredte_data
+
+        data = self._client.call(self._RENDER_OPERATION, bag=bag)
         return RenderResult.from_api(data)

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/libredte_lib_sdk/sdk.py

@@ -34,14 +34,14 @@ class LibreDTE:
             sdk.billing.integration,
         )
 
-        borrador = doc.builder.build_draft(parsed_data)
+        borrador = doc.builder.build_draft(input_data)
 
         caf = ident.caf_faker.create(emisor, codigo_documento=33)
         certificate = tp.mandatario_manager.create_fake_certificate(
             mandatario,
         )
         documento = doc.builder.build_signed(
-            parsed_data, caf_xml=caf.xml_base64, certificate=certificate,
+            input_data, caf_xml=caf.xml_base64, certificate=certificate,
         )
         sobre = doc.dispatcher.create(
             documento.xml_base64, certificate=certificate, emisor=emisor_dto,

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libredte-lib-sdk"
-version = "0.2.0"
+version = "0.3.0"
 description = "SDK Python para la API de LibreDTE Lib (facturacion electronica de Chile)."
 readme = "README.rst"
 license = { file = "LICENSE" }

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/integration/conftest.py

@@ -17,7 +17,7 @@ import pytest
 from libredte_lib_sdk import LibreDTE
 from libredte_lib_sdk.billing.trading_parties import Mandatario
 
-_PARSED_DATA = {
+_INPUT_DATA = {
     'Encabezado': {
         'IdDoc': {'TipoDTE': 33, 'Folio': 1},
         'Emisor': {
@@ -38,7 +38,7 @@ _PARSED_DATA = {
     'Detalle': [{'NmbItem': 'Producto A', 'QtyItem': 1, 'PrcItem': 1000}],
 }
 
-_PARSED_DATA_BOLETA = {
+_INPUT_DATA_BOLETA = {
     'Encabezado': {
         'IdDoc': {'TipoDTE': 39, 'Folio': 1},
         'Emisor': {
@@ -68,7 +68,7 @@ def real_sdk():
 @pytest.fixture
 def draft_document(real_sdk):
     """Un borrador real (factura afecta, tipo 33), construido en vivo."""
-    return real_sdk.billing.document.builder.build_draft(_PARSED_DATA)
+    return real_sdk.billing.document.builder.build_draft(_INPUT_DATA)
 
 
 @pytest.fixture
@@ -80,7 +80,7 @@ def draft_boleta(real_sdk):
     API omite en silencio una presentación `'cedible'` pedida sobre un
     tipo de documento que no la soporta (ver `RenderResult`).
     """
-    return real_sdk.billing.document.builder.build_draft(_PARSED_DATA_BOLETA)
+    return real_sdk.billing.document.builder.build_draft(_INPUT_DATA_BOLETA)
 
 
 @pytest.fixture
@@ -111,7 +111,7 @@ def signed_document(real_sdk, fake_certificate):
         folio_hasta=100,
     )
     return real_sdk.billing.document.builder.build_signed(
-        _PARSED_DATA,
+        _INPUT_DATA,
         caf_xml=caf.xml_base64,
         certificate=fake_certificate,
     )

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/integration/test_book.py

@@ -42,7 +42,7 @@ _BAG = {
 }
 
 
-def test_builder_build_returns_the_parsed_data_and_the_xml(
+def test_builder_build_returns_the_datos_and_the_xml(
     fake_certificate,
     real_sdk,
 ):

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/integration/test_examples.py

@@ -6,7 +6,7 @@ Tests en vivo para `DocumentExamplesService`.
 
 Los ejemplos son los mismos casos de prueba, ya validados, de
 `libredte-lib-core` (`tests/fixtures/yaml/documentos_ok/`) — se prueba
-que `get()` entrega un `parsed_data` realmente utilizable por
+que `get()` entrega un `input_data` realmente utilizable por
 `DocumentBuilderService`, no solo que la llamada HTTP responde.
 """
 
@@ -34,19 +34,19 @@ def test_list_returns_many_examples_across_document_types(real_sdk):
     assert len(categories) > 1
 
 
-def test_get_returns_parsed_data_and_expected_values(real_sdk):
+def test_get_returns_input_data_and_expected_values(real_sdk):
     first = real_sdk.billing.document.examples.list()[0]
 
     example = real_sdk.billing.document.examples.get(first.id)
 
     assert example.id == first.id
-    assert 'Encabezado' in example.parsed_data
-    assert 'Detalle' in example.parsed_data
+    assert 'Encabezado' in example.input_data
+    assert 'Detalle' in example.input_data
     assert example.expected
 
 
 def test_an_example_builds_into_a_real_signed_document(real_sdk):
-    """El `parsed_data` de un ejemplo debe servir tal cual a `build_signed`."""
+    """El `input_data` de un ejemplo debe servir tal cual a `build_signed`."""
     b = real_sdk.billing
     example = next(
         e
@@ -57,14 +57,14 @@ def test_an_example_builds_into_a_real_signed_document(real_sdk):
 
     caf = b.identifier.caf_faker.create(
         _EMISOR,
-        codigo_documento=data.parsed_data['Encabezado']['IdDoc']['TipoDTE'],
+        codigo_documento=data.input_data['Encabezado']['IdDoc']['TipoDTE'],
     )
     certificate = b.trading_parties.mandatario_manager.create_fake_certificate(
         _MANDATARIO,
     )
 
     documento = b.document.builder.build_signed(
-        data.parsed_data,
+        data.input_data,
         caf_xml=caf.xml_base64,
         certificate=certificate,
     )

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/integration/test_exchange.py

@@ -50,7 +50,7 @@ _RESULTADO_DTE = {
 }
 
 
-def test_build_envio_recibos_returns_the_parsed_data_and_the_xml(
+def test_build_envio_recibos_returns_the_datos_and_the_xml(
     fake_certificate,
     real_sdk,
 ):
@@ -82,7 +82,7 @@ def test_build_envio_recibos_result_chains_into_validator(
     assert len(results) >= 1
 
 
-def test_build_respuesta_envio_returns_the_parsed_data_and_the_xml(
+def test_build_respuesta_envio_returns_the_datos_and_the_xml(
     fake_certificate,
     real_sdk,
 ):

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/integration/test_ownership_transfer.py

@@ -36,7 +36,7 @@ def built_aec(signed_document, fake_certificate, real_sdk):
     )
 
 
-def test_build_returns_the_parsed_data_and_the_xml(built_aec):
+def test_build_returns_the_datos_and_the_xml(built_aec):
     assert (
         built_aec.datos['DocumentoAEC']['Caratula']['RutCedente']
         == '76192083-9'

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/test_client.py

@@ -67,7 +67,7 @@ def test_call_returns_the_data_payload_on_success(api_client):
 
     result = api_client.call(
         'billing.document.builder::build',
-        bag={'parsedData': {}},
+        bag={'inputData': {}},
     )
 
     assert result == {'id': 'doc-1'}

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.3.0}/tests/test_services.py

@@ -42,7 +42,7 @@ _REAL_SIGNED_DOCUMENT_RESPONSE = {
     },
 }
 
-_PARSED_DATA = {
+_INPUT_DATA = {
     'Encabezado': {
         'IdDoc': {'TipoDTE': 33, 'Folio': 1},
         'Emisor': {'RUTEmisor': '76192083-9', 'RznSoc': 'SASCO SpA'},
@@ -64,14 +64,35 @@ def test_build_draft_omits_caf_and_certificate_from_the_payload(sdk):
         f'{TEST_BASE_URL}/billing/document/builder/build',
     ).mock(return_value=httpx.Response(200, json=draft_response))
 
-    document = sdk.billing.document.builder.build_draft(_PARSED_DATA)
+    document = sdk.billing.document.builder.build_draft(_INPUT_DATA)
 
     sent = json.loads(route.calls.last.request.content)
-    assert sent['parameters']['bag'].keys() == {'parsedData'}
+    assert sent['parameters']['bag'].keys() == {'inputData'}
     assert document.id == '76192083-9_T033F000000001'
     assert document.is_timbrado is False
 
 
+@respx.mock
+def test_build_draft_sends_options_when_given(sdk):
+    draft_response = {
+        'meta': _REAL_SIGNED_DOCUMENT_RESPONSE['meta'],
+        'data': {**_REAL_SIGNED_DOCUMENT_RESPONSE['data'], 'ted': None},
+    }
+    route = respx.post(
+        f'{TEST_BASE_URL}/billing/document/builder/build',
+    ).mock(return_value=httpx.Response(200, json=draft_response))
+
+    sdk.billing.document.builder.build_draft(
+        '<DTE>...</DTE>',
+        options={'parser': {'strategy': 'default.xml'}},
+    )
+
+    sent = json.loads(route.calls.last.request.content)
+    bag = sent['parameters']['bag']
+    assert bag['inputData'] == '<DTE>...</DTE>'
+    assert bag['options'] == {'parser': {'strategy': 'default.xml'}}
+
+
 @respx.mock
 def test_build_signed_includes_caf_and_certificate(sdk):
     route = respx.post(
@@ -81,7 +102,7 @@ def test_build_signed_includes_caf_and_certificate(sdk):
     )
 
     document = sdk.billing.document.builder.build_signed(
-        _PARSED_DATA,
+        _INPUT_DATA,
         caf_xml='<AUTORIZACION/>',
         certificate=_CERTIFICATE,
     )
@@ -451,6 +472,33 @@ def test_renderer_render_omits_renderings_key_by_default(sdk):
 
     sent = json.loads(route.calls.last.request.content)['parameters']
     assert 'renderings' not in sent['bag']['options']['renderer']
+    assert 'libredteData' not in sent['bag']
+
+
+@respx.mock
+def test_renderer_render_sends_libredte_data_when_given(sdk):
+    """`libredte_data` viaja como `bag.libredteData` cuando se indica."""
+    route = respx.post(
+        f'{TEST_BASE_URL}/billing/document/renderer/render',
+    ).mock(
+        return_value=httpx.Response(
+            200,
+            json={
+                'meta': {},
+                'data': {'renderings': [_rendering_response(b'ok')]},
+            },
+        ),
+    )
+
+    sdk.billing.document.renderer.render(
+        'ZG9jdW1lbnRv',
+        libredte_data={'extra': {'historial': ['evento 1']}},
+    )
+
+    sent = json.loads(route.calls.last.request.content)['parameters']
+    assert sent['bag']['libredteData'] == {
+        'extra': {'historial': ['evento 1']},
+    }
 
 
 @respx.mock
@@ -492,7 +540,7 @@ def test_document_examples_get_sends_id_and_splits_expected(sdk):
                 'meta': {},
                 'data': {
                     'id': '033_factura_afecta/033_001_simple',
-                    'example': _PARSED_DATA,
+                    'example': _INPUT_DATA,
                     'expected': {
                         'Encabezado': {'Totales': {'MntTotal': 1190}},
                     },
@@ -507,7 +555,7 @@ def test_document_examples_get_sends_id_and_splits_expected(sdk):
 
     sent = json.loads(route.calls.last.request.content)['parameters']
     assert sent['id'] == '033_factura_afecta/033_001_simple'
-    assert example.parsed_data == _PARSED_DATA
+    assert example.input_data == _INPUT_DATA
     assert example.expected['Encabezado']['Totales']['MntTotal'] == 1190
 
 

libredte_lib_sdk-0.2.0/libredte_lib_sdk/billing/document/builder.py

@@ -1,71 +0,0 @@
-# Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
-# SPDX-License-Identifier: MIT
-
-"""Servicio para `billing.document.builder`."""
-
-from __future__ import annotations
-
-from typing import Any
-
-from ...client import ApiClient
-from ..trading_parties.models import Certificate
-from .models import Document
-
-
-class DocumentBuilderService:
-    """
-    Construye documentos tributarios (`billing.document.builder`).
-
-    El mismo worker de la API sirve tanto para un borrador como para el
-    documento timbrado y firmado, según qué datos se le pasen — acá se
-    separa en dos métodos explícitos para que la intención de cada
-    llamada quede clara en el código que la usa.
-    """
-
-    _BUILD_OPERATION = 'billing.document.builder::build'
-
-    def __init__(self, client: ApiClient) -> None:
-        """Guarda el `ApiClient` compartido usado para llamar a la API."""
-        self._client = client
-
-    def build_draft(self, parsed_data: dict[str, Any]) -> Document:
-        """
-        Emite el borrador de un DTE a partir de datos ya normalizados.
-
-        `parsed_data` es el `Encabezado`/`Detalle` (y demás nodos) del
-        formato DTE del SII, incluyendo `Encabezado.IdDoc.Folio` (el SDK
-        no asigna folios: eso lo decide quien llama, típicamente porque
-        lleva el correlativo). Sin CAF ni certificado, el resultado no
-        queda timbrado (`Document.is_timbrado` es `False`).
-        """
-        data = self._client.call(
-            self._BUILD_OPERATION,
-            bag={'parsedData': parsed_data},
-        )
-        return Document.from_api(data)
-
-    def build_signed(
-        self,
-        parsed_data: dict[str, Any],
-        *,
-        caf_xml: str,
-        certificate: Certificate,
-    ) -> Document:
-        """
-        Genera el DTE real, timbrado y firmado.
-
-        Requiere un CAF real (XML tal como lo entrega el SII, cubriendo
-        el folio indicado en `parsed_data`) y el certificado digital del
-        emisor. Para pruebas, ambos se pueden generar con
-        `IdentifierComponent.caf_faker` y
-        `TradingPartiesComponent.mandatario_manager`.
-        """
-        data = self._client.call(
-            self._BUILD_OPERATION,
-            bag={
-                'parsedData': parsed_data,
-                'caf': caf_xml,
-                'certificate': certificate.to_payload(),
-            },
-        )
-        return Document.from_api(data)