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

libredte_lib_sdk-0.4.0/.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"64edfb1a-a3db-44cc-af25-6c7405269fdf","pid":73057,"procStart":"Mon Sep  7 03:13:55 2026","acquiredAt":1789224889985}

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.2.0
+Version: 0.4.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.example, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # Catálogos/repositorios reales (comunas, tipos de documento, etc.)
@@ -238,7 +238,7 @@ necesita para poblar sus propios datos, no operaciones de facturación.
     # ya extraídos en una sola llamada — mismo `Certificate` que usan
     # build_signed()/dispatcher.create(), ya con todos los datos.
     certificate = s.certificate.loader.load(datos_del_archivo_pfx, 'contraseña')
-    print(certificate.rut, certificate.nombre, certificate.email)
+    print(certificate.id, certificate.name, certificate.email)
 
 Errores
 -------

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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.example, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
     # Catálogos/repositorios reales (comunas, tipos de documento, etc.)
@@ -194,7 +194,7 @@ necesita para poblar sus propios datos, no operaciones de facturación.
     # ya extraídos en una sola llamada — mismo `Certificate` que usan
     # build_signed()/dispatcher.create(), ya con todos los datos.
     certificate = s.certificate.loader.load(datos_del_archivo_pfx, 'contraseña')
-    print(certificate.rut, certificate.nombre, certificate.email)
+    print(certificate.id, certificate.name, certificate.email)
 
 Errores
 -------

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.0}/libredte_lib_sdk/billing/book/loader.py

@@ -31,8 +31,8 @@ class BookLoaderService:
         Normaliza `caratula`/`detalle` de `bag` en un `BookBag`.
 
         `bag` trae `tipo`/`caratula`/`detalle`/`emisor`, tal cual el
-        formato SII. `BookBag.datos` siempre viene `None` (no construye
-        el libro); `BookBag.auth` viene poblado solo si
+        formato SII. `BookBag.book` siempre viene `None` (no construye
+        el libro); `BookBag.book_auth` viene poblado solo si
         `bag['emisor']` incluye `autorizacion_dte`.
         """
         data = self._client.call(

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.0}/libredte_lib_sdk/billing/book/models.py

@@ -43,16 +43,16 @@ class BookBag:
     Esta operación solo normaliza `caratula`/`detalle` a partir de los
     datos de entrada — no construye el libro ni genera su documento
     firmado (eso lo hace `BookBuilderService.build`), por lo que
-    `datos` (el libro ya construido) siempre viene `None` acá, sin
-    importar los datos de entrada recibidos. `auth` (la autorización
-    del emisor del libro) solo viene poblada si esa autorización se
-    incluyó junto con los datos del emisor en la solicitud; si no, viene
-    `None`.
+    `book` (el libro ya construido) siempre viene `None` acá, sin
+    importar los datos de entrada recibidos. `book_auth` (la
+    autorización del emisor del libro) solo viene poblada si esa
+    autorización se incluyó junto con los datos del emisor en la
+    solicitud; si no, viene `None`.
     """
 
-    datos: dict[str, Any] | None
+    book: dict[str, Any] | None
     book_type: dict[str, Any]
-    auth: dict[str, Any] | None
+    book_auth: dict[str, Any] | None
     caratula: dict[str, Any]
     detalle: list[dict[str, Any]]
     raw: dict[str, Any]
