Skip to main content

Agrupación de Precios SPPD (alp_lista_sppd_groups_prices)


1. Descripción​

La función alp_lista_sppd_groups_prices actúa como una capa de agregación y consolidación analítica sobre el motor de precios alp_lista_sppd_precios. Su objetivo principal es agrupar clientes que comparten las mismas condiciones de precio final (monto neto, tipo de precio y unidad de medida) para un artículo y canal determinados.

Esta función resuelve el problema de cardinalidad en reportes masivos y cotizaciones comerciales: en lugar de devolver miles de filas idénticas cliente por cliente, comprime el resultado agrupando las cuentas separadas por comas o asignando la etiqueta especial TODO EL BLOQUE cuando el 100% de los clientes evaluados del canal tienen asignado exactamente el mismo precio.

Adicionalmente, incorpora un cruce maestro con el catálogo de artículos (alp_cat_inv_items) bajo la organización 'OMA', garantizando la persistencia de las descripciones, claves AS400 y unidades de medida incluso si un cliente o grupo no cuenta con un precio configurado (marcado explícitamente como Sin Precio).


2. Parámetros​

ParámetroTipoObligatorioValor por DefectoDescripción
p_canalTEXTSíN/ACanal de ventas a consultar (ej. 'AUTOSERVICIO', 'DETALLE'). Filtra el universo de clientes en mv_cat_oracle_clientes.
p_clientesTEXT[]No'{TODOS}'Arreglo de números de cuenta de clientes. Soporta:
  • 'TODOS': Evalúa la totalidad de los clientes del canal.
  • 'LIST_PRICE': Evalúa a todos los clientes omitiendo acuerdos SPPD (precio de lista).
  • ARRAY['100245', '100246']: Filtra un subconjunto específico de cuentas.
p_productoTEXTNoNULLCódigo maestro Oracle del artículo (item). Filtra la información técnica en inventarios y el precio.
p_fechaTEXTNoNULLFecha de referencia de vigencia en formato 'YYYY-MM-DD'.

3. Retorno​

La función retorna una tabla consolidada con las siguientes columnas:

CampoTipoDescripción
no_clienteTEXTCuentas agrupadas ('100245, 100246'), cuenta individual o la leyenda 'TODO EL BLOQUE' si la totalidad de clientes comparten el precio.
item_codeTEXTCódigo identificador Oracle del artículo.
item_code_as400TEXTCódigo histórico u homologado en AS400 (clave_anterior).
descriptionTEXTDescripción comercial del artículo.
price_typeTEXTClasificación del precio resultante: 'Precio Especial', 'Precio Normal' o 'Sin Precio'.
udmTEXTUnidad de medida del artículo (primary_uom_code o UDM de lista).
precioNUMERICPrecio final resultante tras la evaluación de reglas y acuerdos (nulo si es 'Sin Precio').

4. Flujo funcional​


5. Lógica de negocio​

5.1. Extracción de Metadatos de Inventario (alp_item)​

Se consulta la tabla alp_cat_inv_items filtrando estrictamente por la organización comercial OMA (Maestro de Artículos Oracle Cloud) y el artículo p_producto. De aquí se aseguran los metadatos oficiales del producto:

  • item
  • clave_anterior
  • description
  • primary_uom_code

5.2. Cruce y Manejo de Clientes sin Precio (alp_lista)​

Se obtiene el universo de clientes activos en mv_cat_oracle_clientes para el canal p_canal y el filtro p_clientes. Se realiza un LEFT JOIN con la función base alp_lista_sppd_precios. Si un cliente no cuenta con una lista de precios asignada o folio SPPD vigente:

  • Se preservan sus datos descriptivos mediante COALESCE con alp_item.
  • Se asigna el valor 'Sin Precio' en la columna price_type.
  • El campo precio permanece como NULL.

5.3. Agrupación y Ponderación (alp_mostrar)​

Mediante agregaciones relacionales:

  • Se contabiliza el total global de registros evaluados (total_all_reg).
  • Se agrupan los clientes que tienen idéntico precio, tipo de precio y artículo, concatenando sus números de cuenta con STRING_AGG(al.no_cliente::text, ', ' ORDER BY al.no_cliente::text).
  • Se calcula la cardinalidad de cada grupo (total_reg).

5.4. Regla de Bloque Unificado​

