producteca 1.0.0__py3-none-any.whl

producteca/__init__.py

@@ -0,0 +1,5 @@
+from . import products
+from . import search
+from . import sales_orders
+from . import shipments
+from . import payments

producteca/abstract/abstract_dataclass.py

@@ -0,0 +1,23 @@
+from pydantic import BaseModel, PrivateAttr
+from abc import ABC, abstractmethod
+from ..config.config import ConfigProducteca, APIConfig
+
+
+class AbstractProductecaModel(BaseModel, ABC):
+    _config: APIConfig = PrivateAttr()
+
+    @property
+    @abstractmethod
+    def endpoint(self) -> str:
+        pass
+
+    def dict(self, *args, **kwargs):
+        return super().dict(*args, exclude_none=True, **kwargs)
+
+
+class AbstractProductecaV1Model(AbstractProductecaModel):
+    _config: ConfigProducteca = PrivateAttr()
+
+    @property
+    def endpoint_url(self) -> str:
+        return self._config.get_endpoint(self.endpoint)

producteca/config/__init__.py

@@ -0,0 +1 @@
+from .config import ConfigProducteca

producteca/config/config.py

@@ -0,0 +1,28 @@
+from pydantic import BaseModel, PrivateAttr
+from abc import ABC, abstractmethod
+
+
+class APIConfig(BaseModel, ABC):
+    base_url: str = 'https://api-external.producteca.com'
+
+    @property
+    @abstractmethod
+    def headers(self) -> dict:
+        pass
+
+    def get_endpoint(self, endpoint: str) -> str:
+        return f'{self.base_url}/{endpoint}'
+
+
+class ConfigProducteca(APIConfig):
+    token: str
+    api_key: str
+
+    @property
+    def headers(self) -> dict:
+        return {
+            "Content-Type": "application/json",
+            "authorization": f"Bearer {self.token}",
+            "x-api-key": self.api_key,
+            "Accept": "*/*"
+        }

producteca/payments/payments.py

@@ -0,0 +1,45 @@
+from pydantic import BaseModel
+from typing import Optional
+import requests
+from ..config.config import ConfigProducteca
+
+
+class PaymentCard(BaseModel):
+    paymentNetwork: Optional[str] = None
+    firstSixDigits: Optional[int] = None
+    lastFourDigits: Optional[int] = None
+    cardholderIdentificationNumber: Optional[str] = None
+    cardholderIdentificationType: Optional[str] = None
+    cardholderName: Optional[str] = None
+
+
+class PaymentIntegration(BaseModel):
+    integrationId: str
+    app: int
+
+
+class Payment(BaseModel):
+    date: str
+    amount: float
+    couponAmount: Optional[float] = None
+    status: str
+    method: str
+    integration: Optional[PaymentIntegration] = None
+    transactionFee: Optional[float] = None
+    installments: Optional[int] = None
+    card: Optional[PaymentCard] = None
+    notes: Optional[str] = None
+    hasCancelableStatus: bool
+    id: Optional[int] = None
+
+    @classmethod
+    def create(cls, config: ConfigProducteca, sale_order_id: int, payload: "Payment") -> "Payment":
+        url = config.get_endpoint(f"salesorders/{sale_order_id}/payments")
+        res = requests.post(url, data=payload.model_dump_json(exclude_none=True), headers=config.headers)
+        return cls(**res.json())
+
+    @classmethod
+    def update(cls, config: ConfigProducteca, sale_order_id: int, payment_id: int, payload: "Payment") -> "Payment":
+        url = config.get_endpoint(f"salesorders/{sale_order_id}/payments/{payment_id}")
+        res = requests.put(url, data=payload.model_dump_json(exclude_none=True), headers=config.headers)
+        return cls(**res.json())

producteca/products/__init__.py

@@ -0,0 +1 @@
+from . import products

producteca/products/products.py

