masstack-python-client 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

masstack_python_client/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.0.2"
+__version__ = "0.0.3"
 __homepage__ = "https://somconnexio.coop/"
 __author__ = "Borja Gimeno <borja.gimeno@somconnexio.coop>"
 __license__ = "GPL-3.0-only"

masstack_python_client/resources/customers.py

@@ -0,0 +1,106 @@
+from typing import Optional
+from dataclasses import asdict
+
+from masstack_python_client.client import MasstackClient
+from masstack_python_client.resources.enums.document_type_search import (
+    DocumentTypeSearch,
+)
+from masstack_python_client.resources.models.signup import (
+    SignupRequestData,
+    SignupsResponseData,
+)
+from masstack_python_client.resources.models.user import UserData
+from masstack_python_client.resources.utils.serialize import remove_none
+
+
+class CustomersResource:
+    """Provide the necessary functionality to be able to give
+    E2E coverage to the entire life-cycle of a client
+    https://developers.masstack.com/en/docs/apis_customers_doc_swagger/2/apioverview
+    """
+
+    _api_domain = "customers"
+
+    @classmethod
+    def _request(
+        cls,
+        method: str,
+        endpoint: str,
+        params: Optional[dict] = None,
+        data: Optional[dict] = None,
+    ) -> dict:
+        client = MasstackClient()
+        func = getattr(client, method)
+
+        return func(
+            api=cls._api_domain,
+            version=cls._version,
+            endpoint=endpoint,
+            params=params,
+            data=data,
+        )
+
+
+class SignupsResource(CustomersResource):
+    _api_path = "signups"
+    _version = "v2"
+
+    @classmethod
+    def add_customer(cls, customer_data: SignupRequestData) -> SignupsResponseData:
+        """Add new customers including products purchased.
+
+        Args:
+            customer_data (SignupRequestData): The data of the customer to be added.
+
+        Returns:
+            SignupsResponseData
+        """
+        payload = remove_none(asdict(customer_data))
+        result = cls._request(
+            method="post",
+            endpoint=cls._api_path,
+            data=payload,
+        )
+
+        return SignupsResponseData(
+            sell_id=result["sell_id"],
+            customer_id=result["customer_id"],
+            work_order_id=[result["work_order_id"]],
+        )
+
+
+class Users(CustomersResource):
+    _api_path = "users"
+    _version = "v2"
+
+    @classmethod
+    def get_user_id_by_doc(cls, doc: str, doc_type: DocumentTypeSearch) -> str:
+        """
+        Get user ID associated to a given document identification
+
+        Args:
+            doc (str): The user's document number.
+            doc_type (DocumentTypeSearch): The type of document.
+
+        Returns:
+            user id.
+        """
+        data = {"document_type": doc_type.value, "document": doc}
+
+        return cls._request(method="post", endpoint=f"{cls._api_path}/tree", data=data)[
+            "id"
+        ]
+
+    @classmethod
+    def get_user_by_id(cls, user_id: str) -> dict:
+        """
+        Get user information by user ID
+
+        Args:
+            user_id (str): The user's ID.
+
+        Returns:
+            UserData
+        """
+        user = cls._request(method="get", endpoint=f"{cls._api_path}/{user_id}")
+        return UserData.from_dict(**user)

masstack_python_client/resources/enums/document_type_search.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+
+class DocumentTypeSearch(Enum):
+    NIF = "NIF"
+    DNI = "DNI"
+    TR = "TR"
+    PASS = "PASS"
+    CIF = "CIF"

masstack_python_client/resources/models/client_address.py

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class ClientAddress:
+    street_name: str
+    state_id: int
+    locality: str
+    postal_code: str
+    number: int
+    country: str = "España"

masstack_python_client/resources/models/client_attribute.py

@@ -0,0 +1,27 @@
+from dataclasses import dataclass
+from typing import Dict, Any
+
+from masstack_python_client.resources.models.client_address import ClientAddress
+
+
+@dataclass(frozen=True)
+class ClientAttribute:
+    type: str
+    document_type_id: int
+    document_value: str
+    email: str
+    birthdate: str
+    nationality_id: int
+    contact_phone: str
+    gender: str
+    language_id: int
+    address: ClientAddress
+    name: str = None
+    company_name: str = None
+    middlename: str = "."
+    lastname: str = "."
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "ClientAttribute":
+        data_address = data.pop("address")
+        return cls(address=ClientAddress(**data_address), **data)

masstack_python_client/resources/models/client_payment.py

@@ -0,0 +1,14 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class BankAccount:
+    bank_account: str
+
+
+@dataclass(frozen=True)
+class ScoringAccount:
+    id_value: float = 1.01
+    scoring_value: int = 71
+    up_front: float = 1.01
+    forced_value: float = 0.01

masstack_python_client/resources/models/products.py

