libredte-lib-sdk 0.6.1__tar.gz → 0.7.0__tar.gz

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/.gitignore

@@ -17,5 +17,7 @@ docs/_build/
 docs/libredte_lib_sdk*.rst
 docs/modules.rst
 
+.env
+
 # Archivos específicos del sistema operativo.
 .DS_Store

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/CLAUDE.md

@@ -2,14 +2,6 @@
 
 ## Pendiente
 
-- **Tests en vivo de `integration.sii_dte`/`sii_rcv`/`sii_rtc`** (10
-  operaciones): tienen test unitario (mockeado), pero ninguno en
-  `live`. A diferencia del resto de la suite `live` (que usa
-  `fake_certificate`, autofirmado), estas operaciones hablan con el SII
-  real y necesitan un certificado real vigente — no hay fixture para
-  eso hoy, y committear uno no correspondería. Falta decidir el
-  mecanismo (ej. certificado real vía variable de entorno, `skip` si
-  no está disponible) antes de poder escribirlos.
 - **DTO `Liquidacion` sin construir.** `human_resources.payroll
   .calculator::calculate()` recibe `empleado`/`contrato`/`contexto`
   como `dict` (correcto — son entradas) pero **devuelve** la

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.6.1
+Version: 0.7.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
@@ -74,7 +74,11 @@ Uso
 
 .. code-block:: python
 
+    import dataclasses
+
     from libredte_lib_sdk import LibreDTE
+    from libredte_lib_sdk.billing.common import SII_RUT
+    from libredte_lib_sdk.billing.integration import SiiRequestOptions
     from libredte_lib_sdk.billing.trading_parties import Mandatario
 
     sdk = LibreDTE()  # base_url y api_token también vía env vars, ver abajo
@@ -90,6 +94,7 @@ Uso
                 'RUTEmisor': '76192083-9',
                 'RznSoc': 'SASCO SpA',
                 'GiroEmis': 'Servicios',
+                'Acteco': 620200,
                 'DirOrigen': 'Santiago',
                 'CmnaOrigen': 'Santiago',
             },
@@ -116,7 +121,7 @@ Uso
         codigo_documento=33, folio_desde=1, folio_hasta=100,
     )
     certificate = b.trading_parties.mandatario_manager.create_fake_certificate(
-        Mandatario(rut='76192083-9', nombre='SASCO SpA', email='sasco@example.com'),
+        Mandatario(run='76192083-9', nombre='SASCO SpA', email='sasco@example.com'),
     )
 
     # En producción: cargar y validar el CAF real que el SII le entregó
@@ -132,17 +137,46 @@ Uso
         input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
-    # 3. Envío al SII (arma el sobre EnvioDTE y luego lo envía).
-    # `documento` ya trae certificate/emisor incluidos — no hace falta
-    # pasarlos aparte.
-    sobre = b.document.dispatcher.create(documento)
+    # 3. Sobres. El envío normal usa dos: uno para el SII y otro para el
+    # receptor del documento (el cliente). `documento` ya trae
+    # certificate/emisor incluidos — no hace falta pasarlos aparte, salvo
+    # `autorizacion_dte` del emisor (`fecha_resolucion` y
+    # `numero_resolucion`), que va en la carátula.
+    documento = dataclasses.replace(
+        documento,
+        emisor={
+            **documento.emisor,
+            'autorizacion_dte': {
+                'fecha_resolucion': '2019-12-23',
+                'numero_resolucion': 0,
+            },
+        },
+    )
+
+    # El sobre para el SII siempre tiene al SII como receptor.
+    sobre_sii = b.document.dispatcher.create(documento, receptor_rut=SII_RUT)
+
+    # El sobre para el cliente toma el receptor del documento.
+    sobre_cliente = b.document.dispatcher.create(documento)
+
+    # 4. Envío al SII y estado del envío, por Track ID.
     envio = b.integration.sii_dte.send(
-        sobre.xml_base64, certificate=certificate, company_rut='76192083-9',
+        sobre_sii.xml_base64, certificate=certificate,
+        company_rut='76192083-9',
+    )
+    estado = b.integration.sii_dte.check_status(
+        envio.track_id, certificate=certificate, company_rut='76192083-9',
     )
 