@@ -0,0 +1,182 @@
+from typing import List, Optional, Union
+from pydantic import BaseModel, Field
+import requests
+from ..config.config import ConfigProducteca
+import logging
+
+_logger = logging.getLogger(__name__)
+
+# Models for nested structures
+
+class Attribute(BaseModel):
+    key: str
+    value: str
+
+class Tag(BaseModel):
+    tag: str
+
+class Dimensions(BaseModel):
+    weight: Optional[float] = None
+    width: Optional[float] = None
+    height: Optional[float] = None
+    length: Optional[float] = None
+    pieces: Optional[int] = None
+
+class Deal(BaseModel):
+    campaign: str
+    regular_price: Optional[float] = Field(default=None, alias='regularPrice')
+    deal_price: Optional[float] = Field(default=None, alias='dealPrice')
+
+class Stock(BaseModel):
+    quantity: Optional[int] = None
+    available_quantity: Optional[int] = Field(default=None, alias='availableQuantity')
+    warehouse: Optional[str] = None
+    warehouse_id: Optional[int] = Field(default=None, alias='warehouseId')
+    reserved: Optional[int] = None
+    available: Optional[int] = None
+
+class Price(BaseModel):
+    amount: Optional[float] = None
+    currency: str
+    price_list: str = Field(alias='priceList')
+    price_list_id: Optional[int] = Field(default=None, alias='priceListId')
+
+class Picture(BaseModel):
+    url: str
+
+class Integration(BaseModel):
+    app: Optional[int] = None
+    integration_id: Optional[str] = Field(default=None, alias='integrationId')
+    permalink: Optional[str] = None
+    status: Optional[str] = None
+    listing_type: Optional[str] = Field(default=None, alias='listingType')
+    safety_stock: Optional[int] = Field(default=None, alias='safetyStock')
+    synchronize_stock: Optional[bool] = Field(default=None, alias='synchronizeStock')
+    is_active: Optional[bool] = Field(default=None, alias='isActive')
+    is_active_or_paused: Optional[bool] = Field(default=None, alias='isActiveOrPaused')
+    id: Optional[int] = None
+    parent_integration: Optional[str] = Field(default=None, alias='parentIntegration')
+
+class Variation(BaseModel):
+    variation_id: Optional[int] = Field(default=None, alias='variationId')
+    components: Optional[List] = None
+    pictures: Optional[List[Picture]] = None
+    stocks: Optional[List[Stock]] = None
+    attributes_hash: Optional[str] = Field(default=None, alias='attributesHash')
+    primary_color: Optional[str] = Field(default=None, alias='primaryColor')
+    thumbnail: Optional[str] = None
+    attributes: Optional[List[Attribute]] = None
+    integrations: Optional[List[Integration]] = None
+    id: Optional[int] = None
+    sku: Optional[str] = None
+    barcode: Optional[str] = None
+
+# Model base para los productos
+class Product(BaseModel):
+    config: Optional[ConfigProducteca] = Field(default=None, exclude=True)
+    endpoint: str = Field(default='products', exclude=True)
+    create_if_it_doesnt_exist: bool = Field(default=False, exclude=True)
+    sku: Optional[str] = None
+    variation_id: Optional[int] = None
+    code: Optional[str] = None
+    name: Optional[str] = None
+    barcode: Optional[str] = None
+    attributes: Optional[List[Attribute]] = None
+    tags: Optional[List[str]] = None
+    buying_price: Optional[float] = None
+    dimensions: Optional[Dimensions] = None
+    category: Optional[Union[str, dict]] = None  # Puede ser string en POST o dict en GET Meli
+    brand: Optional[str] = None
+    notes: Optional[str] = None
+    deals: Optional[List[Deal]] = None
+    stocks: Optional[List[Stock]] = None
+    prices: Optional[List[Price]] = None
+    pictures: Optional[List[Picture]] = None
+
+
+    def create(self):
+        endpoint_url = self.config.get_endpoint(f'{self.endpoint}/synchronize')
+        headers = self.config.headers.copy()
+        headers.update({"createifitdoesntexist": str(self.create_if_it_doesnt_exist).lower()})
+        data = self.model_dump_json(by_alias=True, exclude_none=True)
+        response = requests.post(endpoint_url, data=data, headers=headers)
+        if response.status_code == 204:
+            final_response = {"Message":"Product does not exist and the request cant create if it does not exist"}
+        else:
+            final_response = response.json()
+        return final_response, response.status_code
+
+    def update(self):
+        endpoint_url = self.config.get_endpoint(f'{self.endpoint}/synchronize')
+        headers = self.config.headers.copy()
+        data = self.model_dump_json(by_alias=True, exclude_none=True)
+        if not self.code and not self.sku:
+            return {"Message":"Sku or code should be provided to update the product"}, 204
+        response = requests.post(endpoint_url, data=data, headers=headers)
+        if response.status_code == 204:
+            final_response = {"Message":"Product does not exist and the request cant create if it does not exist"}
+        else:
+            final_response = response.json()
+        return final_response, response.status_code
+
+    @classmethod
+    def get(cls, config: ConfigProducteca, product_id: int):
+        endpoint_url = config.get_endpoint(f'{cls().endpoint}/{product_id}')
+        headers = config.headers
+        response = requests.get(endpoint_url, headers=headers)
+        response_data = response.json()
+        return response_data, response.status_code
+
+    @classmethod
+    def get_bundle(cls, config: ConfigProducteca, product_id: int):
+        endpoint_url = config.get_endpoint(f'{cls().endpoint}/{product_id}/bundles')
+        headers = config.headers
+        response = requests.get(endpoint_url, headers=headers)
+        return cls(config=config, **response.json()), response.status_code
+
+    @classmethod
+    def get_ml_integration(cls, config: ConfigProducteca, product_id: int):
+        endpoint_url = config.get_endpoint(f'{cls().endpoint}/{product_id}/listintegration')
+        headers = config.headers
+        response = requests.get(endpoint_url, headers=headers)
+        return cls(config=config, **response.json()), response.status_code
+
+# Modelo con campos extra de la vista Meli
+class MeliCategory(BaseModel):
+    meli_id: Optional[str] = Field(default=None, alias='meliId')
+    accepts_mercadoenvios: Optional[bool] = Field(default=None, alias='acceptsMercadoenvios')
+    suggest: Optional[bool] = None
+    fixed: Optional[bool] = None
+
+class Shipping(BaseModel):
+    local_pickup: Optional[bool] = Field(default=None, alias='localPickup')
+    mode: Optional[str] = None
+    free_shipping: Optional[bool] = Field(default=None, alias='freeShipping')
+    free_shipping_cost: Optional[float] = Field(default=None, alias='freeShippingCost')
+    mandatory_free_shipping: Optional[bool] = Field(default=None, alias='mandatoryFreeShipping')
+    free_shipping_method: Optional[str] = Field(default=None, alias='freeShippingMethod')
+
+class MShopsShipping(BaseModel):
+    enabled: Optional[bool] = None
+
+class AttributeCompletion(BaseModel):
+    product_identifier_status: Optional[str] = Field(default=None, alias='productIdentifierStatus')
+    data_sheet_status: Optional[str] = Field(default=None, alias='dataSheetStatus')
+    status: Optional[str] = None
+    count: Optional[int] = None
+    total: Optional[int] = None
+
+class MeliProduct(Product):
+    product_id: Optional[int] = Field(default=None, alias='productId')
+    has_custom_shipping_costs: Optional[bool] = Field(default=None, alias='hasCustomShippingCosts')
+    shipping: Optional[Shipping] = None
+    mshops_shipping: Optional[MShopsShipping] = Field(default=None, alias='mShopsShipping')
+    add_free_shipping_cost_to_price: Optional[bool] = Field(default=None, alias='addFreeShippingCostToPrice')
+    category: Optional[MeliCategory] = None
+    attribute_completion: Optional[AttributeCompletion] = Field(default=None, alias='attributeCompletion')
+    catalog_products: Optional[List[str]] = Field(default=None, alias='catalogProducts')
+    warranty: Optional[str] = None
+    domain: Optional[str] = None
+    listing_type_id: Optional[str] = Field(default=None, alias='listingTypeId')
+    catalog_products_status: Optional[str] = Field(default=None, alias='catalogProductsStatus')
+

