clientGBP 2.2.2__tar.gz → 2.2.3__tar.gz

clientgbp-2.2.3/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: clientGBP
+Version: 2.2.3
+Summary: Libreria para el uso de GBP mediante HTTP. Sin utilizar interfaz gráfica (Scraping).Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
+License-Expression: MIT
+License-File: LICENSE
+Author: Leandro Franco
+Author-email: leandro00fr@gmail.com
+Requires-Python: >=3.12
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: beautifulsoup4 (==4.13.5)
+Requires-Dist: email-validator (==2.3.0)
+Requires-Dist: pydantic-settings (==2.10.1)
+Requires-Dist: pydantic[email] (==2.11.9)
+Requires-Dist: requests (==2.32.3)
+Requires-Dist: requests-toolbelt (==1.0.0)
+Project-URL: Homepage, https://github.com/Netpoint-ARG/gbp
+Project-URL: Issues, https://github.com/Netpoint-ARG/gbp/issues
+Project-URL: Repository, https://github.com/Netpoint-ARG/gbp
+Description-Content-Type: text/markdown
+
+# GBP
+
+La libreria permite realizar operaciones en Global Blue Point (GBP) mediante HTTP. Sin utilizar interfaz gráfica (Scraping). Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
+
+## Instalación
+
+Requiere Python 3.12 o superior. El paquete se publica en PyPI como `clientGBP`:
+
+```bash
+pip install clientGBP
+```
+
+## Uso
+
+```python
+from gbp import ClientGBP, Client, Contact, ClientType
+from gbp.domain.models import OrderProduct
+
+client = ClientGBP(username="user", password="pass")
+client.login()
+```
+
+Operaciones disponibles en `ClientGBP` (todas salvo `login` requieren sesión; sin sesión devuelven `None`):
+
+- **Clientes**: `exists_client_cuit`, `exists_client_email`, `get_client_by_dni`, `get_client_by_email`, `create_client`, `update_client`, `clean_client`. Si un CUIT tiene una ficha en dólares y una copia en pesos de Mercado Libre, se usa la de dólares.
+- **Contactos**: `exists_contact`, `get_contact_by_email`, `get_contact_edit_url_by_email`, `search_contact_with_email_cuit`, `exists_contact_with_email_cuit`, `create_contact`, `update_contact`.
+- **Órdenes de venta**: `create_order(client, products)`.
+- **Reportes Excel**: `download_valorized_stock`, `download_potential_stock`, `download_price_list`, `download_customers`, `download_report`.
+
+## Desarrollo
+
+```bash
+poetry install
+poetry run ruff check gbp tests
+poetry run pytest
+```
+

clientgbp-2.2.3/README.md

@@ -0,0 +1,36 @@
+# GBP
+
+La libreria permite realizar operaciones en Global Blue Point (GBP) mediante HTTP. Sin utilizar interfaz gráfica (Scraping). Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
+
+## Instalación
+
+Requiere Python 3.12 o superior. El paquete se publica en PyPI como `clientGBP`:
+
+```bash
+pip install clientGBP
+```
+
+## Uso
+
+```python
+from gbp import ClientGBP, Client, Contact, ClientType
+from gbp.domain.models import OrderProduct
+
+client = ClientGBP(username="user", password="pass")
+client.login()
+```
+
+Operaciones disponibles en `ClientGBP` (todas salvo `login` requieren sesión; sin sesión devuelven `None`):
+
+- **Clientes**: `exists_client_cuit`, `exists_client_email`, `get_client_by_dni`, `get_client_by_email`, `create_client`, `update_client`, `clean_client`. Si un CUIT tiene una ficha en dólares y una copia en pesos de Mercado Libre, se usa la de dólares.
+- **Contactos**: `exists_contact`, `get_contact_by_email`, `get_contact_edit_url_by_email`, `search_contact_with_email_cuit`, `exists_contact_with_email_cuit`, `create_contact`, `update_contact`.
+- **Órdenes de venta**: `create_order(client, products)`.
+- **Reportes Excel**: `download_valorized_stock`, `download_potential_stock`, `download_price_list`, `download_customers`, `download_report`.
+
+## Desarrollo
+
+```bash
+poetry install
+poetry run ruff check gbp tests
+poetry run pytest
+```

