tax file service initial added

mendozagit · mendozagit · commit d489f94a00e7 · 2025-02-06T08:56:22.000-06:00
diff --git a/certificates/cert.pem b/certificates/cert.pem
@@ -0,0 +1,31 @@
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIUAcW1jm0oxA7uzQRVMCAEebAEPjcwDQYJKoZIhvcNAQEL
+BQAwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUxITAfBgNVBAoM
+GEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZDAeFw0yNTAyMDYxNDM2MjdaFw0yNjAy
+MDYxNDM2MjdaMEUxCzAJBgNVBAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEw
+HwYDVQQKDBhJbnRlcm5ldCBXaWRnaXRzIFB0eSBMdGQwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQDLf0fg92cFh5dpGFJ84ArJraOai+kW4YSL9245nJP/
+z+XViPFCeQxmocyb5SAkFTrCKIzMFrxLDdkH/rcBNbVCnK0uXjLWWq1am3U5VuyO
+OlG4/RqFywynT5Yp+lP8RJErkffVc+ZNYxNHlXUYG8SBX5r3R9c6qBp+idY2DYyJ
+p3uJrcY+IwLC+UaUJrWlAG8gbYW+cYf5N42YJGfsk/vN3e+QaCvJa/6R7rTmn4fl
+rJP0VPZvjn7ocbnLfVaAIlHSCIrcm6sotVQcMUoKlzhBKqWgYrMvl1WUFKt/q51Y
+ciTIFULjgv56ClT0fMTTYZXDah6SNNG7uw+syrBiPDKiw3hTqwRozRgzPOFHRZ3x
+6vcEZE4cBvELrfvqCFQC9BBiaRlOXg/L4ZRbyegKzDHK647ijPqdxkXK0weO5fE6
+krGTuJrzPhN9Qm06t8y9+FKHxj2navui9Z3o/f7/YHX9u1DplPc1R9QLp23y0Tf3
+OwNy07hcegB0/bdazIHmxN5raZdlpI1uqd6mLTZa5eNayWzfwb2oB2Q4aUNVhK/m
+PCvZyjqVlvVQKNwpoPAOadGCGXVsBqt0EQ3DqtTRfcBBAx28QFGpyvKCsPbqEZh/
+CvUih/HPuHEWvfYuwqMOJSLRwFXwbG0SBpZvtVFitNWORZsbeclhrAENSLURirFM
+4wIDAQABo1MwUTAdBgNVHQ4EFgQU7K+3pypdVzXywHi+iJHQ7m+n1HIwHwYDVR0j
+BBgwFoAU7K+3pypdVzXywHi+iJHQ7m+n1HIwDwYDVR0TAQH/BAUwAwEB/zANBgkq
+hkiG9w0BAQsFAAOCAgEABXUq3WraB77Ylmrd6ECkqcav7fAqbmGPufY8ywa2+/RV
+tly7W03xKOv6erQVInctMtscm7WcWD9vkvC8QGdbry9yKRex3xb8Po4yDii7ZHKB
+6HPQ7gp4bOJUzuUdRwe0aobycWxaeQrXF7yGHT86bdhLrfSDruAm3BMjYrx109RZ
+RL9fvB3qog+Z5Vehgq+RaDEudfNh/kC7nFIHIjviMBwabXZWVsrIJA9NRu8nVqDm
+Ve+myGB4xZYct7sfihdAvzs1d/lsdFWy4si4wavfJdiwL4Y19CN9M2o24a3FwB1I
+c8c4a8w67KeoRVfin6ascUML3VF5D3AJ8UZtad+NOvoAdSGtPTdWobCzsil0qisb
+bnhK5+ZjtmHlQhlnbzG6BeszpqwBL0qtiCCq8rUgzcGm8jPnVo4DNTIhDuJV5IZL
+DtnXY71B3pD7aAc27r0J70YCv5aJLUIs+L/arkzsZlYhi7m7ReEoGFrvg4rdWgX3
+Y+uGL07g0tnxSUSXgvnHscb/KWYGVREHlkWTS6TXIY3V61DqkHCByHzY386C/DCu
+z8cUtXqSralvwQ2kaJ5p+yZ7eh+TFNUPLSMnpVwohVlfHFlkjSw4pyGic9C6Gx/4
+UuHkXpWSDlDcwdMEqKBp/os1vvhuGhCSpDgneVYjF4yuIFu3x1AwdnmgmmBvu1w=
+-----END CERTIFICATE-----
diff --git a/certificates/key.pem b/certificates/key.pem
@@ -0,0 +1,52 @@
+-----BEGIN PRIVATE KEY-----
+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
+P6iaupM5anRsbT3aPDrWq6kflu9Qhg==
+-----END PRIVATE KEY-----
diff --git a/fiscalapi/models/fiscalapi_models.py b/fiscalapi/models/fiscalapi_models.py
@@ -1,3 +1,4 @@
+import datetime
 from decimal import Decimal
 from pydantic import ConfigDict, EmailStr, Field
 from fiscalapi.models.common_models import BaseDto, CatalogDto
