Diseño funcional - Ventas brutas

Objetivo

Documentar la funcionalidad del proceso NB_Silver_Ventas_Brutas, cuyo propósito es construir y mantener la tabla de hechos de ventas brutas de AS400 en la capa Silver, integrando dos corrientes transaccionales principales (NFD y APCXNVO), enriqueciendo con dimensiones operativas y calculando métricas comerciales, descuentos, kilos y proyecciones antes de persistir el resultado incremental en cat_master_alpura.sch_silver_layer.as4_fact_ventas.

Alcance

Dentro del alcance

• Limpieza de caché y parametrización de la ejecución mediante widgets.
• Construcción de objetos ODS intermedios requeridos por el proceso:
  • as4_mcterut_ODS
  • as4_mlispren_ODS
  • as4_apcxnvo_ODS
  • as4_nfd_ODS
  • as4_rutas_ODS
  • as4_promo_ODS
  • as4_alpsigin_ODS
  • stg_ventas_ODS
• Generación de dimensiones auxiliares internas del proceso.
  • as4_dim_rutas
  • as4_dim_promo
• Consolidación final incremental de la fact as4_fact_ventas por rango de fechas.

Contenido principal

Descripción general

El proceso NB_Silver_Ventas_Brutas tiene como finalidad consolidar la información de ventas brutas generada en AS400 para ponerla a disposición en la capa Silver. Para ello, integra dos corrientes transaccionales principales: NFD y APCXNVO, las cuales son enriquecidas mediante dimensiones operativas y de negocio.

Durante la ejecución se generan diversos objetos ODS, se construyen dimensiones auxiliares internas y se enriquecen ambas corrientes utilizando dimensiones operativas previamente disponibles.

Posteriormente, ambas corrientes son homologadas a una estructura común, consolidadas en un staging y persistidas de forma incremental en la tabla as4_fact_ventas mediante reproceso por rango de fechas.

Flujo funcional

1. Se crean widgets de parametrización y se capturan fechas y esquemas de origen y destino.
2. Se generan funciones auxiliares para el procesamiento.
3. Se construye as4_mcterut_ODS.
4. Se construye as4_mlispren_ODS.
5. Se construye as4_apcxnvo_ODS.
6. Se construye as4_nfd_ODS.
7. Se consolidan rutas para generar as4_rutas_ODS y as4_dim_rutas.
8. Se generan as4_promo_ODS y as4_dim_promo.
9. Se construye as4_alpsigin_ODS.
10. Se ejecutan enriquecimientos y cálculos para la corriente NFD.
11. Se ejecutan enriquecimientos y cálculos para la corriente APCXNVO.
12. Ambas corrientes son homologadas al mismo layout y se unen con unionByName para formar stg_ventas_ODS.
13. Se filtra la información por el rango de fechas recibido.
14. Se agrega la columna Origen = 'AS400'.
15. Se persiste la información en as4_fact_ventas mediante un proceso incremental basado en eliminación y reinserción del rango reprocesado.

Corrientes transaccionales

El proceso integra dos fuentes principales de ventas, cada una con características particulares:

Corriente NFD

• Se construye el objeto as4_nfd_ODS.
• Se realiza unión con as4_mpro.
• Se filtran productos cuya familia (NUMFAM) no se encuentre en (54, 96).
• Se realizan lookups a cliente, depósito, fuente, producto, fecha, ruta, canal y ejecutivo.
• Se calculan métricas derivadas relacionadas con mermas, descuentos, kilos y proyecciones.

Corriente APCXNVO

• Se construye el objeto as4_apcxnvo_ODS.
• Se utiliza información proveniente de as4_mlispren_ODS.
• Se recalcula el campo impbto.
• Se identifica la promoción mediante cve_promo.
• Se excluyen registros mediante anti-join con as4_alpsigin_ODS.
• Se realizan lookups a cliente, depósito, cliente-distribuidor, fuente, producto, fecha, ruta, canal, ejecutivo y tipo de venta.

Entradas y salidas

Entradas

Entrada	Descripción
Corriente NFD	Información transaccional proveniente de AS400.
Corriente APCXNVO	Información transaccional proveniente de AS400.
Dimensiones consumidas	Información utilizada para enriquecer la fact de ventas.
Parámetros de ejecución	Configuración utilizada durante el reproceso.

Parametros de ejecución

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

Salidas intermedias

Objeto	Descripción
as4_mcterut_ODS	ODS derivado de clientes activos.
as4_mlispren_ODS	ODS derivado de listas y precios.
as4_apcxnvo_ODS	ODS derivado de APCXNVO.
as4_nfd_ODS	ODS derivado de NFD.
as4_rutas_ODS	ODS utilizado para consolidación de rutas.
as4_promo_ODS	ODS utilizado para promociones.
as4_alpsigin_ODS	ODS utilizado para exclusiones.
stg_ventas_ODS	Staging consolidado previo a la fact final.

Salida final

Salida	Descripción
as4_fact_ventas	Tabla de hechos consolidada de ventas brutas.

Características Funcionales Identificadas

• Las corrientes NFD y APCXNVO son homologadas al mismo layout antes de su consolidación.
• La información final es enriquecida mediante dimensiones consumidas por el proceso.
• El staging consolidado corresponde a stg_ventas_ODS.
• El reproceso se encuentra acotado mediante un rango de fechas parametrizado.
• Se agrega el valor constante Origen = 'AS400' antes de persistir la información final.
• La actualización final de la fact se realiza mediante eliminación y reinserción del rango reprocesado.

Nota

Este documento describe el comportamiento funcional identificado a partir de la documentación analizada para el proceso NB_Silver_Ventas_Brutas.

Artefactos relacionados

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

Próximos pasos

No se identifican próximos pasos específicos dentro del alcance de este documento.