producteca/sales_orders/__init__.py

@@ -0,0 +1 @@
+from . import sales_orders

producteca/sales_orders/sales_orders.py

@@ -0,0 +1,255 @@
+from pydantic import BaseModel, Field
+from typing import List, Optional
+import requests
+from ..config.config import ConfigProducteca
+import logging
+_logger = logging.getLogger(__name__)
+
+class SaleOrderLocation(BaseModel):
+    streetName: Optional[str] = None
+    streetNumber: Optional[str] = None
+    addressNotes: Optional[str] = None
+    state: Optional[str] = None
+    city: Optional[str] = None
+    neighborhood: Optional[str] = None
+    zipCode: Optional[str] = None
+
+class SaleOrderBillingInfo(BaseModel):
+    docType: Optional[str] = None
+    docNumber: Optional[str] = None
+    streetName: Optional[str] = None
+    streetNumber: Optional[str] = None
+    comment: Optional[str] = None
+    zipCode: Optional[str] = None
+    city: Optional[str] = None
+    state: Optional[str] = None
+    stateRegistration: Optional[str] = None
+    taxPayerType: Optional[str] = None
+    firstName: Optional[str] = None
+    lastName: Optional[str] = None
+    businessName: Optional[str] = None
+
+class SaleOrderProfile(BaseModel):
+    app: int
+    integrationId: str
+    nickname: Optional[str] = None
+
+class SaleOrderContact(BaseModel):
+    id: int
+    name: str
+    contactPerson: Optional[str] = None
+    mail: Optional[str] = None
+    phoneNumber: Optional[str] = None
+    taxId: Optional[str] = None
+    location: Optional[SaleOrderLocation] = None
+    notes: Optional[str] = None
+    type: Optional[str] = None
+    priceList: Optional[str] = None
+    priceListId: Optional[str] = None
+    profile: Optional[SaleOrderProfile] = None
+    billingInfo: Optional[SaleOrderBillingInfo] = None
+
+class SaleOrderIntegrationId(BaseModel):
+    alternateId: Optional[str] = None
+    integrationId: str
+    app: int
+
+class SaleOrderVariationPicture(BaseModel):
+    url: str
+    id: Optional[int] = None
+
+class SaleOrderVariationStock(BaseModel):
+    warehouseId: Optional[int] = None
+    warehouse: str
+    quantity: int
+    reserved: int
+    lastModified: Optional[str] = None
+    available: int
+
+class SaleOrderVariationAttribute(BaseModel):
+    key: str
+    value: str
+
+class SaleOrderVariation(BaseModel):
+    supplierCode: Optional[str] = None
+    pictures: Optional[List[SaleOrderVariationPicture]] = None
+    stocks: Optional[List[SaleOrderVariationStock]] = None
+    integrationId: Optional[int] = None
+    attributesHash: Optional[str] = None
+    primaryColor: Optional[str] = None
+    secondaryColor: Optional[str] = None
+    size: Optional[str] = None
+    thumbnail: Optional[str] = None
+    attributes: Optional[List[SaleOrderVariationAttribute]] = None
+    integrations: Optional[List[SaleOrderIntegrationId]] = None
+    id: int
+    sku: str
+    barcode: Optional[str] = None
+
+class SaleOrderProduct(BaseModel):
+    name: str
+    code: str
+    brand: Optional[str] = None
+    id: int
+
+class SaleOrderConversation(BaseModel):
+    questions: Optional[List[str]] = None
+
+class SaleOrderLine(BaseModel):
+    price: float
+    originalPrice: Optional[float] = None
+    transactionFee: Optional[float] = None
+    product: SaleOrderProduct
+    variation: SaleOrderVariation
+    orderVariationIntegrationId: Optional[str] = None
+    quantity: int
+    conversation: Optional[SaleOrderConversation] = None
+    reserved: Optional[int] = None
+    id: int
+
+class SaleOrderCard(BaseModel):
+    paymentNetwork: Optional[str] = None
+    firstSixDigits: Optional[int] = None
+    lastFourDigits: Optional[int] = None
+    cardholderIdentificationNumber: Optional[str] = None
+    cardholderIdentificationType: Optional[str] = None
+    cardholderName: Optional[str] = None
+
+class SaleOrderPaymentIntegration(BaseModel):
+    integrationId: str
+    app: int
+
+class SaleOrderPayment(BaseModel):
+    date: Optional[str] = None
+    amount: float
+    couponAmount: Optional[float] = None
+    status: Optional[str] = None
+    method: Optional[str] = None
+    integration: Optional[SaleOrderPaymentIntegration] = None
+    transactionFee: Optional[float] = None
+    installments: Optional[int] = None
+    card: Optional[SaleOrderCard] = None
+    notes: Optional[str] = None
+    authorizationCode: Optional[str] = None
+    hasCancelableStatus: Optional[bool] = None
+    id: Optional[int] = None
+
+class SaleOrderShipmentMethod(BaseModel):
+    trackingNumber: Optional[str] = None
+    trackingUrl: Optional[str] = None
+    courier: Optional[str] = None
+    mode: Optional[str] = None
+    cost: Optional[float] = None
+    type: Optional[str] = None
+    eta: Optional[int] = None
+    status: Optional[str] = None
+
+class SaleOrderShipmentProduct(BaseModel):
+    product: int
+    variation: int
+    quantity: int
+
+class SaleOrderShipmentIntegration(BaseModel):
+    app: int
+    integrationId: str
+    status: str
+    id: int
+
+class SaleOrderShipment(BaseModel):
+    date: str
+    products: List[SaleOrderShipmentProduct]
+    method: Optional[SaleOrderShipmentMethod] = None
+    integration: Optional[SaleOrderShipmentIntegration] = None
+    receiver: Optional[dict] = None
+    id: int
+
+class SaleOrderInvoiceIntegration(BaseModel):
+    id: Optional[int] = None
+    integrationId: Optional[str] = None
+    app: Optional[int] = None
+    createdAt: Optional[str] = None
+    documentUrl: Optional[str] = None
+    xmlUrl: Optional[str] = None
+    decreaseStock: Optional[bool] = None
+
+class SaleOrder(BaseModel):
+    tags: Optional[List[str]] = None
+    integrations: Optional[List[SaleOrderIntegrationId]] = None
+    invoiceIntegration: Optional[SaleOrderInvoiceIntegration] = None
+    channel: Optional[str] = None
+    piiExpired: Optional[bool] = None
+    contact: Optional[SaleOrderContact] = None
+    lines: Optional[List[SaleOrderLine]] = None
+    warehouse: Optional[str] = None
+    warehouseId: Optional[int] = None
+    warehouseIntegration: Optional[str] = None
+    pickUpStore: Optional[str] = None
+    payments: Optional[List[SaleOrderPayment]] = None
+    shipments: Optional[List[SaleOrderShipment]] = None
+    amount: Optional[float] = None
+    shippingCost: Optional[float] = None
+    financialCost: Optional[float] = None
+    paidApproved: Optional[float] = None
+    paymentStatus: Optional[str] = None
+    deliveryStatus: Optional[str] = None
+    paymentFulfillmentStatus: Optional[str] = None
+    deliveryFulfillmentStatus: Optional[str] = None
+    deliveryMethod: Optional[str] = None
+    paymentTerm: Optional[str] = None
+    currency: Optional[str] = None
+    customId: Optional[str] = None
+    isOpen: Optional[bool] = None
+    isCanceled: Optional[bool] = None
+    cartId: Optional[str] = None
+    draft: Optional[bool] = None
+    promiseDeliveryDate: Optional[str] = None
+    promiseDispatchDate: Optional[str] = None
+    hasAnyShipments: Optional[bool] = None
+    hasAnyPayments: Optional[bool] = None
+    date: Optional[str] = None
+    notes: Optional[str] = None
+    id: int
+
+    @classmethod
+    def get(cls, config: ConfigProducteca, sale_order_id: int) -> "SaleOrder":
+        endpoint = f'salesorders/{sale_order_id}'
+        url = config.get_endpoint(endpoint)
+        response = requests.get(url, headers=config.headers)
+        return cls(**response.json())
+
+    @classmethod
+    def get_shipping_labels(cls, config: ConfigProducteca, sale_order_id: int):
+        endpoint = f'salesorders/{sale_order_id}/labels'
+        url = config.get_endpoint(endpoint)
+        response = requests.get(url, headers=config.headers)
+        return response.json()
+
+    @classmethod
+    def close(cls, config: ConfigProducteca, sale_order_id: int):
+        endpoint = f'salesorders/{sale_order_id}/close'
+        url = config.get_endpoint(endpoint)
+        response = requests.post(url, headers=config.headers)
+        return response.status_code, response.json()
+
+    @classmethod
+    def cancel(cls, config: ConfigProducteca, sale_order_id: int):
+        endpoint = f'salesorders/{sale_order_id}/cancel'
+        url = config.get_endpoint(endpoint)
+        response = requests.post(url, headers=config.headers)
+        return response.status_code, response.json()
+
+    @classmethod
+    def synchronize(cls, config: ConfigProducteca, payload: "SaleOrder") -> tuple[int, "SaleOrder"]:
+        endpoint = 'salesorders/synchronize'
+        url = config.get_endpoint(endpoint)
+        response = requests.post(url, data=payload.model_dump_json(exclude_none=True), headers=config.headers)
+        return response.status_code, cls(**response.json())
+
+    @classmethod
+    def invoice_integration(cls, config: ConfigProducteca, sale_order_id: int, payload: "SaleOrder"):
+        endpoint = f'salesorders/{sale_order_id}/invoiceIntegration'
+        url = config.get_endpoint(endpoint)
+        response = requests.put(url, headers=config.headers, data=payload.model_dump_json(exclude_none=True))
+        if response.status_code == 200:
+            return response.status_code, {}
+        return response.status_code, response.json()

