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

{libredte_lib_sdk-0.1.0 → libredte_lib_sdk-0.3.0}/.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ['3.14']
+        python-version: ['3.11', '3.12', '3.13', '3.14']
 
     steps:
       - name: Check out repository
@@ -42,6 +42,9 @@ jobs:
       - name: Run Ruff (format)
         run: ruff format --check .
 
+      - name: Run mypy
+        run: mypy
+
       # No corre los tests `live` (marker `live`, excluidos por defecto vía
       # `addopts` en pyproject.toml): golpean la API real de LibreDTE y/o
       # un ambiente de desarrollo local, no algo apto para CI.

libredte_lib_sdk-0.3.0/.github/workflows/docs.yml

@@ -0,0 +1,43 @@
+name: Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+jobs:
+  docs:
+    name: Docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e '.[docs]'
+
+      - name: Generate API reference
+        run: sphinx-apidoc -o docs/ libredte_lib_sdk --force --separate
+
+      - name: Build documentation
+        run: sphinx-build -b html docs/ docs/_build/html
+
+      - name: Create CNAME file
+        run: echo "lib-sdk-python.docs.libredte.cl" > docs/_build/html/CNAME
+
+      - name: Deploy to GitHub Pages
+        if: success()
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/_build/html
+          publish_branch: gh-pages

libredte_lib_sdk-0.3.0/.gitignore

@@ -0,0 +1,21 @@
+# Python.
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+.coverage
+var/
+# Referencia de API generada por `sphinx-apidoc` (ver `make docs` /
+# `build.jobs.pre_build` en `.readthedocs.yaml`) — no se commitea, se
+# regenera en cada build a partir de los docstrings.
+docs/_build/
+docs/libredte_lib_sdk*.rst
+docs/modules.rst
+
+# Archivos específicos del sistema operativo.
+.DS_Store

libredte_lib_sdk-0.3.0/.readthedocs.yaml

@@ -0,0 +1,26 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    # La referencia de API (docs/libredte_lib_sdk*.rst, docs/modules.rst)
+    # no se commitea: se regenera acá a partir de los docstrings, igual
+    # que hace `make docs` en local.
+    pre_build:
+      - sphinx-apidoc -o docs/ libredte_lib_sdk --force --separate
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

libredte_lib_sdk-0.3.0/CLAUDE.md

@@ -0,0 +1,37 @@
+# `libredte_lib_sdk` — pendientes
+
+## 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
+  liquidación también como `dict`, sin tipar; al ser una respuesta,
+  debería tipar como un DTO real (reusable también como entrada de
+  `renderer::render()`, que hoy acepta el mismo `dict` tal cual, igual
+  que `Certificate`). Pendiente por el tamaño de la entidad real en
+  `libredte-lib-pro` (`Liquidacion`, con `Empleado`/`Contrato`/
+  `LiquidacionContexto` anidados; `Empleado` por sí solo tiene ~26
+  campos con varios enums y objetos anidados — `Contacto`,
+  `CuentaBancaria`, `CargaFamiliar`).
+- **`exchange.receiver`/`exchange.sender`** (framework genérico de
+  intercambio de documentos comerciales, tipo Peppol/UBL, no solo DTE)
+  queda fuera del SDK — se agrega cuando una app consumidora lo
+  necesite de verdad.
+- **Docs (Sphinx) armadas pero sin publicar.** `.readthedocs.yaml` +
+  `docs/` generan la documentación (`make docs`), y
+  `.github/workflows/docs.yml` ya publica a GitHub Pages
+  (`gh-pages`) con CNAME `lib-sdk-python.docs.libredte.cl` en cada
+  push a `main`. Faltan 2 pasos externos, ninguno hecho todavía: (1)
+  conectar el repo en readthedocs.org (sin eso no hay build ahí ni URL
+  en `readthedocs.io`); (2) apuntar el DNS de
+  `lib-sdk-python.docs.libredte.cl` a GitHub Pages y habilitar el
+  origen `gh-pages` en la configuración de Pages del repo (sin eso el
+  workflow corre pero el dominio no sirve nada).

libredte_lib_sdk-0.3.0/LICENSE

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

