Integración Shopify → SAP Business One (snobbycl y on-chile)

Pipeline de integración de órdenes de Shopify a SAP Service Layer:
Invoice de reserva, pago con tarjeta o transferencia por transacción,
solicitud de traslado, traslado de stock y entrega.

- Invoice igual a lo cobrado; fulfillments limitados a lo facturado
- Estados terminales integrated, timeout, ignored y cancelled
- Idempotencia contra SAP: adopta documentos existentes en vez de duplicar
- Reintentos de red en el cliente de Shopify
- Secretos fuera de los JSON de tienda (${VARIABLE} resuelta desde .env)
- Herramientas de consulta, integración puntual y carga de pruebas
- Documentación en docs/ (flujo, casos especiales, mapeo, configuración)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

domain/items.py

@@ -0,0 +1,29 @@
+from typing import List
+from urllib.parse import quote
+
+from core.errors import SAPServiceLayerError
+from core.sap import SAPServiceLayerClient
+
+
+def _item_key(sku: str) -> str:
+    escaped = quote(sku.replace("'", "''"), safe="")
+    return f"Items('{escaped}')"
+
+
+def item_existe(sap: SAPServiceLayerClient, sku: str) -> bool:
+    try:
+        sap.forward("GET", _item_key(sku))
+        return True
+    except SAPServiceLayerError as exc:
+        if exc.status_code == 404:
+            return False
+        raise
+
+
+def identificar_skus_faltantes(sap: SAPServiceLayerClient, skus: List[str]) -> List[str]:
+    """
+    Revisa cada SKU contra SAP (GET Items) y devuelve los que no existen.
+    Se usa cuando un POST de Invoice falla con el código -5009
+    ("Item number is missing"), que no indica cuál ItemCode es el problema.
+    """
+    return [sku for sku in skus if not item_existe(sap, sku)]