producteca/search/search.py

@@ -0,0 +1,149 @@
+from typing import List, Optional
+from pydantic import BaseModel, Field
+import requests
+from ..config.config import ConfigProducteca
+
+
+class FacetValue(BaseModel):
+    count: int
+    value: str
+    label: str
+
+
+class Facet(BaseModel):
+    key: str
+    value: List[FacetValue]
+    is_collection: bool
+    translate: bool
+
+
+class SearchStocks(BaseModel):
+    warehouse: str
+    quantity: int
+    reserved: int
+
+
+class SearchPrices(BaseModel):
+    price_list_id: int
+    price_list: str
+    amount: float
+    currency: str
+
+
+class SearchIntegration(BaseModel):
+    app: Optional[int]
+    integration_id: Optional[str]
+    permalink: Optional[str]
+    status: Optional[str]
+    listing_type: Optional[str]
+    safety_stock: Optional[int]
+    synchronize_stock: Optional[bool]
+    is_active: Optional[bool]
+    is_active_or_paused: Optional[bool]
+    id: Optional[int]
+
+
+class SearchDeals(BaseModel):
+    campaign: str
+    product: int
+    variation: str
+    deal_price: float
+    discount: float
+    regular_price: float
+    enabled: bool
+    currency: str
+    id: str
+
+
+class SearchResultItem(BaseModel):
+    search_score: float = Field(..., alias='@search.score')
+    id: int
+    product_id: int
+    company_id: int
+    name: str
+    code: str
+    skus: List[str]
+    brand: str
+    category: str
+    thumbnail: str
+    stocks: List[SearchStocks]
+    warehouses_with_stock: List[str]
+    total_stock: int
+    has_pictures: bool
+    buying_price: float
+    prices: List[SearchPrices]
+    integration_ids: List[str]
+    integration_apps: List[str]
+    integrations: List[SearchIntegration]
+    campaigns: List[str]
+    app: Optional[int]
+    status: Optional[str]
+    synchronize_stock: Optional[bool]
+    listing_type: Optional[str]
+    price_amount: Optional[float]
+    price_currency: Optional[str]
+    category_id: Optional[str]
+    category_base_id: Optional[str]
+    category_l1: Optional[str]
+    category_l2: Optional[str]
+    category_l3: Optional[str]
+    category_l4: Optional[str]
+    category_l5: Optional[str]
+    category_l6: Optional[str]
+    has_category: Optional[bool]
+    category_fixed: Optional[bool]
+    accepts_mercadoenvios: Optional[bool]
+    shipping_mode: Optional[str]
+    local_pickup: Optional[bool]
+    mandatory_free_shipping: Optional[bool]
+    free_shipping: Optional[bool]
+    free_shipping_cost: Optional[float]
+    template: Optional[str]
+    youtube_id: Optional[str]
+    warranty: Optional[str]
+    permalink: Optional[str]
+    domain: Optional[str]
+    attribute_completion_status: Optional[str]
+    attribute_completion_count: Optional[int]
+    attribute_completion_total: Optional[int]
+    deals: Optional[SearchDeals]
+    campaign_status: Optional[List[str]]
+    size_chart: Optional[str]
+    channel_status: Optional[List[str]]
+    channel_category_l1: Optional[List[str]]
+    channel_category_l2: Optional[List[str]]
+    channel_category_l3: Optional[List[str]]
+    channel_category_id: Optional[List[str]]
+    channel_synchronizes_stock: Optional[List[str]]
+    channel_has_category: Optional[List[str]]
+    catalog_products_status: Optional[List[str]]
+    metadata: Optional[List[str]]
+    integration_tags: Optional[List[str]]
+    variations_integration_ids: Optional[List[str]]
+    channel_pictures_templates: Optional[List[str]]
+    channel_pictures_templates_apps: Optional[List[str]]
+
+
+class SearchProductResponse(BaseModel):
+    count: int
+    facets: List[Facet]
+    results: List[SearchResultItem]
+
+
+class SearchProductParams(BaseModel):
+    top: Optional[int]
+    skip: Optional[int]
+    filter: Optional[str] = Field(default=None, alias='$filter')
+    search: Optional[str]
+    sales_channel: Optional[str] = Field(default='2', alias='salesChannel')
+
+
+class SearchProduct:
+    endpoint: str = 'search/products'
+
+    @classmethod
+    def search_product(cls, config: ConfigProducteca, params: SearchProductParams) -> SearchProductResponse:
+        headers = config.headers
+        url = config.get_endpoint(cls.endpoint)
+        response = requests.get(url, headers=headers, params=params.dict(by_alias=True, exclude_none=True))
+        return SearchProductResponse(**response.json())

