Bases de datos

4. Bases de datos

Las bases de datos son hojas del libro con tablas de referencia. El sistema las consulta automáticamente al generar el F5, Confirmaciones y Activity. En las hojas de base de datos la primera fila siempre es el encabezado y los datos empiezan en la fila 2.

ℹ

Todas las hojas de base de datos tienen una columna Observaciones al final. Es una columna libre para que el equipo anote comentarios internos. El sistema la ignora completamente — nunca la lee ni la escribe.

db_genero Obligatoria

Convierte el valor de Subdivisión de la Chequera en el género que va en el F5 y en los campos de clasificación de la hoja Product Content del Activity.

subdivision	genero	act_pc_grupo_edad	act_pc_grupo_talla	act_pc_genero
Pijama Mujer	Dama	Adulto	Mujer	Femenino
Pijama Hombre	Caballero	Adulto	Hombre	Masculino
Pijama Juvenil Niña	Juvenil Niña	Adolescente	Jóvenes	Femenino
Pijama Juvenil Niño	Juvenil Niño	Adolescente	Jóvenes	Masculino
Pijama Niño	Niño	Niño	Niño	Masculino

• subdivision: prefijo del valor que llega en la Chequera. Búsqueda por prefijo — no hace falta una fila por temporada.
• genero: valor que aparece en la columna Género del F5.
• act_pc_grupo_edad: grupo de edad para Product Content del Activity (Adulto, Adolescente, Niño…).
• act_pc_grupo_talla: grupo de talla de ropa para Product Content (Mujer, Hombre, Jóvenes, Niño…).
• act_pc_genero: género que requiere el GOI del Comprador (Femenino, Masculino…).

ℹ

Usa búsqueda por prefijo. Si la chequera trae "Pijama Mujer Inv 2025", la clave "Pijama Mujer" lo atrapa. No hay que agregar una fila por cada temporada.

¿Cuándo agregar filas? Cuando el F5 muestre No definida en DB: db_genero / subdivision, o cuando el Activity muestre error en act_pc_grupo_edad / act_pc_grupo_talla / act_pc_genero. Ver qué valor trae la chequera en Subdivisión y agregar su prefijo con todos los campos de Activity.

db_operadora Obligatoria

Convierte el nombre de la operadora de la Chequera a su abreviatura para el F5, define el orden de aparición y aporta datos de configuración para el Activity.

formato_chequera	abreviatura_f5	orden	act_ti_num_negocio	act_ti_omitir_rasgos	act_ti_enviar_rasgos
Operadora A	OA	1	1	000009O000011O…	297
Operadora B	OB	2	5	000297O000011O…	9

• formato_chequera: valor exacto que llega en la columna de operadora de la Chequera.
• abreviatura_f5: la abreviatura que aparece en el F5.
• orden = 1 → se escribe primero en el F5; orden > 1 → después.
• act_ti_num_negocio: número de negocio del Comprador para la hoja Trade Item del Activity (ej. 1 = Operadora A).
• act_ti_omitir_rasgos: cadena de rasgos a omitir en Trade Item. Valor proporcionado por el Comprador para cada operadora.
• act_ti_enviar_rasgos: cadena de rasgos a enviar en Trade Item. Valor proporcionado por el Comprador.

¿Cuándo agregar filas? Cuando aparece ??? NO EN DB en la columna de operadora del F5. Para el Activity, cuando hay error No definida en DB: db_operadora / act_ti_num_negocio.

db_marcas Semi-opcional

Convierte el nombre completo de la marca en su abreviatura para el F5 y en el ID numérico que requiere el Comprador para el Activity.

brand_id	brand_desc	brand_abreviada
100001	Marca A	MA
100002	Marca A Jr	MA Jr
100003	Marca A Girls	MA G
100004	Marca A Teens	MA T
100005	Marca B	MB

• brand_id: ID numérico del Comprador. Lo usa el Activity para los campos Brand ID y Brand Code. Si no está, el Activity marcará error.
• brand_desc: nombre de la marca tal como llega en la Chequera (columna Brand Desc).
• brand_abreviada: abreviatura de 2-4 letras que aparece en la Descripción 1 del Artículo del F5.

