libredte-lib-sdk 0.3.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.3.0 → libredte_lib_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.3.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
@@ -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.input_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.3.0 → libredte_lib_sdk-0.4.0}/README.rst

@@ -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.input_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.3.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.3.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.3.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.input_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.3.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()`.
 
-    `input_data` se pasa directamente al parámetro homónimo de
+    `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
-    input_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'],
-            input_data=data['example'],
+            example=data['example'],
             expected=data.get('expected') or {},
         )
 

{libredte_lib_sdk-0.3.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.3.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.3.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.3.0 → libredte_lib_sdk-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libredte-lib-sdk"
-version = "0.3.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.3.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.3.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 `input_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_input_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.input_data
-    assert 'Detalle' in example.input_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 `input_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.input_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.input_data,
+        data.example,
         caf_xml=caf.xml_base64,
         certificate=certificate,
     )

{libredte_lib_sdk-0.3.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.3.0 → libredte_lib_sdk-0.4.0}/tests/test_services.py

@@ -241,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'
@@ -555,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.input_data == _INPUT_DATA
+    assert example.example == _INPUT_DATA
     assert example.expected['Encabezado']['Totales']['MntTotal'] == 1190
 
 
@@ -586,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'
 
@@ -742,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'
@@ -1038,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'}
 
 
@@ -1154,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='
@@ -1218,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 = {
@@ -1327,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',