producteca/search/search_sale_orders.py

@@ -0,0 +1,170 @@
+from typing import List, Optional
+from pydantic import BaseModel, Field
+import requests
+from ..config.config import ConfigProducteca
+import logging
+
+_logger = logging.getLogger(__name__)
+
+
+class SalesOrderProduct(BaseModel):
+    id: int
+    name: str
+    code: str
+    brand: str
+
+
+class SalesOrderVariationAttribute(BaseModel):
+    key: str
+    value: str
+
+
+class SalesOrderVariation(BaseModel):
+    id: int
+    attributes: List[SalesOrderVariationAttribute]
+    sku: str
+    thumbnail: str
+
+
+class SalesOrderLine(BaseModel):
+    product: SalesOrderProduct
+    variation: SalesOrderVariation
+    quantity: int
+    price: float
+
+
+class SalesOrderCard(BaseModel):
+    payment_network: str
+    first_six_digits: int
+    last_four_digits: int
+    cardholder_identification_number: str
+    cardholder_identification_type: str
+    cardholder_name: str
+
+
+class SalesOrderPaymentIntegration(BaseModel):
+    integration_id: str
+    app: int
+
+
+class SalesOrderPayment(BaseModel):
+    date: str
+    amount: float
+    coupon_amount: float
+    status: str
+    method: str
+    integration: SalesOrderPaymentIntegration
+    transaction_fee: float
+    installments: int
+    card: SalesOrderCard
+    notes: str
+    has_cancelable_status: bool
+    id: int
+
+
+class SalesOrderIntegration(BaseModel):
+    alternate_id: str
+    integration_id: int
+    app: int
+
+
+class SalesOrderShipmentProduct(BaseModel):
+    product: int
+    variation: int
+    quantity: int
+
+
+class SalesOrderShipmentMethod(BaseModel):
+    tracking_number: str
+    tracking_url: str
+    courier: str
+    mode: str
+    cost: float
+    type: str
+    eta: str
+    status: str
+
+
+class SalesOrderShipmentIntegration(BaseModel):
+    id: int
+    integration_id: str
+    app: int
+    status: str
+
+
+class SalesOrderShipment(BaseModel):
+    date: str
+    products: List[SalesOrderShipmentProduct]
+    method: SalesOrderShipmentMethod
+    integration: SalesOrderShipmentIntegration
+
+
+class SalesOrderResultItem(BaseModel):
+    codes: List[str]
+    contact_id: int
+    currency: str
+    date: str
+    delivery_method: str
+    delivery_status: str
+    id: str
+    integration_ids: List[str]
+    integrations: List[SalesOrderIntegration]
+    invoice_integration_app: int
+    invoice_integration_id: str
+    lines: List[SalesOrderLine]
+    payments: List[SalesOrderPayment]
+    payment_status: str
+    payment_term: str
+    product_names: List[str]
+    reserving_product_ids: str
+    sales_channel: int
+    shipments: List[SalesOrderShipment]
+    tracking_number: str
+    skus: List[str]
+    status: str
+    tags: List[str]
+    warehouse: str
+    company_id: int
+    shipping_cost: float
+    contact_phone: str
+    brands: List[str]
+    courier: str
+    order_id: int
+    updated_at: str
+    invoice_integration_created_at: str
+    invoice_integration_document_url: str
+    has_document_url: bool
+    integration_alternate_ids: str
+    cart_id: str
+    amount: float
+    has_any_shipments: bool
+
+
+class SearchSalesOrderResponse(BaseModel):
+    count: int
+    results: List[SalesOrderResultItem]
+
+
+class SearchSalesOrderParams(BaseModel):
+    top: Optional[int]
+    skip: Optional[int]
+    filter: Optional[str] = Field(default=None, alias="$filter")
+    class Config:
+        validate_by_name = True
+
+class SearchSalesOrder:
+    endpoint: str = "search/salesorders"
+
+
+    @classmethod
+    def search_saleorder(cls, config: ConfigProducteca, params: SearchSalesOrderParams):
+        headers = config.headers
+        url = config.get_endpoint(cls.endpoint)
+        new_url = f"{url}?$filter={params.filter}&top={params.top}&skip={params.skip}"
+        response = requests.get(
+            new_url,
+            headers=headers,
+        )
+        return response.json(), response.status_code
+
+