ℹ

Si la marca no está en la tabla, el F5 usa automáticamente las primeras 2 letras del nombre (sin error rojo). Pero el Activity sí genera error si no encuentra el brand_id — por eso es importante tenerla registrada antes de generar el Activity.

db_tipo_marca Obligatoria

Convierte el tipo de marca (licencia, marca propia, etc.) al valor que va en el F5. También arma la Descripción UPC.

tipo_marca_chequera	valor_f5
Licencia	LIC
Marca Propia	MP
DTR	DTR

¿Cuándo agregar filas? Cuando el F5 muestre rojo en la columna de tipo de marca.

db_categoria Obligatoria

Convierte la descripción de categoría en el número de categoría que requiere el F5.

categoria_description	categoria_num
Pijama Set	7500
Bata	1900
Camison	9300
Pijama Pieza	9400
Mameluco	6100

¿Cuándo agregar filas? Cuando aparece No definida en DB: db_categoria / categoria_num en el F5.

db_set_tipo Obligatoria

Clasifica el tipo de prenda (Set Pant, Set Short, Camison, etc.) a partir del valor de la columna D3 de la chequera. El resultado va en la columna E del F5 ("Set Short o pantalon ?") y también alimenta las descripciones J y K.

valor_d3_chequera	valor_e_f5
Set Pant	Set Pant
Set Short	Set Short
Camisero	Camison
Camison	Camison
Bata	Bata
Mameluco	Mameluco
Pieza Suelta Pantalón	Pantalón
Sudadera	Sudadera

ℹ

Usa búsqueda por prefijo. La clave "Set Pant" atrapa "Set Pantalón ML Invierno Pesado" porque "set pant" es prefijo de "set pantalon" (tras normalizar acentos).

↕

Flujo de dos intentos: el sistema consulta primero esta tabla. Solo si no encuentra el valor, intenta automáticamente db_set_tipo_keywords. No hace falta duplicar reglas.

¿Cuándo agregar filas? Cuando llega un valor estructurado nuevo en D3 que no existe en la tabla (ej. "Mameluco", "Set Camisero ML").

db_set_tipo_keywords

Clasifica el tipo de prenda cuando la chequera no tiene columna D3 y en su lugar hay una descripción libre como "Playera ML & Pantalón Brush Simpsons". Detecta el tipo mediante palabras clave dentro de la descripción, sin importar la marca ni el estilo.

#### Estructura de la tabla

keyword1	keyword2	excluye	valor_e_f5
set	pant		Set Pant
set	camisero		Set Pant
playera	pant		Set Pant
camisero	pant		Set Pant
playera	short		Set Short
camisero	short		Set Short
pieza	pant		Pantalón
pieza	short		Set Short
sudadera			Sudadera
camisero		pant	Camison
camison		pant	Camison
bata			Bata

#### Cómo funciona el matching

• keyword1 Siempre: esta palabra debe estar en algún lugar del valor de la chequera.
• keyword2 Si no está vacía: esta segunda palabra también debe estar presente.
• excluye Opcional: si esta palabra está en el valor, la regla queda descartada.
• Gana la regla con más palabras coincidentes (mayor score). El orden de las filas en la tabla no importa para determinar el ganador.

#### Ejemplos de resolución

Valor en chequera	Regla que gana	Score	Resultado
Playera ML & Pantalón Brush Stitch	playera + pant	2	Set Pant
Camisero ML & Pant Brush Simpsons	camisero + pant	2	Set Pant
Camisero Casual	camisero (excluye pant, no aplica la de score 2)	1	Camison
Pieza Suelta Pantalón Brush Estampado	pieza + pant	2	Pantalón
Wabi Maxi Sudadera	sudadera	1	Sudadera
Set Camisero ML Invierno Pesado	set + camisero	2	Set Pant

#### Cómo agregar una regla nueva

Agrega una fila en la hoja db_set_tipo_keywords. No necesitas tocar ningún código.

Ejemplo: si llega "Conjunto Short Deportivo" y debe ser Set Short:

