fiscalapi 4.0.386__tar.gz → 4.0.417__tar.gz

{fiscalapi-4.0.386/fiscalapi.egg-info → fiscalapi-4.0.417}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fiscalapi
-Version: 4.0.386
+Version: 4.0.417
 Summary: Genera facturas CFDI válidas ante el SAT consumiendo el API de https://www.fiscalapi.com
 Home-page: https://www.fiscalapi.com
 Author: Fiscalapi
@@ -76,10 +76,7 @@ Dynamic: summary
 - **Configuración de datos fiscales** (RFC, domicilio fiscal, régimen fiscal)
 - **Datos de empleado** (agrega/actualiza/elimina datos de empleado a una persona. CFDI Nómina)
 - **Datos de empleador** (agrega/actualiza/elimina datos de empleador a una persona. CFDI Nómina)
-
-## 🎖️ Gestión de Timbres 
-- **Gestión de folios fiscales** Compra timbres a fiscalapi y transfiere/retira a las personas de tu organizacion segun tus reglas de negocio.
-
+- **Firma de carta manifiesto** (firma el manifiesto de una persona con su e.firma/FIEL)
 
 ## 🛍️ Gestión de Productos/Servicios
 - **Gestión de productos y servicios** con catálogo personalizable
@@ -91,11 +88,21 @@ Dynamic: summary
 - **Búsqueda de información** en catálogos del SAT con filtros avanzados
 - **Acceso y búsqueda** en catálogos completos
 
-## 🎫 Gestión de Timbres
-- **Listar transacciones de timbres** con paginación
+## 🎫 Gestión de Timbres y Créditos de Validación
+- **Gestión de folios fiscales**: compra timbres a FiscalAPI y transfiere/retira a las personas de tu organización según tus reglas de negocio
+- **Listar transacciones** del ledger con paginación
 - **Consultar transacciones** por ID
 - **Transferir timbres** entre personas
 - **Retirar timbres** de una persona
+- **Transferir y retirar créditos de validación SAT** con `credit_type=CreditType.VALIDATION`
+
+## 🛡️ Validaciones SAT
+- **Estructura del XML** contra el Anexo 20 y los complementos declarados
+- **Vigencia del certificado** del emisor a la fecha de emisión
+- **Sello del CFDI** y **sello del SAT** en el Timbre Fiscal Digital
+- **Estatus del comprobante** en el SAT (vigente, cancelado, no encontrado)
+- **Listas negras del artículo 69-B y 69-B Bis** del CFF, por CFDI o por RFC
+- **Catálogo de tipos de validación** y de los estatus que cada uno puede tomar
 
 ## 📖 Recursos Adicionales
 - **Cientos de ejemplos de código** disponibles en múltiples lenguajes de programación