Para simplificar la visualización ejecutiva:

  • Si todos los clientes del universo analizado comparten el mismo precio (total_all_reg = total_reg), se sustituye la lista de números por el texto identificador 'TODO EL BLOQUE'.
  • Si existen variaciones, se muestra la lista explícita de cuentas que integran cada precio.

6. Catálogos, Vistas y Funciones Utilizadas​

ObjetoEsquemaTipoPropósito Operativo
alp_cat_inv_itemsgeneral_catalogsTablaMaestro de artículos de inventario de Oracle Fusion (organización OMA).
mv_cat_oracle_clientesgeneral_catalogsVistaCatálogo maestro consolidado de cuentas de clientes por canal.
alp_lista_sppd_preciosgeneral_catalogsFunciónMotor central de cálculo de precios y acuerdos SPPD por cliente.

7. Consideraciones Técnicas​

Rendimiento y Buenas Prácticas
  • Dependencia de Producto: Dado que alp_item realiza un filtro directo sobre acii.item = p_producto, la consulta espera un código de producto válido. Si el parámetro p_producto es nulo o no existe en la organización OMA, él CROSS JOIN descartará los registros retornando un conjunto vacío.
  • Homologación de Tipos de Datos: El cruce entre la vista de clientes y el motor de precios castea explícitamente c.numero_cuenta_cliente::int = p.no_cliente, asegurando compatibilidad con los tipos de datos internos.
  • Reducción de Payload de Red: Al agrupar cuentas masivas en un solo registro con STRING_AGG o 'TODO EL BLOQUE', se reduce drásticamente el volumen de datos transferido hacia aplicaciones cliente o microservicios.

8. SQL​

CREATE OR REPLACE FUNCTION general_catalogs.alp_lista_sppd_groups_prices(p_canal text, p_clientes text[] DEFAULT '{TODOS}'::text[], p_producto text DEFAULT NULL::text, p_fecha text DEFAULT NULL::text)
RETURNS TABLE(no_cliente text, item_code text, item_code_as400 text, description text, price_type text, udm text, precio numeric)
LANGUAGE plpgsql
AS $function$

begin
return query
with alp_item as
( select acii.item
, acii.clave_anterior
, acii.description
, acii.primary_uom_code
from alp_cat_inv_items acii
where acii.org_code = 'OMA'
and acii.item = p_producto)
, alp_lista as
( select c.numero_cuenta_cliente no_cliente
, coalesce(p.item_code,ai.item) item_code
, coalesce(p.item_code_as400,ai.clave_anterior) item_code_as400
, coalesce(p.description,ai.description) description
, coalesce(p.price_type,'Sin Precio') price_type
, coalesce(p.udm,ai.primary_uom_code) udm
, p.precio
from mv_cat_oracle_clientes c
left join general_catalogs.alp_lista_sppd_precios(p_canal,p_clientes,p_producto,p_fecha) p
on c.numero_cuenta_cliente::int = p.no_cliente
cross join alp_item ai
where c.desc_canal_tipo_cuenta = p_canal
and ('TODOS' = ANY(p_clientes::text[])
or 'LIST_PRICE' = ANY(p_clientes::text[])
or c.numero_cuenta_cliente::text = ANY(p_clientes::text[]))
group by c.numero_cuenta_cliente
, coalesce(p.item_code,ai.item)
, coalesce(p.item_code_as400,ai.clave_anterior)
, coalesce(p.description,ai.description)
, coalesce(p.price_type,'Sin Precio')
, coalesce(p.udm,ai.primary_uom_code)
, p.precio)
, alp_mostrar as
( select ( select count(*)
from alp_lista) total_all_reg
, count(*) total_reg
, string_agg
( al.no_cliente::text
, ', ' order by al.no_cliente::text) clientes
, al.item_code
, al.item_code_as400
, al.description
, al.price_type
, al.udm
, al.precio
from alp_lista al
group by al.item_code
, al.item_code_as400
, al.description
, al.price_type
, al.udm
, al.precio)
select case
when am.total_all_reg = 1 then am.clientes
when am.total_all_reg = am.total_reg then 'TODO EL BLOQUE'
else am.clientes
end clientes
, am.item_code
, am.item_code_as400
, am.description
, am.price_type
, am.udm
, am.precio
from alp_mostrar am
order by total_reg;

end;
$function$
;