🔗 Nexus

← Volver a notas
4 KB 01/11/2026 22:59
🔗

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

  1. La acción es ProductUpdate, no UpdatePrice. UpdatePrice y UpdateProductPrice devuelven E008: Invalid Action.
  2. ProductUpdate exige el bloque BusinessUnits anidado. Sin él responde 1000: BusinessUnits is missing y no toca nada.
  3. 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).
  4. El descuento va en SpecialPrice + SpecialFromDate + SpecialToDate; el Price base 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" }

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

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

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.