FT-PRD-09 · Contrato de propuestas con Entrada Única

En 30 segundos

Hoy las pantallas de propuesta de Vendor Center llaman a P360 y al backend de Entrada Única. En R2 cambian una sola vez al BFF del portal, que les compone la propuesta con su vista efectiva, sus listas y sus permisos, y escriben en los servicios del PIM. No se construye una capa que imite a P360: sólo queda, hasta el apagado de P360 en R3, el adaptador que usa su middleware para quitar un EAN.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-13 Identidad y acceso.
• Etapa 0 · Entrada. Recibe «PE-C · Catálogo vigente» y entrega «PE-1 · Propuesta en Borrador».
• APIs: construye 3 y usa 20 que construyen otras épicas.
• Eventos: publica 4 y consume 0.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: Corrección.

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 Corregir, quitar una variante y reenviar

3.2 Placeholders desde el portal

3.3 El middleware de P360 quita un EAN (hasta R3)

4. Si algo sale mal

• Una pantalla vieja sigue llamando a P360 o al backend de Entrada Única en R2. La entrada mide el tráfico por ruta y una ruta vieja no se da por apagada hasta tener 30 días en cero. Mientras P360 viva la llamada funciona, pero lo nuevo ya se guarda en el PIM, que escribe en P360 por MS-03 mientras P360 sea la fuente.
• MS-01 no responde al armar la pantalla. El BFF devuelve la propuesta de sólo lectura con un aviso (partial = true): no se puede capturar sin vista efectiva, pero no se pierde nada de lo guardado.
• Otra persona cambió la propuesta mientras se corregía. La confirmación responde 409 VERSION_CONFLICT; la pantalla recarga la versión nueva y el proveedor ve qué cambió antes de volver a guardar.
• Quiere quitar una variante que ya tiene SKU. El plan responde 422 con el motivo; esa variante se cambia con una modificación o se da de baja, no se borra.
• El middleware de P360 manda un EAN que no está en el PIM. El adaptador responde igual que hoy y deja el caso en la bitácora; no crea ni cambia nada.

5. APIs

Las que construye esta épica (3)

null

{
  "success": true,
  "data": {
    "proposal": {
      "productId": "PRD-0004812",
      "business": "MER",
      "status": "BORRADOR",
      "visibleStatus": "Rechazada",
      "version": 6,
      "origin": "PORTAL",
      "supplierId": "PROV-0001",
      "templateId": "EU4-0412",
      "base": {
        "TITULO": "Licuadora de 10 velocidades",
        "MARCA": "MARCA01",
        "MODELO": "LV-10"
      },
      "variants": [
        {
          "variantId": "VAR-0004812-01",
          "ean": "7501234567893",
          "sku": null,
          "axes": {
            "COLOR": "ROJO"
          }
        },
        {
          "variantId": "VAR-0004812-02",
          "ean": "7501234567909",
          "sku": null,
          "axes": {
            "COLOR": "NEGRO"
          }
        }
      ]
    },
    "template": {
      "templateId": "EU4-0412",
      "version": 7,
      "business": "MER",
      "sections": [
        {
          "code": "DATOS_BASE",
          "owner": "PROVEEDOR",
          "attributes": [
            {
              "code": "COLOR",
              "level": "REQUIRED",
              "type": "LIST",
              "list": "COLOR"
            },
            {
              "code": "TONO",
              "level": "OPTIONAL",
              "type": "LIST",
              "list": "TONO",
              "dependsOn": "COLOR"
            }
          ]
        },
        {
          "code": "LOGISTICA",
          "owner": "PROVEEDOR",
          "attributes": [
            {
              "code": "ALTO_EMPAQUE",
              "level": "REQUIRED",
              "type": "NUMBER",
              "unit": "CM"
            }
          ]
        }
      ]
    },
    "lists": {
      "COLOR": [
        {
          "code": "ROJO",
          "label": "Rojo"
        },
        {
          "code": "NEGRO",
          "label": "Negro"
        }
      ],
      "TONO": {
        "byParent": {
          "ROJO": [
            {
              "code": "ROJO_VINO",
              "label": "Rojo vino"
            }
          ]
        }
      }
    },
    "permissions": {
      "fieldGroups": [
        {
          "group": "DATOS_BASE",
          "access": "editable"
        },
        {
          "group": "LOGISTICA",
          "access": "editable"
        }
      ],
      "actions": [
        "SUBMIT",
        "CANCEL"
      ],
      "isContentOwner": true
    },
    "rejection": {
      "rejectedAt": "2026-10-18T15:04:07Z",
      "byArea": "COMPRAS-HOGAR",
      "reason": {
        "code": "DATOS_INCOMPLETOS",
        "comment": "Faltan medidas del empaque"
      },
      "fields": [
        {
          "attribute": "ALTO_EMPAQUE",
          "code": "REQUIRED",
          "comment": "Captura el alto en centímetros"
        }
      ],
      "correctionDueAt": "2026-12-17T15:04:05Z"
    },
    "partial": false
  }
}

