FT-INT-02 · Publicación a OMS, DWH y Señalización

En 30 segundos

Además de la tienda, cada producto aprobado tiene que llegar a OMS para venderse y surtirse, a Señalización para las etiquetas en tienda y al DWH para análisis, con el contenido que reciben hoy. Esta épica entrega a cada uno su documento desde la misma foto del producto, confirma que llegó y devuelve el acuse. El DWH lo atiende el exportador MS-10, que también manda cada día hábil el diccionario de plantillas.

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

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 Envío exprés a OMS al asignar el SKU

3.2 Diccionario de plantillas al DWH

3.3 Si OMS o el DWH no confirman

4. Si algo sale mal

• El broker no responde o responde vacío para OMS. El lote queda incierto y el canal OMS pasa a Error; nada se reenvía solo. Mientras OMS no esté Publicado, Producto no cataloga para venta ese producto en la tienda.
• Llega un Conjunto Look aprobado. No va a OMS ni al DWH, como hoy: Producto no lo pide para esos canales y el carril de OMS lo quita si viene en un lote mixto.
• Falla el SFTP de Señalización. Se reintenta con espera creciente hasta 15 minutos; después el canal pasa a Error y el archivo queda intacto en el almacén para reenviarlo igual.
• El DWH no confirma el cambio de nombre del archivo. El envío queda incierto en el monitor de MS-10 y Operaciones decide subirlo otra vez o descartarlo (API-10-002); los productos del lote quedan en Error mientras tanto.

5. APIs

Las que construye esta épica (3)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "exportId": "dwh-20261018-152011-042",
        "type": "PRODUCTS",
        "state": "UNCERTAIN",
        "sourceEvidenceId": "evd-7a51c0",
        "fileName": "eilstep_20261018_152011_042.xml",
        "sha256": "4c1e0d9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d",
        "products": 120,
        "startedAt": "2026-10-18T15:20:11Z",
        "reason": {
          "code": "RENAME_NOT_CONFIRMED",
          "detail": "Se subió el .part y no se pudo confirmar el cambio de nombre"
        }
      },
      {
        "exportId": "dwh-dict-20261017",
        "type": "TEMPLATE_DICTIONARY",
        "state": "DELIVERED",
        "sourceEvidenceId": null,
        "fileName": "diccionario_plantillas_20261017.csv",
        "sha256": "7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c",
        "templates": 4096,
        "startedAt": "2026-10-17T00:00:05Z",
        "reason": null
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

{
  "decision": "RESEND",
  "reason": "El área del DWH confirmó que el archivo no aparece en su carpeta"
}

{
  "success": true,
  "data": {
    "requestId": "req-dwh-0091",
    "status": "ACCEPTED",
    "receiptUrl": "/api/v2/dwh-exports?exportId=dwh-20261018-152011-042"
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "templateId": "EU4-0412",
        "name": "Licuadoras",
        "business": "MER",
        "viewVersion": 31,
        "group": "EU3-0398",
        "attributes": [
          {
            "attributeId": "MARCA",
            "label": "Marca",
            "dataType": "LOV",
            "lovId": "MARCAS_ECC_LOV",
            "level": "REQUIRED"
          },
          {
            "attributeId": "POTENCIA_W",
            "label": "Potencia en watts",
            "dataType": "NUMBER",
            "lovId": null,
            "level": "OPTIONAL"
          }
        ]
      }
    ],
    "page": 1,
    "size": 200,
    "total": 12288
  }
}

Las que usa y construye otra épica (3)

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-02-1. OMS va por el broker en el primer corte, con el contenido de hoy: el XML canónico sin Classifications ni AttributeList y con SalesItemFamilyMkt renombrado a SalesItemFamily, por la misma ruta. El éxito es la respuesta no vacía del broker. Cuando OMS tenga un contrato sin broker, sólo cambia el carril de MS-08. Por qué: OMS depende hoy de la cola del broker y no tiene dueño identificado para un contrato nuevo; cambiarlo en el corte sumaría un riesgo crítico. Se apoya en PD-10, DUD-10, RSG-25.
• D-INT-02-2. La tienda espera a OMS: un producto nuevo no se cataloga para venta en la tienda hasta que su canal OMS esté Publicado. La regla vive en el enrutamiento de Producto y usa el acuse que devuelve MS-08. Por qué: No se vende lo que no se puede entregar; la regla es del canal y la decide quien decide los canales. Se apoya en RN-PUB-05, FT-CAT-05, DUD-10.
• D-INT-02-3. Señalización recibe por el SFTP «pricing», con el nombre output-<época en ms>.xml, el mismo XML de cada lote, sólo con los artículos que Producto pidió para ese canal: los marcados para Access Via (EnvioAV). Es la entrega por lote que hace el código desde el 31-ago; la de las 19:00 de la tabla de integraciones no tiene código. Por qué: Gana el código sobre la tabla; Producto ya sólo pide Señalización para los artículos marcados. Se apoya en DUD-10, RSG-28.
• D-INT-02-4. El DWH es un canal con adaptador propio: MS-10 copia al SFTP del DWH cada XML canónico que MS-08 deja en el almacén (eilstep_yyyyMMdd_HHmmss_SSS.xml; sube .part y renombra) y devuelve el acuse por producto. MS-10 no transforma ni guarda datos: la marca de entregado vive en el archivo. Por qué: El DWH recibe hoy el mismo XML del comercio electrónico; copiarlo evita un segundo armador y deja el canal con estado. Se apoya en DEC-ARQ-03, DUD-10, FT-CAT-05.
• D-INT-02-5. El diccionario de plantillas y atributos (S41) lo arma MS-10 de lunes a viernes a las 18:00 con las vistas efectivas de MS-01: identificador, nombre, grupo, tipo de dato, lista y obligatoriedad por negocio, en CSV mientras el DWH no entregue su muestra. Por qué: No hay clase ni muestra de hoy; las vistas de MS-01 ya traen todo resuelto. Se apoya en DUD-10.
• D-INT-02-6. Cada destino recibe los atributos marcados para él en el catálogo (uso por canal que llega en la foto). Mientras un destino no tenga marcas, recibe lo mismo que hoy. El Conjunto Look nunca va a OMS ni al DWH. Por qué: Dirección aprobó las mejoras en catalogación (DEC-ARQ-12) y el uso por canal ya lo administra FT-PLT-04; sin marcas, se conserva la paridad. Se apoya en DEC-ARQ-12, FT-PLT-04.
• D-INT-02-7. El envío exprés a OMS al asignar el SKU sigue como hoy: XML propio en lotes de 25 con acuse por lote. Un lote en vuelo o fallido queda en revisión y nunca se reenvía a ciegas. Su acuse se guarda en el historial de envíos sin mover el estado del canal, que nace al aprobar. Por qué: OMS necesita el artículo desde que tiene SKU para surtir; mezclarlo con el estado por canal confundiría Enviado con Publicado. Se apoya en DUD-10, PD-10.
• D-INT-02-8. Cada sistema recibe sólo sus negocios: lo decide el enrutamiento de Producto (por ejemplo, Suburbia nunca va a Marketplace) y MS-08 y MS-10 entregan sólo lo pedido. Por qué: Un solo lugar decide qué recibe cada destino; el adaptador no filtra por su cuenta. Se apoya en FT-CAT-05, P-40.

Qué falta decidir

Fuentes

1. [D] trazabilidad/features/FT-INT-02-publicacion-oms-dwh-senalizacion.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.