FT-PRD-02 · Creación de SKU con SAP

En 30 segundos

Cuando una propuesta tiene visto bueno, hay que pedirle a SAP que cree el artículo y esperar el SKU (el número con el que se vende) y el EAN (el código de barras). Esta épica hace ese tramo igual para los tres negocios y para cualquier origen: arma los cuatro archivos que lee SAP, recibe la respuesta 122, asigna los códigos a cada variante y, si SAP rechaza (archivo 141), deja el error visible y lo turna a Gobierno de Datos.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-07 Ingesta de archivos, MS-08 Adaptadores de salida, MS-14 Avisos y ayuda, MS-05 Auditoría.
• Etapa 5 · SKU en SAP. Recibe «PE-5 · Visto bueno dado», «PE-C · Catálogo vigente» y entrega «PE-6 · SKU asignado».
• APIs: construye 5 y usa 10 que construyen otras épicas.
• Eventos: publica 6 y consume 6.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: SKU en SAP, Gobierno de Datos, 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 Si SAP rechaza el alta (archivo 141)

3.2 Variante nueva en una familia que ya tiene SKU

3.3 Tablero de errores de SAP

4. Si algo sale mal

• SAP no contesta el 122. El reloj de MS-02 revisa la tarea SKU en SAP: si los archivos se entregaron y no llega el 122 en 24 horas (configurable por negocio), abre Gobierno de Datos con «Sin respuesta de SAP» y el proveedor sigue viendo «En revisión». Si los archivos ni siquiera llegaron, MS-08 reintenta en su propio carril y la tarea dice «No entregado a SAP».
• El 122 trae un SKU que ya usa otro producto, o un SKU distinto para una variante que ya tenía uno. El registro sale rechazado en el recibo y no cambia nada (el SKU es único e inmutable); se abre Gobierno de Datos y MS-07 lo deja como fallido en su monitor para reprocesarlo cuando se corrija (API-07-002).
• La familia queda incompleta: alguna variante elegible sigue sin SKU. La familia se queda en Creación de SKU con una tarea de Gobierno de Datos «Familia incompleta» y no pasa a enriquecimiento hasta que todas sus variantes tengan SKU, como hace hoy P360 (RC-P3B-055).
• Llega el mismo archivo dos veces. Cada registro se aplica una sola vez por su llave (archivo y renglón): el repetido devuelve el mismo recibo y uno con otro contenido responde IDEMPOTENCY_MISMATCH. Nada se duplica.
• El 122 llega para una propuesta que ya se canceló. No se revive: el SKU queda registrado para que nadie lo vuelva a usar y se abre Gobierno de Datos para darlo de baja en SAP.

5. APIs

Las que construye esta épica (5)

null

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "version": 7,
    "business": "MER",
    "system": "ECC",
    "kind": "CREATE",
    "reason": "VISTO_BUENO",
    "filePrefix": "P360A",
    "header": {
      "supplierId": "PROV-0001",
      "productTypeSap": "ZMER",
      "itemGroup": "GA-0412",
      "brand": "MARCA01",
      "name": "Licuadora de 10 velocidades",
      "identificaNegocio": "REGULAR",
      "taxCode": "IVA16",
      "cost": 820.0,
      "suggestedPrice": 1499.0,
      "deliveryMonth": "2026-12",
      "fashionGrade": "BASICO",
      "roundingProfile": "R01",
      "dimensions": {
        "heightCm": 38.0,
        "widthCm": 20.0,
        "depthCm": 22.0,
        "weightKg": 3.1
      }
    },
    "variantCount": 2,
    "variants": [
      {
        "variantId": "VAR-0004812-01",
        "sku": null,
        "ean": "7501234567893",
        "color": "ROJO",
        "supplierPartNumber": "LIC-10V-R"
      },
      {
        "variantId": "VAR-0004812-02",
        "sku": null,
        "ean": "7501234567909",
        "color": "NEGRO",
        "supplierPartNumber": "LIC-10V-N"
      }
    ],
    "units": [
      {
        "variantId": "VAR-0004812-01",
        "unit": "PZA",
        "ean": "7501234567893"
      },
      {
        "variantId": "VAR-0004812-02",
        "unit": "PZA",
        "ean": "7501234567909"
      }
    ],
    "salesAttributes": [
      {
        "attribute": "POTENCIA_W",
        "value": "600"
      },
      {
        "attribute": "VELOCIDADES",
        "value": "10"
      }
    ],
    "foro40": {
      "photoBy": "LIVERPOOL",
      "firstApprovalAt": null
    }
  }
}