{libredte_lib_sdk-0.1.0 → libredte_lib_sdk-0.3.0}/Makefile

@@ -1,4 +1,4 @@
-.PHONY: install-dev lint format format-check test test-live check build upload clean
+.PHONY: install-dev lint format format-check typecheck test test-live check docs build upload clean
 
 VENV = .venv
 VENV_READY = $(VENV)/.installed
@@ -20,6 +20,9 @@ format: $(VENV_READY)
 format-check: $(VENV_READY)
 	$(VENV)/bin/ruff format --check .
 
+typecheck: $(VENV_READY)
+	$(VENV)/bin/mypy
+
 test: $(VENV_READY)
 	$(VENV)/bin/pytest -v
 
@@ -29,7 +32,12 @@ test: $(VENV_READY)
 test-live: $(VENV_READY)
 	$(VENV)/bin/pytest -v -m live
 
-check: lint format-check test
+check: lint format-check typecheck test
+
+docs: $(VENV_READY)
+	$(VENV)/bin/pip install -e '.[docs]'
+	$(VENV)/bin/sphinx-apidoc -o docs libredte_lib_sdk --force --separate
+	$(VENV)/bin/sphinx-build -b html docs docs/_build/html
 
 build: $(VENV_READY)
 	$(VENV)/bin/python -m build

