people service added

Author: mendozagit

fiscalapi/models/fiscalapi_models.py

@@ -1,5 +1,5 @@
 from decimal import Decimal
-from pydantic import ConfigDict, Field
+from pydantic import ConfigDict, EmailStr, Field
 from fiscalapi.models.common_models import BaseDto, CatalogDto
 from typing import Literal, Optional
 
@@ -45,3 +45,32 @@ class Product(BaseDto):
         populate_by_name=True,
         json_encoders={Decimal: str}
     )
+
+
+
+class Person(BaseDto):
+    """Modelo persona en FiscalAPI."""
+
+    legal_name: Optional[str] = Field(default=None, alias="legalName", description="Razón social de la persona sin régimen de capital.")
+    email: Optional[EmailStr] = Field(default=None, alias="email", description="Correo electrónico de la persona.")
+    password: Optional[str]  = Field(default=None, alias="password", description="Contraseña para acceder al dashboard.")
+    capital_regime: Optional[str] = Field(default=None, alias="CapitalRegime", description="Régimen de capital de la persona.")
+    sat_tax_regime_id: Optional[Literal["601", "603", "605", "606", "607", "608", "610", "611", "612", "614", "615", "616", "620", "621", "622", "623", "624", "625", "626"]] = Field(default=None, alias="satTaxRegimeId", description="Código del régimen fiscal del emisor.")
+    sat_tax_regime: Optional[CatalogDto] = Field(default=None, alias="satTaxRegime", description="Código del régimen fiscal expandido.")
+    sat_cfdi_use_id: Optional[Literal["G01", "G02", "G03", "I01", "I02", "I03", "I04", "I05", "I06", "I07", "I08", "D01", "D02", "D03", "D04", "D05", "D06", "D07", "D08", "D09", "D10", "S01", "CP01", "CN01"]] = Field(default=None, alias="satCfdiUseId", description="Código de uso del CFDI.")
+    sat_cfdi_use: Optional[CatalogDto] = Field(default=None, alias="cfdiUse", description="Código de uso del CFDI expandido.")
+    user_type_id: Optional[Literal["T","C", "U"]] = Field(default=None, alias="userTypeId", description="Tipo de persona.")
+    user_type: Optional[CatalogDto] = Field(default=None, alias="userType", description="Tipo de persona expandido.")
+    tin: Optional[str] = Field(default=None, alias="tin", description="RFC del emisor (Tax Identification Number).")
+    zip_code: Optional[str] = Field(default=None, alias="zipCode", description="Código postal del emisor.")
+    base64_photo: Optional[str] = Field(default=None, alias="base64Photo", description="Foto de perfil en formato base64.")
+    tax_password: Optional[str] = Field(default=None, alias="taxPassword", description="Contraseña de los certificados CSD del emisor.")
+    available_balance: Optional[Decimal] = Field(default=None, alias="availableBalance", description="Saldo disponible en la cuenta.")
+    committed_balance: Optional[Decimal] = Field(default=None, alias="committedBalance", description="Saldo en tránsito.")
+    tenant_id: Optional[str] = Field(default=None, alias="tenantId", description="ID del tenant al que pertenece el emisor.")
+    tenant: Optional[CatalogDto] = Field(default=None, alias="tenant", description="Tenant expandido.")
+    
+    model_config = ConfigDict(
+        populate_by_name=True,
+        json_encoders={Decimal: str}
+    )

fiscalapi/services/common_services.py fiscalapi/services/base_service.pyfiscalapi/services/common_services.py renamed to fiscalapi/services/base_service.py

@@ -3,7 +3,10 @@
 import requests
 from fiscalapi.models.common_models import ApiResponse, FiscalApiSettings, ValidationFailure
 
-T = TypeVar('T', bound=BaseModel)
+#T = TypeVar('T', bound=BaseModel)
+
+T = TypeVar('T')
+
 
 class BaseService:
     def __init__(self, settings: FiscalApiSettings):
@@ -30,7 +33,24 @@ def _request(self, method: str, endpoint: str, **kwargs) -> requests.Response:
         # Disable certificate validation (for development only!)
         kwargs.setdefault("verify", False)
 