keyword1	keyword2	excluye	valor_e_f5
conjunto	short		Set Short

⚠

Si dos reglas tienen el mismo score (mismo número de keywords), gana la que esté primero en la tabla. Para evitar empates, siempre usa keyword1 + keyword2 para prendas compuestas y keyword1 + excluye para prendas simples.

db_colores Opcional

Normaliza el nombre del color que llega en la Chequera y lo clasifica en una categoría de color para el Activity.

color_origen	color_limpio	categoria_color
AMAR	AMARILLO	Amarillo
NARANJA	NARANJA	Anaranjado
SHEDRON	SHEDRON	Anaranjado
MARINO	MARINO	Azul
PLUMBAGO	PLUMBAGO	Azul

• color_origen: valor exacto que llega en la columna Color de la Chequera (puede ser abreviatura o nombre con caracteres extraños).
• color_limpio: nombre normalizado que va en el F5. Sin espacios ni caracteres especiales.
• categoria_color: categoría de color estándar que usa el Activity en la hoja Product Content (Amarillo, Azul, Rojo, Verde, etc.).

Si un color no está en la tabla, el sistema usa el valor crudo de la Chequera. No genera rojo en el F5, pero el Activity puede no poder asignar una categoría de color correcta.

db_upc Opcional

Asigna el UPC completo (13 dígitos) a cada combinación de modelo + color + talla. Cada talla tiene su propio UPC.

modelo	color	talla	upc_completo
MODELO-001	AZUL	TCH	7500000000001
MODELO-001	AZUL	TM	7500000000002
MODELO-001	AZUL	TG	7500000000003
MODELO-001	AZUL	TEG	7500000000004

⚠

Cada combinación modelo + color + talla debe ser única en la tabla. Si hay duplicados, el sistema toma el primero. La talla en esta tabla debe escribirse exactamente igual que en la Chequera (ej. TCH, TM, TCH EG).

Si no hay UPC en la tabla para esa combinación, el F5 usa los primeros dígitos fijos configurados en la columna Valor Definido de la fila Upc en map_f5. La celda queda en rojo si no alcanza los 13 dígitos, como recordatorio para completarla.

db_unspsc Activity — obligatoria

Usada exclusivamente por el Activity. Convierte el número de departamento (y en algunos casos el tipo de prenda) en el código UNSPSC que requiere la hoja Product Content, y en el nombre del departamento del Comprador que requiere Trade Item.

#### Estructura de la tabla

dep_num	categoria_description	unspsc_code	act_ti_num_departamento
30	(vacío)	53102600	CORSETERIA
27	(vacío)	53102600	CALCETAS DAMA
54	(vacío)	53102600	JUVENIL 12 - 16
33	(vacío)	53102600	NINAS
24	(vacío)	53102600	NINOS
26	(vacío)	53102600	BEBES
34	Playera	53101600	DAMAS
34	Sudaderas	53101700	(pendiente)
34	pantalon	53101500	(pendiente)

#### Cómo se usa

• Departamentos 30 / 27 / 54 / 33 / 24 / 26: todos comparten el mismo código UNSPSC. El sistema lo encuentra usando solo el número de departamento, sin importar el tipo de prenda. No es necesario llenar la columna categoria_description.
• Departamento 34: cada tipo de prenda tiene un código UNSPSC distinto. El sistema usa tanto el número de departamento como la categoría de la Chequera (columna H) para encontrar el código correcto. Si la categoría de la Chequera no tiene coincidencia en la tabla, el sistema lo reporta como error.

ℹ

La columna act_ti_num_departamento se usa para el campo Número de Departamento del Comprador de la hoja Trade Item. El resultado que aparece en el Activity es dep_num - nombre, por ejemplo 30 - CORSETERIA.

¿Cuándo agregar filas? Cuando aparezca No definida en DB: db_unspsc / act_pc_unspsc en el Activity. Agregar el número de departamento y, si es dep 34, también la categoría tal como aparece en la chequera.

db_fibra Activity — obligatoria

