esofitec. CoreDocs

esofitec. CoreDocs

Addons estándar / Módulo de cambio de tarifas desde compras / Visión general

Ficha técnica

Sit.Viv.Tar es un addon estándar de a3ERP que automatiza el mantenimiento de los precios de tarifa de venta de los artículos y, opcionalmente, la generación de códigos de barras EAN13. Este documento está dirigido a implantación y soporte: cubre la arquitectura, el modelo de datos, el funcionamiento interno, la instalación y el diagnóstico.

Identificación del addon#

Elemento Valor
Nombre comercial Módulo de cambio de tarifas desde compras
Nombre interno Sit.Viv.Tar
Código de artículo VRADDCTARIF
Diccionario DSIT_VIV_TAR

Alcance#

El addon cubre dos funcionalidades independientes que comparten pantalla de configuración:

  • Cálculo y actualización de tarifas de venta, que escribe en los tramos de tarifa (TARIFAVE) según el modo configurado en SIT_VIVT_CALCULO_PRECIO_VENTA (PrcCompra o PrcVenta).
  • Generación automática de EAN13, que registra el código en ALTERNA al guardar artículos de venta.

La operativa funcional —qué consigue el usuario, paso a paso y con capturas— está en la Visión general del portal de usuario.

Cómo encaja en a3ERP (y por qué)#

Casi todo el módulo es reactivo: no hay un proceso que el usuario arranque y observe, sino una DLL escuchadora registrada en a3ERP que actúa en los eventos de guardado. Cuando se guarda un artículo, un albarán de compra, un cliente o un documento de venta, la DLL decide si tiene que hacer algo según la configuración. Esto tiene una consecuencia práctica para soporte: el comportamiento depende de la configuración vigente y del evento concreto, no de una acción explícita del usuario, por lo que el diagnóstico empieza casi siempre por revisar SIT_VIVT_CONFIGURACION. El detalle de cada evento —cuándo se dispara, para qué y qué tablas y campos toca— está en Funcionamiento y eventos.

Dos cálculos pesados se delegan fuera de la DLL por motivos técnicos:

  • El cálculo de precios recomendados desde el albarán de compra lo hace un procedimiento almacenado (SIT_VIVT_CALCULA_PRC_RECOMENDADO), porque es trabajo de conjunto sobre las líneas del documento y se resuelve mejor en SQL.
  • La aplicación de tarifas (botón del rayo) y el recálculo masivo de todos los artículos los ejecuta un proceso externo (Sit.Viv.Tar.exe) a través del enlace NAX, porque escriben en a3ERP y necesitan el componente ActiveX/NAX.

Componentes#

Todo se despliega bajo Extensiones\Sofitec\Sit_Viv_Tar:

Componente Qué es y para qué
Diccionario DSIT_VIV_TAR Crea las tablas propias y los campos en tablas estándar, y despliega el procedimiento almacenado. Ver Modelo de datos
DLL Sit.Viv.Tar.Dll.dll Escuchadora de eventos, registrada en DLLS como Sit.Viv.Tar.Dll.Escuchador. Es el corazón reactivo del módulo. Ver Funcionamiento y eventos
Ejecutable Sit.Viv.Tar.exe Da servicio al recálculo masivo (menú) y a la aplicación de tarifas desde el albarán (botón del rayo)

Por dónde seguir#

  1. Instalación — requisitos, despliegue y validación.
  2. Modelo de datos — tablas, campos y el procedimiento almacenado.
  3. Funcionamiento y eventos — qué hace el módulo en cada evento y por qué.
  4. Errores conocidos y diagnóstico — limitaciones conocidas y cómo investigarlas.