FT-INT-01 · Publicación a e-commerce

En 30 segundos

Cuando un producto queda aprobado tiene que llegar a la tienda en línea (Product Data Service y commercetools) en uno o dos minutos y sin pasar por el broker. Los adaptadores de salida (MS-08) arman, con la foto del producto, el mismo mensaje que hoy produce la cadena del broker, lo dejan en los tópicos que ya lee la tienda, guardan lo enviado con su huella y devuelven el acuse para que el canal pase a Publicado o a Error.

• Módulo dueño: MS-08 Adaptadores de salida. También participan: MS-02 Producto, MS-03 Migración y convivencia.
• Etapa 8 · Publicación. Recibe «PE-8 · Aprobado», «PE-M · Producto migrado» y entrega «PE-9 · Publicado por canal».
• APIs: construye 5 y usa 4 que construyen otras épicas.
• Eventos: publica 2 y consume 2.

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 la tienda no acusa o rechaza

3.2 Comparar contra el broker antes del corte

3.3 Retirar un producto de la tienda

4. Si algo sale mal

• La tienda no acusa en 30 minutos. El lote queda incierto y el canal pasa a Error con «sin acuse». Nada se reenvía solo: el lote aparece en la revisión de Repoblamiento y Operaciones, que deciden reenviar igual o descartar, siempre con motivo.
• La tienda rechaza un producto en su tópico de errores. Ese producto pasa a Error con la respuesta de la tienda y los demás del lote siguen. Se republica desde el portal (API-02-039) cuando se corrige.
• Una variante no tiene imagen principal congelada. La foto de Producto la trae como «no procede»: esa variante no viaja y sus hermanas sí. Si ninguna tiene principal, Producto no pide publicar y el producto queda «Sin imágenes congeladas».
• El producto no tiene categoría válida. Producto no pide el canal tienda, así que la tienda nunca recibe un producto sin categoría; OMS y Marketplace no esperan la categoría.
• Llega dos veces la misma petición. MS-08 la reconoce por producto, versión y destino y no vuelve a mandar; una versión vieja que llega tarde se ignora.

5. APIs

Las que construye esta épica (5)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "batchId": "egb-20261018-oms-0142",
        "destination": "OMS",
        "operation": "APPROVE",
        "status": "UNCERTAIN",
        "reason": {
          "code": "TIMEOUT",
          "detail": "El broker no respondió en 120 s"
        },
        "sentAt": "2026-10-18T15:20:03Z",
        "attempts": 3,
        "products": 120,
        "sampleProductIds": [
          "PRD-0004812",
          "PRD-0004813"
        ],
        "evidenceId": "evd-7a51c0",
        "version": 3
      }
    ],
    "page": 1,
    "size": 50,
    "total": 1
  }
}

{
  "decision": "RESEND",
  "reason": "El equipo de OMS confirmó que el lote no llegó",
  "version": 3
}

{
  "success": true,
  "data": {
    "requestId": "req-eg-8812",
    "status": "ACCEPTED",
    "receiptUrl": "/api/v2/egress/batches/egb-20261018-oms-0142"
  }
}

null

{
  "success": true,
  "data": {
    "batchId": "egb-20261018-ecom-0311",
    "destination": "TIENDA",
    "operation": "APPROVE",
    "status": "ACCEPTED",
    "items": [
      {
        "productId": "PRD-0004812",
        "version": 9,
        "business": "MER",
        "variants": 3,
        "excludedVariants": [
          {
            "variantId": "VAR-0004812-04",
            "reason": "NO_MAIN_IMAGE"
          }
        ],
        "result": "ACCEPTED",
        "ackAt": "2026-10-18T15:21:10Z",
        "traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
      }
    ],
    "attempts": [
      {
        "n": 1,
        "at": "2026-10-18T15:20:05Z",
        "outcome": "ACK",
        "detail": "La tienda guardó el producto y lo mandó a commercetools"
      }
    ],
    "evidence": [
      {
        "evidenceId": "evd-7a51c0",
        "format": "STEP_XML",
        "sha256": "4c1e0d9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d",
        "bytes": 482113
      },
      {
        "evidenceId": "evd-7a51c1",
        "format": "PDS_JSON",
        "sha256": "0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9",
        "bytes": 96210
      }
    ],
    "version": 2
  }
}

null

{
  "success": true,
  "data": {
    "evidenceId": "evd-7a51c0",
    "batchId": "egb-20261018-ecom-0311",
    "destination": "TIENDA",
    "format": "STEP_XML",
    "sha256": "4c1e0d9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d",
    "bytes": 482113,
    "download": "/api/v2/egress/evidence/evd-7a51c0/content?t=dl-58c1",
    "expiresAt": "2026-10-18T15:45:00Z",
    "keptUntil": "2027-10-18T00:00:00Z"
  }
}

{
  "rehearsalId": "rh-e2-0004",
  "destinations": [
    "TIENDA",
    "OMS"
  ],
  "items": [
    {
      "productId": "PRD-0004812",
      "version": 1
    },
    {
      "productId": "PRD-0004813",
      "version": 1
    }
  ]
}