@@ -357,6 +364,211 @@ else:
     print(api_response.message)
 ```
 
+### 8. Validaciones SAT
+
+Cada tipo de validación solicitado consume un crédito de validación. El cobro es todo o nada: si el saldo no alcanza para todos, no se ejecuta ninguno y la API responde 403.
+
+```python
+import base64
+from pathlib import Path
+from fiscalapi import SatValidationRequest, SatValidationTypeIds
+
+# Validar un CFDI timbrado: con xml puedes solicitar cualquier tipo de validación
+request = SatValidationRequest(
+    xml=base64.b64encode(Path("factura.xml").read_bytes()).decode("ascii"),
+    validation_types=[
+        SatValidationTypeIds.XML_STRUCTURE,
+        SatValidationTypeIds.CFDI_SELLO,
+        SatValidationTypeIds.CFDI_STATUS,
+        SatValidationTypeIds.BLACKLIST_69B,
+    ]
+)
+
+api_response = client.sat_validations.validate(request)
+
+if api_response.succeeded:
+    for result in api_response.data:
+        veredicto = "PASSED" if result.passed else "FAILED"
+        print(f"[{veredicto}] {result.type.id.value} -> {result.status.id.value}")
+        if result.status.details:
+            print(f"          {result.status.details}")
+else:
+    print(api_response.details)
+```
+
+Para consultar únicamente listas negras basta el RFC, sin enviar el CFDI:
+
+```python
+request = SatValidationRequest(
+    tin="FUNK671228PH6",
+    validation_types=[
+        SatValidationTypeIds.BLACKLIST_69B,
+        SatValidationTypeIds.BLACKLIST_69B_BIS,
+    ]
+)
+
+api_response = client.sat_validations.validate(request)
+```
+
+Envía `xml` o `tin`, nunca ambos y nunca ninguno: con `tin` solo se pueden solicitar listas negras.
+
+El catálogo de tipos y los estatus que cada tipo puede tomar se consultan sin consumir créditos:
+
+```python
+api_response = client.sat_validations.get_types()
+api_response = client.sat_validations.get_type_by_id(SatValidationTypeIds.CFDI_STATUS)
+api_response = client.sat_validations.get_statuses(SatValidationTypeIds.CFDI_STATUS)
+```
+
+### 9. Transferir Créditos de Validación
+
+Los saldos nunca se mezclan: `CreditType.STAMP` mueve timbres (`available_balance`) y `CreditType.VALIDATION` mueve créditos de validación (`available_validation_balance`).
+
+```python
+from fiscalapi import CreditType, StampTransactionParams
+
+params = StampTransactionParams(
+    from_person_id="3f3478b4-60fd-459e-8bfc-f8239fc96257",
+    to_person_id="96b46762-d246-4a67-a562-510a25dbafa9",
+    amount=10,
+    comments="Asignación de créditos de validación",
+    credit_type=CreditType.VALIDATION
+)
+
+api_response = client.stamps.transfer_stamps(params)
+```
+
+### 10. Factura de Comercio Exterior
+
+El complemento se envía en `Invoice.complement.comercio_exterior`. Puede combinarse con carta porte en el mismo comprobante.
+
+> **Escala decimal:** el SAT valida la cantidad de decimales de varios campos. Construye siempre los montos con `Decimal("...")` a partir de una cadena con la escala exacta (`Decimal("0.160000")`, no `Decimal(0.16)`): el SDK preserva los ceros finales al serializar. Una escala incorrecta produce rechazos `CFDI40179` (en `taxRate`) o `CCE122` (en `valorDolares`).
+
+> **Tipo de cambio:** `tipo_cambio_usd` debe ser el publicado en el DOF para la fecha de emisión, y la fecha del comprobante no puede exceder 72 horas al momento del timbrado. Si no coinciden, el PAC responde `CCE121` e indica el valor esperado.
+
+```python
+from datetime import datetime
+from decimal import Decimal
+
+from fiscalapi.models import (
+    Invoice, InvoiceIssuer, InvoiceRecipient, InvoiceItem, ItemTax,
+    InvoiceComplement, TaxCredential,
+    ComercioExteriorComplement, ComercioExteriorEmisor, ComercioExteriorEmisorDomicilio,
+    ComercioExteriorReceptor, ComercioExteriorReceptorDomicilio, ComercioExteriorMercancia,
+)
+
+invoice = Invoice(
+    version_code="4.0",
+    payment_form_code="99",
+    payment_method_code="PPD",
+    currency_code="USD",
+    type_code="I",
+    expedition_zip_code="42501",
+    series="CCE",
+    date=datetime.now().replace(microsecond=0),
+    export_code="02",
+    issuer=InvoiceIssuer(
+        tin="EKU9003173C9",
+        legal_name="ESCUELA KEMPER URGATE",
+        tax_regime_code="601",
+        tax_credentials=[
+            TaxCredential(base64_file="<CER_BASE64>", file_type=0, password="<CSD_PASSWORD>"),
+            TaxCredential(base64_file="<KEY_BASE64>", file_type=1, password="<CSD_PASSWORD>"),
+        ],
+    ),
+    # Receptor extranjero: country_id (ResidenciaFiscal) es obligatorio si se envía foreign_tin.
+    recipient=InvoiceRecipient(
+        tin="XEXX010101000",
+        legal_name="U.S. 0026 SW",
+        zip_code="42501",
+        tax_regime_code="616",
+        cfdi_use_code="S01",
+        country_id="USA",
+        foreign_tin="123456789",
+    ),
+    items=[
+        InvoiceItem(
+            item_code="50211503",
+            item_sku="131494-1055",  # debe coincidir con mercancia.no_identificacion
+            quantity=Decimal("2"),
+            unit_of_measurement_code="H87",
+            description="Cigarros",
+            unit_price=Decimal("200.00"),
+            discount=Decimal("0"),
+            tax_object_code="02",
+            item_taxes=[
+                ItemTax(tax_code="002", tax_type_code="Tasa", tax_rate=Decimal("0.160000"), tax_flag_code="T"),
+            ],
+        ),
+    ],
+    complement=InvoiceComplement(
+        comercio_exterior=ComercioExteriorComplement(
+            clave_de_pedimento_id="A1",
+            certificado_origen=0,  # 0 = no funge como certificado de origen, 1 = sí
+            incoterm_id="FOB",
+            tipo_cambio_usd=Decimal("16.9722"),
+            # Domicilio del emisor: campos de catálogo SAT, con sufijo Id.
+            emisor=ComercioExteriorEmisor(
+                domicilio=ComercioExteriorEmisorDomicilio(
+                    calle="CALLE DEL PAPEL",
+                    colonia_id="0214",
+                    localidad_id="01",
+                    municipio_id="014",
+                    estado_id="QUE",
+                    pais_id="MEX",
+                    codigo_postal_id="76199",
+                ),
+            ),
+            # Domicilio del receptor: texto libre, sin sufijo Id (salvo pais_id).
+            receptor=ComercioExteriorReceptor(
+                num_reg_id_trib="123456789",
+                domicilio=ComercioExteriorReceptorDomicilio(
+                    calle="ST. A",
+                    estado="TX",
+                    pais_id="USA",
+                    codigo_postal="00000",
+                ),
+            ),
+            mercancias=[
+                ComercioExteriorMercancia(
+                    no_identificacion="131494-1055",
+                    fraccion_arancelaria_id="2402200100",
+                    cantidad_aduana=Decimal("117.64"),
+                    unidad_aduana_id="01",
+                    valor_unitario_aduana=Decimal("3.40"),
+                    valor_dolares=Decimal("400.00"),
+                ),
+            ],
+        ),
+    ),
+)
+
+api_response = client.invoices.create(invoice)
+```
+
+### 11. Firmar Carta Manifiesto
+
+Firma la carta manifiesto de una persona y devuelve el PDF resultante en base64.
+
+Requiere la **e.firma (FIEL)** del contribuyente, no el CSD de timbrado, y que exista una persona con ese RFC en el tenant.
+
+```python
+from fiscalapi.models import SignManifestRequest
+
+api_response = client.manifests.sign(SignManifestRequest(
+    base64_cer="<FIEL_CER_BASE64>",
+    base64_key="<FIEL_KEY_BASE64>",
+    password="<FIEL_PASSWORD>",
+))
+
+if api_response.succeeded:
+    print(api_response.data.file_name)       # EKU9003173C9.pdf
+    print(api_response.data.file_extension)  # .pdf
+    print(api_response.data.base64_file)     # PDF firmado en base64
+```
+
+Tras una firma exitosa, `client.people.get_by_id(...)` refleja el nuevo estado en `manifest_status_id`.
+
 ## 📋 Operaciones Principales
 
 - **Facturas (CFDI)**
@@ -365,16 +577,26 @@ else:
   Alta y administración de personas, gestión de certificados (CSD).
 - **Productos y Servicios**
   Administración de catálogos de productos, búsqueda en catálogos SAT.
-- **Timbres**
-  Listar transacciones, transferir y retirar timbres entre personas.
+- **Timbres y créditos de validación**
+  Listar transacciones, transferir y retirar timbres o créditos de validación entre personas.
+- **Validaciones SAT**
+  Validar estructura, certificado, sellos, estatus en el SAT y listas negras 69-B de un CFDI o un RFC.
+- **Carta manifiesto**
+  Firmar la carta manifiesto de una persona con su e.firma (FIEL) y obtener el PDF resultante.
 
 ## 📂 Más Ejemplos
 
 - [Gestión de Timbres](examples/ejemplos-timbres.py)
+- [Validaciones SAT](examples/ejemplos-validaciones-sat.py)
 - [Complementos de Pago](examples/ejemplos-facturas-de-complemento-pago.py)
 - [Facturas de Nómina](examples/ejemplos-facturas-de-nomina.py)
 - [Impuestos Locales (Por Valores)](examples/ejemplos-factura-impuestos-locales-valores.py)
 - [Impuestos Locales (Por Referencias)](examples/ejemplos-factura-impuestos-locales-referencias.py)
+- [Comercio Exterior (Por Valores)](examples/ejemplos-factura-comercio-exterior-valores.py)
+- [Comercio Exterior (Por Referencias)](examples/ejemplos-factura-comercio-exterior-referencias.py)
+- [Carta Porte (Por Valores)](examples/ejemplos-factura-carta-porte-valores.py)
+- [Carta Porte (Por Referencias)](examples/ejemplos-factura-carta-porte-referencias.py)
+- [Firma de Cartas Manifiesto](examples/ejemplos-firma-manifiestos.py)
 
 ## 🤝 Contribuir
 

{fiscalapi-4.0.386 → fiscalapi-4.0.417}/README.md

@@ -38,10 +38,7 @@
 - **Configuración de datos fiscales** (RFC, domicilio fiscal, régimen fiscal)
 - **Datos de empleado** (agrega/actualiza/elimina datos de empleado a una persona. CFDI Nómina)
 - **Datos de empleador** (agrega/actualiza/elimina datos de empleador a una persona. CFDI Nómina)
-
-## 🎖️ Gestión de Timbres 
-- **Gestión de folios fiscales** Compra timbres a fiscalapi y transfiere/retira a las personas de tu organizacion segun tus reglas de negocio.
-
+- **Firma de carta manifiesto** (firma el manifiesto de una persona con su e.firma/FIEL)
 
 ## 🛍️ Gestión de Productos/Servicios
 - **Gestión de productos y servicios** con catálogo personalizable
@@ -53,11 +50,21 @@
 - **Búsqueda de información** en catálogos del SAT con filtros avanzados
 - **Acceso y búsqueda** en catálogos completos
 
-## 🎫 Gestión de Timbres
-- **Listar transacciones de timbres** con paginación
+## 🎫 Gestión de Timbres y Créditos de Validación
+- **Gestión de folios fiscales**: compra timbres a FiscalAPI y transfiere/retira a las personas de tu organización según tus reglas de negocio
+- **Listar transacciones** del ledger con paginación
 - **Consultar transacciones** por ID
 - **Transferir timbres** entre personas
 - **Retirar timbres** de una persona
+- **Transferir y retirar créditos de validación SAT** con `credit_type=CreditType.VALIDATION`
+
+## 🛡️ Validaciones SAT
+- **Estructura del XML** contra el Anexo 20 y los complementos declarados
+- **Vigencia del certificado** del emisor a la fecha de emisión
+- **Sello del CFDI** y **sello del SAT** en el Timbre Fiscal Digital
+- **Estatus del comprobante** en el SAT (vigente, cancelado, no encontrado)
+- **Listas negras del artículo 69-B y 69-B Bis** del CFF, por CFDI o por RFC
+- **Catálogo de tipos de validación** y de los estatus que cada uno puede tomar
 
 ## 📖 Recursos Adicionales
 - **Cientos de ejemplos de código** disponibles en múltiples lenguajes de programación
@@ -319,6 +326,211 @@ else:
     print(api_response.message)
 ```
 
