Documentación completa del módulo de cereales - Calipso WAN

1. Introducción y descripción general

El Módulo de Cereales es una herramienta de software integrada en la aplicación Calipso WAN. Está diseñado para gestionar el ciclo completo de operaciones con cereales, cumpliendo con los requisitos de la ARCA (anteriormente AFIP). Este módulo permite a los usuarios interactuar con los servicios web oficiales para la gestión de Cartas de Porte Electrónicas (CPE) y Liquidaciones Primarias de Granos (LPG), lo que facilita el cumplimiento fiscal y operativo en el sector agroindustrial.

Las funciones principales del módulo son:

• Recibir Cartas de Porte electrónicas a través de los web services de ARCA.

• Gestionar los estados de las CPE y registrar el ingreso del cereal en el sistema.

• Generar liquidaciones de cereal después de calcular las retenciones correspondientes.

• Comunicar las liquidaciones a ARCA para obtener el Código de Operación Electrónica (COE).

2. Arquitectura del módulo

El módulo se compone de los siguientes elementos interrelacionados:

• Procedimiento público EVENTOS: Maneja los eventos que responden a las acciones del usuario, organizados por tipo de documento y acción.

• Componentes de CPE: Gestiona el ciclo de vida completo de las cartas de porte.

• Componentes de LPG: Maneja el proceso de liquidación de cereales, incluyendo los cálculos de retenciones y la comunicación con ARCA.

• Servicios Web: Interfaces que permiten la comunicación con los servicios de ARCA para validar, registrar y consultar operaciones.

3. Flujo de trabajo principal

El flujo de trabajo estándar en el Módulo de Cereales es:

1. Recepción/Alta de CPE: Se da de alta o se recibe una CPE a través de los servicios web de ARCA, y el sistema guarda la información en la base de datos local.

2. Gestión de estados de CPE: Los usuarios pueden confirmar, rechazar, desviar o registrar el arribo de una CPE. Cada cambio de estado se comunica a ARCA y se actualiza en la base de datos local.

3. Generación de liquidación: Una vez que el cereal ha sido ingresado, se calculan las retenciones y se genera una Liquidación Primaria de Granos.

4. Comunicación con ARCA: La liquidación se comunica a ARCA para obtener el COE como confirmación, y el sistema actualiza el estado de la operación.

4. Eventos y sus manejadores

El sistema utiliza tres eventos principales para gestionar las acciones:

1. appcontext_objectinit: Se ejecuta al inicializar objetos del modelo y se encarga de configurar propiedades iniciales, establecer permisos y configurar métodos disponibles.

2. appcontext_makeformfinal: Se ejecuta al crear un formulario para configurar su apariencia, establecer valores iniciales y preparar los controles.

3. appcontext_saveform: Se ejecuta al guardar un formulario para procesar la lógica de negocio, realizar validaciones y comunicar los cambios a ARCA cuando sea necesario.

5. Tabla de relaciones entre objetos y acciones

6. Flujo de ejecución

El sistema sigue un modelo de dos pasos para cada acción.

1. Configuración de formularios (appcontext_makeformfinal): Se dispara el evento, se evalúan las propiedades del objeto (como p("tipo").Value o campo("o1")) y se llama a la función de configuración (CTG_Config_form_* o Config_form_Liquidacion) correspondiente.

2. Procesamiento de formularios (appcontext_saveform): Se dispara el evento, se evalúan las propiedades del objeto, y se llama a la función de procesamiento (CTG_Config_Proceso_* o LPG_Proceso1) que ejecuta la lógica de negocio.

7. Liquidación primaria de granos (LPG)

• Configuración (o1=LIQUIDACION&o2=209): Se ocultan los campos no necesarios con Config_form_Liquidacion_OcultoCampos, y se configuran los campos específicos para la liquidación con Config_form_Liquidacion y LPG_ConfForms.

• Procesamiento: El proceso inicia con LPG_Proceso1. Posteriormente, LPG_Config_Proceso se encarga de la comunicación con ARCA, obtiene el COE y actualiza los datos en el sistema local.

8. Aspectos técnicos y configuración

• El módulo está desarrollado en Visual Basic y utiliza servicios web para comunicarse con ARCA.

• Requiere certificados digitales válidos, la configuración de parámetros fiscales (como CUIT) y acceso a Internet.

9. Integración con el sistema

El Módulo de Cereales se integra con otros componentes de Calipso WAN:

• Gestión de inventario: Actualiza los niveles de stock automáticamente al confirmar la recepción de cereales.

• Gestión financiera: Integra las liquidaciones con el sistema contable.

• Facturación: Facilita la emisión de facturas basadas en las liquidaciones.

• Reportes: Permite generar informes detallados sobre las operaciones con cereales.