{
  "fileId": "ECC122-20261018-153010-01",
  "system": "ECC",
  "batch": {
    "number": 1,
    "of": 1
  },
  "records": [
    {
      "recordKey": "ECC122-20261018-153010-01#1",
      "proposalId": "PRD-0004812",
      "variantId": "VAR-0004812-01",
      "sku": "1000004812",
      "ean": "7501234567893",
      "eanType": "IE",
      "shortName": "LICUADORA 10 VEL ROJA",
      "sapBusiness": "REGULAR",
      "supplierId": "PROV-0001",
      "itemGroup": "GA-0412",
      "articleType": "01"
    },
    {
      "recordKey": "ECC122-20261018-153010-01#2",
      "proposalId": "PRD-0004812",
      "variantId": "VAR-0004812-02",
      "sku": "1000004813",
      "ean": "7501234567909",
      "eanType": "IE",
      "shortName": "LICUADORA 10 VEL NEGRA",
      "sapBusiness": "REGULAR",
      "supplierId": "PROV-0001",
      "itemGroup": "GA-0412",
      "articleType": "01"
    },
    {
      "recordKey": "ECC122-20261018-153010-01#3",
      "proposalId": null,
      "variantId": null,
      "sku": "1000009001",
      "ean": "7501234567930",
      "eanType": "IE",
      "shortName": "CAFETERA GOTEO 12 TAZAS",
      "sapBusiness": "SFERA",
      "supplierId": "PROV-0001",
      "itemGroup": "GA-0415",
      "articleType": "00"
    }
  ]
}

{
  "success": true,
  "data": {
    "fileId": "ECC122-20261018-153010-01",
    "applied": 2,
    "created": 1,
    "rejected": 0,
    "items": [
      {
        "recordKey": "ECC122-20261018-153010-01#1",
        "result": "APPLIED",
        "productId": "PRD-0004812",
        "variantId": "VAR-0004812-01",
        "sku": "1000004812"
      },
      {
        "recordKey": "ECC122-20261018-153010-01#2",
        "result": "APPLIED",
        "productId": "PRD-0004812",
        "variantId": "VAR-0004812-02",
        "sku": "1000004813"
      },
      {
        "recordKey": "ECC122-20261018-153010-01#3",
        "result": "CREATED",
        "productId": "LVP1000009001",
        "sku": "1000009001"
      }
    ],
    "families": [
      {
        "productId": "PRD-0004812",
        "complete": true,
        "nowStatus": "EN_ENRIQUECIMIENTO",
        "closedTasks": [
          "SKU_EN_SAP"
        ],
        "openedTasks": [
          "FORO",
          "SECCION_CON_DUENO"
        ]
      },
      {
        "productId": "LVP1000009001",
        "complete": true,
        "nowStatus": "EN_ENRIQUECIMIENTO",
        "openedTasks": [
          "GOBIERNO_DE_DATOS"
        ]
      }
    ]
  }
}

{
  "fileId": "ECC141-20261018-154500-01",
  "system": "ECC",
  "records": [
    {
      "recordKey": "ECC141-20261018-154500-01#1",
      "proposalId": "PRD-0004815",
      "message": "El grupo de artículos GA-9999 no existe para la sociedad",
      "receivedAt": "2026-10-18T15:45:00Z"
    }
  ]
}

