Tienda Crema

Arquitectura general

flowchart LR
  subgraph ERP["SAP BUSINESS ONE — MAESTRO"]
    SAP["Catálogo · Precios · Stock
Pedidos · Facturación"]
  end
  subgraph MID["MIDDLEWARE EQAPLA"]
    MW["Orquestador
sesión · colas · reintentos · logs"]
  end
  subgraph STORE["SHOPIFY — TIENDA CREMA"]
    SH["Contenido · Carrito
Checkout · Pagos"]
  end
  SAP -->|"Service Layer · REST/OData"| MW
  MW -->|"Admin API"| SH
  SH -->|"Webhooks orders/paid"| MW
  MW -->|"Pedido de venta"| SAP

1. Catálogo · SAP → Shopify

sequenceDiagram
  participant SAP as SAP B1
  participant MW as Middleware
  participant SH as Shopify
  MW->>SAP: GET Items modificados (UpdateDate)
  SAP-->>MW: Artículos + variantes
  alt No existe en Shopify
    MW->>SH: Crea producto / variante
  else Ya existe
    MW->>SH: Actualiza campos maestros (no pisa fotos)
  end
  MW->>MW: Registra mapeo ItemCode ↔ variantId

2. Precios · SAP → Shopify

sequenceDiagram
  participant SAP as SAP B1
  participant MW as Middleware
  participant SH as Shopify
  MW->>SAP: Lee lista de precios de la tienda
  SAP-->>MW: Precio por artículo
  MW->>MW: Ajusta IGV si aplica
  MW->>SH: Actualiza variant.price

3. Stock (crítico) · bidireccional

Disponible = InStock (SAP) − Reservado − Buffer

sequenceDiagram
  participant SAP as SAP B1
  participant MW as Middleware
  participant SH as Shopify
  Note over SAP,SH: 3a · Refresco de disponibilidad (cada N min)
  MW->>SAP: GET Items con cambio de stock
  SAP-->>MW: InStock por almacén
  MW->>MW: Disponible = InStock − Reservado − Buffer
  MW->>SH: Actualiza inventory_level
  Note over SAP,SH: 3b · Venta en tiempo real
  SH->>MW: webhook orders/paid
  MW->>SAP: Crea pedido de venta (descuenta stock)
  MW->>SH: Actualiza disponible (anti-oversell)
  Note over SAP,SH: 3d · Reconciliación nocturna
  MW->>SAP: Lee stock total
  MW->>SH: Compara y ALERTA diferencias

4. Pedido → despacho → comprobante (boleta/factura)

sequenceDiagram
  participant C as Cliente
  participant SH as Shopify
  participant MW as Middleware
  participant SAP as SAP B1
  C->>SH: Paga (elige boleta o factura: DNI/RUC)
  SH->>MW: webhook orders/paid
  MW->>MW: ¿order.id ya procesado? (idempotencia)
  MW->>SAP: Resuelve / crea BusinessPartner (DNI/RUC)
  MW->>SAP: Crea Orden de venta (+ servicios EST- / PARCHE-)
  SAP-->>MW: DocEntry
  Note over SAP: Genera Orden de despacho (entrega)
  SAP->>SAP: Pedido entregado
  SAP->>SAP: Emite Boleta o Factura (según lo pedido)
  SAP-->>MW: Comprobante CPE emitido
  MW->>SH: Actualiza estado + adjunta comprobante