-    # 4. Estado del envío, por Track ID.
+    # Las boletas (tipos 39 y 41) se envían por otra API del SII, solo
+    # disponible en Lib Pro: `b.integration.sii_boleta` tiene `send()`,
+    # `check_status()` y `validate_document()` con la misma forma.
+
+    # Reintentos y tiempos de una llamada al SII (todos opcionales; la API
+    # usa los suyos si no se indican y los ajusta a su rango).
     estado = b.integration.sii_dte.check_status(
         envio.track_id, certificate=certificate, company_rut='76192083-9',
+        options=SiiRequestOptions(retries=3, timeout=20, max_duration=60),
     )
 
     # 5. HTML o PDF — misma forma de respuesta para ambos.
@@ -254,7 +288,10 @@ levanta ``libredte_lib_sdk.LibreDteApiError``, con ``.status_code``,
 si la API la informó — ej. ``DocumentException``, o una excepción de
 autenticación del SII). Un ``429`` de la API levanta
 ``LibreDteRateLimitError`` (subclase de lo anterior), con
-``.retry_after``/``.limit``/``.remaining``. Un problema de red levanta
+``.retry_after`` y ``.reset_at`` (cuándo se libera), ``.policy`` (cuál límite
+se agotó), el cupo del usuario (``.limit``/``.remaining``, solo con
+autenticación) y el límite por IP (``.ip_limit``/``.ip_remaining``). Cada
+dato es ``None`` si la API no lo informa. Un problema de red levanta
 ``libredte_lib_sdk.LibreDteConnectionError``.
 
 Desarrollo
@@ -270,6 +307,17 @@ Los tests unitarios no hacen red real: mockean la API con ``respx``. Los
 de ``tests/integration/`` sí (marker ``live``), y están excluidos por
 defecto de ``pytest``/``make test``/``make check``.
 
+Los tests ``live`` usan ``LIBREDTE_LIB_SDK_BASE_URL`` y
+``LIBREDTE_LIB_SDK_TOKEN``. Los de ``tests/integration/test_sii_certification.py``
+envían documentos reales al ambiente de certificación del SII y se omiten si
+faltan estas variables de entorno:
+
+- ``LIBREDTE_CERTIFICATE_CERT`` y ``LIBREDTE_CERTIFICATE_PKEY``: certificado
+  digital y su clave privada, en PEM (un ``\n`` literal vale como salto de
+  línea).
+- ``LIBREDTE_CAF_DIR``: directorio con los CAF de certificación, uno por tipo
+  de documento (``033.xml``, ``034.xml``, ``039.xml``, ...).
+
 Términos y condiciones de uso
 ------------------------------
 

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/README.rst

@@ -30,7 +30,11 @@ Uso
 
 .. code-block:: python
 
+    import dataclasses
+
     from libredte_lib_sdk import LibreDTE
+    from libredte_lib_sdk.billing.common import SII_RUT
+    from libredte_lib_sdk.billing.integration import SiiRequestOptions
     from libredte_lib_sdk.billing.trading_parties import Mandatario
 
     sdk = LibreDTE()  # base_url y api_token también vía env vars, ver abajo
@@ -46,6 +50,7 @@ Uso
                 'RUTEmisor': '76192083-9',
                 'RznSoc': 'SASCO SpA',
                 'GiroEmis': 'Servicios',
+                'Acteco': 620200,
                 'DirOrigen': 'Santiago',
                 'CmnaOrigen': 'Santiago',
             },
@@ -72,7 +77,7 @@ Uso
         codigo_documento=33, folio_desde=1, folio_hasta=100,
     )
     certificate = b.trading_parties.mandatario_manager.create_fake_certificate(
-        Mandatario(rut='76192083-9', nombre='SASCO SpA', email='sasco@example.com'),
+        Mandatario(run='76192083-9', nombre='SASCO SpA', email='sasco@example.com'),
     )
 
     # En producción: cargar y validar el CAF real que el SII le entregó
@@ -88,17 +93,46 @@ Uso
         input_data, caf_xml=caf.xml_base64, certificate=certificate,
     )
 
