FT-CAT-04 · Clasificación SAP derivada

En 30 segundos

El grupo de artículos de SAP es obligatorio para crear el SKU, pero el proveedor o seller no entiende esa clasificación y hoy los productos llegan mal clasificados. Esta épica hace que el PIM la derive de lo que el proveedor sí entiende (plantilla y tipo de producto), que valide siempre dirección, sección y grupo, y que asigne plantilla a lo que llega directo de SAP.

• Módulo dueño: MS-01 Catálogo. También participan: MS-02 Producto, MS-07 Ingesta de archivos, MS-15 IA y enriquecimiento.
• Etapa 5 · SKU en SAP. Recibe «PE-3 · Plantilla asignada», «PE-C · Catálogo vigente» y entrega «PE-6 · SKU asignado».
• APIs: construye 2 y usa 9 que construyen otras épicas.
• Eventos: publica 5 y consume 2.

1. Dónde encaja

Recibe

Entrega

Tareas que abre o cierra: Gobierno de Datos.

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 Lo que llega de SAP sin pasar por el portal

3.2 Gobierno de Producto asigna plantilla a lo «Sin categorizar»

3.3 La IA no alcanza la confianza

4. Si algo sale mal

• La tabla da varios grupos para la plantilla en Mercaderías o Suburbia. No se usa IA, como hoy: el proveedor elige entre los candidatos, que ve con su nombre y sin códigos, y Compras confirma o corrige el grupo en su visto bueno.
• El grupo no pertenece a la sección o a la dirección del producto. El plan de MS-02 responde 422 con el campo y no se guarda; si viene de SAP, el producto queda con una tarea de Gobierno de Datos.
• Un SKU llega de SAP sin regla de plantilla. Queda en «Sin categorizar» sólo con los atributos de raíz y con una tarea de Gobierno de Datos con motivo «Sin plantilla» en la cola de Gobierno de Producto; no puede terminar su enriquecimiento.
• MS-15 no responde o la confianza es baja. La clasificación queda pendiente y se abre Gobierno de Datos; sin grupo o sin sección el producto no pasa a Creación de SKU.
• Al pedir el SKU falta el grupo o la sección. El plan de la acción de visto bueno responde 422 y la propuesta no pasa a Creación de SKU hasta corregirlo.

5. APIs

Las que construye esta épica (2)

{
  "business": "MKP",
  "templateId": "EU4-0412",
  "productType": "CAMISA",
  "supplierId": "SELLER-0001",
  "itemGroup": null
}

{
  "success": true,
  "data": {
    "result": "UNIQUE",
    "classification": {
      "itemGroup": {
        "ecc": "424104421",
        "s4h": "424104421"
      },
      "section": "424",
      "direction": "9"
    },
    "labels": {
      "template": "Camisas",
      "productType": "Camisa",
      "itemGroup": "Camisas de caballero"
    },
    "source": "TABLE",
    "rule": {
      "ruleId": "rul-000113",
      "type": "ALLOWED_ITEM_GROUPS_BY_TEMPLATE",
      "version": 6
    },
    "candidates": []
  }
}

{
  "fileId": "sap-122-20261018-03",
  "items": [
    {
      "sku": "1000004812",
      "business": "MER",
      "supplierId": "PROV-0001",
      "itemGroup": {
        "ecc": "424104421",
        "s4h": "424104421"
      },
      "productType": "CAMISA"
    },
    {
      "sku": "1000004813",
      "business": "MER",
      "supplierId": "PROV-0001",
      "itemGroup": {
        "ecc": "531220110",
        "s4h": "531220110"
      },
      "productType": "BOTA"
    }
  ]
}