Usada exclusivamente por el Activity. Convierte las siglas textiles de la composición de tela (como CO, PES, EL, CV) en el nombre completo de la fibra que requiere la hoja Product Content.

sigla	nombre_fibra
PES	Poliéster
CO	Algodón
EL	Elastano
CV	Viscosa
PA	Nylon

La composición de tela se lee de db_composicion en formato "95%pes/5%el". El sistema la separa automáticamente, identifica las siglas y busca el nombre en esta tabla. El resultado va a las columnas de composición de la hoja Product Content.

¿Cuándo agregar filas? Cuando aparezca una sigla nueva que no esté en la tabla. El nombre correcto de la fibra lo indica el Comprador en su catálogo de fibras textiles.

db_composicion Obligatoria

Mapea el nombre del tipo de tela a su composición porcentual. Se usa como dropdown de selección en el F5 y Confirmaciones, y como fuente para el Activity al convertir composiciones a fibras.

tela	composicion
Brush	95%pes/5%el
Chalise	100% cv
Brush + Chalise	95%pes/5%el 100%cv
Poliester	100%pes
Chifón/Brush	50%co/50%pes 95%pes/5%el

• tela: nombre del tipo de tela tal como se usa internamente (puede ser el nombre comercial o la combinación de telas).
• composicion: cadena de composición en formato porcentual (95%pes/5%el). Para prendas con más de un tipo de tela, las composiciones se separan por espacios — el sistema las interpreta como secciones independientes.

ℹ

Las composiciones de esta tabla alimentan el dropdown que aparece al editar la celda de composición en el F5. El Activity luego toma esa cadena, la separa por siglas (PES, EL, CV…) y consulta db_fibra para obtener el nombre completo de cada fibra.

¿Cuándo agregar filas? Cuando llegue una nueva tela que no esté en el dropdown. Agregar el nombre de la tela y su composición en el formato estándar.

db_dropdowns Opcional

Define las listas de valores válidos para los dropdowns del F5 y del Activity: fábricas (Factory ID / Maquila), proveedores de tela y código de temporada.

factory_id	maquila	nombre_proveedor	act_ti_cod_temporada
36000001	Maquila Principal S.A. de C.V.	Tela A	1 - Spring
36000002	Maquila Secundaria S.A. de C.V.	Tela B	4 - Winter
36000003	Maquila C	Tela C	(vacío)
36000004	Maquila D	Tela D	(vacío)

• factory_id: código numérico del Comprador para la fábrica / maquilador. Aparece en el dropdown de Factory ID del F5.
• maquila: nombre completo de la empresa maquiladora. Se muestra junto al Factory ID en el dropdown.
• nombre_proveedor: nombre corto del proveedor de tela. Aparece en el dropdown de Proveedor de Tela de Confirmaciones.
• act_ti_cod_temporada: código de temporada para el Activity, en formato N - Nombre (ej. 1 - Spring, 4 - Winter). Si está vacío, esa fila no aparece en el dropdown de temporada del GOI.

¿Cuándo actualizar? Al agregar una fábrica nueva, cambiar el nombre de una maquila, incorporar un nuevo proveedor de tela, o cuando el Comprador actualice los códigos de temporada.

db_empaque Opcional

Contiene las dimensiones y peso de empaque por tipo de prenda y temporada. Se usa para rellenar las columnas de medidas de caja en el F5.

tipo_prenda	temporada	piezas_por_caja	longitud_dm	ancho_dm	alto_dm	peso_kg
Pijama Set Polar	Invierno	12	4.9	3.9	3.0	(vacío)

• tipo_prenda: tipo de prenda / categoría de empaque (ej. Pijama Set Polar, Bata, Camison).
• temporada: temporada a la que aplican estas dimensiones (Invierno, Verano…).
• piezas_por_caja: cantidad de prendas que entran en una caja master.
• longitud_dm, ancho_dm, alto_dm: dimensiones del empaque en decímetros.
• peso_kg: peso del empaque en kilogramos.

¿Cuándo actualizar? Cuando cambian las dimensiones de empaque o se incorpora un nuevo tipo de prenda con medidas diferentes.