producteca/shipments/__init__.py

@@ -0,0 +1 @@
+from . import shipment

producteca/shipments/shipment.py

@@ -0,0 +1,47 @@
+from typing import List, Optional
+from pydantic import BaseModel
+import requests
+from ..config.config import ConfigProducteca
+
+
+class ShipmentProduct(BaseModel):
+    product: int
+    variation: Optional[int] = None
+    quantity: int
+
+
+class ShipmentMethod(BaseModel):
+    trackingNumber: Optional[str] = None
+    trackingUrl: Optional[str] = None
+    courier: Optional[str] = None
+    mode: Optional[str] = None
+    cost: Optional[float] = None
+    type: Optional[str] = None
+    eta: Optional[int] = None
+    status: Optional[str] = None
+
+
+class ShipmentIntegration(BaseModel):
+    id: Optional[int] = None
+    integrationId: Optional[str] = None
+    app: Optional[int] = None
+    status: str
+
+
+class Shipment(BaseModel):
+    date: Optional[str] = None
+    products: Optional[List[ShipmentProduct]] = None
+    method: Optional[ShipmentMethod] = None
+    integration: Optional[ShipmentIntegration] = None
+
+    @classmethod
+    def create(cls, config: ConfigProducteca, sale_order_id: int, payload: "Shipment") -> "Shipment":
+        url = config.get_endpoint(f"salesorders/{sale_order_id}/shipments")
+        res = requests.post(url, data=payload.model_dump_json(exclude_none=True), headers=config.headers)
+        return res.status_code, res.json()
+
+    @classmethod
+    def update(cls, config: ConfigProducteca, sale_order_id: int, shipment_id: str, payload: "Shipment") -> "Shipment":
+        url = config.get_endpoint(f"salesorders/{sale_order_id}/shipments/{shipment_id}")
+        res = requests.put(url, data=payload.model_dump_json(exclude_none=True), headers=config.headers)
+        return res.status_code, res.json()

