Operación - Ventas Netas

Objetivo

Documentar la información operativa del proceso Ventas Netas, incluyendo consideraciones de ejecución, trazabilidad, Runbook L1, acciones básicas y escalamiento para la generación de la tabla Silver as4_netsales.

Alcance

Dentro del alcance

• Consideraciones operativas del proceso NB_Silver_NetSales.
• Información de gobierno y trazabilidad asociada a la tabla final.
• Runbook L1 del proceso.
• Ejecución manual del notebook.
• Detección de fallos, acciones básicas y escalamiento.

Fuera del alcance

• Diseño funcional del proceso.
• Arquitectura técnica.
• Definición de fuentes de datos.
• Reglas de negocio.
• Configuración del pipeline.
• Validaciones no documentadas

Contenido principal

Descripción general

Este documento concentra la información operativa del proceso Ventas Netas, incluyendo consideraciones de ejecución, gobierno y trazabilidad , Runbook L1, detección de fallos, acciones básicas y escalamiento.

El proceso realiza una carga idempotente por rangos de fechas, eliminando primero registros as4_netsales por CVE_FECHA entre w_StartDate y w_EndDate, para después insertar el resultado procesado. No se identifica workflow, frecuencia, SLA ni notificaciones dentro del DBC.

Consideraciones Operativas

• La carga final es idempotente por rango de fechas porque primero elimina registros de as4_netsales por CVE_FECHA entre w_StartDate y w_EndDate y luego inserta el resultado.
• El DBC no define workflow asociado, frecuencia, SLA ni notificaciones.
• vw_dctvtasn_error se crea para detectar registros inválidos, pero el DBC no muestra persistencia de esta vista como tabla de errores.
• Si una dimensión migrada no tiene match, puede generar nulos o valores 0 en llaves críticas.
• El campo CVE_CTE se define como DECIMAL en la tabla, pero en el INSERT aparece casteado como STRING; se recomienda validad compatibilidad y comportamiento en Databricks.

Gobierno y Trazabilidad

• La tabla final incluye _row_hash calculado con SHA2 sobre campos clave.
• Se incluye _run_id por ejecución.
• Se incluye _load_ts con current_timestamp().
• El origen se marca como AS400 en la base.
• La documentación final deberá publicarse en SharePoint y actualizar el placeholder Documentación: {sharepoint_link} dentro de la celda del notebook.

Runbook L1

Campo	Valor
Nombre del proceso	NB_Silver_NetSales
Qué hace	Carga ventas netas Silver desde AS400, enriquece con catálogos migrados, depura, agrega métricas y publica as4_netsales.
Workflow asociado	No identificado en el DBC.
Frecuencia	No identificada en el DBC.
Ejecución manual	Ejecutar el notebook NB_Silver_NetSales con w_StartDate, w_EndDate, w_catalog, w_schema_origin y w_schema_destiny.
Cómo detectar fallo	Errores en vistas temporales, joins con dimensiones, delete/insert, nulos en CVE_CTE/CVE_PRO o ID_PLADIS <= 0.
Acciones básicas	Validar parámetros, conteo en as4_dctvtasn, existencia de dimensiones migradas y registros en vw_dctvtasn_error.
Escalamiento	Data Engineer L2 / Arquitecto de Datos.

Soporte y Escalamiento

El Runbook L1 establece como punto de escalamiento a Data Engineer L2 y Arquitecto de Datos

Artefactos relacionados

Artefacto	Descripción
Diseño Funcional - Ventas Netas	Describe el objetivo funcional, alcance y flujo funcional del proceso
Diseño Técnico - Ventas Netas	Documenta la arquitectura, modelo de datos y dependencias técnicas.
Fuentes - Ventas Netas	Documenta las fuentes de datos utilizadas por el proceso.
Pipelines - Ventas Netas	Describe la secuencia de ejecución del proceso.
Reglas de Negocio - Ventas Netas	Contiene las reglas aplicadas durante el procesamiento.
Tablas - Ventas Netas	Documenta las tablas origen, dimensiones, campos, ralaciones y tabla final.
Validaciones - Ventas Netas	Describe validaciones identificadas.

Próximos pasos

• Identificar workflow asociado al proceso.
• Definir frecuencia de ejecución.
• Definir SLA operativo
• Definir notificaciones del proceso
• Validar compatibilidad y comportamiento de CVE_CTE, ya que se define como DECIMAL en la tabla y aparece castado como STRING en el INSERT.
• Confirmar si vw_dctvtasn_error debe persistir como tabla de errores.