FT-INT-03 · Entrada de SKUs creados en SAP

En 30 segundos

Todo artículo que se crea en SAP, venga de una propuesta, de la MM41, de PLM o de B2B, regresa en el archivo 122. Esta épica hace que cada uno llegue al PIM sin intervención: la ingesta (MS-07) lee el archivo, aparta lo que excluyen las reglas que Gobierno de Datos configura con motivo y responsable, y entrega el resto a Producto. Lo que no entra queda en una lista «no vive» para reprocesarlo o pedirlo a SAP.

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

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: SKU en SAP, 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 Artículo o Conjunto Look creado directo en SAP

3.2 Si Gobierno de Datos reactiva un grupo excluido

3.3 Lista «no vive» y reenvío

4. Si algo sale mal

• Un registro del 122 no se puede aplicar (grupo sin plantilla, EAN que ya usa otro SKU del negocio). MS-02 lo rechaza con su motivo. Si el error es pasajero, MS-07 reintenta hasta 10 veces; si no, queda fallido en la lista «no vive». Si era de una propuesta, MS-02 abre una tarea de Gobierno de Datos y la propuesta sigue en Creación de SKU.
• Llegan los atributos antes que los productos del mismo momento. MS-07 los empareja por la marca de tiempo del nombre y espera al de productos hasta 30 minutos; nunca aplica atributos de un SKU que todavía no existe. Si no llega, el archivo queda incompleto en el monitor.
• El mismo 122 llega dos veces. Cada registro tiene llave (archivo, SKU y marca de tiempo) y recibo: lo ya aplicado no se repite y el archivo repetido sólo queda registrado.
• SAP creó un SKU y nunca mandó su 122. Aparece en la lista «no vive» con el motivo «SAP no lo mandó» al cruzar el control del día. Gobierno de Datos pide el reenvío a SAP; el PIM no inventa el artículo.
• Producto no responde. El lote se reintenta con espera creciente sin perder el orden del archivo; los demás archivos esperan su turno y el atraso se ve en el monitor.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "fileId": "sapf-20261018-122-0007",
        "interface": "122",
        "system": "ECC",
        "name": "GenericXMLproducts_20261018013000.xml",
        "pairedWith": "sapf-20261018-122-0008",
        "receivedAt": "2026-10-18T07:30:04Z",
        "finishedAt": "2026-10-18T07:30:41Z",
        "sha256": "9f2c4e7a1b0d55e3c8a6f1e2d4b7a9c0e5f3d2b1a8c7e6f5d4c3b2a1f0e9d8c7",
        "state": "COMPLETED_WITH_ERRORS",
        "records": {
          "total": 412,
          "applied": 405,
          "unchanged": 0,
          "excluded": 4,
          "failed": 3,
          "pending": 0
        },
        "copyRef": "sap-in/122/ECC/2026-10-18/GenericXMLproducts_20261018013000.xml"
      },
      {
        "fileId": "sapf-20261018-lov-0001",
        "interface": "LOV",
        "system": "ECC",
        "name": "LOV20261017210000.XML",
        "pairedWith": null,
        "receivedAt": "2026-10-18T05:00:12Z",
        "finishedAt": "2026-10-18T05:06:55Z",
        "sha256": "1c0a9e8d7f6b5a4c3e2d1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c",
        "state": "COMPLETED_WITH_ERRORS",
        "records": {
          "total": 18240,
          "applied": 312,
          "unchanged": 17925,
          "excluded": 0,
          "failed": 3,
          "pending": 0
        },
        "copyRef": "sap-in/LOV/ECC/2026-10-18/LOV20261017210000.XML"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

{
  "scope": "FAILED",
  "reason": "Se asignó plantilla al grupo de artículos 1203 con producto 0045"
}

{
  "success": true,
  "data": {
    "jobId": "job-ri-5512",
    "status": "ACCEPTED",
    "records": 3,
    "links": {
      "file": "/api/v2/sap-ingest/files?fileId=sapf-20261018-122-0007",
      "records": "/api/v2/sap-ingest/records?jobId=job-ri-5512"
    }
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "recordKey": "122:ECC:1000004812",
        "interface": "122",
        "fileId": "sapf-20261018-122-0007",
        "sku": "1000004812",
        "business": "MKP",
        "articleGroup": "1203",
        "result": "EXCLUDED",
        "reason": {
          "code": "EXCLUSION_RULE",
          "ruleId": "RUL-EXC-0031",
          "detail": "Grupo de artículos excluido para Marketplace"
        },
        "attempts": 1,
        "lastAttemptAt": "2026-10-18T07:30:22Z",
        "reprocessable": true
      },
      {
        "recordKey": "122:ECC:1000004813",
        "interface": "122",
        "fileId": "sapf-20261018-122-0007",
        "sku": "1000004813",
        "business": "MER",
        "articleGroup": "1203",
        "result": "FAILED",
        "reason": {
          "code": "NO_TEMPLATE_MAPPING",
          "detail": "El grupo de artículos 1203 con producto 0045 no tiene plantilla"
        },
        "attempts": 10,
        "lastAttemptAt": "2026-10-18T08:12:40Z",
        "reprocessable": true
      },
      {
        "recordKey": "CONTROL:ECC:1000004820",
        "interface": "CONTROL",
        "fileId": "sapf-20261018-ctl-0001",
        "sku": "1000004820",
        "business": "MER",
        "articleGroup": "0871",
        "result": "NOT_RECEIVED",
        "reason": {
          "code": "SAP_NOT_SENT",
          "detail": "Viene en el archivo de control del día y no llegó su 122"
        },
        "attempts": 0,
        "lastAttemptAt": null,
        "reprocessable": false
      }
    ],
    "page": 1,
    "size": 50,
    "total": 3
  }
}