{
  "success": true,
  "data": {
    "fileId": "ECC141-20261018-154500-01",
    "applied": 1,
    "rejected": 0,
    "items": [
      {
        "recordKey": "ECC141-20261018-154500-01#1",
        "result": "APPLIED",
        "productId": "PRD-0004815",
        "errorType": "GRUPO_ARTICULO_INVALIDO",
        "taskId": "tsk-40122",
        "taskType": "GOBIERNO_DE_DATOS",
        "status": "CREACION_SKU"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "from": "2026-10-18T00:00:00Z",
    "to": "2026-10-18T23:59:59Z",
    "business": "MER",
    "totalProducts": 113,
    "groups": [
      {
        "errorType": "GRUPO_ARTICULO_INVALIDO",
        "label": "El grupo de artículos no existe en SAP",
        "products": 61,
        "records": 70,
        "lastSeenAt": "2026-10-18T15:45:00Z",
        "sampleMessage": "El grupo de artículos GA-9999 no existe para la sociedad"
      },
      {
        "errorType": "PROVEEDOR_BLOQUEADO",
        "label": "Proveedor bloqueado en SAP",
        "products": 40,
        "records": 40,
        "lastSeenAt": "2026-10-18T14:30:00Z",
        "sampleMessage": "El proveedor PROV-0001 está bloqueado para compras"
      },
      {
        "errorType": "SIN_CLASIFICAR",
        "label": "Mensaje sin tipo conocido",
        "products": 12,
        "records": 12,
        "lastSeenAt": "2026-10-18T13:10:00Z",
        "sampleMessage": "Error al crear el material"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "productId": "PRD-0004815",
        "business": "MER",
        "name": "Batidora de pedestal",
        "supplierId": "PROV-0001",
        "status": "CREACION_SKU",
        "message": "El grupo de artículos GA-9999 no existe para la sociedad",
        "receivedAt": "2026-10-18T15:45:00Z",
        "fileId": "ECC141-20261018-154500-01",
        "taskId": "tsk-40122",
        "taskStatus": "OPEN"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 61
  }
}

Las que usa y construye otra épica (10)

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-02-1. La petición a SAP (SAP_CREATION_REQUESTED) sólo sale por tres motivos: CREATE al entrar a Creación de SKU, RESEND cuando Gobierno de Datos relanza y MODIFY cuando se aprueba un cambio que toca un campo de SAP o una variante nueva. Nunca al editar una propuesta en revisión. Si ya hay una abierta, la nueva se junta con ella. Por qué: Hoy un cambio de característica en 1007 o 1008 reenvía a SAP sin que nadie lo apruebe, y eso rompe la integración. Un solo constructor y tres motivos dan la «una sola lógica» que piden los talleres para pantalla, carga masiva, API e IA. Se apoya en PEN-71, RF-ALT-01, RF-ALT-11, RN-ALT-12.
• D-PRD-02-2. El mínimo de la MM41 lo revisan los candados SKU y SAP del motor de validación (FT-RAC-01) contra el grupo de atributos «Mínimo SAP» por negocio que administra MS-01 (FT-PLT-04). El candado SKU frena el visto bueno: el plan de ACCEPT, o la compuerta de Marketplace, responde con el campo que falta y la petición nunca sale incompleta. Los obligatorios históricos de Entrada Única que la MM41 no pide no frenan el SKU. Por qué: SAP deja de ser el último validador sin copiar las casi 500 reglas de hoy; la lista vive en un solo lugar y la lee cualquier origen. Se apoya en PEN-63, RF-ALT-02, PD-24.
• D-PRD-02-3. MS-08 arma los archivos con la foto de la versión pedida (API-02-055): en ECC, P360A o STEPM más H, D, S y T; en S4H, STEPMD, STEPVAR, STEPUOM y STEPATT. Es la misma lógica para los tres negocios; sólo cambia el formato. Al dejarlos, MS-08 publica DELIVERY_RESULT con destino SAP y MS-02 lo guarda en la tarea SKU en SAP. Por qué: Separa «no se mandó» de «SAP no ha contestado», que hoy no se distingue, y deja medir los errores de SAP que piden vigilar. Se apoya en DUD-23, P-32, RSG-27.
• D-PRD-02-4. El 122 se aplica por familia: la familia pasa a En enriquecimiento (T06) sólo cuando todas sus variantes elegibles tienen SKU. SKU y EAN de SAP ganan sobre lo capturado y el SKU no cambia nunca. Por qué: Así PE-6 garantiza que cada variante tiene SKU; es la regla vigente de P360 para la familia incompleta y la de SKU único e inmutable. Se apoya en DEC-PRD-04, RN-ALT-12.
• D-PRD-02-5. En Marketplace el genérico lleva un SKU sintético, 999 más los dígitos de su ID, que asigna MS-02 con una sola fórmula; sus variantes reciben el SKU de SAP. Un producto con coincidencia no crea SKU (se vuelve oferta, FT-INT-05) y el Genérico Dummy no viaja a SAP. Por qué: Hoy hay dos fórmulas distintas para el mismo genérico según quién lo calcule; una sola evita SKU duplicados. Se apoya en RN-MAT-18, DUD-19.
• D-PRD-02-6. Las tareas que abre el 122 salen de la tabla versionada SKU_TASKS del motor, por negocio de SAP: SFERA abre Gobierno de Datos; REGULAR, MARCAS PROPIAS y SERVICIOS abren Foro o Carga de imagen según quién toma la foto; todas abren las secciones con dueño que pida la plantilla. Lo que llega sin propuesta crea el producto nacido en SAP con la misma tabla. Por qué: Convierte en datos las reglas por negocio que hoy están en el código del 122 y abre en paralelo la «segunda carretera» del enriquecimiento. Se apoya en PD-29, PEN-60.
• D-PRD-02-7. Un 141 guarda en el producto el mensaje completo de SAP (sin truncar), lo clasifica con la tabla de patrones SAP_ERROR_PATTERNS del motor (los no reconocidos quedan «Sin clasificar») y abre Gobierno de Datos; el producto se queda en Creación de SKU. Gobierno de Datos relanza, regresa a Compras (T07), rechaza al proveedor con una Corrección o cancela (T13). Por qué: El proveedor ve su error y Gobierno de Datos ataca primero lo que más se repite; el tablero sale de los mismos datos, sin copia. Se apoya en DUD-23, P-32, PEN-60.

Qué falta decidir

También siguen abiertos: PEN-63, La matriz de la MM41 por negocio: los 13 campos de PP33 y qué obligatorios de hoy sobran. Gobierno de Producto con SAP; PEN-71, Confirmar que los reenvíos automáticos de hoy en 1007 y 1008 no se necesitan fuera de un cambio aprobado.

Fuentes

1. [D] trazabilidad/features/FT-PRD-02-creacion-sku-sap-interfaz-122.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.