-    # 3. Envío al SII (arma el sobre EnvioDTE y luego lo envía).
-    # `documento` ya trae certificate/emisor incluidos — no hace falta
-    # pasarlos aparte.
-    sobre = b.document.dispatcher.create(documento)
+    # 3. Sobres. El envío normal usa dos: uno para el SII y otro para el
+    # receptor del documento (el cliente). `documento` ya trae
+    # certificate/emisor incluidos — no hace falta pasarlos aparte, salvo
+    # `autorizacion_dte` del emisor (`fecha_resolucion` y
+    # `numero_resolucion`), que va en la carátula.
+    documento = dataclasses.replace(
+        documento,
+        emisor={
+            **documento.emisor,
+            'autorizacion_dte': {
+                'fecha_resolucion': '2019-12-23',
+                'numero_resolucion': 0,
+            },
+        },
+    )
+
+    # El sobre para el SII siempre tiene al SII como receptor.
+    sobre_sii = b.document.dispatcher.create(documento, receptor_rut=SII_RUT)
+
+    # El sobre para el cliente toma el receptor del documento.
+    sobre_cliente = b.document.dispatcher.create(documento)
+
+    # 4. Envío al SII y estado del envío, por Track ID.
     envio = b.integration.sii_dte.send(
-        sobre.xml_base64, certificate=certificate, company_rut='76192083-9',
+        sobre_sii.xml_base64, certificate=certificate,
+        company_rut='76192083-9',
+    )
+    estado = b.integration.sii_dte.check_status(
+        envio.track_id, certificate=certificate, company_rut='76192083-9',
     )
 
-    # 4. Estado del envío, por Track ID.
+    # Las boletas (tipos 39 y 41) se envían por otra API del SII, solo
+    # disponible en Lib Pro: `b.integration.sii_boleta` tiene `send()`,
+    # `check_status()` y `validate_document()` con la misma forma.
+
+    # Reintentos y tiempos de una llamada al SII (todos opcionales; la API
+    # usa los suyos si no se indican y los ajusta a su rango).
     estado = b.integration.sii_dte.check_status(
         envio.track_id, certificate=certificate, company_rut='76192083-9',
+        options=SiiRequestOptions(retries=3, timeout=20, max_duration=60),
     )
 
     # 5. HTML o PDF — misma forma de respuesta para ambos.
@@ -210,7 +244,10 @@ levanta ``libredte_lib_sdk.LibreDteApiError``, con ``.status_code``,
 si la API la informó — ej. ``DocumentException``, o una excepción de
 autenticación del SII). Un ``429`` de la API levanta
 ``LibreDteRateLimitError`` (subclase de lo anterior), con
-``.retry_after``/``.limit``/``.remaining``. Un problema de red levanta
+``.retry_after`` y ``.reset_at`` (cuándo se libera), ``.policy`` (cuál límite
+se agotó), el cupo del usuario (``.limit``/``.remaining``, solo con
+autenticación) y el límite por IP (``.ip_limit``/``.ip_remaining``). Cada
+dato es ``None`` si la API no lo informa. Un problema de red levanta
 ``libredte_lib_sdk.LibreDteConnectionError``.
 
 Desarrollo
@@ -226,6 +263,17 @@ Los tests unitarios no hacen red real: mockean la API con ``respx``. Los
 de ``tests/integration/`` sí (marker ``live``), y están excluidos por
 defecto de ``pytest``/``make test``/``make check``.
 
+Los tests ``live`` usan ``LIBREDTE_LIB_SDK_BASE_URL`` y
+``LIBREDTE_LIB_SDK_TOKEN``. Los de ``tests/integration/test_sii_certification.py``
+envían documentos reales al ambiente de certificación del SII y se omiten si
+faltan estas variables de entorno:
+
+- ``LIBREDTE_CERTIFICATE_CERT`` y ``LIBREDTE_CERTIFICATE_PKEY``: certificado
+  digital y su clave privada, en PEM (un ``\n`` literal vale como salto de
+  línea).
+- ``LIBREDTE_CAF_DIR``: directorio con los CAF de certificación, uno por tipo
+  de documento (``033.xml``, ``034.xml``, ``039.xml``, ...).
+
 Términos y condiciones de uso
 ------------------------------
 

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/book/validator.py

