Manual de uso ← Ir a la herramienta
Placeholder Validator & Expander

Manual de uso

Esta herramienta permite validar, expandir y preparar archivos CSV de placeholders antes de subirlos a O9. El proceso se divide en 5 pasos guiados que aseguran que el archivo esté completo y correcto.

Contenido
Vista general

Flujo de 5 pasos

La herramienta guía al usuario por 5 pasos en orden. Cada paso se desbloquea automáticamente al completar el anterior. No es posible saltar pasos.

1
Subir archivo
Siempre
2
Expandir / Generar PHs
Condicional
3
File Name
Siempre
4
Validar
Siempre
5
Descargar
Si 0 errores
PasoAcciónCuándo se ejecuta
1Subir archivo CSVSiempre
2Seleccionar División y Temporada, expandir filas con OC > 1 y/o regenerar PHs inválidosSi hay filas con Options Count > 1, o si hay Placeholder IDs vacíos o con longitud distinta a 16 caracteres
3Rellenar columna File Name con el nombre del archivoSiempre
4Validar todos los campos contra reglas de O9Siempre
5Vista previa y descarga del CSV procesadoSolo si la validación no encuentra errores
Paso 1

Subir archivo

Arrastra el archivo CSV al área de carga o haz clic para buscarlo. El archivo debe cumplir las siguientes condiciones para ser aceptado.

Validaciones en carga
CondiciónQué pasa si falla
Extensión .csvRechaza el archivo con alerta
Separador punto y coma ;Alerta pidiendo re-exportar desde Excel con ;
Al menos 2 líneas (encabezados + datos)Alerta: archivo vacío
Al menos 1 fila de datos no vacíaAlerta: solo encabezados o filas vacías
Más de 1 columna detectadaAlerta pidiendo revisar el separador
Las 43 columnas del template presentesAlerta con lista de columnas faltantes
Encoding Si el archivo tiene caracteres mal codificados en UTF-8, la herramienta reintenta automáticamente con encoding macintosh (común en archivos exportados desde Excel en Mac).
Paso 2

Expandir y generar PHs

Este paso aparece cuando el archivo necesita procesamiento de Placeholder IDs. Se activa en dos escenarios distintos.

Escenario A — Expansión

Si alguna fila tiene Options Count mayor que 1, la herramienta expande esa fila en N copias. Cada copia recibe un nuevo Placeholder ID único y Options Count se establece en 1.

Valores divididos automáticamente

CampoLógica
Buying CashDividido entre N, 2 decimales, separador coma
Buying UnitsDividido entre N, redondeo hacia arriba
Wholesale ReservationDividido entre N, redondeo hacia arriba
Online ReservationDividido entre N, redondeo hacia arriba
Escenario B — Regeneración de PHs

Si no hay filas con OC > 1 pero existen Placeholder IDs vacíos o con longitud distinta a 16 caracteres, la herramienta solicita División y Temporada para regenerar solo los PHs que lo necesiten.

Regla de conservación

Los Placeholder IDs que ya tienen exactamente 16 caracteres se conservan intactos. Solo se regeneran los vacíos o inválidos.

Paso omitido automáticamente Si todas las filas tienen OC ≤ 1 y todos los PHs tienen 16 caracteres, este paso se marca como «No requerido» y se salta.
Límite por lote: 9.999 Placeholder IDs El formato de PH usa un contador de 4 dígitos (0001–9999). Si el archivo genera más de 9.999 IDs nuevos, la herramienta alerta y pide dividir el archivo en partes más pequeñas.
Paso 3

Agregar File Name

Rellena la columna File Name con el nombre del archivo sin la extensión .csv en todas las filas. Este paso siempre se ejecuta.

Ejemplo: si el archivo se llama Item_Plan_Woman_20260527.csv, el valor asignado será Item_Plan_Woman_20260527.

Paso 4

Validar

La herramienta verifica que todos los campos cumplan los requisitos de O9. Los errores se muestran agrupados por categoría. Si hay errores, no se puede continuar a la descarga.

Validaciones sobre el archivo original
CampoReglaNotas
Options Count Vacío, 1, o entero > 1 Valores como 0, negativos, decimales o texto son errores. Valores > 1 sin expandir generan un aviso.
Phase In Date dd/mm/aa o dd/mm/aaaa Además del formato, se valida que el mes esté entre 01–12 y el día entre 01–31. Ejemplo válido: 01/06/26 o 01/06/2026.
Global Phase-In Date dd/mm/aa o dd/mm/aaaa Mismas reglas que Phase In Date.
Proximity Nearshore, Farshore, o vacío Respeta mayúsculas exactas. nearshore o Near no son válidos.
Product Type Code No puede estar vacío Campo obligatorio.
PurchasingGroupId No puede estar vacío Campo obligatorio.
Validaciones sobre el archivo procesado (post-expansión)
CampoReglaNotas
Placeholder Exactamente 16 caracteres Aplica a todos los PHs del archivo final, incluyendo los generados por la herramienta.
Placeholder No vacío Toda fila debe tener un Placeholder ID tras el procesamiento.
Placeholder Sin duplicados Cada PH debe ser único dentro del archivo. Se indica la fila del duplicado.
Advertencias — campos recomendados