producteca/shipments/test_shipment.py

@@ -0,0 +1,55 @@
+import unittest
+from unittest.mock import patch, MagicMock
+from .shipment import Shipment, ShipmentProduct, ShipmentMethod, ShipmentIntegration, ConfigProducteca
+
+class TestShipment(unittest.TestCase):
+
+    @patch('requests.post')
+    def test_create_shipment(self, mock_post):
+        # Arrange
+        config = ConfigProducteca()
+        sale_order_id = 123
+        products = [ShipmentProduct(product=1, variation=2, quantity=3)]
+        method = ShipmentMethod(trackingNumber="TN123", trackingUrl="http://track.url", courier="DHL", mode="air", cost=10.5, type="express", eta=5, status="shipped")
+        integration = ShipmentIntegration(id=1, integrationId="int123", app=10, status="active")
+        payload = Shipment(date="2023-01-01", products=products, method=method, integration=integration)
+
+        mock_response = MagicMock()
+        mock_response.status_code = 201
+        mock_response.json.return_value = {'success': True}
+        mock_post.return_value = mock_response
+
+        # Act
+        status_code, response_json = Shipment.create(config, sale_order_id, payload)
+
+        # Assert
+        self.assertEqual(status_code, 201)
+        self.assertEqual(response_json, {'success': True})
+        mock_post.assert_called_once()
+
+    @patch('requests.put')
+    def test_update_shipment(self, mock_put):
+        # Arrange
+        config = ConfigProducteca()
+        sale_order_id = 123
+        shipment_id = 'abc'
+        products = [ShipmentProduct(product=4, quantity=7)]
+        method = ShipmentMethod(courier="FedEx", cost=15.0)
+        integration = ShipmentIntegration(status="pending")
+        payload = Shipment(date="2023-02-02", products=products, method=method, integration=integration)
+
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {'updated': True}
+        mock_put.return_value = mock_response
+
+        # Act
+        status_code, response_json = Shipment.update(config, sale_order_id, shipment_id, payload)
+
+        # Assert
+        self.assertEqual(status_code, 200)
+        self.assertEqual(response_json, {'updated': True})
+        mock_put.assert_called_once()
+
+if __name__ == '__main__':
+    unittest.main()

