FT-PRD-08 · Plazos de enriquecimiento de Mercaderías hasta la…

En 30 segundos

En Mercaderías el proveedor tiene hasta que llega su pedido para terminar fotos y atributos, y si lo deja al final la carga cae de golpe en Foro. Esta épica le pone a cada SKU una fecha límite visible, calculada con la recepción esperada del pedido, le avisa antes de que venza y, si vence, pasa el trabajo a Foro con la lista de lo que llegará sin enriquecer para que el estudio lo planee.

• Módulo dueño: MS-02 Producto. También participan: MS-07 Ingesta de archivos, MS-11 Activos digitales, MS-12 Estudio fotográfico, MS-14 Avisos y ayuda.
• Etapa 6 · Imágenes. Recibe «PE-6 · SKU asignado» y entrega «PE-7 · Imágenes listas».
• APIs: construye 2 y usa 4 que construyen otras épicas.
• Eventos: publica 2 y consume 3.

1. Dónde encaja

Recibe

Entrega

Tareas que abre o cierra: Carga de imagen, Sección con dueño, Foro: muestra, foto y enriquecimiento.

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 vence el plazo, Liverpool toma el enriquecimiento

4. Si algo sale mal

• SAP no manda la fecha de recepción del pedido. Vale el plazo de omisión: 30 días desde el visto bueno. La lista marca el SKU como «sin fecha de recepción» para que Compras lo vea; cuando llega la fecha, el plazo se recalcula solo.
• El pedido cambia de fecha o se cancela. MS-07 entrega el cambio y el plazo se recalcula con la fecha nueva; si se cancela el pedido, regresa al plazo de omisión. El vencimiento de las tareas abiertas se mueve con él y el proveedor recibe aviso si su fecha se adelanta.
• Vence el plazo con imágenes o secciones pendientes. Carga de imagen se cierra como vencida y se abre Foro por rescate: la responsabilidad pasa a Liverpool, como hoy. El proveedor y catalogación reciben aviso; el producto no se cancela ni se bloquea.
• El mismo archivo de pedidos llega dos veces. Se aplica una sola vez por su identificador; si llega con otro contenido, responde 409 IDEMPOTENCY_MISMATCH y MS-07 lo deja en revisión.

5. APIs

Las que construye esta épica (2)

{
  "fileId": "sap-po-20261018-03",
  "records": [
    {
      "sku": "1000004812",
      "purchaseOrder": "4500012345",
      "expectedReceiptAt": "2027-01-20T06:00:00Z",
      "status": "OPEN"
    },
    {
      "sku": "1000004813",
      "purchaseOrder": "4500012346",
      "status": "CANCELLED"
    }
  ]
}

{
  "success": true,
  "data": {
    "fileId": "sap-po-20261018-03",
    "applied": 2,
    "rejected": 0,
    "items": [
      {
        "sku": "1000004812",
        "result": "APPLIED",
        "enrichmentDueAt": "2027-01-16T06:00:00Z",
        "anchor": "RECEPTION"
      },
      {
        "sku": "1000004813",
        "result": "APPLIED",
        "enrichmentDueAt": "2026-11-17T16:20:00Z",
        "anchor": "APPROVAL"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "sku": "1000004812",
        "productId": "PRD-0004812",
        "supplierId": "PROV-0001",
        "business": "MER",
        "dueAt": "2026-11-16T06:00:00Z",
        "anchor": "RECEPTION",
        "expectedReceiptAt": "2026-11-20T06:00:00Z",
        "state": "EXPIRED",
        "rescuedBy": "FORO",
        "missing": [
          {
            "task": "CARGA_DE_IMAGEN",
            "detail": "Falta la imagen principal"
          },
          {
            "task": "SECCION_CON_DUENO",
            "detail": "Falta la sección de Sostenibilidad"
          }
        ]
      }
    ],
    "page": 1,
    "size": 50,
    "total": 1
  }
}

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-PRD-08-1. La fecha límite de enriquecimiento es la recepción esperada del pedido menos 4 días, cuando SAP la manda; mientras no llegue, 30 días desde el visto bueno de Compras. Las dos cifras son por negocio en la tabla DEADLINES (tarea ENRICHMENT), con avisos a 15 y a 3 días. Por qué: Conserva el plazo de hoy, hasta la recepción, y le agrega aviso previo; los 30 días son los mismos del rescate de Carga de imagen en la máquina de estados. Los 4 días salen de la única cifra que dio el taller y se ajustan sin desplegar código. Se apoya en RF-ENR-13, RN-ENR-01, PEN-08, PEN-138.
• D-PRD-08-2. La fecha del pedido llega de SAP en un archivo que lee MS-07 y entrega a MS-02 por API-02-307; MS-02 no habla con SAP. La interfaz todavía no existe y se acuerda con los dueños de SAP. Por qué: Los externos sólo hablan con los adaptadores; hoy ninguna interfaz del catálogo da al PIM la fecha del pedido ni de la recepción. Se apoya en DUD-23, ADR-12.
• D-PRD-08-3. Al vencer, Liverpool toma el enriquecimiento: Carga de imagen se cierra como vencida y se abre Foro por rescate. El producto no se cancela ni se bloquea, porque el SKU ya existe y el enriquecimiento va por la segunda carretera. Por qué: Es la regla de hoy (si el proveedor no completa, los SKU pasan al portal de Foro) y respeta que el enriquecimiento no frena el SKU. Se apoya en RN-ENR-01, RN-GEN-03.
• D-PRD-08-4. El plazo aplica igual sin importar por dónde nació el SKU (Entrada Única, MM41, PLM o B2B) y vive en el producto y en el vencimiento de sus tareas; lo vigila el reloj único de MS-02, sin procesos aparte. Por qué: En Mercaderías y Suburbia el SKU nace por varios caminos; un solo reloj evita trabajos sueltos por sistema. Se apoya en RN-ALT-01, PD-29.
• D-PRD-08-5. Avisar o impedir la recepción en el CEDIS de un SKU sin enriquecer queda para una etapa posterior. Cuando se decida, el sistema de recepción consultará la fecha límite y lo que falta por SKU con API-02-308; no se construye nada más ahora. Por qué: El taller lo consideró valioso pero lo difirió, y el sistema de recepción no forma parte del Nuevo PIM. Se apoya en DEC-05, RF-ENR-14.

Qué falta decidir

También siguen abiertos: PEN-08, Mercaderías confirma los plazos de enriquecimiento (aquí arrancan en recepción menos 4 días o 30 días desde el visto bueno); PEN-138, Aclarar la regla de «4 días antes» que quedó ininteligible en el taller.

Fuentes

1. [D] trazabilidad/features/FT-PRD-08-plazos-enriquecimiento-recepcion-pedido.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.