FT-CAT-05 · Sitios, enrutamiento y visibilidad por negocio

En 30 segundos

Cuando un producto queda Aprobado hay que decidir a qué tiendas en línea (sitios) y a qué sistemas va, según su negocio dueño: lo de Suburbia sólo se prende en Suburbia, lo de Marketplace sólo en Liverpool y lo de Suburbia nunca va al portal de ofertas. Esta épica toma esa decisión en el PIM, sin que el seller elija, la deja registrada, pide publicar a cada canal y guarda lo que contesta cada destino.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-08 Adaptadores de salida, MS-10 Exportador al DWH, MS-14 Avisos y ayuda.
• Etapa 8 · Publicación. Recibe «PE-8 · Aprobado», «PE-10 · Cambio aprobado», «PE-M · Producto migrado», «PE-C · Catálogo vigente» y entrega «PE-9 · Publicado por canal».
• APIs: construye 4 y usa 11 que construyen otras épicas.
• Eventos: publica 4 y consume 6.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

2. Diagrama de contexto

Quién participa y cómo se conecta. Las pantallas llegan por el BFF del portal, que valida el token y compone; cada módulo vuelve a validar el token y decide sus permisos con los roles de MS-13.

🟩 Verde: nuevo, se construye · 🟦 Azul: ya existe y se queda, se reutiliza su código · 🟧 Naranja: temporal o se retira (se apaga en R3) · ⬜ Gris: sistema externo · ★ módulo dueño

3. Diagrama de flujo

El camino principal, paso por paso. Cuando una pantalla llama a un módulo se ven dos flechas: la pantalla al BFF y el BFF al módulo. Los eventos salen del outbox del módulo después de guardar; quien los consume ignora los repetidos.

3.1 Si un destino rechaza o no contesta

3.2 Retirar un producto de un canal

3.3 Limpieza de Suburbia con sitio Liverpool

4. Si algo sale mal

• Un destino no contesta. El reloj de MS-02 vigila los canales en Enviado: si no llega acuse en el plazo del canal (30 minutos por omisión para la tienda y OMS), el canal pasa a Error «Sin acuse». Nada se reenvía a ciegas: lo dudoso del lado de MS-08 queda en su revisión de lotes inciertos (API-08-001) y una persona decide reenviar o descartar con motivo (API-08-002).
• Un producto de Suburbia trae una categoría de un sitio Liverpool. La regla de sitios la deja fuera del XML antes de enviar y la marca como aviso en el estado por destino: el producto nunca se prende en Liverpool. La limpieza del dato la hace Gobierno de Datos.
• Falta la categoría web o la imagen principal. El canal tienda se queda en Pendiente con el motivo y entra al reporte diario y a la cola de Category; OMS y Marketplace no la esperan. Una variante sin imagen principal congelada no viaja y las demás sí.
• Un producto no tiene negocio dueño. No se enruta ni se publica a todos los sitios por omisión: sus canales se quedan en Pendiente con «Sin negocio» y el caso entra a la cola de Gobierno de Datos.
• Cambia la regla de sitios en MS-01. MS-02 se entera por catalog.governance.changed y la regla nueva vale para lo que se apruebe después. Lo ya publicado se corrige con una republicación explícita, con vista previa (API-02-039).

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "version": 9,
    "business": "MER",
    "productType": "GENERICO_CON_VARIANTES",
    "templateId": "EU4-0412",
    "name": "Licuadora de 10 velocidades",
    "brand": "MARCA01",
    "inventoryOwner": "MER",
    "routing": {
      "sites": [
        {
          "site": "LIVERPOOL",
          "idCatalog": "ICatalog1000"
        }
      ],
      "ruleVersion": 4
    },
    "attributes": [
      {
        "attribute": "POTENCIA_W",
        "value": "600",
        "channels": [
          "TIENDA",
          "OMS",
          "MARKETPLACE"
        ]
      },
      {
        "attribute": "GARANTIA_MESES",
        "value": "12",
        "channels": [
          "TIENDA"
        ]
      }
    ],
    "variants": [
      {
        "variantId": "VAR-0004812-01",
        "sku": "1000004812",
        "ean": "7501234567893",
        "eanType": "IE",
        "variantSequence": 1,
        "procede": true,
        "images": [
          {
            "position": 1,
            "type": "PRINCIPAL",
            "assetId": "ast-77120",
            "frozenPath": "congeladas/PRD-0004812/VAR-0004812-01/1.jpg"
          }
        ]
      },
      {
        "variantId": "VAR-0004812-02",
        "sku": "1000004813",
        "ean": "7501234567909",
        "eanType": "IE",
        "variantSequence": 2,
        "procede": false,
        "reason": "Sin imagen principal congelada",
        "images": []
      }
    ],
    "categories": [
      {
        "categoryId": "catst000123",
        "site": "LIVERPOOL",
        "path": [
          "Sitios Web",
          "Liverpool",
          "Electrodomésticos",
          "Licuadoras"
        ],
        "direct": true
      }
    ],
    "lastApprovedCategories": [
      "catst000120"
    ],
    "supplierShopId": "2001",
    "envase": "CAJA",
    "baseUnitOfMeasure": "PZA"
  }
}