@@ -18,8 +18,10 @@ class BookValidatorService:
     vacío en caso de éxito.
     """
 
-    _VALIDATE_SCHEMA_OPERATION = 'billing.book.validator::validateSchema'
-    _VALIDATE_SIGNATURE_OPERATION = 'billing.book.validator::validateSignature'
+    _VALIDATE_SCHEMA_OPERATION = 'billing.book.validator::validate_schema'
+    _VALIDATE_SIGNATURE_OPERATION = (
+        'billing.book.validator::validate_signature'
+    )
 
     def __init__(self, client: ApiClient) -> None:
         """Guarda el `ApiClient` compartido usado para llamar a la API."""
@@ -40,7 +42,9 @@ class BookValidatorService:
         Valida la firma electrónica del libro.
 
         El libro tiene una sola firma — devuelve un único `dict`, no
-        una lista.
+        una lista, con `{'valid': bool, 'error': str | None,
+        'signature': {...}}`. Una firma inválida no levanta error, hay
+        que revisar `valid`.
         """
         return cast(
             'dict[str, Any]',

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/common.py

@@ -8,6 +8,16 @@ from __future__ import annotations
 import base64
 from typing import Any
 
+SII_RUT = '60803000-K'
+"""
+RUT del SII, receptor de la carátula de todo sobre que se envía al SII.
+
+Un sobre para el SII (`SiiDteService.send`, `SiiBoletaService.send`) se
+arma con `receptor_rut=SII_RUT`. Un sobre para el receptor real del
+documento (el cliente) se arma sin `receptor_rut`: la carátula toma el
+receptor del primer documento.
+"""
+
 
 def encode_content(content: str | bytes) -> str:
     """

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/document/dispatcher.py

@@ -17,34 +17,53 @@ class DocumentDispatcherService:
     """Arma y valida el sobre `EnvioDTE` (`billing.document.dispatcher`)."""
 
     _CREATE_OPERATION = 'billing.document.dispatcher::create'
-    _CREATE_MANY_OPERATION = 'billing.document.dispatcher::createMany'
-    _LOAD_XML_OPERATION = 'billing.document.dispatcher::loadXml'
+    _CREATE_MANY_OPERATION = 'billing.document.dispatcher::create_many'
+    _LOAD_XML_OPERATION = 'billing.document.dispatcher::load_xml'
     _VALIDATE_OPERATION = 'billing.document.dispatcher::validate'
-    _VALIDATE_SCHEMA_OPERATION = 'billing.document.dispatcher::validateSchema'
+    _VALIDATE_SCHEMA_OPERATION = 'billing.document.dispatcher::validate_schema'
     _VALIDATE_SIGNATURE_OPERATION = (
-        'billing.document.dispatcher::validateSignature'
+        'billing.document.dispatcher::validate_signature'
     )
 
     def __init__(self, client: ApiClient) -> None:
         """Guarda el `ApiClient` compartido usado para llamar a la API."""
         self._client = client
 
-    def create(self, bag: DocumentBag) -> DocumentEnvelope:
+    def create(
+        self,
+        bag: DocumentBag,
+        *,
+        receptor_rut: str | None = None,
+    ) -> DocumentEnvelope:
         """
-        Envuelve y firma un documento ya timbrado en un sobre `EnvioDTE`.
+        Envuelve y firma un documento ya timbrado en un sobre.
 
         `bag` es el `DocumentBag` ya timbrado y firmado que devuelve
         `DocumentBuilderService.build_signed()` — trae `certificate`/
         `emisor` incluidos, no hace falta pasarlos aparte. El sobre
         resultante es lo que se envía al SII (`SiiDteService.send`).
+
+        `receptor_rut` es el RUT del receptor de la carátula del sobre.
+        Sin indicarlo es el receptor del documento, que es el sobre para
+        enviar al cliente. El sobre que va al SII se arma con
+        `receptor_rut=SII_RUT` (`60803000-K`): el SII lo exige y rechaza
+        el envío con otro receptor. El envío normal usa dos sobres, uno
+        para el SII y otro para el cliente. Para enviar el sobre al SII
+        el emisor debe traer `autorizacion_dte`, con `fecha_resolucion` y
+        `numero_resolucion` de su autorización.
         """
         response = self._client.call_response(
             self._CREATE_OPERATION,
-            bag=self._bag_payload(bag),
+            bag=self._bag_payload(bag, receptor_rut),
         )
         return build_response(DocumentEnvelope, response)
 
-    def create_many(self, bags: Sequence[DocumentBag]) -> DocumentEnvelope:
+    def create_many(
+        self,
+        bags: Sequence[DocumentBag],
+        *,
+        receptor_rut: str | None = None,
+    ) -> DocumentEnvelope:
         """
         Envuelve y firma 2+ documentos ya timbrados en un sobre `EnvioDTE`.
 
@@ -53,15 +72,24 @@ class DocumentDispatcherService:
         `emisor`. El sobre resultante queda firmado con el certificado
         del PRIMER `DocumentBag` (el sobre en sí también se firma, no
         solo cada documento).
+
+        `receptor_rut` funciona igual que en `create()`: es el receptor
+        de la carátula del sobre, y para el SII debe ser `SII_RUT`.
         """
         response = self._client.call_response(
             self._CREATE_MANY_OPERATION,
-            bags=[self._bag_payload(bag) for bag in bags],
+            bags=[
+                self._bag_payload(bag, receptor_rut if index == 0 else None)
+                for index, bag in enumerate(bags)
+            ],
         )
         return build_response(DocumentEnvelope, response)
 
     @staticmethod
-    def _bag_payload(bag: DocumentBag) -> dict[str, Any]:
+    def _bag_payload(
+        bag: DocumentBag,
+        receptor_rut: str | None = None,
+    ) -> dict[str, Any]:
         if bag.certificate is None:
             raise ValueError(
                 'Este DocumentBag no tiene certificado — ¿se firmó con '
@@ -73,11 +101,15 @@ class DocumentDispatcherService:
                 '`builder.build_draft/build_signed()` o se cargó con '
                 '`loader.load_xml()`?',
             )
-        return {
+        payload: dict[str, Any] = {
             'xmlDocument': bag.xml_base64,
             'certificate': bag.certificate.to_payload(),
             'emisor': bag.emisor,
         }
+        if receptor_rut is not None:
+            payload['receptor'] = {'rut': receptor_rut}
+
+        return payload
 
     def load_xml(self, xml_base64: str) -> DocumentEnvelope:
         """
@@ -121,7 +153,9 @@ class DocumentDispatcherService:
 
         Un sobre trae más de una firma (la del DTE y la del propio
         `EnvioDTE`) — devuelve una lista, un ítem por firma. Cada ítem
-        es un `dict` vacío en caso de éxito.
+        es `{'valid': bool, 'error': str | None, 'signature': {...}}`,
+        igual que en `DocumentValidatorService.validate_signature()`: una
+        firma inválida no levanta error, hay que revisar `valid`.
         """
         return cast(
             'list[dict[str, Any]]',

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/document/loader.py

@@ -14,13 +14,13 @@ class DocumentLoaderService:
     """
     Carga un documento tributario completo desde su XML.
 
-    Solo cubre `loadXml` — pensado para reconstruir los datos
+    Solo cubre `load_xml` — pensado para reconstruir los datos
     normalizados de un DTE ya emitido (timbrado y firmado) a partir de
     su XML, ej. un documento recibido de un tercero o recuperado de un
     respaldo.
     """
 
-    _LOAD_XML_OPERATION = 'billing.document.loader::loadXml'
+    _LOAD_XML_OPERATION = 'billing.document.loader::load_xml'
 
     def __init__(self, client: ApiClient) -> None:
         """Guarda el `ApiClient` compartido usado para llamar a la API."""

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/document/models.py

@@ -31,15 +31,15 @@ class DocumentBag:
     """
     Bolsa de un documento tributario.
 
-    Devuelta por `document.builder::build`/`document.loader::loadXml`/
+    Devuelta por `document.builder::build`/`document.loader::load_xml`/
     `document.parser::parse` — todas en esta misma forma, con los campos
     que correspondan a cuánto se hizo con el documento. `document`
     (`Encabezado`/`Detalle`, con el merge de `libredte_data.extra.dte`
     si se pasó al renderizar) es la vista "de datos" limpia del
     documento — SIN los campos opcionales no usados (se omiten, no
-    quedan en `False`). `document_normalized` es la data cruda tal como
+    quedan en `None`). `document_normalized` es la data cruda tal como
     la usa el builder internamente para generar el XML (con esos
-    campos opcionales en `False` en vez de omitidos): es la que hay que
+    campos opcionales en `None` en vez de omitidos): es la que hay que
     guardar para poder reconstruir el documento después con
     `options={'normalizer': {'normalize': False}}` sin volver a
     normalizar — usar `document` para eso corrompe la reconstrucción.