{
  "recordKeys": [
    "122:ECC:1000004812",
    "122:ECC:1000004813"
  ],
  "reason": "Se reactivó la multioferta de Esfera Boutique (regla RUL-EXC-0031)"
}

{
  "success": true,
  "data": {
    "jobId": "job-ri-5520",
    "status": "ACCEPTED",
    "accepted": 2,
    "rejected": [],
    "links": {
      "records": "/api/v2/sap-ingest/records?jobId=job-ri-5520"
    }
  }
}

Las que usa y construye otra épica (6)

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-03-1. MS-07 lee el 122 de ECC (E15) y de S4H (E13) con las reglas de hoy: empareja productos y atributos del mismo momento y los entrega en ese orden, guarda copia de cada archivo y entrega en lotes de hasta 100 a MS-02. Producto es quien asigna SKU y EAN, el estado por negocio y el ID LVP o SBB más SKU del nacido en SAP. Por qué: La misma lógica sirve para cualquier origen si vive en Producto (FT-PRD-02); MS-07 sólo lee, ordena, filtra y reintenta. La copia corrige que hoy sólo haya archivos desde el 24-sep. Se apoya en FT-PRD-02, RN-INT-03, DUD-23.
• D-INT-03-2. Las exclusiones se deciden en el PIM y no en la variante de SAP: SAP manda todo el 122 y MS-07 aparta, con la tabla de exclusiones de MS-01 en memoria, lo que combina grupo de artículos con negocio, flujo u origen. Cada entrada lleva motivo, responsable y fecha de revisión, y un cambio se confirma con plan en MS-01 y llega a MS-07 en segundos por REFERENCE_TABLE_CHANGED. Por qué: La variante de SAP excluye sólo por grupo y deja fuera la multioferta de Esfera; en el PIM la regla tiene dueño, se ve y cambia en menos de los 5 minutos de hoy. Se alinea con FT-REF-01 y FT-PRD-02. Se apoya en RF-INT-02, DEC-70, PEN-69, FT-REF-01.
• D-INT-03-3. Lo excluido también se registra: queda en el libro de MS-07 con la regla que lo apartó, para reprocesarlo cuando la regla cambie (API-07-004) sin pedir otro archivo a SAP. Por qué: Reactivar un grupo no debe depender de que SAP vuelva a mandar lo que ya mandó. Se apoya en RF-INT-03, DEC-80.
• D-INT-03-4. «No vive» por variante es todo SKU que SAP mandó y no está aplicado en el PIM (excluido o fallido) y, cuando SAP entregue un archivo de control diario con los artículos creados o cambiados ese día, también lo que SAP creó y nunca mandó. Se calcula al cerrar cada archivo y cada noche contra el control. Por qué: Hasta 7 a 9 mil SKU por semana no llegan y nadie lo ve; sin el control de SAP, el PIM sólo puede ver lo que recibió. Se apoya en RF-INT-03, DEC-80, PEN-116, DUD-23.
• D-INT-03-5. Capacidad: el 122 se lee al llegar, sin ventana de lote. Cada archivo es independiente y cada lote de 100 se reintenta hasta 10 veces con espera creciente antes de quedar fallido. Por qué: Un lote diario no alcanza para el volumen de hoy; el aviso del almacén quita la espera de 10 s y la ventana. Se apoya en DUD-25, PEN-116.
• D-INT-03-6. Todo lo que entra por el 122 lo gobierna el Nuevo PIM. El dato «owner» P360 o STEP sólo sobrevive en el aviso a Entrada Única mientras exista (FT-INT-06), y la ruta GetProductSystemOwner no se construye (decisión 20 que adopta ADR-12). Por qué: Con un solo sistema ya no hay dos dueños posibles del producto que nace en SAP. Se apoya en ADR-12, DUD-11, FT-INT-06.
• D-INT-03-7. Mientras P360 sea la fuente (hasta el corte de R3), el 122 lo sigue leyendo el middleware de P360. MS-07 se enciende por interfaz en el corte: P360 termina el archivo en curso y MS-07 empieza con el siguiente. Por qué: Dos lectores de la misma carpeta duplicarían o perderían registros. Se apoya en PD-11, FT-MIG-04.
• D-INT-03-8. MS-07 avisa en catalog.sap.inbound sólo lo que nadie más puede avisar: SAP_ARTICLE_CREATED por cada registro aplicado, con su archivo y su registro, para la bitácora; y SAP_ARTICLE_FAILED por cada SKU que no vive y cada error 141, para Gobierno de Datos y la clasificación de errores. Los cambios del producto los sigue avisando Producto (SKU_ASSIGNED, STATUS_CHANGED). Por qué: La bitácora necesita el origen exacto en SAP y los errores que se repiten hay que vigilarlos; repetir los avisos de Producto los duplicaría. Se apoya en P-32, FT-ARQ-02.

Qué falta decidir

También siguen abiertos: PEN-108, Revisar con SAP qué grupos de Esfera se reactivan al quitar la variante de exclusión; PEN-69, Documentar por qué se excluyó cada grupo hoy, para cargar la tabla con motivo y responsable; PEN-116, Ubicar el proceso por lotes de SAP que deja SKU sin mandar.

Fuentes

1. [D] trazabilidad/features/FT-INT-03-entrada-skus-sap-exclusion-conciliacion.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.