consultar estado de facturas added

Author: mendozagit

examples.py

@@ -1095,5 +1095,25 @@ def main ():
     # print(api_response)
 
 
+    # Consultar estado de factura por valores
+    # invoice_status = InvoiceStatusRequest(
+    #     issuer_tin="POPJ450924HD6",           # RFC del emisor
+    #     recipient_tin="MEJJ940824C61",        # RFC del receptor
+    #     invoice_total=Decimal("430.00"),      # Total de la factura
+    #     invoice_uuid="8e0fdc23-e148-4cf5-b3ce-4459f31c9c45",  # UUID de la factura
+    #     last8_digits_issuer_signature="oxPKRg=="  # Últimos 8 dígitos del sello digital del emisor
+    # )
+    #api_response = client.invoices.get_status(invoice_status)
+    #print(api_response)
+    
+    
+    # Consultar estado de factura por referencias (id)
+    # invoice_status = InvoiceStatusRequest(
+    #     id="16444d58-37e0-4a86-b247-a73bcc18c751"
+    # )
+    # api_response = client.invoices.get_status(invoice_status)
+    # print(api_response)
+    
+    
 if __name__ == "__main__":
     main()

fiscalapi/__init__.py

@@ -33,6 +33,8 @@
     CreatePdfRequest,
     FileResponse,
     SendInvoiceRequest,
+    InvoiceStatusRequest,
+    InvoiceStatusResponse,
 )
 
 # Re-exportar servicios
@@ -75,7 +77,10 @@
     "CreatePdfRequest",
     "FileResponse",
     "SendInvoiceRequest",
-
+    "InvoiceStatusRequest",
+    "InvoiceStatusResponse",
+    
+    
     # Servicios
     "CatalogService",
     "InvoiceService",

fiscalapi/models/fiscalapi_models.py

@@ -321,3 +321,30 @@ class SendInvoiceRequest(BaseDto):
 
     class Config:
         populate_by_name = True
+
+
+class InvoiceStatusRequest(BaseDto):
+    """Modelo para consultar estado de facturas."""
+    id: Optional[str] = Field(default=None, description="Id de la factura a consultar")
+    issuer_tin: Optional[str] = Field(default=None, alias="issuerTin", description="RFC Emisor la factura")
+    recipient_tin: Optional[str] = Field(default=None, alias="recipientTin", description="RFC Receptor de la factura")
+    invoice_total: Optional[Decimal] = Field(default=None, alias="invoiceTotal", description="Total de la factura")
+    invoice_uuid: Optional[str] = Field(default=None, alias="invoiceUuid", description="Folio fiscal factura a consultar")
+    last8_digits_issuer_signature: Optional[str] = Field(default=None, alias="last8DigitsIssuerSignature", description="Últimos ocho caracteres del sello digital del emisor")
+    
+    model_config = {
+        "populate_by_name": True,
+        "json_encoders": {Decimal: str}
+    }
+
+class InvoiceStatusResponse(BaseDto):
+    """Modelo de respuesta de consulta de estado de facturas."""
+    status_code: str = Field(..., alias="statusCode", description="Código de estatus retornado por el SAT")
+    status: str = Field(..., description="Estado actual de la factura. Posibles valores: 'Vigente' | 'Cancelado' | 'No Encontrado'")
+    cancelable_status: str = Field(..., alias="cancelableStatus", description="Indica si la factura es cancelable. Posibles valores: 'Cancelable con aceptación' | 'No cancelable' | 'Cancelable sin aceptación'")
+    cancellation_status: str = Field(..., alias="cancellationStatus", description="Detalle del estatus de cancelación")
+    efos_validation: str = Field(..., alias="efosValidation", description="Codigo que indica si el RFC Emisor se encuentra dentro de la lista negra de EFOS")
+
+    model_config = {
+        "populate_by_name": True
+    }

fiscalapi/services/invoice_service.py

@@ -1,5 +1,5 @@
 from fiscalapi.models.common_models import ApiResponse, PagedList
-from fiscalapi.models.fiscalapi_models import CancelInvoiceRequest, CancelInvoiceResponse, CreatePdfRequest, FileResponse, Invoice, SendInvoiceRequest
+from fiscalapi.models.fiscalapi_models import CancelInvoiceRequest, CancelInvoiceResponse, CreatePdfRequest, FileResponse, Invoice, InvoiceStatusRequest, InvoiceStatusResponse, SendInvoiceRequest
 from fiscalapi.services.base_service import BaseService
 
 
@@ -63,4 +63,21 @@ def send(self, send_invoice_request : SendInvoiceRequest):
 
         return self.send_request("POST", endpoint, bool, payload=send_invoice_request)
 
+    # consultar estado de facturas
+    def get_status(self, request: InvoiceStatusRequest) -> ApiResponse[InvoiceStatusResponse]:
+        """
+        Obtiene el estado de una factura.
+        
+        Args:
+            request (InvoiceStatusRequest): Solicitud para consultar estado
+        
+        Returns:
+            ApiResponse[InvoiceStatusResponse]: Respuesta con el estado de la factura
+        """
+        if request is None:
+            raise ValueError("request cannot be null")
+        
+        endpoint = "invoices/status"
+        return self.send_request("POST", endpoint, InvoiceStatusResponse, payload=request)
+    
 

setup.py

@@ -2,7 +2,7 @@
 import os
 from setuptools import setup, find_packages
 
-VERSION = "4.0.120"
+VERSION = "4.0.142"
 # Descripción breve basada en el .csproj
 DESCRIPTION = "Genera facturas CFDI válidas ante el SAT consumiendo el API de https://www.fiscalapi.com"