Operación - Ventas brutas

Objetivo

Documentar los aspectos operativos del proceso NB_Silver_Ventas_Brutas, incluyendo su ejecución, dependencias identificadas y acciones básicas de revisión ante incidencias observadas durante la ejecución.

Alcance

Dentro del alcance

• Ejecución manual del notebook.
• Configuración de parámetros requeridos por el proceso.
• Identificación de dependencias operativas.
• Detección básica de fallos.
• Acciones iniciales de revisión.
• Escalamiento operativo.

Contenido principal

Descripción general

El proceso NB_Silver_Ventas_Brutas construye la tabla de hechos as4_fact_ventas en la capa Silver integrando las corrientes transaccionales NFD y APCXNVO, enriqueciéndolas con dimensiones y calculando métricas comerciales.

La ejecución se encuentra parametrizada mediante widgets y procesa un rango de fechas específico para actualizar la tabla as4_fact_ventas.

Informacion Operativa

Elemento	Valor
Nombre del proceso	NB_Silver_Ventas_Brutas
Qué hace	Construye staging y tabla de hechos de ventas brutas AS400 en Silver, enriquecida con dimensiones y métricas comerciales.
Workflow asociado	No identificado en los DBC entregados.
Capa objetivo	Silver
Tabla final	as4_fact_ventas
Plataforma de ejecución	Databricks
Tipo carga	Incremental por rango de fechas

Nota: Esta tabla representa los detalles operativos del proceso de NB_Silver_Ventas_Brutas, Runbook L1

Parametros de ejecución

El proceso requiere la configuración de los siguientes widgets:

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

Dependencias Operativas

Se identifican las siguientes dependencias para la ejecución del proceso.

Fuentes transaccionales

• Objeto
  • as4_mcterut
  • as4_mcten
  • as4_mlispren
  • as4_apcxnvo
  • as4_nfd
  • as4_mpro
  • as4_mrut
  • as4_adpdepc
  • as4_alpsigin

Dimensiones consumidas

• Objeto
  • snw_dim_clientes
  • snw_deposit
  • snw_dim_fuente
  • snw_dim_productos
  • v_dim_date_esp
  • snw_dim_canal
  • snw_dim_ejecutivos_vtas
  • snw_dim_tipo_venta
  • as4_dim_rutas
  • as4_dim_promo

Procedimiento de Ejecución Manual

1. Configurar parametros, capturar los valores requeridos para los widgets de ejecución:
   • w_StartDate
   • w_EndDate
   • w_catalog
   • w_schema origin
   • w_schema destiny
2. Ejecutar el notebook completo respetando la secuencia definida en el proceso.
3. Confirmar que la ejecución finalice sin errores.
4. Revisar que los objetos esperados sean generados durante la ejecución.
5. Confirmar que la tabla as4_fact_ventas haya sido actualizada para el rango procesado.

Detección de Fallos

Para una deteccion de fallos se establece que una revisión operativa puede considerar los siguientes puntos:

Validación	Descripción
Creación de ODS	Validar si falla la creación de ODS intermedios.
Actualización del staging	Validar que la tabla stg_ventas_ODS no se actualiza o no contenga información del rango procesado .
Actualización de la fact	Validar que as4_fact_ventas no refleje el rango reprocesado.

Acciones Básicas

Ante una incidencia, se recomienda realizar las siguientes revisiones:

1. Revisar los parámetros de ejecución.
2. Verificar la existencia y freshness de las dimensiones.
3. Validar la disponibilidad de las tablas fuente AS400.
4. Ejecutar nuevamente el rango afectado.

Escalamiento

Escalar a equipo de Ingeniería o Arquitectura de Datos cuando se presente alguna de las siguientes situaciones:

Situación	Acción
Falla de una dependencia maestra.	Escalar al equipo de Ingeniería o Arquitectura de Datos.
Cambio de esquema fuente	Escalar al equipo de Ingeniería o Arquitectura de Datos.
Inconsistencias en reglas de negocio	Escalar al equipo de Ingeniería o Arquitectura de Datos.

Consideraciones operativas

• El notebook mezcla rutas parametrizadas con referencias hardcodeadas a cat_master_alpura.sch_silver_layer y cat_master_alpura.sch_bronze_layer; esto debe considerarse en despliegues entre ambientes.
• El workflow no fue identificado dentro de los DBC exportados; por tanto, la orquestación exacta debe documentarse posteriormente en SharePoint o ADO.
• La frecuencia de ejecución no está declarada explícitamente en el notebook; solo se observa procesamiento incremental por rango de fechas.
• El proceso depende de que las dimensiones maestras ya estén disponibles y actualizadas antes de ejecutar la fact.
• La calidad del dato de IdDep requiere normalización explícita de caracteres anómalos ('?', '¿').

Nota

Este documento refleja únicamente los aspectos operativos identificados en el proceso NB_Silver_Ventas_Brutas.

Artefactos relacionados

Artefacto	Descripción
Diseño Funcional - Ventas_Brutas	Documenta la arquitectura funcional, componentes y dependencias del proceso.
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.
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.