{clientgbp-2.2.2 → clientgbp-2.2.3}/gbp/parsers/__init__.py

@@ -14,7 +14,6 @@ from gbp.parsers.forms import (
 from gbp.parsers.html import parse_html
 from gbp.parsers.items import (
     extract_item_code_from_row,
-    extract_sku_tail,
     match_item_to_requested_sku,
     normalize_sku_token,
 )
@@ -37,7 +36,6 @@ __all__ = [
     "extract_item_code_from_row",
     "extract_order_message",
     "extract_save_order_alert",
-    "extract_sku_tail",
     "extract_usd_client_ids",
     "get_input_value",
     "get_option_value_by_text",

clientgbp-2.2.3/gbp/parsers/items.py

@@ -0,0 +1,58 @@
+"""Parsers y normalizacion para items y SKUs."""
+
+import logging
+import re
+
+logger = logging.getLogger(__name__)
+logger.addHandler(logging.NullHandler())
+
+
+def normalize_sku_token(value: str) -> str:
+    """Normaliza un token de SKU para comparacion flexible.
+
+    Args:
+        value (str): Valor de entrada a normalizar o procesar.
+
+    Returns:
+        str: Texto resultante del procesamiento.
+    """
+    return re.sub(r"[^a-z0-9]", "", value.lower())
+
+
+def extract_item_code_from_row(raw_item: str) -> str:
+    """Extrae el codigo de articulo desde una fila devuelta por itemGetText.
+
+    Args:
+        raw_item (str): Fila cruda devuelta por itemGetText.
+
+    Returns:
+        str: Texto resultante del procesamiento.
+    """
+    parts = [part.strip() for part in raw_item.split("|")]
+    return parts[-1] if parts else raw_item
+
+
+def match_item_to_requested_sku(items: list[str], requested_sku: str) -> str | None:
+    """Selecciona el item cuyo codigo es exactamente el SKU solicitado.
+
+    Sólo acepta el mismo codigo (sin distinguir mayusculas ni simbolos): un articulo parecido
+    es otro producto (`3NS-POS-SC415` no es `3NS-POS-SC415BT`, `PC084WV-8-240` no es `PC082WV-8-240`).
+
+    Args:
+        items (list[str]): Items devueltos por el servicio de catalogo.
+        requested_sku (str): SKU solicitado originalmente por el usuario.
+
+    Returns:
+        str | None: Fila del item elegido o `None` cuando el codigo no esta en los resultados.
+    """
+    requested_norm = normalize_sku_token(requested_sku.strip().lstrip("*"))
+    if not requested_norm:
+        return None
+
+    rows = [raw_item for raw_item in items if isinstance(raw_item, str)]
+    for row in rows:
+        if normalize_sku_token(extract_item_code_from_row(row)) == requested_norm:
+            return row
+
+    logger.error("SKU %s no esta en el catalogo de GBP. Resultados: %s", requested_sku, [extract_item_code_from_row(row) for row in rows])
+    return None

{clientgbp-2.2.2 → clientgbp-2.2.3}/gbp/payloads/ws.py

@@ -1,7 +1,5 @@
 """Builders de payload JSON para webservices de GBP."""
 
-import re
-
 from gbp.validators.identifiers import get_national_id
 
 def crm_payload(tax_number: str, prefix_text: str | None = None) -> dict[str, str | int]:
@@ -29,14 +27,13 @@ def item_search_payload(sku: str) -> dict[str, str | int]:
     Returns:
         dict[str, str | int]: Payload serializable para enviar al endpoint correspondiente.
     """
-    clean_sku = sku.strip().lstrip("*")
-    clean_sku = re.sub(r"[^A-Za-z0-9-]", "", clean_sku)
-    if "-" in clean_sku:
-        clean_sku = clean_sku.rsplit("-", 1)[-1]
-    clean_sku = clean_sku.upper()
+    # SKU completo y sin limpiar: buscar sólo el último segmento ("**240") traía otros artículos y el exacto
+    # quedaba afuera del límite. El webservice no encuentra nada si el texto tiene un ".", así que se corta
+    # en el primero (`SEG-FUE-125-2.1` -> `SEG-FUE-125-2`) y se piden 100 resultados para que entre el exacto.
+    search_term = sku.strip().lstrip("*").split(".")[0].strip()
 
     return {
-        "prefixText": f"**{clean_sku}",
-        "count": 20,
+        "prefixText": f"**{search_term}",
+        "count": 100,
         "contextKey": "10/1/1/50031/1/1/8/0",
     }

{clientgbp-2.2.2 → clientgbp-2.2.3}/gbp/services/base.py

@@ -13,7 +13,6 @@ from gbp.http.http import HttpClient
 from gbp.http.urls import BASE_URL, CUSTOMER_WS_URL, DEFAULT_TIMEOUT, ITEM_WS_URL, MAIN_URL, SEARCH_URL
 from gbp.parsers import (
     extract_client_edit_keys,
-    extract_sku_tail,
     extract_usd_client_ids,
     get_input_value,
     match_item_to_requested_sku,
@@ -345,8 +344,7 @@ class BaseGBPService:
             str | None: Cadena encontrada o `None` cuando el dato no esta disponible.
         """
         try:
-            search_term = extract_sku_tail(sku)
-            payload = item_search_payload(search_term)
+            payload = item_search_payload(sku)
             resp_item = self._send_post_json(ITEM_WS_URL, payload, HEADERS_JSON_CONTACT)
 
             if resp_item.status_code != 200:

{clientgbp-2.2.2 → clientgbp-2.2.3}/gbp/services/orders.py

@@ -13,6 +13,7 @@ from gbp.http.headers import HEADERS_RELOAD_ORDER, HEADERS_SALE_ORDER, get_heade
 from gbp.http.urls import BASE_URL, ORIGIN_URL, SALE_ORDER, UPDATE_IS_EDITING_URL
 from gbp.parsers import (
     extract_add_item_form_data,
+    extract_item_code_from_row,
     extract_all_form_fields,
     extract_order_detail_dialog_url,
     extract_order_message,
@@ -95,6 +96,7 @@ class OrderService(BaseGBPService):
                 if not item_data:
                     logger.error(f"No se encontró producto con SKU: {product.sku}")
                     return False
+                logger.info("Artículo de GBP para el SKU %s: %s", product.sku, extract_item_code_from_row(item_data))
 
                 resp_add_item_form = self._get_page_session_keys(add_item_url)
                 if not resp_add_item_form:

{clientgbp-2.2.2 → clientgbp-2.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "clientGBP"
-version = "2.2.2"
+version = "2.2.3"
 description = "Libreria para el uso de GBP mediante HTTP. Sin utilizar interfaz gráfica (Scraping).Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona."
 authors = [
     {name = "Leandro Franco",email = "leandro00fr@gmail.com"}

clientgbp-2.2.2/PKG-INFO

@@ -1,29 +0,0 @@
-Metadata-Version: 2.4
-Name: clientGBP
-Version: 2.2.2
-Summary: Libreria para el uso de GBP mediante HTTP. Sin utilizar interfaz gráfica (Scraping).Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
-License-Expression: MIT
-License-File: LICENSE
-Author: Leandro Franco
-Author-email: leandro00fr@gmail.com
-Requires-Python: >=3.12
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: beautifulsoup4 (==4.13.5)
-Requires-Dist: email-validator (==2.3.0)
-Requires-Dist: pydantic-settings (==2.10.1)
-Requires-Dist: pydantic[email] (==2.11.9)
-Requires-Dist: requests (==2.32.3)
-Requires-Dist: requests-toolbelt (==1.0.0)
-Project-URL: Homepage, https://github.com/Netpoint-ARG/gbp
-Project-URL: Issues, https://github.com/Netpoint-ARG/gbp/issues
-Project-URL: Repository, https://github.com/Netpoint-ARG/gbp
-Description-Content-Type: text/markdown
-
-# GBP
-
-La libreria permite realizar operaciones en Global Blue Point (GBP)mediante HTTP. Sin utilizar interfaz gráfica (Scraping). Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
-
-

clientgbp-2.2.2/README.md

@@ -1,4 +0,0 @@
-# GBP
-
-La libreria permite realizar operaciones en Global Blue Point (GBP)mediante HTTP. Sin utilizar interfaz gráfica (Scraping). Usando las credenciales de una cuenta, se obtiene las cookies de sesión y se pueden realizar operaciones. Se realiza todo de manera sincrona.
-

clientgbp-2.2.2/gbp/parsers/items.py

@@ -1,101 +0,0 @@
-"""Parsers y normalizacion para items y SKUs."""
-
-import logging
-import re
-
-logger = logging.getLogger(__name__)
-logger.addHandler(logging.NullHandler())
-
-
-def extract_sku_tail(value: str) -> str:
-    """Extrae el segmento final del SKU separado por '-'.
-
-    Args:
-        value (str): Valor de entrada a normalizar o procesar.
-
-    Returns:
-        str: Texto resultante del procesamiento.
-    """
-    source = value.strip()
-    if not source:
-        return ""
-
-    hashtag_match = re.search(r"#([A-Za-z0-9-]+)", source)
-    if hashtag_match:
-        source = hashtag_match.group(1)
-
-    source = source.split("|")[-1].strip()
-    source = re.sub(r"[^A-Za-z0-9-]", "", source)
-    if not source:
-        return ""
-
-    parts = [part for part in source.split("-") if part]
-    return parts[-1] if parts else source
-
-
-def normalize_sku_token(value: str) -> str:
-    """Normaliza un token de SKU para comparacion flexible.
-
-    Args:
-        value (str): Valor de entrada a normalizar o procesar.
-
-    Returns:
-        str: Texto resultante del procesamiento.
-    """
-    return re.sub(r"[^a-z0-9]", "", value.lower())
-
-
-def extract_item_code_from_row(raw_item: str) -> str:
-    """Extrae el codigo de articulo desde una fila devuelta por itemGetText.
-
-    Args:
-        raw_item (str): Fila cruda devuelta por itemGetText.
-
-    Returns:
-        str: Texto resultante del procesamiento.
-    """
-    parts = [part.strip() for part in raw_item.split("|")]
-    return parts[-1] if parts else raw_item
-
-
-def match_item_to_requested_sku(items: list[str], requested_sku: str) -> str | None:
-    """Selecciona el item cuyo codigo coincide con el SKU solicitado.
-
-    Prioriza la coincidencia exacta del codigo de articulo para no confundir SKUs
-    con prefijo comun (por ejemplo `3NS-POS-SC415` contra `3NS-POS-SC415BT`).
-
-    Args:
-        items (list[str]): Items devueltos por el servicio de catalogo.
-        requested_sku (str): SKU solicitado originalmente por el usuario.
-
-    Returns:
-        str | None: Fila del item elegido o `None` cuando no hay coincidencia confiable.
-    """
-    requested_code = re.sub(r"[^A-Za-z0-9-]", "", requested_sku.strip().lstrip("*"))
-    if not requested_code:
-        return None
-
-    rows = [raw_item for raw_item in items if isinstance(raw_item, str)]
-    requested_norm = normalize_sku_token(requested_code)
-
-    exact_matches = [row for row in rows if normalize_sku_token(extract_item_code_from_row(row)) == requested_norm]
-    if exact_matches:
-        return exact_matches[0]
-
-    requested_tail_norm = normalize_sku_token(extract_sku_tail(requested_code))
-    if requested_tail_norm:
-        tail_matches = [row for row in rows if normalize_sku_token(extract_sku_tail(extract_item_code_from_row(row))) == requested_tail_norm]
-        if tail_matches:
-            return tail_matches[0]
-
-    partial_matches = [row for row in rows if requested_norm in normalize_sku_token(row)]
-    if len(partial_matches) == 1:
-        return partial_matches[0]
-
-    if partial_matches:
-        codes = [extract_item_code_from_row(row) for row in partial_matches]
-        logger.error("SKU %s es ambiguo en el catalogo de GBP: %s", requested_sku, codes)
-        return None
-
-    logger.error("SKU %s no coincide con ningun item del catalogo de GBP", requested_sku)
-    return None