{
  "productIds": [
    "PRD-0004812",
    "PRD-0007301"
  ],
  "context": "APPROVE"
}

{
  "success": true,
  "data": {
    "items": [
      {
        "productId": "PRD-0004812",
        "business": "MER",
        "version": 9,
        "channels": [
          {
            "channel": "TIENDA",
            "eligible": true,
            "sites": [
              "LIVERPOOL"
            ],
            "variants": [
              {
                "variantId": "VAR-0004812-01",
                "eligible": true
              },
              {
                "variantId": "VAR-0004812-02",
                "eligible": false,
                "reasons": [
                  {
                    "code": "MAIN_IMAGE_MISSING",
                    "message": "Sin imagen principal congelada: esta variante no viaja"
                  }
                ]
              }
            ]
          },
          {
            "channel": "OMS",
            "eligible": true
          },
          {
            "channel": "MARKETPLACE",
            "eligible": true,
            "document": "LVP"
          },
          {
            "channel": "SENALIZACION",
            "eligible": false,
            "reasons": [
              {
                "code": "NOT_FLAGGED",
                "message": "El artículo no está marcado para Señalización"
              }
            ]
          },
          {
            "channel": "DWH",
            "eligible": true
          }
        ]
      },
      {
        "productId": "PRD-0007301",
        "business": "MKP",
        "version": 3,
        "channels": [
          {
            "channel": "TIENDA",
            "eligible": false,
            "sites": [
              "LIVERPOOL"
            ],
            "reasons": [
              {
                "code": "WEB_CATEGORY_MISSING",
                "message": "Sin categoría web del sitio Liverpool"
              }
            ]
          },
          {
            "channel": "OMS",
            "eligible": true
          },
          {
            "channel": "MARKETPLACE",
            "eligible": true,
            "document": "MKT"
          },
          {
            "channel": "DWH",
            "eligible": true
          }
        ]
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "business": "MER",
    "status": "APROBADO",
    "approvedVersion": 9,
    "routing": {
      "sites": [
        "LIVERPOOL"
      ],
      "decidedAt": "2026-10-18T15:20:00Z",
      "ruleVersion": 4
    },
    "summary": "Publicado en 3 de 5 destinos",
    "channels": [
      {
        "channel": "TIENDA",
        "state": "PUBLICADO",
        "sites": [
          "LIVERPOOL"
        ],
        "version": 9,
        "sentAt": "2026-10-18T15:20:02Z",
        "ackAt": "2026-10-18T15:20:09Z",
        "lastResult": "ACCEPTED",
        "message": "Se procesó correctamente",
        "attempts": 1
      },
      {
        "channel": "OMS",
        "state": "PUBLICADO",
        "version": 9,
        "sentAt": "2026-10-18T15:20:02Z",
        "ackAt": "2026-10-18T15:20:05Z",
        "lastResult": "ACCEPTED",
        "attempts": 1
      },
      {
        "channel": "MARKETPLACE",
        "state": "ERROR",
        "document": "LVP",
        "version": 9,
        "sentAt": "2026-10-18T15:20:02Z",
        "lastResult": "FAILED",
        "message": "El destino rechazó el documento: tienda del proveedor inválida",
        "attempts": 2
      },
      {
        "channel": "SENALIZACION",
        "state": "PUBLICADO",
        "version": 9,
        "sentAt": "2026-10-18T15:21:00Z",
        "ackAt": "2026-10-18T15:23:00Z",
        "lastResult": "ACCEPTED",
        "attempts": 1
      },
      {
        "channel": "DWH",
        "state": "ENVIADO",
        "version": 9,
        "sentAt": "2026-10-18T15:21:00Z",
        "attempts": 1
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "attemptId": "att-5512",
        "jobId": "job-a1f0",
        "operation": "APPROVE",
        "channel": "MARKETPLACE",
        "document": "LVP",
        "version": 9,
        "attempt": 1,
        "sentAt": "2026-10-18T15:20:02Z",
        "ackAt": "2026-10-18T15:20:30Z",
        "result": "FAILED",
        "destinationResponse": "Tienda del proveedor inválida",
        "trackingId": null,
        "evidence": {
          "xmlRef": "evidencias/publicaciones/2026/10/18/job-a1f0-mkp-001.xml",
          "sha256": "1c0be72d9a35"
        }
      },
      {
        "attemptId": "att-5508",
        "jobId": "job-a1f0",
        "operation": "APPROVE",
        "channel": "TIENDA",
        "version": 9,
        "attempt": 1,
        "sentAt": "2026-10-18T15:20:02Z",
        "ackAt": "2026-10-18T15:20:09Z",
        "result": "ACCEPTED",
        "destinationResponse": "Se procesó correctamente",
        "evidence": {
          "xmlRef": "evidencias/publicaciones/2026/10/18/job-a1f0-tienda-001.xml",
          "sha256": "9f2c7e11a04b"
        }
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

Las que usa y construye otra épica (11)

Su request y su response están en la página de la épica que la construye.

6. Eventos

Publica

Consume

7. Datos

Cada colección tiene un solo dueño, el único que escribe en ella.

8. Historias que cubre

9. Decisiones de esta épica

Las tomó el TL como arquitecto; quedan como [Propuesta] hasta que el equipo de la épica las revise.

• D-CAT-05-1. Canales por negocio, en publication_rules de MS-02: Mercaderías va a la tienda (sitio Liverpool y los que diga la regla por marca), OMS, Marketplace con el documento de stock out (LVP) y DWH; Suburbia va a la tienda sólo en el sitio Suburbia, OMS y DWH, y nunca a Marketplace; Marketplace va a la tienda sólo en el sitio Liverpool, OMS, Marketplace con el documento MKT y DWH. Señalización, en los tres, sólo si el artículo trae la marca de Señalización. Por qué: Es lo que hace hoy el código (Mirakl nunca recibe Suburbia; Marketplace sólo vende en Liverpool) puesto en una tabla, para dejar de enrutar a mano. Se apoya en P-40, RN-CAT-04, RN-CAT-06, PEN-133.
• D-CAT-05-2. La regla de sitios es configuración del catálogo: vive en MS-01 como un tipo nuevo de regla (SITE_ROUTING en governance_rules) que administra Gobierno de Producto con Category. MS-02 la evalúa al aprobar y guarda en el producto los sitios, la versión de la regla y la fecha, antes de publicar. El seller nunca elige sitio. Por qué: Un solo dueño para la regla (el catálogo) y otro para la decisión de cada producto (Producto); así la decisión queda registrada antes de publicar, como pide RF-CAT-11. Se apoya en PEN-42, PEN-89, RF-CAT-11, PD-05.
• D-CAT-05-3. Un sitio es la rama de nivel 0 de «Sitios Web» y se nombra con la tabla oficial de sitios y sus tres códigos. La tienda recibe sólo las categorías de los sitios permitidos para el negocio; las demás se quitan del XML y quedan como aviso. Por qué: Con el código de sitio equivocado la categoría no llega a la tienda, y un producto enrutado a dos sitios anula la lista negra por negocio. Se apoya en DUD-21, DEC-95.
• D-CAT-05-4. El negocio dueño es el campo business del producto (MER, SUB o MKP), fijado al entrar; para lo que nace en SAP se calcula con la regla 1.0 (con EXTWG de S4H, Suburbia; con negocio «ART. MARKETPLACE», Marketplace; si no, Mercaderías). Sin negocio no se publica. Por qué: E-commerce aplica la visibilidad por sitio con este dato y hoy unos 60 mil renglones no lo tienen; un valor por omisión escondería el problema. Se apoya en DUD-19, PD-17.
• D-CAT-05-5. El mínimo de cada canal está en publication_rules: qué revisa por contexto (aprobar, republicar, repoblar) y con qué acción (apagado, aviso o bloqueo). La lista de atributos obligatorios de cada destino la pone MS-01 (FT-PLT-04). La tienda pide al menos una categoría web del sitio; OMS y Marketplace no la esperan; una variante sin imagen principal congelada no viaja. Por qué: Aprobar no espera a los canales y cada canal publica cuando cumple su mínimo; la categoría frena sólo a la tienda, como propone PD-22. Se apoya en PD-22, RF-PUB-12, RF-PUB-01.
• D-CAT-05-6. Estados por canal: Enviado al escribir PUBLICATION_REQUESTED en el outbox, en la misma transacción; Publicado con el acuse ACCEPTED, que sólo dice que el destino leyó el mensaje; Error con FAILED, con UNCERTAIN o si no hay acuse en el plazo del canal. Nada se reenvía solo. La petición lleva jobId, operación, producto, versión y, por canal, sitios y documento; cada cambio de canal sale como STATUS_CHANGED con el cambio en channels.<destino>.status. Por qué: Es la publicación por canal de la máquina de estados; que algo esté «Publicado» no prueba que ya se vea en la tienda, y eso lo vigila FT-RAC-08. Se apoya en PD-29, DUD-36.
• D-CAT-05-7. Señalización y DWH reciben el mismo XML que la tienda, guardado en el almacén con su SHA-256: MS-08 lo manda a Señalización y MS-10 al DWH, y los dos devuelven acuse (se pide que MS-10 publique DELIVERY_RESULT). Por qué: Un solo XML para todos los destinos, como hoy; sin acuse, el canal DWH se quedaría en Enviado para siempre. Se apoya en PD-09, DUD-10.
• D-CAT-05-8. Retirar de un canal es una operación más del plan de publicación (WITHDRAW en API-02-039): un producto aprobado no se cancela, se retira de cada canal, y se republica después si hace falta (C08). Por qué: Hoy la baja es una corrida manual sin estado; así cada canal sabe si el producto está retirado. Se apoya en PD-29.
• D-CAT-05-9. Tienda y OMS salen en la misma petición y la tienda no espera el acuse de OMS; la regla de no vender en línea lo que no llegó a OMS queda configurable en publication_rules y apagada. Por qué: Así funciona hoy y la regla contraria todavía es propuesta; prenderla después es configuración, no código. Se apoya en RN-PUB-05, PD-10.

Qué falta decidir

También siguen abiertos: PEN-42, Quién administra la regla de sitios; aquí se propone Gobierno de Producto con Category, en MS-01; PEN-89, La tabla de marcas y enrutado que alimenta la regla de sitios; PEN-133, Confirmar con Marketplace que sólo se vende en el sitio Liverpool; PEN-139, Confirmar con e-commerce que ya existe la regla que apaga en Suburbia lo que tiene inventario de Liverpool.

Fuentes

1. [D] trazabilidad/features/FT-CAT-05-sitios-enrutamiento-y-visibilidad.md: la ficha de la épica, con sus historias, reglas y bloqueos.
2. [D] ADR-12 · Un solo sistema: backend compartido y una sola base (sección 3.4).
3. [D] docs/arquitectura/por-epica/base/: piezas, colecciones, eventos y el hilo de punta a punta.
4. [D] docs/arquitectura/omega-a-pim-headless/contratos-api.md: convenciones y endpoints de partida.
5. [D] docs/arquitectura/maquina-de-estados-to-be/propuesta-maquina-de-estados.md §7: estados, tareas y canales.
6. [I] Las decisiones de la sección 9 son del TL sobre esas fuentes.