-        return requests.request(method=method, url=url, headers=headers, **kwargs)
+
+        # print payload request
+        print("***Payload Request:", kwargs.get("json"))
+        
+        # print line breaks 
+        print("\n\n")
+        
+        
+        # Send request
+        response = requests.request(method=method, url=url, headers=headers, **kwargs)
+        
+        # print payload response
+        print("***Payload Response:", response.text)
+         
+        # print line breaks 
+        print("\n\n")
+
+        return response
 
     def _process_response(self, response: requests.Response, response_model: Type[T]) -> ApiResponse[T]:
         status_code = response.status_code
@@ -48,8 +68,10 @@ def _process_response(self, response: requests.Response, response_model: Type[T]
             )
 
         if 200 <= status_code < 300:
-            if "data" in response_data and response_data["data"] is not None:
+            
+            if issubclass(response_model, BaseModel) and isinstance(response_data["data"], dict):
                 response_data["data"] = response_model.model_validate(response_data["data"])
+                
             return ApiResponse[T].model_validate(response_data)
 
         try:
@@ -92,6 +114,5 @@ def send_request(self, method: str, endpoint: str, response_model: Type[T], **kw
             # Excluir propiedades con valor None
             kwargs["json"] = payload.model_dump(mode="json", by_alias=True, exclude_none=True)
 
-        print("Payload Request:", kwargs.get("json")) 
         response = self._request(method, endpoint, **kwargs)
         return self._process_response(response, response_model)

fiscalapi/services/fiscalapi_client.py

@@ -1,9 +1,14 @@
 from fiscalapi.models.common_models import FiscalApiSettings
-from fiscalapi.services.products_service import ProductService
+from fiscalapi.services.people_service import PeopleService
+from fiscalapi.services.product_service import ProductService
 
 
 class FiscalApiClient:
+    
     def __init__(self, settings: FiscalApiSettings):
         self.products = ProductService(settings)
+        self.people = PeopleService(settings)
+        
+        
         #self.invoice_service = InvoiceService(settings)
         # Otros servicios concretos pueden ser inicializados aquí

fiscalapi/services/people_service.py

@@ -0,0 +1,32 @@
+from fiscalapi.models.common_models import ApiResponse, PagedList
+from fiscalapi.models.fiscalapi_models import Person, Product
+from fiscalapi.services.base_service import BaseService
+
+
+class PeopleService(BaseService):
+    
+    # get paged list of people
+    def get_list(self, page_number: int, page_size: int) -> ApiResponse[PagedList[Person]]:
+        endpoint = f"people?pageNumber={page_number}&pageSize={page_size}"
+        return self.send_request("GET", endpoint, PagedList[Person])
+    
+    # get person by id
+    def get_by_id(self, person_id: int) -> ApiResponse[Person]:
+        endpoint = f"people/{person_id}"
+        return self.send_request("GET", endpoint, Person)
+    
+    # create person
+    def create(self, person: Person) -> ApiResponse[Person]:
+        endpoint = "people"
+        return self.send_request("POST", endpoint, Person, payload=person)
+    
+    # update person
+    def update(self, person: Person) -> ApiResponse[Person]:
+        endpoint = f"people/{person.id}"
+        return self.send_request("PUT", endpoint, Person, payload=person)
+    
+    # delete person
+    def delete(self, person_id: str) -> ApiResponse[bool]:
+        endpoint = f"people/{person_id}"
+        return self.send_request("DELETE", endpoint, bool)
+    

fiscalapi/services/products_service.py fiscalapi/services/product_service.pyfiscalapi/services/products_service.py renamed to fiscalapi/services/product_service.py

@@ -1,6 +1,6 @@
 from fiscalapi.models.common_models import ApiResponse, PagedList
 from fiscalapi.models.fiscalapi_models import Product
-from fiscalapi.services.common_services import BaseService
+from fiscalapi.services.base_service import BaseService
 
 
 class ProductService(BaseService):

requirements.txt

@@ -3,6 +3,8 @@ build==1.2.2.post1
 certifi==2024.12.14
 charset-normalizer==3.4.1
 colorama==0.4.6
+dnspython==2.7.0
+email_validator==2.2.0
 idna==3.10
 packaging==24.2
 pydantic==2.10.5