Falabella — aplicar un descuento con fechas por API
Creado: 2026-11-01 · Probado: descuento 15% a 138 productos activos (2–6 nov 2026)
Runbook para cargar una oferta con vigencia en el Seller Center CVMI sin entrar al portal.
Lo que hay que saber de entrada
- La acción es
ProductUpdate, noUpdatePrice.UpdatePriceyUpdateProductPricedevuelvenE008: Invalid Action. ProductUpdateexige el bloqueBusinessUnitsanidado. Sin él responde1000: BusinessUnits is missingy no toca nada.- Es asíncrono. Acepta la petición al instante (devuelve
RequestId) y el cambio se refleja ~90 segundos después. Si se relee antes, parece que no se aplicó → NO reenviar (duplica). - El descuento va en
SpecialPrice+SpecialFromDate+SpecialToDate; elPricebase no se toca. Al vencer la fecha, el precio vuelve solo: no hay que revertir a mano.
Ubicación
Host ......... Zeta (100.83.7.25)
Proyecto ..... /home/opsmgr/proyectos/falabella-sync/
Credenciales . .env (FB_USER_ID, FB_API_KEY, FB_BASE, FB_CHANNEL_ID) — 0600
Motor sync ... sync.py (cron */10) — solo mueve stock y pedidos, NO precios
El .env no se puede importar directo con import sync fuera del contenedor (requiere pymysql). Para operar contra la API sin Docker se usa un cliente propio con la stdlib, replicando _enc / _sign / _fb_call de sync.py (líneas 60-90).
Estructura de la oferta (lectura)
GetProducts devuelve, dentro de BusinessUnits.BusinessUnit:
{ "Price": "399.00", "SpecialPrice": "", "SpecialFromDate": "", "SpecialToDate": "",
"Stock": "46", "Status": "active", "OperatorCode": "fape" }
SpecialPricevacío = sin ofertaStatus=active/ inactivoOperatorCodehay que reenviarlo tal cual (fapepara Falabella PE)
Procedimiento
1. Diagnóstico previo (obligatorio)
Antes de aplicar, contar productos y verificar que ninguno tenga SpecialPrice cargado. Si hubiera una campaña vigente, aplicar otra encima duplica el descuento y se vende bajo costo.
r = fb_call("GetProducts", {"Filter": "all"})
prods = r["SuccessResponse"]["Body"]["Products"]["Product"]
# si es dict -> [dict]
activos = [p for p in prods if str(bu(p).get("Status")).lower() in ("active","activo")]
con_oferta = [p for p in prods if bu(p).get("SpecialPrice")]
Referencia medida: 140 productos, 138 activos, 0 con oferta.
2. Piloto con un SKU (obligatorio)
Enviar ProductUpdate a un solo SKU con su precio actual, sin oferta, y comparar el producto completo antes/después (nombre, marca, descripción, imágenes, estado). Sirve para confirmar que la estructura es correcta sin riesgo de daño masivo.
3. Aplicar la oferta a un SKU de prueba y esperar
<?xml version="1.0" encoding="UTF-8" ?>
<Request>
<Product>
<SellerSku>SKU</SellerSku>
<BusinessUnits>
<BusinessUnit>
<OperatorCode>fape</OperatorCode>
<Price>399.00</Price>
<SpecialPrice>339.15</SpecialPrice>
<SpecialFromDate>2026-11-02</SpecialFromDate>
<SpecialToDate>2026-11-06</SpecialToDate>
</BusinessUnit>
</BusinessUnits>
</Product>
</Request>
POST con Action=ProductUpdate. Esperar 90 s y releer. Confirmar que SpecialPrice, From y To volvieron con valores.
4. Carga masiva
- Mismo XML con varios
<Product>por request — lotes de 25 (138 SKUs = 6 requests, ~2 s) - Precio especial =
round(Price * (1 - descuento), 2) - Incluir siempre
<Price>con el valor actual: si se omite, el precio base puede quedar afectado - Saltar inactivos, precio 0 o no numérico
5. Verificación final
Tras 90 s, contar activos con SpecialPrice cargado. Esperado: activos == con oferta.
Referencia: 138 activos | 138 con oferta | 0 sin oferta.
Trampas conocidas
- Reenviar por impaciencia. El cambio tarda ~90 s; reenviar antes de tiempo duplica la petición sin efecto visible.
- Usar
UpdatePrice. No existe en esta API; el error esE008. - Omitir
BusinessUnits.1000: BusinessUnits is missing. - Omitir
<Price>. El feed puede interpretar 0 o dejar el precio indefinido. - Fechas en otro formato. El formato aceptado es
YYYY-MM-DD; la API lo devuelve comoYYYY-MM-DD 00:00:00. - Confundir con campaña. Si la oferta se carga en el módulo Campañas del portal, no aparece en
SpecialPricepor API y no se puede leer ni editar desde aquí.
Reversión
No se requiere acción: al pasar SpecialToDate el precio vuelve solo. Para cortar antes, reenviar el SKU con SpecialPrice vacío y las dos fechas vacías.
Snapshot de precios previo (referencia para comparar): /tmp/fb_snapshot.json en Zeta.