Diseño funcional - DS_cuota

Objetivo

Documentar la funcionalidad del proceso NB_Silver_DS_Cuota tiene como objetivo transformar y enriquecer el archivo de cuotas de ventas mensuales (originalmente cargado en Bronze como tabla plana desde un archivo de cuota de abril 2026) hacia la capa Silver, generando la tabla as4_fact_vtas_cuota. Esta tabla consolidada integra dimensiones de canal, producto, grupo de cliente, depósito, tiempo y categoría/subcategoría, permitiendo el análisis de planes de ventas (litros, pesos y piezas) por canal, cliente, producto, plaza y depósito.

Alcance

El proceso NB_Silver_DS_Cuota contempla la transformación de información de cuotas de ventas desde la capa Bronze hacia la capa Silver para la generación de la tabla de hechos as4_fact_vtas_cuota.

• Capa origen: Bronze (sch_bronze_layer).
• Capa destino: Silver (sch_silver_layer).
• Catálogo: cat_master_alpura.
• Tabla fuente: cat_master_alpura.sch_bronze_layer.27_03_cuota_abril_2026.
• Tabla destino: cat_master_alpura.sch_silver_layer.as4_fact_vtas_cuota.
• Granularidad: Año, Mes, Canal, Grupo Cliente, Oracle, Producto y Plaza.
• Partición utilizada: CVE_PART, derivada del período Año-Mes.
• Período documentado: Abril 2026 (w_StartDate = 202604).

Dentro del alcance

• Lectura del archivo de cuotas cargado en Bronze.
• Enriquecimiento mediante dimensiones de canal, producto, grupo de cliente, depósito y tiempo.
• Incorporación de información de categoría y subcategoría.
• Identificación de clasificación frío/seco.
• Cálculo de la métrica PLAN_PIEZAS.
• Generación de la tabla as4_fact_vtas_cuota.
• Escritura particionada mediante CVE_PART.

Contenido principal

Descripción general

El proceso NB_Silver_DS_Cuota transforma un archivo de cuotas de ventas mensuales previamente cargado en Bronze hacia una estructura analítica en Silver. Durante la ejecución se realiza el enriquecimiento de la información mediante dimensiones de canal, producto, grupo de cliente, depósito, tiempo, categoría y subcategoría. Adicionalmente, se incorpora la clasificación frío/seco y se calcula la cuota planificada en piezas a partir de los litros y el factor de conversión del producto. El resultado final se almacena en la tabla as4_fact_vtas_cuota, particionada mediante el campo CVE_PART.

Flujo Funcional

1. Lectura de parámetros de ejecución.
2. Lectura de la tabla fuente de cuotas en Bronze.
3. Incorporación de información de canal.
4. Incorporación de información de grupo de cliente, depósito y tiempo.
5. Cálculo de PLAN_PIEZAS.
6. Incorporación de atributos de producto y clasificación frío/seco.
7. Incorporación de categorías y subcategorías.
8. Filtrado de registros con partición válida.
9. Escritura de la tabla final en Silver.

Entradas y salidas

Entradas

Entrada	Descripción
27_03_cuota_abril_2026	Archivo de cuota de ventas cargado en Bronze.
snw_dim_canal	Dimensión de canales de venta.
snw_dim_productos	Dimensión de productos.
snw_dim_grupo_cliente	Dimensión de grupos de cliente.
snw_deposit	Dimensión de depósitos.
v_dim_date_esp	Vista de dimensión de tiempo.
snw_dim_categoria	Dimensión de categorías.
snw_dim_subcategoria	Dimensión de subcategorías.
oon_fact_indi_vb_frios_secos	Indicador utilizado para clasificación frío/seco.

Parametros de ejecución

Parametro	Descripción
w_StartDate	Fecha inicial del rango de procesamiento: 202604.
w_EndDate	Fecha final del rango de procesamiento.
w_catalog	Catálogo utilizado durante la ejecución: cat_master_alpura
w_schema origin	Esquema origen utilizado por el notebook: sch_bronze_layer.
w_schema destiny	Esquema destino utilizado por el notebook: sch_silver_layer.

Salida final

Salida	Descripción
as4_fact_vtas_cuota	Tabla de cuotas de ventas enriquecida en capa Silver.

Particionamiento

La tabla final utiliza el campo CVE_PART, como clave de partición, la cual corresponde a una representación numérica derivada de año y mes.

Características Funcionales Identificadas

• La información de cuotas se obtiene desde la tabla 27_03_cuota_abril_2026 ubicada en la capa Bronze.
• La información es enriquecida mediante dimensiones de canal, producto, grupo de cliente, depósito y tiempo.
• Se incorporan atributos de categoría y subcategoría utilizando las dimensiones correspondientes.
• La clasificación frío/seco se obtiene mediante la consulta a oon_fact_indi_vb_frios_secos.
• La métrica PLAN_PIEZAS se calcula a partir de PLAN_LITROS y el factor de conversión del producto (FCONKL).
• Los registros son enriquecidos con información temporal mediante la vista v_dim_date_esp.
• Solo se consideran registros con valor válido en CVE_PART.
• La información final se almacena en la tabla as4_fact_vtas_cuota.
• La escritura de la tabla destino se realiza utilizando particionamiento por CVE_PART.

Dependencias Funcionales

El proceso NB_Silver_DS_Cuota enlista las siguientes dependencias como requeridas para la correcta ejecución del proceso:

• DIM_CATEGORIA → snw_dim_categoria
• DIM_SUBCATEGORIA → snw_dim_subcategoria
• snw_dim_canal (Bronze — migrada Snowflake)
• snw_dim_productos (Bronze — migrada Snowflake)
• snw_dim_grupo_cliente (Bronze — migrada Snowflake)
• snw_deposit (Bronze — migrada Snowflake)
• v_dim_date_esp (Gold — vista temporal)
• oon_fact_indi_vb_frios_secos (Silver)
• 27_03_cuota_abril_2026 (Bronze — carga manual)

La conclusion del proceso genera: as4_fact_vtas_cuota (Silver), el proceso detalla el uso del framework: NB_FRAMEWORK_LIBRARIES

Consideraciones

1. La tabla fuente utilizada corresponde a una carga manual del archivo de cuota.
2. El nombre de la tabla fuente se encuentra definido explícitamente en el notebook.
3. El proceso requiere que exista información válida en la dimensión de tiempo para el periodo procesado.
4. La salida del proceso corresponde a la tabla as4_fact_vtas_cuota en la capa Silver.

Nota

Este documento describe la funcionalidad identificada para el proceso NB_Silver_DS_Cuota. Los detalles de implementación técnica y transformación se documentan en el Diseño Técnico correspondiente.

Artefactos relacionados

Artefacto	Descripción
Diseño Técnico - DS_cuota	Documenta la arquitectura técnica, componentes y dependencias del proceso.
Fuentes - DS_cuota	Documenta las fuentes de información consumidos por el proceso.
Operación - DS_cuota	Describe los controles operativos y actividades de soporte del proceso.
Pipelines - DS_cuota	Describe la secuencia de ejecución y procesamiento de datos.
Reglas de Negocio - DS_cuota	Describe las reglas apliacadas durante la conformación de la dimensión.
Tablas - DS_cuota	Documenta las tablas origen, intermedias y destino involucradas.
Validaciones - DS_cuota	Documenta controles y validaciones asociados al proceso.

Próximos pasos

• Revisar si la segunda escritura en modo overwrite sin la cláusula replaceWhere corresponde al comportamiento esperado o si requiere una corrección en la implementación.