@@ -0,0 +1,90 @@
+from dataclasses import dataclass, field
+from typing import List, Dict, Any
+
+
+@dataclass(frozen=True)
+class Contact:
+    name: str
+    phone: str
+    email: str
+    document_type_id: str
+    document_value: str
+    middlename: str = "."
+    lastname: str = "."
+
+
+@dataclass(frozen=True)
+class Address:
+    street_type_id: int
+    street_name: str
+    number: int
+    supplement: str
+    state_id: int
+    locality: str
+    postal_code: str
+    gescal: str
+    address_id: str
+    pair_vacancy: bool = True
+
+
+@dataclass(frozen=True)
+class Info:
+    contact: Contact
+    address: Address
+
+    @classmethod
+    def from_dict(
+        cls,
+        data: Dict[str, Any],
+    ) -> "Info":
+        return cls(
+            contact=Contact(**data["contact"]),
+            address=Address(**data["address"]),
+        )
+
+
+@dataclass(frozen=True)
+class Landline:
+    product_id: int
+    number: str
+    services: List = field(default_factory=list)
+    wants_communications: bool = False
+    # TODO portability_info
+
+
+@dataclass(frozen=True)
+class Ftth:
+    product_id: int
+    connection_type: str = ""
+    installer: str = "MM"
+    wants_communications: bool = False
+    # TODO access_reuse
+    # TODO access_reuse_choice
+    # TODO iua
+
+
+@dataclass(frozen=True)
+class Bundle:
+    bundle_id: int
+    territory_owner: str
+    installation_info: Info
+    delivery_info: Info
+    landline: Landline
+    ftth: Ftth
+
+    @classmethod
+    def from_dict(
+        cls,
+        bundle_id: int,
+        territory_owner: str,
+        **data,
+    ) -> "Bundle":
+        info = Info.from_dict(data["client_info"])
+        return cls(
+            bundle_id,
+            territory_owner,
+            installation_info=info,
+            delivery_info=info,
+            landline=Landline(**data["land_line"]),
+            ftth=Ftth(**data["ftth"]),
+        )

masstack_python_client/resources/models/signup.py

@@ -0,0 +1,78 @@
+from dataclasses import dataclass
+from typing import List, Dict, Any
+
+from masstack_python_client.resources.models.client_attribute import ClientAttribute
+from masstack_python_client.resources.models.client_payment import (
+    BankAccount,
+    ScoringAccount,
+)
+from masstack_python_client.resources.models.products import Bundle
+
+
+@dataclass(frozen=True)
+class SalesInfo:
+    dealer_id: str
+    shop_id: str
+    channel: str = "dealer"
+    logistic: bool = False
+
+
+@dataclass(frozen=True)
+class Clients:
+    attributes: List[ClientAttribute]
+    sector_id: int = 1
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Clients":
+        client_types = ["client", "account"]
+        return cls(
+            attributes=[
+                ClientAttribute.from_dict({"type": client_type, **data})
+                for client_type in client_types
+            ]
+        )
+
+
+@dataclass(frozen=True)
+class ClientPayment:
+    info: BankAccount
+    scoring: ScoringAccount = ScoringAccount()
+    billing_type_id: int = 1
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "ClientPayment":
+        return cls(info=BankAccount(bank_account=data["bank_account"]))
+
+
+@dataclass(frozen=True)
+class Products:
+    bundle: Bundle
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Products":
+        return cls(bundle=Bundle.from_dict(**data))
+
+
+@dataclass(frozen=True)
+class SignupRequestData:
+    sales_info: SalesInfo
+    clients: Clients
+    payment: ClientPayment
+    products: Products
+    sales_type: str = "telecomunications"
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "SignupRequestData":
+        return cls(
+            sales_info=SalesInfo(**data["sales"]),
+            clients=Clients.from_dict(data["client"]),
+            payment=ClientPayment.from_dict(data["payment"]),
+            products=Products.from_dict(data["products"]),
+        )
+
+
+@dataclass(frozen=True)
+class SignupsResponseData:
+    sell_id: int
+    customer_id: int
+    work_order_id: str

masstack_python_client/resources/models/user.py

@@ -0,0 +1,42 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class UserData:
+    id: int
+    document_value: str
+    document_type_id: int
+    gender: str
+    first_name: str
+    middle_name: str
+    last_name: str
+    nationality: str
+    email: str
+    birthdate: str
+    phone: str
+
+    @classmethod
+    def from_dict(
+        cls,
+        id,
+        document_value: str,
+        document_type: dict,
+        nationality: dict,
+        personal: dict,
+        **kwargs,
+    ):
+        return cls(
+            **{
+                "id": id,
+                "document_value": document_value,
+                "document_type_id": document_type["id"],
+                "gender": personal["gender"],
+                "first_name": personal["first_name"],
+                "middle_name": personal["middle_name"],
+                "last_name": personal["last_name"],
+                "nationality": nationality["value"],
+                "email": personal["email"],
+                "birthdate": personal["birthdate"],
+                "phone": personal["other_phone"],
+            }
+        )

masstack_python_client/resources/utils/serialize.py

@@ -0,0 +1,7 @@
+def remove_none(obj):
+    if isinstance(obj, dict):
+        return {k: remove_none(v) for k, v in obj.items() if v is not None}
+    elif isinstance(obj, list):
+        return [remove_none(v) for v in obj if v is not None]
+    else:
+        return obj

