FT-FLU-05 · Reglas de negocio en la carga masiva

En 30 segundos

Un seller puede subir cientos o miles de productos en un archivo. Esta épica aplica a cada renglón las mismas reglas del alta individual (lista negra, coincidencia por EAN con la marca y decisión por negocio), sin imagen, URL ni IA para no frenar la carga, y deja en el reporte la acción de cada renglón: crear, crear multioferta o no se puede. Después de crear los productos, cada uno recibe su calificación con sugerencias para mejorarla.

• Módulo dueño: MS-06 Evaluación. También participan: MS-01 Catálogo, MS-02 Producto.
• Etapa 0 · Entrada. Recibe de otras épicas y entrega «PE-1 · Propuesta en Borrador», «PE-2 · Sin duplicado».
• APIs: construye 3 y usa 9 que construyen otras épicas.
• Eventos: publica 2 y consume 1.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

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 Renglones que ya existen o están vetados

3.2 Proveedor de Mercaderías: EAN duplicado

3.3 Calificación después de la carga

4. Si algo sale mal

• Un renglón coincide sólo con Suburbia. Sale «no se puede catalogar» con la explicación de la tabla de decisión; cuando se decida la regla de Suburbia se cambia la fila sin tocar código.
• MS-06 no termina un bloque. MS-02 lo reintenta con la misma llave de idempotencia: lo ya evaluado no se repite. El reporte muestra esos renglones «en revisión» y el resto sigue.
• Cambió la lista negra entre la revisión y la confirmación. Al confirmar, MS-02 vuelve a evaluar sólo los renglones de evaluaciones vencidas o hechas con otra versión de reglas; un renglón que quedó vetado no se crea y el reporte lo dice.
• El archivo trae 20,000 renglones. Son 40 bloques que MS-06 atiende en paralelo con tope; el reporte se llena por bloque y el seller ve el avance.

5. APIs

Las que construye esta épica (3)

{
  "importId": "imp-0000042",
  "chunk": 1,
  "business": "MKP",
  "owner": {
    "type": "SELLER",
    "id": "SELLER-0001"
  },
  "templateId": "EU4-0412",
  "rows": [
    {
      "rowRef": "SEL-001-PB20",
      "brandCode": "MARCA01",
      "model": "PB-20",
      "ean": "7501234567893",
      "productType": "BATERIA_EXTERNA"
    },
    {
      "rowRef": "SEL-001-PB10",
      "brandCode": "MARCA01",
      "model": "PB-10",
      "ean": "7501234500012",
      "productType": "BATERIA_EXTERNA"
    },
    {
      "rowRef": "SEL-001-AUD7",
      "brandCode": "MARCA09",
      "model": "AUD-7",
      "ean": "7501234500029",
      "productType": "AUDIFONOS"
    }
  ]
}

{
  "success": true,
  "data": {
    "batchId": "evb-0000318",
    "status": "ACCEPTED",
    "rows": 3,
    "links": {
      "self": "/api/v2/evaluations/batches/evb-0000318"
    }
  }
}

null

{
  "success": true,
  "data": {
    "batchId": "evb-0000318",
    "importId": "imp-0000042",
    "status": "DONE",
    "finishedAt": "2026-10-18T16:05:40Z",
    "summary": {
      "CONTINUE": 1,
      "MULTI_OFFER": 1,
      "BLOCK": 1
    },
    "items": [
      {
        "rowRef": "SEL-001-PB20",
        "evaluationId": "evl-0000901",
        "action": "MULTI_OFFER",
        "reasonCode": "EXISTS_IN_MKP",
        "message": "Crear multioferta porque existe en Marketplace",
        "targetSku": "1000004812",
        "confidence": 1.0
      },
      {
        "rowRef": "SEL-001-PB10",
        "evaluationId": "evl-0000902",
        "action": "CONTINUE",
        "reasonCode": "NO_MATCH",
        "message": "Producto nuevo: se crea la propuesta",
        "targetSku": null,
        "confidence": 0.41
      },
      {
        "rowRef": "SEL-001-AUD7",
        "evaluationId": "evl-0000903",
        "action": "BLOCK",
        "reasonCode": "BRAND_BLOCKED",
        "message": "No se puede catalogar: la marca es de productos que comercializa Liverpool (1P o Mercaderías)",
        "targetSku": null,
        "confidence": null
      }
    ],
    "page": 1,
    "size": 500,
    "total": 3
  }
}