@@ -48,8 +48,8 @@ class DocumentBag:
     puede ser un borrador, un documento timbrado, o timbrado y firmado,
     no una subclase distinta: es el mismo recurso en distintos estados
     según qué datos se le hayan pasado a `DocumentBuilderService`. Un
-    borrador sin folio asignado tiene folio `0` en `document_id` (ver
-    `AbstractDocument::getId()` en la biblioteca), nunca lanza error.
+    borrador sin folio asignado tiene folio `0` en `document_id`
+    (criterio de la biblioteca), nunca lanza error.
 
     `document_stamp_base64` es el TED — `None` si el documento aún no
     está timbrado (ver `is_timbrado`). `document_extra` son los campos
@@ -64,7 +64,7 @@ class DocumentBag:
     ninguna al construir/cargar el documento.
 
     `certificate`/`caf` son `None` salvo que el documento se haya
-    construido con ellos (`build_signed`, o un `loadXml` de un XML ya
+    construido con ellos (`build_signed`, o un `load_xml` de un XML ya
     firmado/timbrado) — un borrador (`build_draft`) no los trae.
     `emisor`/`receptor` sí están siempre que haya un documento
     construido (`Encabezado.Emisor`/`Encabezado.Receptor` ya
@@ -209,8 +209,8 @@ class DocumentEnvelope(XmlPayloadMixin):
 
     `documents` trae una bolsa (`DocumentBag`) por cada documento
     tributario que el sobre contiene — uno solo si se armó con
-    `create()`, uno o más si se armó con `createMany()` o si se cargó
-    con `loadXml()` un sobre que agrupaba varios documentos. `caratula`
+    `create()`, uno o más si se armó con `create_many()` o si se cargó
+    con `load_xml()` un sobre que agrupaba varios documentos. `caratula`
     es el `dict` con los datos de la carátula del sobre (`RutEmisor`,
     `RutEnvia`, `RutReceptor`, `FchResol`, `NroResol`, `TmstFirmaEnv`,
     `SubTotDTE`).
@@ -249,9 +249,8 @@ class RenderedDocument:
     liquidación de sueldo, que siempre es un único archivo).
     `copies`/`copy_number` identifican esta copia entre las pedidas de
     ese mismo `label` (ej. `copies=2, copy_number=1` es la primera de
-    2 copias tributarias). El nombre de los campos en la API
-    (`content`/`mimeType`/`filename`/`copyNumber`) es camelCase; acá
-    quedan en snake_case como el resto del SDK.
+    2 copias tributarias). La API entrega los campos como
+    `content`/`mime_type`/`filename`/`copy_number`.
     """
 
     content_base64: str
@@ -271,11 +270,11 @@ class RenderedDocument:
         """Construye desde un ítem de `data.renderings`."""
         return cls(
             content_base64=data['content'],
-            mime_type=data['mimeType'],
+            mime_type=data['mime_type'],
             filename=data['filename'],
             label=data.get('label'),
             copies=data['copies'],
-            copy_number=data['copyNumber'],
+            copy_number=data['copy_number'],
         )
 
 

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/document/validator.py

@@ -20,9 +20,9 @@ class DocumentValidatorService:
     """
 
     _VALIDATE_OPERATION = 'billing.document.validator::validate'