Además de los errores, la herramienta muestra advertencias si ciertos campos están vacíos. Estas advertencias no bloquean la descarga, pero los valores son necesarios para que el Placeholder sea válido en O9.

CampoTipo
Spanish Full PriceAdvertencia si vacío
Global Phase-In DateAdvertencia si vacío
Unitary CostAdvertencia si vacío
Buying UnitsAdvertencia si vacío
Wholesale ReservationAdvertencia si vacío
Online ReservationAdvertencia si vacío
Cluster NameAdvertencia si vacío
Transportation Lead TimeAdvertencia si vacío
Manufacturing Lead TimeAdvertencia si vacío
Estimated Count of StoresAdvertencia si vacío
Diferencia entre errores y advertencias Los errores bloquean la descarga y deben corregirse. Las advertencias permiten continuar, pero se recomienda revisar los campos antes de importar a O9.
Paso 5

Descargar

Si el archivo pasó todas las validaciones, se muestra una vista previa con las 43 columnas (primeras 50 filas) y el botón de descarga.

Nombre del archivo de salida
CasoSufijo
Se ejecutó expansión (OC > 1)_expanded.csv
Solo validación / regeneración de PHs_validated.csv
Formato de salida
PropiedadValor
Separador; (punto y coma)
EncodingUTF-8 con BOM
Columnas43 (mismas del template)
Referencia

Tipos de errores y advertencias

Los errores se dividen en dos categorías según el momento en que se detectan. Las advertencias no bloquean la descarga pero indican campos recomendados vacíos.

Errores de estructura

Se detectan al cargar el archivo (Paso 1). Bloquean la carga — el archivo no se procesa hasta corregirlos.

  • Archivo no es .csv
  • Separador incorrecto (coma en vez de punto y coma)
  • Archivo vacío o sin filas de datos
  • Columnas faltantes
Errores de datos

Se detectan en la validación (Paso 4). Bloquean la descarga — se debe corregir el archivo y volver a subirlo.

  • Options Count inválido
  • Campos obligatorios vacíos
  • Fechas con formato o rango incorrecto
  • Proximity con valor no permitido
  • Placeholder ID duplicado, vacío o con longitud incorrecta
Advertencias

Se detectan en la validación (Paso 4). No bloquean la descarga — el archivo se puede descargar, pero se recomienda revisar los campos antes de importar a O9. Se muestran agrupados por campo debajo de los errores o del banner de éxito.

Fechas y Excel Excel puede reformatear automáticamente las fechas al abrir un CSV. Si al guardar el formato cambia (por ejemplo de dd/mm/aa a dd-mm-aaaa), la validación fallará. Revisa el formato de celdas en Excel antes de guardar.
Referencia

Formato del Placeholder ID

Cada Placeholder ID tiene exactamente 16 caracteres. Se genera automáticamente a partir de la División, Temporada y un timestamp.

W División
26 Año (2 díg)
F Season
05 Mes
27 Día
18 Hora
30 Min
0042 Contador

División → Letra

DivisiónLetra
WomanW
ManM
KidsK
TeenT
HomeH

Season → Letra

TemporadaLetra
Spring/Summer (SS)S
Fall/Winter (FW)F

Contador

4 dígitos con relleno de ceros. Rango: 0001 a 9999. Se reinicia en cada ejecución de la herramienta.

Importante

Limitaciones y notas

Esta herramienta NO valida contra los masters de O9. Un archivo sin errores aquí puede seguir fallando al importar si algún valor (Product Type Code, PurchasingGroupId, etc.) no existe en los masters de la plataforma.
Limitaciones conocidas
LimitaciónDetalle
Validación de fechas Se valida formato, mes (1–12) y día (1–31), pero no combinaciones imposibles como 31/02 o 31/04. O9 rechazará esas fechas al importar.
Proximity case-sensitive Solo acepta Nearshore y Farshore con la primera letra en mayúscula. Variantes como nearshore o FARSHORE fallan.
PHs duplicados en O9 La herramienta valida unicidad dentro del archivo, pero no puede verificar si un PH ya existe en la plataforma O9.
Máximo 9.999 PHs por ejecución Limitación del formato de 4 dígitos del contador. Para archivos más grandes, dividir en lotes.
Funcionamiento offline La herramienta funciona 100% en el navegador. No envía datos a ningún servidor. Las fuentes tipográficas requieren conexión a internet para cargarse.