+### 8. Validaciones SAT
+
+Cada tipo de validación solicitado consume un crédito de validación. El cobro es todo o nada: si el saldo no alcanza para todos, no se ejecuta ninguno y la API responde 403.
+
+```python
+import base64
+from pathlib import Path
+from fiscalapi import SatValidationRequest, SatValidationTypeIds
+
+# Validar un CFDI timbrado: con xml puedes solicitar cualquier tipo de validación
+request = SatValidationRequest(
+    xml=base64.b64encode(Path("factura.xml").read_bytes()).decode("ascii"),
+    validation_types=[
+        SatValidationTypeIds.XML_STRUCTURE,
+        SatValidationTypeIds.CFDI_SELLO,
+        SatValidationTypeIds.CFDI_STATUS,
+        SatValidationTypeIds.BLACKLIST_69B,
+    ]
+)
+
+api_response = client.sat_validations.validate(request)
+
+if api_response.succeeded:
+    for result in api_response.data:
+        veredicto = "PASSED" if result.passed else "FAILED"
+        print(f"[{veredicto}] {result.type.id.value} -> {result.status.id.value}")
+        if result.status.details:
+            print(f"          {result.status.details}")
+else:
+    print(api_response.details)
+```
+
+Para consultar únicamente listas negras basta el RFC, sin enviar el CFDI:
+
+```python
+request = SatValidationRequest(
+    tin="FUNK671228PH6",
+    validation_types=[
+        SatValidationTypeIds.BLACKLIST_69B,
+        SatValidationTypeIds.BLACKLIST_69B_BIS,
+    ]
+)
+
+api_response = client.sat_validations.validate(request)
+```
+
+Envía `xml` o `tin`, nunca ambos y nunca ninguno: con `tin` solo se pueden solicitar listas negras.
+
+El catálogo de tipos y los estatus que cada tipo puede tomar se consultan sin consumir créditos:
+
+```python
+api_response = client.sat_validations.get_types()
+api_response = client.sat_validations.get_type_by_id(SatValidationTypeIds.CFDI_STATUS)
+api_response = client.sat_validations.get_statuses(SatValidationTypeIds.CFDI_STATUS)
+```
+
+### 9. Transferir Créditos de Validación
+
+Los saldos nunca se mezclan: `CreditType.STAMP` mueve timbres (`available_balance`) y `CreditType.VALIDATION` mueve créditos de validación (`available_validation_balance`).
+
+```python
+from fiscalapi import CreditType, StampTransactionParams
+
+params = StampTransactionParams(
+    from_person_id="3f3478b4-60fd-459e-8bfc-f8239fc96257",
+    to_person_id="96b46762-d246-4a67-a562-510a25dbafa9",
+    amount=10,
+    comments="Asignación de créditos de validación",
+    credit_type=CreditType.VALIDATION
+)
+
+api_response = client.stamps.transfer_stamps(params)
+```
+
+### 10. Factura de Comercio Exterior
+
+El complemento se envía en `Invoice.complement.comercio_exterior`. Puede combinarse con carta porte en el mismo comprobante.
+
+> **Escala decimal:** el SAT valida la cantidad de decimales de varios campos. Construye siempre los montos con `Decimal("...")` a partir de una cadena con la escala exacta (`Decimal("0.160000")`, no `Decimal(0.16)`): el SDK preserva los ceros finales al serializar. Una escala incorrecta produce rechazos `CFDI40179` (en `taxRate`) o `CCE122` (en `valorDolares`).
+
+> **Tipo de cambio:** `tipo_cambio_usd` debe ser el publicado en el DOF para la fecha de emisión, y la fecha del comprobante no puede exceder 72 horas al momento del timbrado. Si no coinciden, el PAC responde `CCE121` e indica el valor esperado.
+
+```python
+from datetime import datetime
+from decimal import Decimal
+
+from fiscalapi.models import (
+    Invoice, InvoiceIssuer, InvoiceRecipient, InvoiceItem, ItemTax,
+    InvoiceComplement, TaxCredential,
+    ComercioExteriorComplement, ComercioExteriorEmisor, ComercioExteriorEmisorDomicilio,
+    ComercioExteriorReceptor, ComercioExteriorReceptorDomicilio, ComercioExteriorMercancia,
+)
+
+invoice = Invoice(
+    version_code="4.0",
+    payment_form_code="99",
+    payment_method_code="PPD",
+    currency_code="USD",
+    type_code="I",
+    expedition_zip_code="42501",
+    series="CCE",
+    date=datetime.now().replace(microsecond=0),
+    export_code="02",
+    issuer=InvoiceIssuer(
+        tin="EKU9003173C9",
+        legal_name="ESCUELA KEMPER URGATE",
+        tax_regime_code="601",
+        tax_credentials=[
+            TaxCredential(base64_file="<CER_BASE64>", file_type=0, password="<CSD_PASSWORD>"),
+            TaxCredential(base64_file="<KEY_BASE64>", file_type=1, password="<CSD_PASSWORD>"),
+        ],
+    ),
+    # Receptor extranjero: country_id (ResidenciaFiscal) es obligatorio si se envía foreign_tin.
+    recipient=InvoiceRecipient(
+        tin="XEXX010101000",
+        legal_name="U.S. 0026 SW",
+        zip_code="42501",
+        tax_regime_code="616",
+        cfdi_use_code="S01",
+        country_id="USA",
+        foreign_tin="123456789",
+    ),
+    items=[
+        InvoiceItem(
+            item_code="50211503",
+            item_sku="131494-1055",  # debe coincidir con mercancia.no_identificacion
+            quantity=Decimal("2"),
+            unit_of_measurement_code="H87",
+            description="Cigarros",
+            unit_price=Decimal("200.00"),
+            discount=Decimal("0"),
+            tax_object_code="02",
+            item_taxes=[
+                ItemTax(tax_code="002", tax_type_code="Tasa", tax_rate=Decimal("0.160000"), tax_flag_code="T"),
+            ],
+        ),
+    ],
+    complement=InvoiceComplement(
+        comercio_exterior=ComercioExteriorComplement(
+            clave_de_pedimento_id="A1",
+            certificado_origen=0,  # 0 = no funge como certificado de origen, 1 = sí
+            incoterm_id="FOB",
+            tipo_cambio_usd=Decimal("16.9722"),
+            # Domicilio del emisor: campos de catálogo SAT, con sufijo Id.
+            emisor=ComercioExteriorEmisor(
+                domicilio=ComercioExteriorEmisorDomicilio(
+                    calle="CALLE DEL PAPEL",
+                    colonia_id="0214",
+                    localidad_id="01",
+                    municipio_id="014",
+                    estado_id="QUE",
+                    pais_id="MEX",
+                    codigo_postal_id="76199",
+                ),
+            ),
+            # Domicilio del receptor: texto libre, sin sufijo Id (salvo pais_id).
+            receptor=ComercioExteriorReceptor(
+                num_reg_id_trib="123456789",
+                domicilio=ComercioExteriorReceptorDomicilio(
+                    calle="ST. A",
+                    estado="TX",
+                    pais_id="USA",
+                    codigo_postal="00000",
+                ),
+            ),
+            mercancias=[
+                ComercioExteriorMercancia(
+                    no_identificacion="131494-1055",
+                    fraccion_arancelaria_id="2402200100",
+                    cantidad_aduana=Decimal("117.64"),
+                    unidad_aduana_id="01",
+                    valor_unitario_aduana=Decimal("3.40"),
+                    valor_dolares=Decimal("400.00"),
+                ),
+            ],
+        ),
+    ),
+)
+
+api_response = client.invoices.create(invoice)
+```
+
+### 11. Firmar Carta Manifiesto
+
+Firma la carta manifiesto de una persona y devuelve el PDF resultante en base64.
+
+Requiere la **e.firma (FIEL)** del contribuyente, no el CSD de timbrado, y que exista una persona con ese RFC en el tenant.
+
+```python
+from fiscalapi.models import SignManifestRequest
+
+api_response = client.manifests.sign(SignManifestRequest(
+    base64_cer="<FIEL_CER_BASE64>",
+    base64_key="<FIEL_KEY_BASE64>",
+    password="<FIEL_PASSWORD>",
+))
+
+if api_response.succeeded:
+    print(api_response.data.file_name)       # EKU9003173C9.pdf
+    print(api_response.data.file_extension)  # .pdf
+    print(api_response.data.base64_file)     # PDF firmado en base64
+```
+
+Tras una firma exitosa, `client.people.get_by_id(...)` refleja el nuevo estado en `manifest_status_id`.
+
 ## 📋 Operaciones Principales
 
 - **Facturas (CFDI)**