{
  "version": 4,
  "variantIds": [
    "VAR-0004812-03"
  ],
  "reason": "Color descontinuado"
}

{
  "success": true,
  "data": {
    "planId": "pln-2b7e10",
    "expiresAt": "2026-10-18T16:50:00Z",
    "items": [
      {
        "variantId": "VAR-0004812-03",
        "result": "WILL_REMOVE",
        "freesEans": [
          "7501234567916"
        ]
      }
    ],
    "remainingVariants": 2,
    "applyUrl": "/api/v2/product-plans/pln-2b7e10/apply"
  }
}

Las que usa y construye otra épica (20)

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

6. Eventos

Publica

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-09-1. Las pantallas de propuesta, variantes y carga masiva de Vendor Center cambian una sola vez al contrato del BFF en R2; no se construye la capa /public/rt (CreateProposal, GetProposals, GetArticleByEanOrBrandAndModel, EliminaVariantes y las demás) ni adaptadores en los servicios. El backend de Entrada Única y P360 se apagan en R3 con tráfico cero. Por qué: Es la decisión 20 que adopta ADR-12: mantener capas temporales cuesta más que cambiar el front una vez, y al llegar al corte no queda nada temporal que mantener. Se apoya en ADR-12, PD-06, ADR-06, RSG-30.
• D-PRD-09-2. La composición «propuesta con su vista efectiva, listas, permisos y motivos» vive una sola vez en el BFF (API-BFF-201), en lugar de las cuatro copias que hoy tiene el navegador. El BFF no decide permisos de dominio: los pide al motor de MS-02 y sólo aplica los de pantalla. Por qué: Decisión 19: un solo lugar para componer, servicios que no saben de pantallas y ninguna regla de negocio en el BFF. Se apoya en ADR-12, PD-30, RF-GEN-10.
• D-PRD-09-3. Cada operación de hoy tiene su reemplazo: GetProposals por API-BFF-201, API-02-001 y API-02-201; GetArticleByEanOrBrandAndModel por la identificación previa al alta (API-02-202) y la revisión de cada EAN (API-02-102); EliminaVariantes por API-02-203; SellersAllowedNotEAN por API-02-102, que dice si el dueño está exento; /catalogationmanagement/product por API-BFF-201 o API-02-201; /catalogationmanagement/templates por la búsqueda de plantillas del BFF (API-BFF-107); los cinco flujos de CreateProposal por API-02-005, API-02-006, API-02-012, API-02-028 y API-02-106; y la carga masiva de Entrada Única por API-02-046. Lo de plantilla (GetTemplate, habilitadores y marcas) pasa al BFF de catálogo en R1 (API-BFF-101 a API-BFF-103). Por qué: Que ninguna función se pierda al apagar P360 (RSG-30) sin copiar los contratos de P360 con sus rarezas (RSG-31). Se apoya en RSG-30, RSG-31, RF-INT-14.
• D-PRD-09-4. El único adaptador es upc-eans (API-02-074): mientras P360 viva, MS-02 atiende el mismo contrato para su middleware, libera el EAN y avisa EAN_CHANGED; se borra con el apagado de P360 en R3. Por qué: Es la única llamada a Entrada Única que no viene de un front (decisión 20); la otra opción, reapuntar la propiedad de P360, llega a la misma ruta de MS-02. Se apoya en ADR-06, PD-06.
• D-PRD-09-6. Mientras P360 sea la fuente del producto (R2), la pantalla ya lee y escribe en el PIM y MS-02 escribe en P360 por MS-03; cada ruta vieja se da por apagada con 30 días de tráfico cero en la entrada. Por qué: La pantalla cambia una sola vez, la convivencia queda en un solo lugar (FT-MIG-04) y se apaga con evidencia. Se apoya en ADR-08, RSG-48, FT-MIG-04.
• D-PRD-09-7. Los placeholders del portal usan la carga masiva con el perfil PLACEHOLDERS, que sólo exige datos maestros y los atributos estratégicos de la plantilla enmascarada; editarlos a mano los conserva como placeholder. Pasan a propuesta sólo cuando o9 los acepta (FT-PRD-04). Por qué: H8 sin otro front ni otro contrato: la misma carga, con un perfil. Se apoya en FT-PRD-04, DEC-PRD-08.

Qué falta decidir

También siguen abiertos: RSG-24, El apagado de P360 depende de que la publicación nueva ya esté operando; sin publicador no hay corte de propuestas.

Fuentes

1. [D] trazabilidad/features/FT-PRD-09-contrato-propuestas-entrada-unica.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.