{masstack_python_client-0.0.2.dist-info → masstack_python_client-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: masstack-python-client
-Version: 0.0.2
+Version: 0.0.3
 Summary: This Python API client provides access to masmovil core API domains
 Author-email: Borja Gimeno <borja.gimeno@somconnexio.coop>
 License: GPL-3.0-only
@@ -38,6 +38,13 @@ This Python API client provides access to masmovil core API domains.
             - get: returns a unit by id with a list of coverages
             - get_coverage: returns coverage info for a unit id and territory_owner
 
+* Customers
+    - Signups - access to signups new clients
+        - post new client
+    - Users
+        - returns customer tree data associated to a given document identification, email or number of the client. 
+        - returns user data by userId
+
 ## Installation
 
 ```commandline

{masstack_python_client-0.0.2.dist-info → masstack_python_client-0.0.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-masstack_python_client/__init__.py,sha256=nONqqQfdBA4hcdLRiI-BLjO8OP62ZMf3nBkKc4iK0PI,154
+masstack_python_client/__init__.py,sha256=ZGw_LqC_xbgEF9n0CyxrpBpNtc1-3gLH0fxTScbA7Bk,154
 masstack_python_client/client.py,sha256=5b52Q2ekABi7DlZPsNobcmaJXOKzZfhKE_kHvNEqE9Q,2496
 masstack_python_client/exceptions.py,sha256=HkX1cP4Ryeas59CzIVW8N5gmnRE1x0yQUQwS3tm9QZQ,2115
 masstack_python_client/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -10,10 +10,19 @@ masstack_python_client/data/province_translation.csv,sha256=Jpd6jbjYaqeNOk9lUA3W
 masstack_python_client/data/street_type_translation.csv,sha256=2MGeTs0v6wVz2yRMyZUuoNOYA4NSqKGJCGYIRi9X8Ic,1791
 masstack_python_client/data/unit_translation.csv,sha256=34FPfaCC1eSmBfV0BbHSHJ-tktQk7YLlfT8tMxnfnys,194
 masstack_python_client/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+masstack_python_client/resources/customers.py,sha256=9GTXQ5fiVosbAzK__uydZOBu9wXC9yO4pHufseHqD38,2924
 masstack_python_client/resources/feasibility.py,sha256=DbiPwWa9orSmITgcID7RVPKf7b50Pk8h1XQh0xxGYhw,7119
+masstack_python_client/resources/enums/document_type_search.py,sha256=pniXpUA_odqeKyxS6yYiN2uje0-F1kKXXBLOk0F8UTQ,136
 masstack_python_client/resources/models/address.py,sha256=hKnEUVVz8AfGjhaDngzQ0HuR4_Z6zhK6Xe8Aj6xJR7I,5451
-masstack_python_client-0.0.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-masstack_python_client-0.0.2.dist-info/METADATA,sha256=PYQ7cZDcfSEI-bLe2FKf4l3LLFCzd1vRtwpBmH7WEPE,3462
-masstack_python_client-0.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-masstack_python_client-0.0.2.dist-info/top_level.txt,sha256=q_iYlqJq22lhg_2O2iktARr7Mzz3QfjaW4l6J4vwyE8,23
-masstack_python_client-0.0.2.dist-info/RECORD,,
+masstack_python_client/resources/models/client_address.py,sha256=7WBiPTce2X6uZUVVZvZlTMgiohbVITUzmKgYYPvpM-w,204
+masstack_python_client/resources/models/client_attribute.py,sha256=rZlLjJeBVD6IpXbSEucujTqcmHhqoJGRTOV1wqyStak,697
+masstack_python_client/resources/models/client_payment.py,sha256=yMGMTuk_07-TzXWO89sCaaZv8soTO9cT0TzfV3xQa1o,262
+masstack_python_client/resources/models/products.py,sha256=cIuUlEKs0OfvBXtYxxUwG4vibfAlZL4uVBK7-nAL9rw,1831
+masstack_python_client/resources/models/signup.py,sha256=Hvo5nZce1ikpUUMEoLt_2g2HipHwh4XRIz344X8_IJk,2018
+masstack_python_client/resources/models/user.py,sha256=N5mwuZN0Saxiro2UXYcCxLL6jrpIU83crHhmrdAcgE8,1080
+masstack_python_client/resources/utils/serialize.py,sha256=F6JxqR2M9HH0TpYKaJritnppWkYlpPztZ9ZC43FdPLg,251
+masstack_python_client-0.0.3.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+masstack_python_client-0.0.3.dist-info/METADATA,sha256=lIkct6n2EgZkeXZ4u1GJv4UIqpJjk9KvMIc4KjEjPoU,3713
+masstack_python_client-0.0.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+masstack_python_client-0.0.3.dist-info/top_level.txt,sha256=q_iYlqJq22lhg_2O2iktARr7Mzz3QfjaW4l6J4vwyE8,23
+masstack_python_client-0.0.3.dist-info/RECORD,,