@@ -61,9 +61,9 @@ class BookBag:
     def from_api(cls, data: dict[str, Any]) -> BookBag:
         """Construye un `BookBag` desde el `data` que devuelve la API."""
         return cls(
-            datos=data.get('book'),
+            book=data.get('book'),
             book_type=data['book_type'],
-            auth=data.get('book_auth'),
+            book_auth=data.get('book_auth'),
             caratula=data.get('caratula') or {},
             detalle=data.get('detalle') or [],
             raw=data,

libredte_lib_sdk-0.4.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.4.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.example` 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.4.0}/libredte_lib_sdk/billing/document/models.py

@@ -56,29 +56,29 @@ class DocumentBag:
     Bolsa normalizada devuelta por `document.loader::loadXml`.
 
     No trae el XML del documento ni `id` — solo la bolsa ya
-    normalizada: `datos` (`Encabezado`/`Detalle`), `document_type`
+    normalizada: `document` (`Encabezado`/`Detalle`), `document_type`
     (metadatos del tipo de documento: `codigo`, `nombre`, `categoria`,
-    `es_boleta`, etc., sin tipar) y `stamp_xml` (el TED, como XML
+    `es_boleta`, etc., sin tipar) y `document_stamp` (el TED, como XML
     plano, no en base64 ni parseado). Sirve para reconstruir los datos
     de un DTE ya emitido a partir de su XML.
     """
 
-    datos: dict[str, Any]
+    document: dict[str, Any]
     document_type: dict[str, Any]
-    stamp_xml: str | None
-    extra: dict[str, Any] | None
-    auth: dict[str, Any] | None
+    document_stamp: str | None
+    document_extra: dict[str, Any] | None
+    document_auth: dict[str, Any] | None
     raw: dict[str, Any]
 
     @classmethod
     def from_api(cls, data: dict[str, Any]) -> DocumentBag:
         """Construye un `DocumentBag` desde el `data` de la API."""
         return cls(
-            datos=data['document'],
+            document=data['document'],
             document_type=data['document_type'],
-            stamp_xml=data.get('document_stamp'),
-            extra=data.get('document_extra'),
-            auth=data.get('document_auth'),
+            document_stamp=data.get('document_stamp'),
+            document_extra=data.get('document_extra'),
+            document_auth=data.get('document_auth'),
             raw=data,
         )
 
@@ -163,7 +163,7 @@ class Example:
     """
     Un ejemplo de documento, tal como lo devuelve `examples::get()`.
 
-    `parsed_data` es directamente el `parsedData` que esperan
+    `example` se pasa directamente al parámetro `input_data` 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]
+    example: 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'],
+            example=data['example'],
             expected=data.get('expected') or {},
         )
 

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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.4.0}/libredte_lib_sdk/billing/integration/models.py

@@ -193,11 +193,11 @@ class GetDocumentSiiReceptionDateResponse:
     Fecha de recepción de un DTE en el SII (`getDocumentSiiReceptionDate`).
 
     Si el documento consultado no tiene fecha de recepción registrada,
-    la API levanta `LibreDteApiError` — `reception_date` nunca es
+    la API levanta `LibreDteApiError` — `fecha_recepcion_sii` nunca es
     `None`.
     """
 
-    reception_date: datetime
+    fecha_recepcion_sii: datetime
     raw: dict[str, Any]
 
     @classmethod
@@ -207,7 +207,7 @@ class GetDocumentSiiReceptionDateResponse:
     ) -> GetDocumentSiiReceptionDateResponse:
         """Construye desde el `data` que devuelve la API."""
         return cls(
-            reception_date=datetime.fromisoformat(
+            fecha_recepcion_sii=datetime.fromisoformat(
                 data['fecha_recepcion_sii'],
             ),
             raw=data,

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.0}/libredte_lib_sdk/billing/ownership_transfer/models.py

@@ -16,16 +16,16 @@ class Aec(XmlPayloadMixin):
     """
     AEC (Archivo Electrónico de Cesión) construido (`aec::build`).
 
-    `datos` es la estructura ya parseada (bajo la clave `AEC` en la
+    `aec` es la estructura ya parseada (bajo la clave `AEC` en la
     respuesta cruda de la API), `xml_base64` el XML completo — permite
     encadenar a `AecService.validate_schema`/`.validate_signature` o a
     `SiiRtcService.send_aec`.
     """
 
-    datos: dict[str, Any]
+    aec: dict[str, Any]
     xml_base64: str
 
     @classmethod
     def from_api(cls, data: dict[str, Any]) -> Aec:
         """Construye un `Aec` desde el `data` que devuelve la API."""
-        return cls(datos=data.get('AEC') or {}, xml_base64=data['xml'])
+        return cls(aec=data.get('AEC') or {}, xml_base64=data['xml'])

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.0}/libredte_lib_sdk/billing/trading_parties/models.py

@@ -30,8 +30,8 @@ class Certificate:
 
     certificate: str
     private_key: str
-    rut: str | None = None
-    nombre: str | None = None
+    id: str | None = None
+    name: str | None = None
     email: str | None = None
     valid_from: datetime | None = None
     valid_until: datetime | None = None
@@ -63,8 +63,8 @@ class Certificate:
         return cls(
             certificate=data['cert'],
             private_key=data['pkey'],
-            rut=data.get('id'),
-            nombre=data.get('name'),
+            id=data.get('id'),
+            name=data.get('name'),
             email=data.get('email'),
             valid_from=(
                 datetime.fromisoformat(data['from'])
@@ -89,13 +89,13 @@ class Certificate:
 class Mandatario:
     """Mandatario (representante) dueño de un certificado digital."""
 
-    rut: str
+    run: str
     nombre: str
     email: str | None = None
 
     def to_payload(self) -> dict[str, Any]:
         """Payload esperado por la API para un mandatario."""
-        payload: dict[str, Any] = {'run': self.rut, 'nombre': self.nombre}
+        payload: dict[str, Any] = {'run': self.run, 'nombre': self.nombre}
         if self.email is not None:
             payload['email'] = self.email
         return payload
@@ -104,7 +104,7 @@ class Mandatario:
     def from_api(cls, data: dict[str, Any]) -> Mandatario:
         """Construye un `Mandatario` desde el `data` que devuelve la API."""
         return cls(
-            rut=data['run'],
+            run=data['run'],
             nombre=data['nombre'],
             email=data.get('email'),
         )

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libredte-lib-sdk"
-version = "0.2.0"
+version = "0.4.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.4.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.4.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.4.0}/tests/integration/test_certificate_loader.py

@@ -24,7 +24,7 @@ from libredte_lib_sdk.billing.trading_parties import Mandatario
 pytestmark = pytest.mark.live
 
 _MANDATARIO = Mandatario(
-    rut='76192083-9',
+    run='76192083-9',
     nombre='SASCO SpA',
     email='demo@sasco.example',
 )
@@ -56,8 +56,8 @@ def test_load_extracts_the_mandatario_and_a_usable_certificate(
 ):
     loaded = real_sdk.system.certificate.loader.load(fake_pkcs12, _PASSWORD)
 
-    assert loaded.rut == '76192083-9'
-    assert loaded.nombre == 'SASCO SpA'
+    assert loaded.id == '76192083-9'
+    assert loaded.name == 'SASCO SpA'
     assert loaded.email == 'demo@sasco.example'
     assert loaded.is_active is True
     assert loaded.certificate.startswith('-----BEGIN CERTIFICATE-----')
@@ -69,6 +69,6 @@ def test_create_from_certificate_matches_load(fake_pkcs12, real_sdk):
     mandatario_manager = real_sdk.billing.trading_parties.mandatario_manager
     mandatario = mandatario_manager.create_from_certificate(loaded)
 
-    assert mandatario.rut == loaded.rut
-    assert mandatario.nombre == loaded.nombre
+    assert mandatario.run == loaded.id
+    assert mandatario.nombre == loaded.name
     assert mandatario.email == loaded.email

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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 `example` realmente utilizable por
 `DocumentBuilderService`, no solo que la llamada HTTP responde.
 """
 
@@ -20,7 +20,7 @@ pytestmark = pytest.mark.live
 
 _EMISOR = {'rut': '76192083-9', 'razon_social': 'SASCO SpA'}
 _MANDATARIO = Mandatario(
-    rut='76192083-9',
+    run='76192083-9',
     nombre='SASCO SpA',
     email='demo@sasco.example',
 )
@@ -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_example_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.example
+    assert 'Detalle' in example.example
     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 `example` 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.example['Encabezado']['IdDoc']['TipoDTE'],
     )
     certificate = b.trading_parties.mandatario_manager.create_fake_certificate(
         _MANDATARIO,
     )
 
     documento = b.document.builder.build_signed(
-        data.parsed_data,
+        data.example,
         caf_xml=caf.xml_base64,
         certificate=certificate,
     )

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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.4.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.4.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.4.0}/tests/test_models.py

@@ -42,7 +42,7 @@ def test_certificate_from_api_maps_cert_and_pkey_fields():
 
 
 def test_mandatario_to_payload_omits_email_when_absent():
-    mandatario = Mandatario(rut='76192083-9', nombre='SASCO SpA')
+    mandatario = Mandatario(run='76192083-9', nombre='SASCO SpA')
 
     assert mandatario.to_payload() == {
         'run': '76192083-9',
@@ -52,7 +52,7 @@ def test_mandatario_to_payload_omits_email_when_absent():
 
 def test_mandatario_to_payload_includes_email_when_present():
     mandatario = Mandatario(
-        rut='76192083-9',
+        run='76192083-9',
         nombre='SASCO SpA',
         email='sasco@example.com',
     )

{libredte_lib_sdk-0.2.0 → libredte_lib_sdk-0.4.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,
     )
@@ -220,15 +241,15 @@ def test_mandatario_manager_create_fake_certificate(sdk):
 
     service = sdk.billing.trading_parties.mandatario_manager
     certificate = service.create_fake_certificate(
-        Mandatario(rut='76192083-9', nombre='SASCO SpA'),
+        Mandatario(run='76192083-9', nombre='SASCO SpA'),
     )
 
     sent = json.loads(route.calls.last.request.content)['parameters']
     assert sent['mandatario']['run'] == '76192083-9'
     assert certificate.certificate == 'CERT-PEM'
     assert certificate.private_key == 'PKEY-PEM'
-    assert certificate.rut == '76192083-9'
-    assert certificate.nombre == 'SASCO SpA'
+    assert certificate.id == '76192083-9'
+    assert certificate.name == 'SASCO SpA'
     assert certificate.email == 'sasco@example.com'
     assert certificate.is_active is True
     assert certificate.issuer == 'Derafu Test Certificate Authority'
@@ -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.example == _INPUT_DATA
     assert example.expected['Encabezado']['Totales']['MntTotal'] == 1190
 
 
@@ -538,7 +586,7 @@ def test_mandatario_manager_create_from_certificate(sdk):
         'certificate': 'cert-pem',
         'privateKey': 'key-pem',
     }
-    assert mandatario.rut == '76192083-9'
+    assert mandatario.run == '76192083-9'
     assert mandatario.nombre == 'SASCO SpA'
     assert mandatario.email == 'demo@sasco.example'
 
@@ -694,8 +742,8 @@ def test_certificate_loader_load_sends_base64_and_decodes_metadata(sdk):
     assert (
         base64.b64decode(sent['certificate']['data']) == b'contenido-del-p12'
     )
-    assert loaded.rut == '76192083-9'
-    assert loaded.nombre == 'SASCO SpA'
+    assert loaded.id == '76192083-9'
+    assert loaded.name == 'SASCO SpA'
     assert loaded.email == 'demo@sasco.example'
     assert loaded.is_active is True
     assert loaded.certificate == 'CERT-PEM'
@@ -990,7 +1038,7 @@ def test_sii_rcv_get_document_sii_reception_date_parses_the_datetime(sdk):
         certificate=Certificate(certificate='cert-pem', private_key='key-pem'),
     )
 
-    assert result.reception_date.isoformat() == '2025-01-02T10:30:00'
+    assert result.fecha_recepcion_sii.isoformat() == '2025-01-02T10:30:00'
     assert result.raw == {'fecha_recepcion_sii': '2025-01-02 10:30:00'}
 
 
@@ -1106,7 +1154,7 @@ def test_aec_build_sends_cedente_cesionario_cesion(sdk):
     }
     assert sent['cesionario']['RazonSocial'] == 'Factoring S.A.'
     assert sent['cesion']['MontoCesion'] == 119000
-    assert result.datos['DocumentoAEC']['Caratula']['RutCedente'] == (
+    assert result.aec['DocumentoAEC']['Caratula']['RutCedente'] == (
         '76192083-9'
     )
     assert result.xml_base64 == 'PEFFQz48L0FFQz4='
@@ -1170,11 +1218,11 @@ def test_document_loader_load_xml_decodes_the_full_bag(sdk):
 
     sent = json.loads(route.calls.last.request.content)['parameters']
     assert sent['xml'] == 'RFRFeG1s'
-    assert result.datos == {'Encabezado': {}}
+    assert result.document == {'Encabezado': {}}
     assert result.document_type == {'codigo': 33, 'nombre': 'Factura'}
-    assert result.stamp_xml == '<TED/>'
-    assert result.extra is None
-    assert result.auth is None
+    assert result.document_stamp == '<TED/>'
+    assert result.document_extra is None
+    assert result.document_auth is None
 
 
 _BOOK_BAG = {
@@ -1279,8 +1327,8 @@ def test_book_loader_load_decodes_book_type_caratula_and_detalle(sdk):
 
     # `book`/`book_auth` siempre vienen `None` desde `load()` (no
     # construye el libro) — ver docstring de `BookBag`.
-    assert result.datos is None
-    assert result.auth is None
+    assert result.book is None
+    assert result.book_auth is None
     assert result.book_type == {
         'codigo': 'libro_ventas',
         'nombre': 'Libro de ventas',

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)