masstack-python-client 0.0.3__tar.gz → 0.0.4__tar.gz

{masstack_python_client-0.0.3/src/masstack_python_client.egg-info → masstack_python_client-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: masstack-python-client
-Version: 0.0.3
+Version: 0.0.4
 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
@@ -45,6 +45,10 @@ This Python API client provides access to masmovil core API domains.
         - returns customer tree data associated to a given document identification, email or number of the client. 
         - returns user data by userId
 
+* Catalogue
+    - bundled_products - access to bundled products
+        - get sellable bundled products
+
 ## Installation
 
 ```commandline

{masstack_python_client-0.0.3 → masstack_python_client-0.0.4}/README.md

@@ -28,6 +28,10 @@ This Python API client provides access to masmovil core API domains.
         - returns customer tree data associated to a given document identification, email or number of the client. 
         - returns user data by userId
 
+* Catalogue
+    - bundled_products - access to bundled products
+        - get sellable bundled products
+
 ## Installation
 
 ```commandline

{masstack_python_client-0.0.3 → masstack_python_client-0.0.4}/src/masstack_python_client/__init__.py

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

masstack_python_client-0.0.4/src/masstack_python_client/resources/catalogue.py

@@ -0,0 +1,110 @@
+from typing import Optional, List
+from masstack_python_client.client import MasstackClient
+from masstack_python_client.resources.enums.bundled_product_category import (
+    BundleCategory,
+)
+from masstack_python_client.resources.enums.commercial_segment_name import (
+    CommercialSegmentName,
+)
+from masstack_python_client.resources.enums.customer_segment_name import (
+    CustomerSegmentName,
+)
+from masstack_python_client.resources.enums.customer_type_name import CustomerTypeName
+from masstack_python_client.resources.enums.sale_type_name import SaleTypeName
+from masstack_python_client.resources.enums.technology_name import TechnologyName
+from masstack_python_client.resources.models.bundled import BundledProduct
+
+
+class CatalogueResource:
+    """Support sales and post-sales operations from catalogue perspective
+    https://developers.masstack.com/en/docs/apis_catalogue_doc_swagger/2/apioverview/
+    """
+
+    _api_domain = "catalogue"
+
+
+class BundledProducts(CatalogueResource):
+    _api_path = "bundled_products"
+    _version = "v2"
+
+    @classmethod
+    def _get_endpoint(cls, subpath: str) -> str:
+        return f"{cls._api_path}/{subpath}"
+
+    @classmethod
+    def _request(
+        cls,
+        method: str,
+        subpath: 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=cls._get_endpoint(subpath),
+            params=params,
+            data=data,
+        )
+
+
+class Sellable(BundledProducts):
+
+    _api_subpath = "sellable"
+
+    @classmethod
+    def get(
+        cls,
+        commercial_profile_name: Optional[str] = None,
+        technology_name: Optional[TechnologyName] = None,
+        territory_owner_id: Optional[str] = None,
+        category: Optional[BundleCategory] = None,
+        customer_segment_name: Optional[CustomerSegmentName] = None,
+        commercial_segment_name: Optional[CommercialSegmentName] = None,
+        customer_type_name: Optional[CustomerTypeName] = None,
+        sale_type_name: Optional[SaleTypeName] = None,
+    ) -> List[BundledProduct]:
+        """Returns an array of sellable bundled products based on input criteria,
+         including the mandatory bundled commercial products for each bundled product.
+         Provides details for each bundled commercial product about the marketing name.
+
+        Args:
+            commercial_profile_name (str): commercial profile name
+            technology_name (TechnologyName): technology name
+            territory_owner_id (str): territory owner identifier
+            category (BundleCategory): bundled product category
+            customer_segment_name (CustomerSegmentName): customer segment name
+            commercial_segment_name(CommercialSegmentName): SmallMediumEnterprise or Consumer
+            customer_type_name(CustomerTypeName): customer type name
+            sale_type_name(SaleTypeName): sale type name
+
+        Returns:
+            BundledProduct
+
+        """
+        params = {
+            "commercial_profile_name": commercial_profile_name,
+            "technology_name": technology_name,
+            "territory_owner_id": territory_owner_id,
+            "category": category,
+            "customer_segment_name": customer_segment_name,
+            "commercial_segment_name": commercial_segment_name,
+            "customer_type_name": customer_type_name,
+            "sale_type_name": sale_type_name,
+        }
+        sellable_bundled_products = cls._request(
+            "get",
+            cls._api_subpath,
+            {
+                k: (v.value if hasattr(v, "value") else v)
+                for k, v in params.items()
+                if v is not None
+            },
+        )
+        return [
+            BundledProduct.from_dict(**sellable_bundled_product)
+            for sellable_bundled_product in sellable_bundled_products
+        ]

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/bundled_product_category.py

@@ -0,0 +1,12 @@
+from enum import Enum
+
+
+class BundleCategory(Enum):
+    MOBILE = "Mobile"
+    TV = "TV"
+    FIXED_BROADBAND = "Fixed+Broadband"
+    FIXED_MOBILE = "Fixed+Mobile"
+    FIXED_BROADBAND_MOBILE = "Fixed+Broadband+Mobile"
+    FIXED_BROADBAND_TV = "Fixed+Broadband+TV"
+    FIXED_BROADBAND_MOBILE_NTX = "Fixed+Broadband+Mobile+Netflix"
+    FIXED_BROADBAND_MOBILE_TV = "Fixed+Broadband+Mobile+TV"

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/commercial_segment_name.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class CommercialSegmentName(Enum):
+    SME = "SME"
+    CONSUMER = "Consumer"

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/customer_segment_name.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class CustomerSegmentName(Enum):
+    RESIDENTIAL = "RESIDENCIAL"
+    COMPANY = "EMPRESA"
+    AUTONOMOUS = "AUTONOMO"
+    HORECA = "HORECA"

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/customer_type_name.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class CustomerTypeName(Enum):
+    NEW = "Nuevo"
+    EXISTING = "Existente"

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/sale_type_name.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+
+class SaleTypeName(Enum):
+    SALE = "Venta"
+    MIGRATION = "Migración"
+    ADD_LINE = "Añadir Línea"
+    CROSS_SELL = "Cross Sell"
+    WALLET = "Cartera"

masstack_python_client-0.0.4/src/masstack_python_client/resources/enums/technology_name.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class TechnologyName(Enum):
+    ADSL = "ADSL"
+    FIBRA = "FIBRA"

masstack_python_client-0.0.4/src/masstack_python_client/resources/models/bundled.py

@@ -0,0 +1,58 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class SubsType:
+    id: str
+    name: str
+    description: str
+
+
+@dataclass(frozen=True)
+class ComercialProduct:
+    id: str
+    name: str
+
+    @classmethod
+    def from_dict(cls, commercial_product, **kwargs) -> "ComercialProduct":
+        return cls(commercial_product["id"], commercial_product["name"])
+
+
+@dataclass(frozen=True)
+class BundledProductSubtype:
+    id: str
+    bundled_commercial_products: list[ComercialProduct]
+    subs_type: SubsType
+
+    @classmethod
+    def from_dict(
+        cls, id, bundled_commercial_products, subs_type, **kwargs
+    ) -> "BundledProductSubtype":
+        return cls(
+            id,
+            bundled_commercial_products=[
+                ComercialProduct.from_dict(**bundled_commercial_product)
+                for bundled_commercial_product in bundled_commercial_products
+            ],
+            subs_type=SubsType(**subs_type),
+        )
+
+
+@dataclass(frozen=True)
+class BundledProduct:
+    id: str
+    name: str
+    bundled_product_subs_types: list[BundledProductSubtype]
+
+    @classmethod
+    def from_dict(
+        cls, id, name, bundled_product_subs_types, **kwargs
+    ) -> "BundledProduct":
+        return cls(
+            id,
+            name,
+            bundled_product_subs_types=[
+                BundledProductSubtype.from_dict(**bundled_product_subs_type)
+                for bundled_product_subs_type in bundled_product_subs_types
+            ],
+        )

{masstack_python_client-0.0.3 → masstack_python_client-0.0.4/src/masstack_python_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: masstack-python-client
-Version: 0.0.3
+Version: 0.0.4
 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
@@ -45,6 +45,10 @@ This Python API client provides access to masmovil core API domains.
         - returns customer tree data associated to a given document identification, email or number of the client. 
         - returns user data by userId
 
+* Catalogue
+    - bundled_products - access to bundled products
+        - get sellable bundled products
+
 ## Installation
 
 ```commandline

{masstack_python_client-0.0.3 → masstack_python_client-0.0.4}/src/masstack_python_client.egg-info/SOURCES.txt

@@ -19,10 +19,19 @@ src/masstack_python_client/data/province_translation.csv
 src/masstack_python_client/data/street_type_translation.csv
 src/masstack_python_client/data/unit_translation.csv
 src/masstack_python_client/resources/__init__.py
+src/masstack_python_client/resources/catalogue.py
 src/masstack_python_client/resources/customers.py
 src/masstack_python_client/resources/feasibility.py
+src/masstack_python_client/resources/enums/__init__.py
+src/masstack_python_client/resources/enums/bundled_product_category.py
+src/masstack_python_client/resources/enums/commercial_segment_name.py
+src/masstack_python_client/resources/enums/customer_segment_name.py
+src/masstack_python_client/resources/enums/customer_type_name.py
 src/masstack_python_client/resources/enums/document_type_search.py
+src/masstack_python_client/resources/enums/sale_type_name.py
+src/masstack_python_client/resources/enums/technology_name.py
 src/masstack_python_client/resources/models/address.py
+src/masstack_python_client/resources/models/bundled.py
 src/masstack_python_client/resources/models/client_address.py
 src/masstack_python_client/resources/models/client_attribute.py
 src/masstack_python_client/resources/models/client_payment.py