-    _VALIDATE_SCHEMA_OPERATION = 'billing.document.validator::validateSchema'
+    _VALIDATE_SCHEMA_OPERATION = 'billing.document.validator::validate_schema'
     _VALIDATE_SIGNATURE_OPERATION = (
-        'billing.document.validator::validateSignature'
+        'billing.document.validator::validate_signature'
     )
 
     def __init__(self, client: ApiClient) -> None:
@@ -58,8 +58,13 @@ class DocumentValidatorService:
         """
         Valida la firma electrónica del documento.
 
-        Devuelve un `dict` vacío en caso de éxito. Si la firma no es
-        válida, la API levanta `LibreDteApiError`.
+        Devuelve `{'valid': bool, 'error': str | None, 'signature': {...}}`.
+        La API responde con éxito tanto si la firma es válida como si no
+        lo es: el resultado está en `valid`, y `error` explica el motivo
+        cuando es `False` (por ejemplo, que el contenido se modificó
+        después de firmarlo). `signature` trae los datos de la firma
+        (`reference`, `signature_method`, `digest_method`, el certificado
+        y `signer`, con los datos del certificado del firmante).
         """
         return cast(
             'dict[str, Any]',

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/exchange/document_response.py

@@ -23,16 +23,16 @@ class DocumentResponseService:
     """
 
     _BUILD_ENVIO_RECIBOS_OPERATION = (
-        'billing.exchange.document_response::buildEnvioRecibos'
+        'billing.exchange.document_response::build_envio_recibos'
     )
     _BUILD_RESPUESTA_ENVIO_OPERATION = (
-        'billing.exchange.document_response::buildRespuestaEnvio'
+        'billing.exchange.document_response::build_respuesta_envio'
     )
     _VALIDATE_SCHEMA_OPERATION = (
-        'billing.exchange.document_response::validateSchema'
+        'billing.exchange.document_response::validate_schema'
     )
     _VALIDATE_SIGNATURE_OPERATION = (
-        'billing.exchange.document_response::validateSignature'
+        'billing.exchange.document_response::validate_signature'
     )
 
     def __init__(self, client: ApiClient) -> None:
@@ -111,7 +111,9 @@ class DocumentResponseService:
         `EnvioRecibos` trae múltiples firmas (una por recibo, más la
         del `SetRecibos`); `RespuestaDTE` trae solo la del nodo
         `Resultado`. En ambos casos se devuelve una lista, un ítem por
-        firma.
+        firma, cada uno con `{'valid': bool, 'error': str | None,
+        'signature': {...}}`. Una firma inválida no levanta error, hay
+        que revisar `valid`.
         """
         return cast(
             'list[dict[str, Any]]',

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/exchange/models.py

@@ -18,7 +18,7 @@ from ..common import XmlPayloadMixin
 @dataclass(frozen=True, slots=True)
 class EnvioRecibos(XmlPayloadMixin):
     """
-    XML `EnvioRecibos` construido (`document_response::buildEnvioRecibos`).
+    XML `EnvioRecibos` construido (`document_response::build_envio_recibos`).
 
     Recibo de mercaderías o servicios prestados por un proveedor.
     `datos` es la estructura ya parseada, `xml_base64` el XML completo
@@ -43,7 +43,7 @@ class EnvioRecibos(XmlPayloadMixin):
 @dataclass(frozen=True, slots=True)
 class RespuestaEnvio(XmlPayloadMixin):
     """
-    XML `RespuestaDTE` construido (`document_response::buildRespuestaEnvio`).
+    XML `RespuestaDTE` construido (`document_response::build_respuesta_envio`).
 
     Acuse de recibo del envío (`RecepcionEnvio`) o resultado de
     validación por documento (`ResultadoDTE`), según los datos

{libredte_lib_sdk-0.6.1 → libredte_lib_sdk-0.7.0}/libredte_lib_sdk/billing/identifier/models.py

@@ -62,13 +62,13 @@ class Caf(XmlPayloadMixin):
         return cls(
             id=data['id'],
             emisor=data['emisor'],
-            tipo_documento=data['tipoDocumento'],
-            folio_desde=data['folioDesde'],
-            folio_hasta=data['folioHasta'],
-            cantidad_folios=data['cantidadFolios'],
-            fecha_autorizacion=data['fechaAutorizacion'],
-            fecha_vencimiento=data.get('fechaVencimiento'),
-            meses_autorizacion=data['mesesAutorizacion'],
+            tipo_documento=data['tipo_documento'],
+            folio_desde=data['folio_desde'],
+            folio_hasta=data['folio_hasta'],
+            cantidad_folios=data['cantidad_folios'],
+            fecha_autorizacion=data['fecha_autorizacion'],
+            fecha_vencimiento=data.get('fecha_vencimiento'),
+            meses_autorizacion=data['meses_autorizacion'],
             vigente=data['vigente'],
             vence=data['vence'],
             idk=data['idk'],
@@ -76,12 +76,12 @@ class Caf(XmlPayloadMixin):
             if ambiente is not None
             else None,
             # Mismo valor que `ambiente`, ya resuelto a `int` — la API lo
-            # entrega redundante así (`Caf::getCertificacion()` en
-            # libredte-lib-core es literalmente `getEnvironment()?->value`),
-            # se mantiene igual acá para no diverger del shape real.
+            # entrega redundante así (en libredte-lib-core es literalmente
+            # el valor de `ambiente`), se mantiene igual acá para no diverger
+            # del shape real.
             certificacion=data.get('certificacion'),
-            public_key=data['publicKey'],
-            private_key=data['privateKey'],
+            public_key=data['public_key'],
+            private_key=data['private_key'],
             xml_base64=data['xml'],
             raw=data,
         )