Reglas de negocio - Ventas Netas

Objetivo

Documentar las reglas de negocio identificadas para el proceso Ventas Netas, aplicadas durante la construcción de la tabla Silver as4_netsales.

Alcance

Dentro del alcance

• Reglas de procesamiento por rango de fechas.
• Derivación de campos de negocio.
• Casteos aplicados a la fuente transaccional.
• Resolución de llaves contra catálogos y dimensiones migradas.
• Ajuste de ID_PLADIS.
• Separación de registros inválidos.
• Agregación de métricas.
• Generación de trazabilidad técnica.
• Estrategia de carga final por rango de fechas

Fuera del alcance

• Diseño funcional del proceso.
• Arquitectura técnica.
• Fuentes de datos detalladas.
• Flujo paso a paso del pipeline.
• Runbook operativo.
• Modelo de datos.
• Validaciones no documentadas.

Contenido principal

Descripción general

Este documento concentra las reglas de negocio identificadas para el proceso Ventas Netas, aplicadas durante la construcción de la tabla Silver as4_netsales.

Las reglas incluyen control del rango de procesamiento, derivación de CVE_PART, casteos de la fuente transaccional, resolución de producto, cliente, tipo de crédito y tipo de venta, recálculo de ID_PLADIS, separación de registros inválidos, agregación de métricas, trazabilidad y carga final mediante delete + insert.

Lógica de negocio

• El rango de procesamiento se controla por los widgets w_StartDate y w_EndDate, comparados contra FECPED/CVE_FECHA.
• CVE_PART se deriva de los primeros 6 caracteres de FECPED.
• La fuente as4_dctvtasn se transforma con casteos explícitos a DECIMAL, INT, STRING y DATE.
• Producto: se toma el registro más reciente de snw_dim_productos por ID_PRO usando ROW_NUMBER ordenado por FECHA_MODIFICA y CVE_PRO descendente.
• Cliente: se resuelve por NUMCTE + NUMSUC contra snw_dim_clientes.
• Tipo de crédito y tipo de venta se resuelven por TIPVTA normalizado con UPPER(TRIM()).
• ID_PLADIS se recalcula con base en ID_TIPDEP de snw_deposit:
  • Si ID_TIPDEP in (1,2) usa ID_PLADIS original.
  • Si ID_TIPDEP = 3 usa ID_PLADIS del depósito.
  • Si no, usa CVE_DEP.
• Se separan registros inválidos en vw_dctvtasn_error cuando CVE_CTE es nulo, CVE_PRO es nulo o ID_PLADIS <= 0.
• Se agregan cantidades, importes y KLT por las llaves definidas en vw_dctvtasn_final_agg.
• Se genera _row_hash con SHA2 sobre campos clave, además de _run_id y _load_ts.
• La carga final aplica delete + insert por CVE_FECHA en el rango de ejecución.

Consideraciones

Nota

No se agregan reglas adicionales a las listadas para la lógica de negocio del proceso.

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.
Operación - Ventas Netas	Documenta consideraciones operativas, Runbook L1 y soporte.
Pipelines - Ventas Netas	Describe la secuencia de ejecución del proceso.
Tablas - Ventas Netas	Documenta las tablas origen, dimensiones, campos, ralaciones y tabla final.
Validaciones - Ventas Netas	Describe validaciones identificadas.

Próximos pasos

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