{
  "success": true,
  "data": {
    "requestId": "req-rh-0004",
    "status": "ACCEPTED",
    "outputs": [
      {
        "destination": "TIENDA",
        "evidenceId": "evd-rh-0004-ecom",
        "format": "PDS_JSON"
      },
      {
        "destination": "OMS",
        "evidenceId": "evd-rh-0004-oms",
        "format": "STEP_XML"
      }
    ],
    "receiptUrl": "/api/v2/egress/evidence/evd-rh-0004-ecom"
  }
}

Las que usa y construye otra épica (4)

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-INT-01-1. Sin broker para la tienda: MS-08 publica directo en los tópicos de producto y de SKU que ya lee el Product Data Service (…feed-data-processor.product-message y …sku-message), con source=STIBO, traceId y objectId, como hoy el procesador. La tienda no cambia su receptor. El broker y el procesador dejan de recibir productos en la misma ventana en que se enciende MS-08: nunca dos productores. Por qué: El Product Data Service no lee el XML del broker sino esos mensajes; publicar ahí quita dos saltos y conserva las reglas de la tienda (mezcla parcial, versión, variante maestra). Es lo que propone PD-10 para la tienda y lo que ya se hizo con categorías. Se apoya en PD-10, PD-09, DEC-ARQ-10, RSG-24.
• D-INT-01-2. MS-08 rehace la traducción que hoy hacen el broker y el procesador, con la foto de Producto como única entrada. La especificación es el cuadre de los 159 campos de la tienda, y se prueba campo por campo contra sus colecciones products y skus antes del corte con el ensayo sin envío (API-08-005). Por qué: Sin esa traducción nadie publica tras apagar P360, el riesgo mayor del programa; compararla contra la tienda es la prueba de que no se pierde nada. Se apoya en RSG-24, PD-23, FT-MIG-03.
• D-INT-01-3. El acuse es de la tienda, no del tópico: MS-08 marca Publicado cuando el Product Data Service publica hacia commercetools el cambio de ese traceId, y Error cuando lo publica en su tópico de errores. Sin ninguno de los dos en 30 minutos, el lote queda incierto y espera a una persona (API-08-002). Que el bus de eventos acepte el mensaje no es Publicado. Por qué: Enviado y Publicado son estados distintos; sólo el destino sabe si de verdad lo guardó. Se apoya en RF-PUB-14, PD-09, DUD-10.
• D-INT-01-4. MS-08 no decide qué ni cuándo se publica: el mínimo del canal, la categoría válida, la variante que no procede, los sitios y la espera de OMS son reglas de Producto (publication_rules y su enrutamiento) y llegan resueltas en la petición y en la foto. MS-08 sólo traduce, entrega y devuelve el acuse. Por qué: Un solo dueño de cada regla; hoy las compuertas viven dentro del exportador y nadie las ve. Se apoya en RF-PUB-05, RN-PUB-05, PD-22, FT-CAT-05.
• D-INT-01-5. Un carril por destino: cada adaptador tiene su suscripción filtrada por canal, su lote (30 s, 1,000 productos o 1 MB, lo que llegue primero), su reintento de 30 s × 2ⁿ hasta 15 minutos y su revisión. Un destino lento no frena a otro. La meta de 1 a 2 minutos se mide de la petición al acuse. Por qué: RF-PUB-01 pide la tienda en 1 a 2 minutos; hoy un solo exportador encadena todo y el 13.7 % de los envíos quedó colgado. Se apoya en RF-PUB-01, RSG-51.
• D-INT-01-6. Cada lote deja en el almacén el XML canónico de hoy (STEP-ProductInformation) y el mensaje de la tienda, con su SHA-256 y un año de resguardo. Es la evidencia de lo enviado (API-08-004) y la fuente del DWH y de Señalización. Por qué: RF-PUB-08 pide descargar lo enviado; un solo documento evita armar tres veces lo mismo. Se apoya en RF-PUB-08, DMS-66.
• D-INT-01-7. Los agrupados (genérico Marketplace o genérico dummy) salen como un genérico con sus variantes, cada una con su SKU de SAP y en el orden de la plantilla (variantSequence de la foto). Antes del corte, la salida de MS-08 se compara con la del broker del mismo día. Por qué: Hoy esa transformación la hace el broker; si no se reproduce, el cliente ve productos sueltos. Se apoya en RF-PUB-08, PD-10.
• D-INT-01-8. Banderas y fechas se mandan como las sabe el PIM: encendidas con sus fechas o apagadas. Lo que no tiene dato no se manda y nunca salen fechas centinela como 0002-11-30 o 9998-11-30. Por qué: El relleno en falso infla el mensaje y las fechas ficticias corrompen la tienda. Se apoya en PD-23, DUD-30.
• D-INT-01-9. MS-08 se enciende para la tienda en el corte de productos (R3). Antes, P360 sigue publicando por el broker y los cambios que llegan por la convivencia no generan peticiones. En el corte no se republica el catálogo: sólo sale lo que cambie. Por qué: Dos productores duplicarían la tienda y republicar 3.4 millones de productos sin cambios la saturaría. Se apoya en PD-10, FT-MIG-04, DEC-PRD-06.

Qué falta decidir

También siguen abiertos: PEN-01, Mínimo de visibilidad de Marketplace con plantillas compartidas de 50 atributos.

Fuentes

1. [D] trazabilidad/features/FT-INT-01-publicacion-ecommerce-sin-broker.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.