{
  "success": true,
  "data": {
    "items": [
      {
        "sku": "1000004812",
        "result": "CLASSIFIED",
        "templateId": "EU4-0412",
        "assignment": "AUTOMATIC",
        "rule": {
          "ruleId": "rul-018822",
          "type": "CLASSIFY_ITEM_GROUP_PRODUCT_TO_TEMPLATE",
          "version": 2
        },
        "section": "424",
        "direction": "9",
        "leaves": {
          "ecc": {
            "nodeId": "ECC-424104421-CAMISA",
            "created": false
          },
          "s4h": {
            "nodeId": "S4H-424104421-CAMISA",
            "created": true
          }
        }
      },
      {
        "sku": "1000004813",
        "result": "NO_RULE",
        "templateId": "SIN_CATEGORIZAR",
        "assignment": "UNCATEGORIZED",
        "rule": null,
        "section": "531",
        "direction": "5",
        "leaves": {
          "ecc": {
            "nodeId": "ECC-531220110-BOTA",
            "created": false
          },
          "s4h": {
            "nodeId": "S4H-531220110-BOTA",
            "created": false
          }
        }
      }
    ]
  }
}

Las que usa y construye otra épica (9)

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-04-1. La clasificación SAP se deriva, no se captura: MS-01 traduce plantilla y tipo de producto a grupo de artículos de ECC y S/4HANA, sección y dirección con la tabla de Gobierno de Producto (reglas ALLOWED_ITEM_GROUPS_BY_TEMPLATE); el proveedor y el seller ven nombres, nunca códigos. MS-02 la guarda en el producto con su origen. Por qué: El grupo es el dato que más se clasifica mal y del que dependen el SKU, la lista negra, el envase y las comisiones; derivarlo quita la decisión a quien no la entiende. Se apoya en RF-CAT-01, PEN-32, DEC-PLT-14.
• D-CAT-04-2. Tabla primero, IA después: si la tabla da un solo grupo, ése es; si da varios, en Marketplace decide la IA de MS-15 con su umbral (hoy 0.999517) y, abajo del umbral o sin grupo o sección, se abre Gobierno de Datos. En Mercaderías y Suburbia no se usa IA: Compras confirma el grupo en su visto bueno. Por qué: Cierra PEN-32 con lo que ya funciona: la tabla es explicable y la IA sólo decide lo ambiguo, como hoy sólo en Marketplace. Se apoya en PEN-32, DUD-35, PD-02, DEC-ARQ-05.
• D-CAT-04-3. Para lo que llega de SAP manda la regla más específica: grupo más tipo de producto y, si no hay, sólo grupo. Las dos tablas de hoy se migran como reglas explícitas; sin ninguna, el producto queda en «Sin categorizar». Por qué: Resuelve DUD-23 sin escoger una de las dos vías: la más específica gana y ninguna asignación automática de hoy se pierde. Se apoya en DUD-23, DEC-PLT-14.
• D-CAT-04-4. La clasificación de lo que llega de SAP crea, en la misma llamada (API-01-018), la hoja de grupo más producto que falte en ECC o S/4HANA, sin repetirla si llega dos veces. Las jerarquías de grupo siguen siendo de sólo lectura para las personas. Por qué: Reproduce el cambio de julio de 2026 sin que MS-02 escriba en datos de Catálogo y sin una segunda llamada. Se apoya en DEC-PLT-14, ADR-12.
• D-CAT-04-5. Grupo y sección son candado del SKU: MS-02 los revalida con MS-01 al cambiar plantilla, tipo de producto o grupo, y otra vez antes de pasar a Creación de SKU; si faltan o no cuadran con la jerarquía de SAP, la acción se bloquea. Por qué: Concreta la regla «de cajón»: se valida contra las jerarquías que manda SAP, al guardar y al pedir el SKU, que es donde un error cuesta más. Se apoya en RN-CAT-05, FT-RAC-01.
• D-CAT-04-6. Lo «Sin categorizar» se trabaja como tarea de Gobierno de Datos con motivo «Sin plantilla», en la cola de Gobierno de Producto; al asignar la plantilla, la pantalla ofrece crear la regla para que el siguiente entre solo. Por qué: Usa una tarea que ya existe en el motor y convierte cada caso resuelto a mano en una regla. Se apoya en DEC-PLT-14, PD-29.

Qué falta decidir

También siguen abiertos: PEN-32, Ratificar tabla primero e IA sólo para lo ambiguo (D-CAT-04-2); PEN-14, Decidir si el seller confirma la clasificación antes de publicar.

Fuentes

1. [D] trazabilidad/features/FT-CAT-04-grupo-de-articulos-derivado.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.