@@ -327,16 +539,26 @@ else:
   Alta y administración de personas, gestión de certificados (CSD).
 - **Productos y Servicios**
   Administración de catálogos de productos, búsqueda en catálogos SAT.
-- **Timbres**
-  Listar transacciones, transferir y retirar timbres entre personas.
+- **Timbres y créditos de validación**
+  Listar transacciones, transferir y retirar timbres o créditos de validación entre personas.
+- **Validaciones SAT**
+  Validar estructura, certificado, sellos, estatus en el SAT y listas negras 69-B de un CFDI o un RFC.
+- **Carta manifiesto**
+  Firmar la carta manifiesto de una persona con su e.firma (FIEL) y obtener el PDF resultante.
 
 ## 📂 Más Ejemplos
 
 - [Gestión de Timbres](examples/ejemplos-timbres.py)
+- [Validaciones SAT](examples/ejemplos-validaciones-sat.py)
 - [Complementos de Pago](examples/ejemplos-facturas-de-complemento-pago.py)
 - [Facturas de Nómina](examples/ejemplos-facturas-de-nomina.py)
 - [Impuestos Locales (Por Valores)](examples/ejemplos-factura-impuestos-locales-valores.py)
 - [Impuestos Locales (Por Referencias)](examples/ejemplos-factura-impuestos-locales-referencias.py)
