Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Fábrica - Integraciones: Supertabla  ======
Esta sección esta dedicada al proceso de generación de documentos por medio de la interface Supertabla.

===== ¿Que es la Supertabla? =====
Es una interface en base de datos que permite la elaboración masiva de documentos financieros en SICOF ERP.

===== Historial de Versiones =====
A continuación se lista el historial de versiones para la rama principal de desarrollo la cual aplica para todos los clientes menos el cliente [[#Lotería de Medellín|Lotería de Medellín]]. Esta rama esta registrada en el siguiente repositorio [[http://adacsc.co:1443/svn/repository/ADA/SICOF/Documentos/Desarrollos/PowerBuilder/ScriptsDB/Branches/App/Financiero/22%20SUPERTABLA/Version%202.0
|SVN]].

^Fecha ^Versión ^Estado ^Notas de Versión^
|01/10/2021|2.4.5.1|Vigente|que se asigne por defecto el usuario para el campo TESORE01.COMPROBANTE_DE_EGRESO.CODIGO_USUARIO_APRUEBA_CONFI|
|07/09/2021|2.4.5|Obsoleta|Se expone configuración de CXC FE en los tipos comerciales|
|29/04/2021|2.4.4a|Obsoleta|Integración FE|
|27/03/2021|2.4.4|Obsoleta|Se incluye control de gestión de PAC|
|29/01/2021|2.4.3|Obsoleta|Se cambia la obtención de la vigencia a la fecha de presupuesto|
|27/03/2021|2.4.2|Obsoleta|Control de estado de documento en las cuentas por cobrar|
|27/03/2021|2.4.1|Obsoleta|Commit por corrección proceso de registro det_asientos_documento en la relación de 
|19/10/2020|2.1.2|Obsoleta|Proceso de Generación CE 03 e Impresión de Cheques|
|19/10/2020|2.1.1|Obsoleta|Proceso de Generación CE 03 e Impresión de Cheques|

==== Versión Lotería de Medellín ====
Actualmente existe una implementación especifica para el cliente Lotería de Medellín en el siguiente repositorio [[http://adacsc.co:1443/svn/repository/ADA/SICOF/Documentos/Desarrollos/PowerBuilder/ScriptsDB/Branches/App/Financiero/22%20SUPERTABLA/Version%202.0/ConfigClienteBENEDAN
|SVN]]. Este escenario se presenta porque el cliente requiere que la funcionalidad se ejecute los más optimizada posible en el backend de base de datos descartando nuevas implementaciones como:

* Validaciones
  * Controles en los procesos
  * Implementación de Logs

==== Nota Importante ====
Sólo las actualizaciones de estructuras como ALTER de Tablas, Triggers y nuevas funciones o precedimientos se deben sincronizar en la dos versiones (Estandar y Lotería de Medellín). Sin embargo, por ningún motivo se debe actualziar el paquete SFCOMERCIAL.PCK_CAUSACION sin los ajustes adaptados a cada versión ya que sin incompatibles.

===== Modelo de Datos =====

[[ada:howto:sicoferp:factory:interface:interfacemodelodatos|Modelo de Datos]]

===== API Interface en la Base de Datos =====
La supertabla hace uso de paquetes, procedimientos y funciones para la generación de documentos financieros los cuales se listan a continuación.

==== Consideraciones ====
Antes de empezar tenga presente las siguientes consideraciones:

* El alcance del API dependerá del modo de ejecución utilizado por lo tanto es posible que algunas funciones o procedimientos no se utilicen en la mayoria de procesos.
  * El registro en la tabla SFCOMERCIAL.DET_COMERCIAL_DOCUMENTOS sólo se llenará cuando se utilicen los [[#Modo de Ejecución Implícito|Modo de Ejecución Implícito]] y [[#Modo de Ejecución Explícito|Modo de Ejecución Explícito]]
  * Para comprensión del API se definen los siguientes códigos de representación para los modos de ejecución: **I:Implícito, E:Explícito, S:Especifico**. Estos códigos se utilizarán en la columna **MODOS** en la siguiente tabla.

==== SFCOMERCIAL.PCK_CAUSACION ====
Este es el paquete principal del API que soporta la interface contiene la mayoria de los procedimientos y funciones que realizan las generaciones de documentos financieros.

===== Modos de Ejecución =====
La interfaz supertabla permite ejecutarse de 3 formas las cuales han sido denominadas modos de ejecución y a continuación se listan:

==== Modo de Ejecución Implícito ====
Este es el modo tradicional de consumo. Es el utilizado por los usuarios del módulo de tesorería de SICOF ERP desde la opción TESORERIA/INTERFACE/Carga de Archivos, para la generación de documentos financieros. En este modo el usuario configura un archivo de texto el cual es generado de acuerdo al tipo de proceso que se va a ejecutar.

==== Modo de Ejecución Explícito ====
Este es el modo recomendado para las integraciones entre sistemas que afecten el módulo financiero SICOF ERP. Este proceso es similar al [[#Modo de Ejecución Implícito|Modo de Ejecución Implícito]] sin embargo en este modo no se genera un archivo, sino que se realizan inserciones en las tablas [[#SFCOMERCIAL.DET_COMERCIAL|SFCOMERCIAL.DET_COMERCIAL]] y [[#SFCOMERCIAL.MAE_COMERCIAL|SFCOMERCIAL.MAE_COMERCIAL]] pero se mantienen las mismas reglas de configuración de las tablas [[#SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL|SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL]] y [[#SFCOMERCIAL.TIPOS_COMERCIAL|SFCOMERCIAL.TIPOS_COMERCIAL]]. El resultado esperado es el mismo del modo anteior.

==== Modo de Ejecución Específico ====
Este modo de ejecución es utilizado para procesos avanzados y requiere dominio interno sobre los flujos de procesos de generación de documentos, este modo de ejecución es más rápido ya que no utiliza las configuraciones de los modos anteriores si embargo tampo almacena logs ni registros de eejcución. Solo es recomendado para procesos donde la generación de documentos es generada por procesos previamente definidos que no requieren intervención del usuario.

==== Tabla de referencia de los modos de ejecución ====
La siguiente tabla presenta las diferencias entre los modos de ejecución y otras conseideraciones que deben ser analizadas al momento de utilizar la interfaz supertabla:

^Modo de Ejecución^Implícito^Explícito^Específico^Notas^
^Configuración de Conceptos|X|X|N/A|[[#SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL|SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL]] |
^Log de Documentos generados|X|X|N/A|[[#SFCOMERCIAL.DET_COMERCIAL_DOCUMENTOS|SFCOMERCIAL.DET_COMERCIAL_DOCUMENTOS]] |
^Utilizado en Integraciones|N/A|X|X|Puede ser utilizado por otras aplicaciones.|
^Log de Procesos|X|X|X|[[#SFCOMERCIAL.DET_COMERCIAL_LOG|SFCOMERCIAL.DET_COMERCIAL_LOG]] |
^Log de Carga|X|X|X|Almacena logs de errores del sistema|

===== Alcance =====
La supertabla soporta para generación de los siguientes documentos financieros:

===== Limitaciones =====
La interfaz de supertabla al ser una funcionalidad soportada actualmente en la base de datos presenta las siguientes limitaciones que deben ser consideradas:

===== Guía de Uso para Integraciones =====
Para utilizar la interfaz de supertabla puede utilizar los siguientes pasos como referencia para implementaciones en los modos de ejecución [[#Modo de Ejecución Implícito|Implícito]] y [[#Modo de Ejecución Implícito|Explícito]]

- Identificar los documentos que va a generar la integración
  - Identificar el modo de ejeucción que va a ser utilizado
  - Identificar las configuraciones, según el modo de ejecución elegido
  - Generar las estructuras que almacenarán los datos de la carga que generará el proceso
  - Generar las estructuras de soporte para almacenar logs. Esto es necesario para poder ientificar que carga se está generando.

[[ada:howto:sicoferp:factory|←Volver atras]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página