{
  "businesses": [
    "MER",
    "MKP",
    "SUB"
  ],
  "maxPerQuery": 5,
  "statuses": [
    "EN_REVISION",
    "CREACION_SKU",
    "EN_ENRIQUECIMIENTO",
    "APROBADO",
    "EN_MODIFICACION"
  ],
  "queries": [
    {
      "ref": "SEL-001-PB20",
      "ean": "7501234567893",
      "brandCode": "MARCA01"
    },
    {
      "ref": "SEL-001-PB10",
      "ean": "7501234500012",
      "brandCode": "MARCA01"
    }
  ]
}

{
  "success": true,
  "data": {
    "items": [
      {
        "ref": "SEL-001-PB20",
        "candidates": [
          {
            "productId": "PRD-0004812",
            "business": "MKP",
            "owner": {
              "type": "SELLER",
              "id": "SELLER-0004"
            },
            "status": "APROBADO",
            "sku": "1000004812",
            "lifecycle": "ACTIVO",
            "matchedOn": [
              "EAN",
              "MARCA"
            ]
          }
        ]
      },
      {
        "ref": "SEL-001-PB10",
        "candidates": []
      }
    ]
  }
}

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-FLU-05-1. Cada renglón pasa por la misma evaluación que el alta individual, en bloques de hasta 500 identificados por rowRef y con respuesta asíncrona (API-06-002 y EVALUATION_DONE): con los mismos datos, la misma decisión. Por qué: Si la masiva tuviera reglas propias, el seller recibiría respuestas distintas para el mismo producto. Se apoya en RN-MAS-03, DEC-56, RF-MAT-20.
• D-FLU-05-2. Cuatro reglas y en este orden: datos (formato, obligatorios y EAN, que revisa MS-02 en el archivo), lista negra, coincidencia por EAN con la marca como peso, y categoría por el mapeo de la plantilla (FT-CAT-03). Sin imagen, URL ni IA para crear; la IA llega después del SKU (FT-IA-05). Por qué: Enriquecer 450 renglones con IA antes de crearlos tardaría días y costaría de más; el orden es el del alta individual: lista negra antes que coincidencia. Se apoya en RN-MAS-05, DEC-61, DEC-57, RN-MAT-05.
• D-FLU-05-3. La evaluación de un renglón vale 24 horas y guarda con qué versión de reglas se hizo; si el seller confirma después o la lista negra cambió, MS-02 vuelve a evaluar sólo esos renglones antes de crearlos. Por qué: Entre revisar y confirmar puede pasar tiempo; no se puede crear con una lista negra vieja. Se apoya en RN-MAT-05, RF-MAS-07.
• D-FLU-05-4. Los renglones con coincidencia o vetados no se crean: su acción va al reporte con el texto de la tabla de decisión («crear multioferta porque existe en Marketplace», «… porque está en Liverpool», «no se puede catalogar», «EAN duplicado») y la multioferta se hace con FT-INT-05. Por qué: Con coincidencia no se crea SKU ni se enriquece; el reporte reemplaza al mensaje en pantalla. Se apoya en RF-MAS-07, DEC-39, RN-MAS-04.
• D-FLU-05-5. En la carga masiva la calificación se calcula después de crear las propuestas, en lotes de 100 (API-06-006), y no detiene la creación; cuenta para la publicación por rangos (FT-RAC-03) y el seller la ve con sugerencias para mejorarla. Por qué: Dos carreteras: el SKU no espera al contenido; la calidad decide la publicación, no la creación. Se apoya en PD-24, RN-CAL-08, RF-MAS-12.
• D-FLU-05-6. Mercaderías y Suburbia usan la misma carga y la misma evaluación, sin lista negra: sólo reglas de datos y coincidencia por EAN en su negocio, donde un EAN ya usado sale como «EAN duplicado», como hoy. Por qué: La lista negra protege el surtido de Liverpool de los sellers; aplicada a sus propios proveedores lo bloquearía. Se apoya en DUD-32, RF-MAT-01.

Qué falta decidir

También siguen abiertos: PEN-19, La regla de Suburbia para los renglones que coinciden sólo con Suburbia (aquí arranca en «no se puede»); PEN-22, Ratificar las bandas de confianza de la coincidencia por EAN y marca; PEN-47, Quién valida lo que la IA agrega después del SKU en productos de carga masiva.

Fuentes

1. [D] trazabilidad/features/FT-FLU-05-reglas-por-renglon-carga-masiva.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.