+- [Comercio Exterior (Por Valores)](examples/ejemplos-factura-comercio-exterior-valores.py)
+- [Comercio Exterior (Por Referencias)](examples/ejemplos-factura-comercio-exterior-referencias.py)
+- [Carta Porte (Por Valores)](examples/ejemplos-factura-carta-porte-valores.py)
+- [Carta Porte (Por Referencias)](examples/ejemplos-factura-carta-porte-referencias.py)
+- [Firma de Cartas Manifiesto](examples/ejemplos-firma-manifiestos.py)
 
 ## 🤝 Contribuir
 

{fiscalapi-4.0.386 → fiscalapi-4.0.417}/fiscalapi/__init__.py

@@ -66,6 +66,15 @@ from .models.manifest_models import (
     SignManifestRequest,
     SignManifestResponse,
 )
+from .models.sat_validation_models import (
+    SatValidationTypeIds,
+    SatValidationStatusIds,
+    SatValidationRequest,
+    SatValidationType,
+    SatValidationTypeStatus,
+    SatValidationStatus,
+    SatValidationResult,
+)
 
 # Modelos de dominio
 from .models.fiscalapi_models import (
@@ -111,7 +120,6 @@ from .models.fiscalapi_models import (
     PayrollDeduction,
     PayrollDisability,
     PayrollComplement,
-    CartaPorteComplement,
     InvoiceComplement,
     # Invoice models
     InvoiceResponse,
@@ -142,6 +150,9 @@ from .models.fiscalapi_models import (
     XmlComplement,
     Xml,
     # Stamp models
+    CreditType,
+    StampTransactionType,
+    StampTransactionStatus,
     UserLookupDto,
     StampTransaction,
     StampTransactionParams,
@@ -160,6 +171,7 @@ from .services.invoice_service import InvoiceService
 from .services.people_service import PeopleService
 from .services.product_service import ProductService
 from .services.tax_file_service import TaxFileService
+from .services.sat_validation_service import SatValidationService
 from .services.stamp_service import StampService
 from .services.manifest_service import ManifestService
 
@@ -216,7 +228,6 @@ __all__ = [
     "PayrollDeduction",
     "PayrollDisability",
     "PayrollComplement",
-    "CartaPorteComplement",
     "InvoiceComplement",
     # Carta Porte models
     "UbicacionDomicilio",
@@ -224,6 +235,7 @@ __all__ = [
     "RegimenAduanero",
     "Ubicacion",
     "DocumentoAduanero",
+    "GuiaIdentificacion",
     "CantidadTransporta",
     "DetalleMercancia",
     "Mercancia",
@@ -280,12 +292,23 @@ __all__ = [
     "XmlComplement",
     "Xml",
     # Stamp models
+    "CreditType",
+    "StampTransactionType",
+    "StampTransactionStatus",
     "UserLookupDto",
     "StampTransaction",
     "StampTransactionParams",
     # Manifest models
     "SignManifestRequest",
     "SignManifestResponse",
+    # SAT validation models
+    "SatValidationTypeIds",
+    "SatValidationStatusIds",
+    "SatValidationRequest",
+    "SatValidationType",
+    "SatValidationTypeStatus",
+    "SatValidationStatus",
+    "SatValidationResult",
     # Servicios
     "BaseService",
     "ApiKeyService",
@@ -299,6 +322,7 @@ __all__ = [
     "PeopleService",
     "ProductService",
     "TaxFileService",
+    "SatValidationService",
     "StampService",
     "ManifestService",
     # Cliente principal