libredte_lib_sdk-0.3.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.5
+Name: libredte-lib-sdk
+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
+Author: LibreDTE
+License: MIT License
+        
+        Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: respx; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme; extra == 'docs'
+Description-Content-Type: text/x-rst
+
+LibreDTE: SDK Python para la API de LibreDTE Lib
+================================================
+
+SDK Python (``libredte_lib_sdk``) que orquesta la API de LibreDTE Lib
+(``https://core.libredte.cl/api`` por defecto) para cubrir el ciclo de
+emisión de un DTE: borrador, documento timbrado y firmado,
+envío al SII, consulta de estado por Track ID, y generación de HTML/PDF
+— más carga y validación de CAF real, y generación de CAF y certificado
+ficticios para poder probar todo lo anterior sin credenciales reales.
+
+Pensado como base de una app de facturación (ej. Django): este SDK
+concentra la lógica de negocio/orquestación de DTE, para que la app web
+sea solo vista, autenticación y persistencia.
+
+El paquete Python espeja la organización de la propia API
+(``package.component.worker::operation``): ``sdk.billing.<component>
+.<worker>`` para negocio DTE, ``sdk.system.<component>.<worker>`` para
+infraestructura de la biblioteca (catálogos reales, carga de certificados
+— ver "Recursos de `system`" más abajo).
+
+Instalación
+-----------
+
+.. code-block:: bash
+
+    pip install libredte-lib-sdk
+
+Uso
+---
+
+.. code-block:: python
+
+    from libredte_lib_sdk import LibreDTE
+    from libredte_lib_sdk.billing.trading_parties import Mandatario
+
+    sdk = LibreDTE()  # base_url y api_token también vía env vars, ver abajo
+    b = sdk.billing
+
+    input_data = {
+        'Encabezado': {
+            'IdDoc': {
+                'TipoDTE': 33,
+                'Folio': 1
+            },
+            'Emisor': {
+                'RUTEmisor': '76192083-9',
+                'RznSoc': 'SASCO SpA',
+                'GiroEmis': 'Servicios',
+                'DirOrigen': 'Santiago',
+                'CmnaOrigen': 'Santiago',
+            },
+            'Receptor': {
+                'RUTRecep': '12345678-5',
+                'RznSocRecep': 'Cliente de prueba',
+                'GiroRecep': 'Giro',
+                'DirRecep': 'Santiago',
+                'CmnaRecep': 'Santiago',
+            },
+        },
+        'Detalle': [
+            {
+                'NmbItem': 'Producto A',
+                'QtyItem': 1,
+                'PrcItem': 1000
+            }
+        ],
+    }
+
+    # CAF y certificado ficticios, para pruebas/desarrollo:
+    caf = b.identifier.caf_faker.create(
+        {'rut': '76192083-9', 'razon_social': 'SASCO SpA'},
+        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'),
+    )
+
+    # En producción: cargar y validar el CAF real que el SII le entregó
+    # al emisor, en vez del CAF ficticio de arriba.
+    # caf = b.identifier.caf_loader.load(xml_base64_del_caf_subido)
+    # b.identifier.caf_validator.validate(caf.xml_base64)
+
+    # 1. Borrador.
+    borrador = b.document.builder.build_draft(input_data)
+
+    # 2. Documento real, timbrado y firmado.
+    documento = b.document.builder.build_signed(
+        input_data, caf_xml=caf.xml_base64, certificate=certificate,
+    )
+
+    # 3. Envío al SII (arma el sobre EnvioDTE y luego lo envía).
+    emisor = {
+        'rut': '76192083-9',
+        'razon_social': 'SASCO SpA',
+        'autorizacion_dte': {
+            'fecha_resolucion': '2014-08-22', 'numero_resolucion': 80,
+        },
+    }
+    sobre = b.document.dispatcher.create(
+        documento.xml_base64, certificate=certificate, emisor=emisor,
+    )
+    envio = b.integration.sii_dte.send(
+        sobre.xml_base64, certificate=certificate, company_rut='76192083-9',
+    )
+
+    # 4. Estado del envío, por Track ID.
+    estado = b.integration.sii_dte.check_status(
+        envio.track_id, certificate=certificate, company_rut='76192083-9',
+    )
+
+    # 5. HTML o PDF — misma forma de respuesta para ambos.
+    html = b.document.renderer.render(documento.xml_base64, format='html')
+    pdf = b.document.renderer.render(documento.xml_base64, format='pdf')
+    pdf_bytes = pdf.first.content_bytes
+
+    # Varias copias/presentaciones en una sola llamada (ej. cedible +
+    # tributaria):
+    copias = b.document.renderer.render(
+        documento.xml_base64,
+        format='pdf',
+        renderings={'tributaria': 1, 'cedible': 1},
+    )
+    cedible_bytes = copias.by_label('cedible')[0].content_bytes
+
+Cada componente (``document``, ``identifier``, ``trading_parties``,
+``integration``) agrupa servicios independientes, uno por *worker* de la
+API: cada método hace exactamente una llamada HTTP, sin encadenar red por
+detrás. Encadenar los pasos (ej. armar el documento, el sobre, y
+enviarlo) es responsabilidad de quien use el SDK.
+
+Configuración
+-------------
+
+Base URL
+~~~~~~~~
+
+Por defecto el SDK apunta a ``https://core.libredte.cl/api``. Para usar
+otra API (ej. ``https://pro.libredte.cl/api``, o un ambiente propio),
+pasar ``base_url`` al construir ``LibreDTE`` o setear la variable de
+entorno ``LIBREDTE_LIB_SDK_BASE_URL``:
+
+.. code-block:: python
+
+    sdk = LibreDTE(base_url='https://pro.libredte.cl/api')
+
+.. code-block:: bash
+
+    export LIBREDTE_LIB_SDK_BASE_URL=https://pro.libredte.cl/api
+
+``core.libredte.cl`` y ``pro.libredte.cl`` exponen el mismo contrato con
+límites de solicitudes distintos; ambos aceptan la variante ``LibreDTE
+(base_url=..., ...)`` con el resto de los parámetros de configuración
+(``api_token``, ``timeout``, ``http_client``).
+
+Autenticación
+~~~~~~~~~~~~~
+
+``LibreDTE(api_token=...)`` o la variable de entorno
+``LIBREDTE_LIB_SDK_TOKEN`` — si está presente, se manda como header
+``Authorization: Bearer <token>``.
+
+Recursos de ``system``
+-----------------------
+
+Además de ``billing`` (negocio DTE), el SDK expone ``system``:
+infraestructura de la biblioteca que una app consumidora
+necesita para poblar sus propios datos, no operaciones de facturación.
+
+.. code-block:: python
+
+    s = sdk.system
+
+    # Ejemplos de documentos reales (los mismos casos de prueba,
+    # validados, de libredte-lib-core) — útiles para poblar datos de
+    # demostración con variedad real en vez de inventada a mano.
+    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,
+    )
+
+    # Catálogos/repositorios reales (comunas, tipos de documento, etc.)
+    # — el esquema de cada elemento depende del repositorio pedido, no
+    # hay un DTO fijo: se devuelve el dict/list tal cual la API.
+    repositorios = s.repository.catalog.list()  # FQCN de cada repositorio disponible
+    tipos_dte = s.repository.catalog.find_by(
+        'libredte\\lib\\Core\\Package\\Billing\\Component\\Document'
+        '\\Contract\\TipoDocumentoInterface',
+        criteria={'codigo': [33, 39]},  # coincidencia con cualquiera de estos códigos
+    )
+
+    # Cargar un certificado real (.p12/.pfx) sin desempaquetarlo
+    # localmente: la API entrega certificado (PEM) + RUT/nombre/correo
+    # 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)
+
+Errores
+-------
+
+Cualquier error de la API (validación, regla de negocio, error interno)
+levanta ``libredte_lib_sdk.LibreDteApiError``, con ``.status_code``,
+``.detail`` y ``.php_class`` (la clase real de la excepción PHP detrás,
+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
+``libredte_lib_sdk.LibreDteConnectionError``.
+
+Desarrollo
+----------
+
+.. code-block:: bash
+
+    make install-dev
+    make check       # ruff + tests unitarios (offline, sin red)
+    make test-live   # tests de integración reales contra la API
+
+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``.
+
+Términos y condiciones de uso
+------------------------------
+
+Este proyecto está licenciado bajo la Licencia MIT. Ver
+`LICENSE <LICENSE>`_.

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

@@ -2,8 +2,8 @@ LibreDTE: SDK Python para la API de LibreDTE Lib
 ================================================
 
 SDK Python (``libredte_lib_sdk``) que orquesta la API de LibreDTE Lib
-(``https://core.libredte.cl/api`` por defecto) para cubrir el ciclo
-básico de emisión de un DTE: borrador, documento timbrado y firmado,
+(``https://core.libredte.cl/api`` por defecto) para cubrir el ciclo de
+emisión de un DTE: borrador, documento timbrado y firmado,
 envío al SII, consulta de estado por Track ID, y generación de HTML/PDF
 — más carga y validación de CAF real, y generación de CAF y certificado
 ficticios para poder probar todo lo anterior sin credenciales reales.
@@ -13,8 +13,10 @@ concentra la lógica de negocio/orquestación de DTE, para que la app web
 sea solo vista, autenticación y persistencia.
 
 El paquete Python espeja la organización de la propia API
-(``paquete.componente.worker::operacion``): ``sdk.billing.<componente>
-.<worker>``.
+(``package.component.worker::operation``): ``sdk.billing.<component>
+.<worker>`` para negocio DTE, ``sdk.system.<component>.<worker>`` para
+infraestructura de la biblioteca (catálogos reales, carga de certificados
+— ver "Recursos de `system`" más abajo).
 
 Instalación
 -----------
@@ -28,14 +30,18 @@ Uso
 
 .. code-block:: python
 
-    from libredte_lib_sdk import Emisor, AutorizacionDte, LibreDTE
+    from libredte_lib_sdk import LibreDTE
+    from libredte_lib_sdk.billing.trading_parties import Mandatario
 
     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, 'Folio': 1},
+            'IdDoc': {
+                'TipoDTE': 33,
+                'Folio': 1
+            },
             'Emisor': {
                 'RUTEmisor': '76192083-9',
                 'RznSoc': 'SASCO SpA',
@@ -51,7 +57,13 @@ Uso
                 'CmnaRecep': 'Santiago',
             },
         },
-        'Detalle': [{'NmbItem': 'Producto A', 'QtyItem': 1, 'PrcItem': 1000}],
+        'Detalle': [
+            {
+                'NmbItem': 'Producto A',
+                'QtyItem': 1,
+                'PrcItem': 1000
+            }
+        ],
     }
 
     # CAF y certificado ficticios, para pruebas/desarrollo:
@@ -60,7 +72,7 @@ Uso
         codigo_documento=33, folio_desde=1, folio_hasta=100,
     )
     certificate = b.trading_parties.mandatario_manager.create_fake_certificate(
-        {'run': '76192083-9', 'nombre': 'SASCO SpA'},
+        Mandatario(rut='76192083-9', nombre='SASCO SpA', email='sasco@example.com'),
     )
 
     # En producción: cargar y validar el CAF real que el SII le entregó