producteca-1.0.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.3
+Name: producteca
+Version: 1.0.0
+Summary: 
+Author: Chroma Agency, Matias Rivera
+Author-email: mrivera@chroma.agency
+Requires-Python: >=3.13,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: coverage (>=7.6.3,<8.0.0)
+Requires-Dist: pydantic (>=2.11.7,<3.0.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Description-Content-Type: text/markdown
+
+# Very small module to connect with producteca

producteca-1.0.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+producteca/__init__.py,sha256=pX_QNJAeP-LJaRdArww3O8MiOp2yTAX1OCjzvzAjU3E,118
+producteca/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/abstract/abstract_dataclass.py,sha256=Q9BaVb34_2MBLWaOOeGuzd1diOePHxxFWBEr8Jw8t40,617
+producteca/config/__init__.py,sha256=ZELnRKNOj0erqtCLRtZURqUhttVbFfqUrHrgg6M5p-M,36
+producteca/config/config.py,sha256=uTRaHLI9L7P_LPuFmuYgV50Aedz9MfDbXOZVZPFkOuI,658
+producteca/payments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/payments/payments.py,sha256=bc9556954GRsvm4XAsTbbdP4-rS275MWGfhuF4MYVsY,1594
+producteca/products/__init__.py,sha256=kIkYF7_BcLUzkGvuRnUBPAELyG9QxUb5D6UiRg4XQCg,22
+producteca/products/products.py,sha256=IagCPEvQBUuUaw9yBQwBu7eJw3HtdAjxiWHEnpLDXwM,8046
+producteca/sales_orders/__init__.py,sha256=9NbTrJhvhtGYX2DFd7CCZvYVKXx6jJCV2L70XPma5_c,26
+producteca/sales_orders/sales_orders.py,sha256=1VzFSou2wOEmZ-uhehVcsj9Q4Gk5Iam4YEIu-l-xEgc,8792
+producteca/search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/search/search.py,sha256=4u_Y5h6ffxxD4_iaSVpKv6ZIOoxU_vZ2cuHvygclmRw,4137
+producteca/search/search_sale_orders.py,sha256=JXxohAhEokUQ_bxBIQesLO_FzpN35lKfpT3fB8-O_Fs,3724
+producteca/shipments/__init__.py,sha256=YZTSiaXNQHTtTrYjnl2bn_E6mcQyS76XVbB7fpCEC2Q,22
+producteca/shipments/shipment.py,sha256=IELAYWVNT862CBvDHOTotqLMXrm6sFECic2E7RTSI-A,1625
+producteca/shipments/test_shipment.py,sha256=QBi6Ee4UcLQgiVLPz3sfug5bZ5F655UTomde0xnDfKk,2215
+producteca-1.0.0.dist-info/METADATA,sha256=ISMhh36r2JSZEHDclGbdjrPeLDmFeHxc5mp6Vz5D83s,478
+producteca-1.0.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+producteca-1.0.0.dist-info/entry_points.txt,sha256=Fk7pn09epcdztiFc7kuYBBlB_e6R2C_c1hmPHsookHI,143
+producteca-1.0.0.dist-info/RECORD,,

producteca-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.1.3
+Root-Is-Purelib: true
+Tag: py3-none-any

producteca-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+generate_html_coverage=scripts:generate_html_coverage
+get_coverage=scripts:get_coverage
+main=logseek:main
+test=scripts:test
+