producteca 1.0.14__py3-none-any.whl → 2.0.57__py3-none-any.whl

{producteca-1.0.14.dist-info → producteca-2.0.57.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: producteca
-Version: 1.0.14
+Version: 2.0.57
 Summary: 
 Author: Chroma Agency, Matias Rivera
 Author-email: mrivera@chroma.agency
@@ -12,8 +12,9 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: coverage (>=7.2.0,<8.0.0)
-Requires-Dist: pydantic (>=2.10.0,<3.0.0)
+Requires-Dist: pydantic (>=2.7.4,<3.0.0)
 Requires-Dist: requests (>=2.32.4,<3.0.0)
+Requires-Dist: typing_extensions (>=4.10.0,<5.0.0)
 Description-Content-Type: text/markdown
 
 [![Maintainability](https://qlty.sh/badges/950972cf-31e6-47cb-ab37-0ad0565c3a59/maintainability.svg)](https://qlty.sh/gh/ChromaAgency/projects/producteca_python)
@@ -38,10 +39,40 @@ To use the Producteca client, first instantiate `ProductecaClient` with your cre
 from producteca.client import ProductecaClient
 
 client = ProductecaClient(token='your_token', api_key='your_api_key')
+
+# Usage examples for SalesOrderService
+sale_order_service = client.SalesOrder
+# Get from api
+sale_order = sale_order_service.get(123)
+# or construct from db
+sale_order = client.SalesOrder(...argswithid)
+labels = sale_order.get_shipping_labels()
+close_response = sale_order.close()
+cancel_response = sale_order.cancel()
+synchronized_order = sale_order.synchronize()
+invoice_response = sale_order.invoice_integration(sale_order)
+search_results = sale_order_service.search(params)
+payment = sale_order.add_payment(payment_payload)
+updated_payment = sale_order.update_payment(payment_id, payment_payload)
+shipment = sale_order.add_shipment(shipment_payload)
+updated_shipment = sale_order.update_shipment(shipment_id, shipment_payload)
+
+# Usage examples for ProductService
+product_service = client.Products
+# Get from api
+product = product_service.get(456)
+bundle = product_service.get_bundle(456)
+ml_integration = product_service.get_ml_integration(456)
+search_results = product_service.search(search_params)
+# Or construct from db
+product = client.Products(...args)
+created_product = product.create()
+updated_product = product.update()
 ```
 
 then with the client you should use every other module, like SalesOrder, Products, Payments, Shipments and Search
 
+
 ## Contributing
 
 We welcome contributions to improve this project! Here's how you can help:

producteca-2.0.57.dist-info/RECORD

@@ -0,0 +1,33 @@
+producteca/__init__.py,sha256=ML-Y_hCd8HOgNOVGiqGpbLqWAtvPXqQQaBQmj-A5Lvc,52
+producteca/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/abstract/abstract_dataclass.py,sha256=Axsf4ewa7Qua5aosvEXksR-fXoGF01_EUlOl1oKdkIk,597
+producteca/client.py,sha256=4T4vLh_Zz56mG2S0P9Il1NEJ4Rj0g2mgXYA7KJjY72U,789
+producteca/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/config/config.py,sha256=uTRaHLI9L7P_LPuFmuYgV50Aedz9MfDbXOZVZPFkOuI,658
+producteca/payments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/payments/payments.py,sha256=zhbv6zWb1i04wGdqiyQJ8Dqp435xNHEOsjnps-pAT58,893
+producteca/payments/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/payments/tests/test_payments.py,sha256=wutk5zK2xRChTvKyTmi54Y_92PzNtUKZF6xWF298sFY,3032
+producteca/products/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/products/products.py,sha256=G5ApUxeipHKRCQZnGdCYLxNE-m--6dOsYiQB_sMI_Dw,13835
+producteca/products/search_products.py,sha256=wPrnChvzPKzVermtKbi-V7wBmILJhJToyoNtpOOeXc4,6172
+producteca/products/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/products/tests/test_products.py,sha256=JMsWq9DDJZn8If1dz42WSJ93-akOm7flFQPm6WYeJus,5377
+producteca/products/tests/test_search_products.py,sha256=ISkDClYaYnwo23a7_O4OlgPfc4dAZCMinLAi07yecEI,4941
+producteca/sales_orders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/sales_orders/sales_orders.py,sha256=js7OoCcSn6P-eHa9IwJDym7kYa5EUteTwI8563VVxEo,18027
+producteca/sales_orders/search_sale_orders.py,sha256=rvbPqVqYjRpM45QXUZp_6uCk1j7CRyfN5hKsinvj6Kc,5179
+producteca/sales_orders/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/sales_orders/tests/search.json,sha256=v6LkTvQyeBdqxRc3iWwXH5Ugs7EYJAEOiuPuuj_rHYk,3508
+producteca/sales_orders/tests/test_sales_orders.py,sha256=hPtUqp4GUpp9iBr3AMGsS7nxHQ5JHJy-DLuTxf9Eufs,4245
+producteca/sales_orders/tests/test_search_so.py,sha256=xXl1Lg_7nZioLqgWXl5vb4kH2JAdGZLX_VGWtH9iAHM,1637
+producteca/shipments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/shipments/shipment.py,sha256=YokJRBX1ZbUtZVc4AOAB188rbHFO0_MH5hFv5U9Qpjw,844
+producteca/shipments/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+producteca/shipments/tests/test_shipment.py,sha256=0edX3WM-t4nbp53r_Lvhtk_Suc2QCnIUQ27I90qSUfE,2512
+producteca/utils.py,sha256=krCUtr5cwu1787v24wSagSltPjY1ERe3E1whhT-SZKU,1961
+producteca-2.0.57.dist-info/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
+producteca-2.0.57.dist-info/METADATA,sha256=hfixRYOulnUNZD58c7LEytb-rke71V8z1bSoQP6m5hQ,3809
+producteca-2.0.57.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+producteca-2.0.57.dist-info/entry_points.txt,sha256=BFSDFLbB70p8YVZPiU7HDJdj2VyyLdMVa4ekLQAUAVc,125
+producteca-2.0.57.dist-info/RECORD,,

producteca/search/search.py

@@ -1,149 +0,0 @@
-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.model_dump(by_alias=True, exclude_none=True))
-        return SearchProductResponse(**response.json())

producteca/search/search_sale_orders.py

@@ -1,170 +0,0 @@
-from typing import List, Optional
-from pydantic import BaseModel, Field
-import requests
-from producteca.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-1.0.14.dist-info/RECORD

@@ -1,31 +0,0 @@
-producteca/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/abstract/abstract_dataclass.py,sha256=Q9BaVb34_2MBLWaOOeGuzd1diOePHxxFWBEr8Jw8t40,617
-producteca/client.py,sha256=oeNeLAlhjXC82oTLRN6HmWilmZqrqrs_Bwr3-u17EuI,1260
-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/payments/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/payments/tests/test_payments.py,sha256=5xUQlBT_E7arJLJAHncJz3Rme2b_JEoJ5_DzsExW4SI,2343
-producteca/products/__init__.py,sha256=kIkYF7_BcLUzkGvuRnUBPAELyG9QxUb5D6UiRg4XQCg,22
-producteca/products/products.py,sha256=IagCPEvQBUuUaw9yBQwBu7eJw3HtdAjxiWHEnpLDXwM,8046
-producteca/products/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/products/tests/test_products.py,sha256=AN2khGNtS7meUe4EAdgKvGadwvg9GYhP7vfI9fC1PBc,3392
-producteca/sales_orders/__init__.py,sha256=9NbTrJhvhtGYX2DFd7CCZvYVKXx6jJCV2L70XPma5_c,26
-producteca/sales_orders/sales_orders.py,sha256=1VzFSou2wOEmZ-uhehVcsj9Q4Gk5Iam4YEIu-l-xEgc,8792
-producteca/sales_orders/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/sales_orders/tests/test_sales_orders.py,sha256=TngA2sOuFDobqe_rWPyho8WutnzZkAKn_eYsNqh3k_A,3372
-producteca/search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/search/search.py,sha256=6Xmxgs0cTK81uDTQAqAeFoWGu5pRZX-lS15tEBkRKrc,4143
-producteca/search/search_sale_orders.py,sha256=cTLI47HyDfPalKT-ApizK6GrVcqfMJVnyLqpJcNjm1c,3733
-producteca/search/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/search/tests/test_search.py,sha256=rD9hNyKscIrZHVR2rvpVGeNXX89sj2IgoH2lwYIHW2U,7454
-producteca/shipments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/shipments/shipment.py,sha256=IELAYWVNT862CBvDHOTotqLMXrm6sFECic2E7RTSI-A,1625
-producteca/shipments/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-producteca/shipments/tests/test_shipment.py,sha256=D42IM5OQOXy9Af9_p8-k_mSFnfX5fUeEWQBPEispOXw,2301
-producteca-1.0.14.dist-info/METADATA,sha256=m3z5ZNc0rKCGeWaC0dSi7wQ192wWSpEONKGsoLXP3yI,2624
-producteca-1.0.14.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-producteca-1.0.14.dist-info/entry_points.txt,sha256=BFSDFLbB70p8YVZPiU7HDJdj2VyyLdMVa4ekLQAUAVc,125
-producteca-1.0.14.dist-info/RECORD,,