@@ -73,4 +74,21 @@ class Person(BaseDto):
     model_config = ConfigDict(
         populate_by_name=True,
         json_encoders={Decimal: str}
-    )
+    )
+    
+    
+class TaxFile(BaseDto):
+        """Modelo TaxFile que representa un componente de un par CSD: certificado (.cer) o llave privada (.key)."""
+
+        person_id: Optional[str] = Field(default=None, alias="personId", description="Id de la persona propietaria del certificado.")
+        tin: Optional[str] = Field(default=None, alias="tin", description="RFC del propietario del certificado. Debe coincidir con el RFC del certificado.")
+        base64_file: Optional[str] = Field(default=None, alias="base64File", description="Archivo certificado o llave privada en formato base64.")
+        file_type: Literal[0, 1] = Field(default=None, alias="fileType", description="Tipo de archivo: 0 para certificado, 1 para llave privada.")
+        password: Optional[str] = Field(default=None, alias="password", description="Contraseña de la llave privada.")
+        valid_from: Optional[datetime.datetime] = Field(default=None, alias="validFrom", description="Fecha de inicio de vigencia del certificado o llave privada.")
+        valid_to: Optional[datetime.datetime] = Field(default=None, alias="validTo", description="Fecha de fin de vigencia del certificado o llave privada.")
+        sequence: Optional[int] = Field(default=None, alias="sequence", description="Numero de secuencia que identifica el par entre certificado y llave privada.")
+
+        model_config = ConfigDict(
+            populate_by_name=True
+        )
diff --git a/fiscalapi/services/base_service.py b/fiscalapi/services/base_service.py
@@ -1,10 +1,11 @@
+import urllib3 
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
 from typing import Type, TypeVar
+import certifi
 from pydantic import BaseModel
 import requests
 from fiscalapi.models.common_models import ApiResponse, FiscalApiSettings, ValidationFailure
 
-#T = TypeVar('T', bound=BaseModel)
-
 T = TypeVar('T')
 
 
@@ -31,7 +32,7 @@ def _request(self, method: str, endpoint: str, **kwargs) -> requests.Response:
             headers.update(kwargs.pop("headers"))
 
         # Disable certificate validation (for development only!)
-        kwargs.setdefault("verify", False)
+        # kwargs.setdefault("verify", False)
 
 
         # print payload request
@@ -40,8 +41,16 @@ def _request(self, method: str, endpoint: str, **kwargs) -> requests.Response:
         # print line breaks 
         print("\n\n")
         
+       
+       # *** DEV ONLY: Disable SSL verification for localhost ***
+        if "localhost" in url or "127.0.0.1" in url:
+            kwargs["verify"] = False
+        else:
+            # Use the default cert store
+            kwargs["verify"] = certifi.where()
+        
         
-        # Send request
+        # send request
         response = requests.request(method=method, url=url, headers=headers, **kwargs)
         
         # print payload response
diff --git a/fiscalapi/services/fiscalapi_client.py b/fiscalapi/services/fiscalapi_client.py
@@ -1,13 +1,16 @@
 from fiscalapi.models.common_models import FiscalApiSettings
 from fiscalapi.services.people_service import PeopleService
 from fiscalapi.services.product_service import ProductService
+from fiscalapi.services.tax_file_servive import TaxFileService
+
 
 
 class FiscalApiClient:
     
     def __init__(self, settings: FiscalApiSettings):
         self.products = ProductService(settings)
         self.people = PeopleService(settings)
+        self.tax_files = TaxFileService(settings)
         
         
         #self.invoice_service = InvoiceService(settings)
diff --git a/fiscalapi/services/tax_file_servive.py b/fiscalapi/services/tax_file_servive.py
@@ -0,0 +1,41 @@
+from fiscalapi.models.common_models import ApiResponse, PagedList
+from fiscalapi.models.fiscalapi_models import TaxFile
+from fiscalapi.services.base_service import BaseService
+
+class TaxFileService(BaseService):
+      
+        # get paged list of tax files
+        def get_list(self, page_number: int, page_size: int) -> ApiResponse[PagedList[TaxFile]]:
+            endpoint = f"tax-files?pageNumber={page_number}&pageSize={page_size}"
+            return self.send_request("GET", endpoint, PagedList[TaxFile])
+        
+        # get tax file by id
+        def get_by_id(self, tax_file_id: int) -> ApiResponse[TaxFile]:
+            endpoint = f"tax-files/{tax_file_id}"
+            return self.send_request("GET", endpoint, TaxFile)
+        
+                       
+        # create tax file (upload tax file)
+        def create(self, tax_file: TaxFile) -> ApiResponse[TaxFile]:
+            endpoint = "tax-files"
+            return self.send_request("POST", endpoint, TaxFile, payload=tax_file)
+        
+        
+        # delete tax file
+        def delete(self, tax_file_id: str) -> ApiResponse[bool]:
+            endpoint = f"tax-files/{tax_file_id}"
+            return self.send_request("DELETE", endpoint, bool)
+        
+         # get default tax files for a given person)
+         # obtiene el último par de certificados válidos y vigente de una persona. Es decir sus certificados por defecto.
+        def get_default_values(self, person_id: int) -> ApiResponse[list[TaxFile]]:
+            endpoint = f"tax-files/{person_id}/default-values"
+            return self.send_request("GET", endpoint, list[TaxFile])
+       
+        
+        # get default references for a given person
+        # obtiene el último par de ids de certificados válidos y vigente de una persona. Es decir sus certificados por defecto (solo los ids)
+        def get_default_references(self, person_id: int) -> ApiResponse[list[TaxFile]]:
+            endpoint = f"tax-files/{person_id}/default-references"
+            return self.send_request("GET", endpoint, list[TaxFile])
+      
