Falabella Sync — Stock WooCommerce ↔ Falabella (CVMI)
- Registrado: 2026-10-08
- Solicitante: Daniel
- Objetivo: alinear el stock de WooCommerce (Zephyra + Cyclofun) con el stock del Seller Center de Falabella de CV Multi Inversiones.
- Vía decidida: Seller API (JSON). Se descartó webhook (para stock no hace falta; y los webhooks de Falabella son de producto/feed, no de ventas).
- Credenciales:
credentials/falabella-cvmi.json(chmod 600) - UserID:
soporte@cvminversiones.pe - ApiKey: guardada en el JSON
- Base:
https://sellercenter-api.falabella.com - Auth: HMAC-SHA256 sobre parámetros ordenados + URL-encoded (validado contra la URL de ejemplo de Daniel ✅)
Tooling (Omni)
scripts/falabella/fb_client.py— cliente (firma + call). ⚠️ Cloudflare (error 1010) bloquea el UA de urllib → se usaUser-Agent: curl/8.5.0.scripts/falabella/fetch_products.py— GetProducts →data/falabella_products.json+data/falabella_stock.csvscripts/falabella/compare.py— cruza Falabella vs Woo (TSV de las BD en Zeta)- Datos Woo:
data/woo_zephyra.tsv,data/woo_cyclofun.tsv(dewp_wc_product_meta_lookup)
Acceso a WooCommerce (Zeta, SSH ~/.ssh/zeta_nexus → opsmgr@100.83.7.25)
- Contenedores:
zephyra_wp+zephyra_db(DBzephyra_wordpress, userzephyra) ·cyclofun_wp+cyclofun_db(DBcyclofun_wordpress, usercyclofun) - Stock en
wp_wc_product_meta_lookup(sku, stock_quantity, stock_status). Escribir → tambiénwp_postmeta(_stock,_stock_status).
Estado 2026-10-08 (primer cruce)
- Falabella: 140 SKUs (138 activos, 114 con stock>0). 119 Zephyra + 6 Cyclofun + 15 sin "ZEPHYRA" en el nombre (pero son Zephyra: mocasines/carteras/bandoleras).
- Cruzan con Woo: 133 / 140.
- Diferencias de stock: solo 4 (1–2 unidades):
240501010101020105Bici Jungle — FB 2 / Woo 3240501010101020104Bici Jungle — FB 1 / Woo 2250402590626060741Cartera Squarely Honey Glaze — FB 0 / Woo 1250402600626060744Bandolera Rhapsody Charcoal — FB 0 / Woo 1- 7 SKUs en Falabella sin equivalente en Woo: 3 bicis Cyclofun "PLEGABLE" (
240501050101041127/119/121, stock 44/44/50) + 4 accesorios Zephyra (aretes/argollas). - Woo: Zephyra 336 fichas (174 con stock) + Cyclofun 69 (44 con stock).
✅ Implementado 2026-10-08 — motor bidireccional en producción
Decisión de Daniel: los 3 sistemas sincronizados (Falabella + Woo Zephyra + Woo Cyclofun + CVMI Ventas). Cualquier venta en cualquier canal actualiza los demás.
Arquitectura: hub + eventos. crm_cvmi.products.stock (CVMI Ventas) = maestro; Woo (x2) y Falabella = canales. El motor compara con un snapshot (data/state.json) para detectar movimientos externos (ventas/ajustes) en cualquier canal y propagarlos. El snapshot se guarda DESPUÉS de escribir → sus propios cambios no se confunden con movimientos externos.
- Dónde corre: Zeta,
/home/opsmgr/proyectos/falabella-sync/(imagen Dockerfalabella-sync, python:3.12-slim + pymysql + requests). Sin bind mount. sync.py(motor) ·.env(creds, chmod 600) ·data/state.json·sync.log- Wrapper:
/home/opsmgr/scripts/falabella_sync.sh(conflock) - Cron:
*/10 * * * *(cada 10 min) — instalado en crontab deopsmgr. - Comando manual:
docker run --rm --network caddy_net --env-file .env -v .../data:/data falabella-sync [--dry-run|--reset] - Falabella API: GET
GetProducts(leer) + POSTUpdateStock(escribir, body XML<Request><Warehouse><Stock><SellerSku><Quantity>…, lote ≤500). ⚠️ UA debe sercurl/8.5.0(Cloudflare 1010).
Lógica bidireccional: si el CRM cambia en el intervalo → manda el CRM (venta directa). Si el CRM no cambió pero Woo y/o Falabella sí → se interpreta como venta/movimiento externo y se aplica la suma de deltas al CRM → se empuja a los 3.
Verificado (test real 2026-10-08 ~22:44 UTC)
- Estado inicial: CRM 320 SKUs = Woo exactamente. Falabella 140; 4 diferencias → alineadas al baseline (min) y resueltas.
- Test de venta Falabella: bajé
240602450423061402(Mocasines Silver Chain) de 3→2 en Falabella → sync → CRM y Woo bajaron a 2 automáticamente ✅. Restaurado a 3 → sync → todo volvió a 3 ✅. - Dry-run posterior: 0 cambios (convergencia estable).
✅ Captura de órdenes de Falabella → CRM (2026-10-08, misma tarde)
El motor ya no solo detecta el descuento de stock: trae la venta completa y la registra en CVMI Ventas.
- API:
GetOrders(lista con filtroCreatedAfter/CreatedBefore/Limit=100) +GetOrderItems(detalle por línea). - Qué se trae: Nº de pedido, ID interno, cliente, dirección, SKU, variante (color/talla), precio, estado, fecha, forma de pago, código de seguimiento + courier, tipo de envío (Dropshipping/Collect), y boleta o factura (
InvoiceRequired). - Registro: se crea la venta vía
POST /api/service/salesdel CRM (canal Falabella, comisión 15%), conapply_stock:true→ descuenta Woo + CRM. Luego se seteasales.order_ref = <OrderId>(columna ya existente) para idempotencia y trazabilidad. - Boleta (decisión Nexus, 2026-10-08): como Falabella no devuelve Nº de boleta y el CRM la exige, se usa
FAL-<Nº de pedido>como referencia (NO es un número fiscal). El pedido crudo se guarda endata/orders/<OrderId>.json. Pendiente: al conectar el facturador, reemplazar por el número fiscal real del comprobante. - Solo se capturan órdenes NUEVAS (baseline
orders_since, creado al desplegar). El pedido histórico5004838608(23/08) NO se reprocesó porque ya estaba registrado a mano (boleta EB01-86) → evita duplicado. - Reglas: se omiten líneas con estado cancelado/devuelto y las de
ShippingType = Own Warehouse(FBF: no consume stock). - Plumbing verificado:
register_sale+order_ref+sale_existsOK; venta de prueba eliminada.
⚠️ Lección infra: el User-Agent y el %-encoding exacto importan. requests re-normaliza el query (%3A→:, %2B→+) y rompe la firma HMAC → se usa urllib. Y el ApiKey debe ir completo (40 hex); un valor truncado da 401.
🔔 Aviso de pedidos Falabella por WhatsApp (2026-10-13)
Ciclo de una orden (API Falabella): llega en estado pending → cuando el vendedor la acepta pasa a ready_to_ship (acción SetStatusToReadyToShip) → shipped → delivered. ⚠️ El stock de Falabella baja al ACEPTAR (no al llegar): por eso el sync reconcilió 240501010101020105 2→1 recién a las 16:10 UTC (Daniel aceptó 11:05 Lima).
- Script (Omni):
scripts/falabella/notify_new_orders.py - Trae órdenes de los últimos 7 días (
GetOrders, sin filtro + refuerzoStatus=pending) +GetOrderItems. El filtroStatus=<estado>deGetOrdersSÍ funciona (probado);Statuses=se ignora. - Estado por
OrderIdenscripts/falabella/data/notify_orders.json({orders:{id:{status,arrival_notified}}}). 1ª corrida = baseline (no avisa históricos). - Detecta DOS eventos:
new_orders(primera vez que aparece el id) ystatus_changes(cambios de estado). - Para órdenes nuevas consulta el stock actual en CVMI Ventas (
POST /api/loginconcredentials/cvmi-ventas.json→GET /api/products?q=<sku>), con login perezoso (solo si hay órdenes nuevas). - Salida:
{first_run, checked, new_orders[], status_changes[], mensaje}—mensaje= texto listo para WhatsApp (vacío = nada que avisar). - Cron (Omni): job
falabella-nuevas-ordenes(id088eb7bc-c8dc-4ab8-9629-292e1489cc9a), cada 10 min, sesión aislada (lightContext; toolsexec+sessions_send). - ⚠️ delivery =
none(NOannounce): el agente solo envía el aviso porsessions_sendaagent:main:whatsapp:direct:+51999923033cuandomensajeno está vacío; si está vacío respondeNO_REPLY. Motivo: conannounce, el cron reenviaba una frase de relleno del modelo ("I'll run the script…") aunque no hubiera novedades → spam cada 10 min (2026-10-13). Connone, aunque el modelo narre, nada se postea a WhatsApp. - Aviso de LLEGADA (para que Daniel revise stock antes de aceptar): nº, cliente, producto(s) (nombre+SKU+cantidad), total y stock actual con semáforo (⚠️ SIN STOCK / ⚠️ stock bajo / ✅ stock).
- Aviso de ACEPTADA (
status_changesconaccepted=true): confirma que ya se descontó stock. - Es independiente del motor de stock de Zeta (avisa aunque el motor falle).
Pendiente
- [ ] Motor Zeta — bug de captura de órdenes:
capture_ordersusa una ventana que se reinicia anowen cada corrida (≤10 min) → si la API tarda en indexar, la orden se pierde (caso real: 5006495148, 12/10, NO capturada). Fix: ventana móvil larga (p. ej. 48 h) + dedupe pororder_ref. Mientras: las ventas se registran a mano (EB01-xx). - [ ] En
GetOrderItemsel campoQuantityno viene (Falabella) → el motor asume 1. Revisar multiplicadores si hay pedidos multi-unidad. - [ ] Facturador: enlazar la venta de Falabella con el comprobante electrónico real (hoy
boleta = FAL-<pedido>). - [ ] 9 SKUs huérfanos (en Falabella, sin equivalente en CRM/Woo): 3 bicis Cyclofun "PLEGABLE" (
240501050101041127/119/121) + 4 accesorios Zephyra (aretes/argollas) +250402590626060742+250402620626060746. → ¿publicar en Woo o marcar solo-Falabella? - [ ] ⚠️ Si en un mismo intervalo entra venta + reposición (neto 0) se pierde el evento.
- [ ] ⚠️ En Woo, el stock baja solo si la orden llega a procesando/completado; pendientes no descuentan.
- [ ] Manejo de cancelaciones de órdenes Falabella ya capturadas (hoy no se revierte stock).
- [ ] Falabella usa modelos logísticos (Dropshipping/Drop Off) — el "stock" del Seller Center ≠ inventario físico necesariamente.