@@ -69,21 +81,21 @@ 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).
-    emisor = Emisor(
-        rut='76192083-9',
-        razon_social='SASCO SpA',
-        autorizacion_dte=AutorizacionDte(
-            fecha_resolucion='2014-08-22', numero_resolucion=80,
-        ),
-    )
+    emisor = {
+        'rut': '76192083-9',
+        'razon_social': 'SASCO SpA',
+        'autorizacion_dte': {
+            'fecha_resolucion': '2014-08-22', 'numero_resolucion': 80,
+        },
+    }
     sobre = b.document.dispatcher.create(
         documento.xml_base64, certificate=certificate, emisor=emisor,
     )
@@ -147,22 +159,42 @@ Autenticación
 ``LIBREDTE_LIB_SDK_TOKEN`` — si está presente, se manda como header
 ``Authorization: Bearer <token>``.
 
-Render de documentos
----------------------
-
-``render()`` devuelve un ``RenderResult`` con ``.renderings`` (una lista
-de ``Rendering``, cada uno con ``.content_bytes``/``.mime_type``/
-``.filename``/``.label``/``.copies``/``.copy_number``). Sin el argumento
-``renderings``, trae un único elemento (``'tributaria'``), accesible con
-``.first``. Pasando ``renderings={'tributaria': 1, 'cedible': 1}`` (o
-más de una copia de una misma presentación, ej. ``{'tributaria': 2}``)
-trae uno por cada copia generada — usar ``.by_label('cedible')`` para
-filtrar. Una presentación no soportada por el tipo de documento (ej.
-``'cedible'`` en una boleta) se omite en silencio si se pidió junto con
-otra que sí se pudo generar; si ninguna se pudo generar, o si se pide
-una presentación que no existe, la API responde con un
-``LibreDteApiError`` claro. Sirve igual para ``format='html'`` y
-``format='pdf'``.
+Recursos de ``system``
+-----------------------
+
+Además de ``billing`` (negocio DTE), el SDK expone ``system``:
+infraestructura de la biblioteca que una app consumidora
+necesita para poblar sus propios datos, no operaciones de facturación.
+
+.. code-block:: python
+
+    s = sdk.system
+
+    # Ejemplos de documentos reales (los mismos casos de prueba,
+    # validados, de libredte-lib-core) — útiles para poblar datos de
+    # demostración con variedad real en vez de inventada a mano.
+    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,
+    )
+
+    # Catálogos/repositorios reales (comunas, tipos de documento, etc.)
+    # — el esquema de cada elemento depende del repositorio pedido, no
+    # hay un DTO fijo: se devuelve el dict/list tal cual la API.
+    repositorios = s.repository.catalog.list()  # FQCN de cada repositorio disponible
+    tipos_dte = s.repository.catalog.find_by(
+        'libredte\\lib\\Core\\Package\\Billing\\Component\\Document'
+        '\\Contract\\TipoDocumentoInterface',
+        criteria={'codigo': [33, 39]},  # coincidencia con cualquiera de estos códigos
+    )
+
+    # Cargar un certificado real (.p12/.pfx) sin desempaquetarlo
+    # localmente: la API entrega certificado (PEM) + RUT/nombre/correo
+    # 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)
 
 Errores
 -------
@@ -192,7 +224,5 @@ defecto de ``pytest``/``make test``/``make check``.
 Términos y condiciones de uso
 ------------------------------
 
-Este proyecto es software libre y puede ser redistribuido y/o modificado
-bajo los términos de la Licencia Pública General Affero de GNU (AGPL),
-versión 3 o (a elección) cualquier versión posterior. Ver
-`COPYING <COPYING>`_.
+Este proyecto está licenciado bajo la Licencia MIT. Ver
+`LICENSE <LICENSE>`_.

libredte_lib_sdk-0.3.0/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)