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:diagramersupertabla.png?600 |}}

El modelo de datos de la supertabla está compuesto por las siguientes tablas:

* **SFCOMERCIAL.DET_COMERCIAL**: Almacena el detalle de la carga, la cual contiene las configuraciones de generación de documentos.
  * **SFCOMERCIAL.MAE_COMERCIAL**: Almacena el encabezado de la carga y lanza el proceso de generación de documentos.
  * **SFCOMERCIAL.DET_COMERCIAL_DOCUMENTOS**: Almacena el registro de documentos generados en los procesos de carga siempre y cuando se utilicen los modos de ejecución [[#Implícito|Implícito]] y [[#Explícito|Explícito]].
  * **SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL**: Almacena las configuraciones de los conceptos los cuales definen los procesos que pueden ser generados en las cargas.
  * **SFCOMERCIAL.TIPOS_COMERCIAL**: Almacena las configuraciones de los tipos comerciales, los cuales son utilizados para extender configuraciones de los procesos de la supertabla. Esta tabla es necesaria ya que por compatibilidad de la funcionalidad no se pueden modificar las definiciones de las funciones y procedimeintos que componentes la interoperabilidad.

Estas tablas contienen la configuración de conceptos y de los procesos de carga cuando se utilizan invocaciones implícitas y explícitas.

===== Diccionario de Datos =====
La inteface [[#Supertabla|Supertabla]] esta soportada por el siguiente modelo de datos:

==== SFCOMERCIAL.DET_COMERCIAL ====

^OWNER |SFCOMERCIAL ^TABLE |DET_COMERCIAL ^COMMENTS |Almacena el detalle de la carga, la cual contiene las configuraciones de generación de documentos.|
^# ^NAME ^NULLEABLE ^TYPE ^COMMENTS ^^  
|1|CODIGO_CONCEPTO|N|VARCHAR2(50)|Código del concepto comercial que describe la configuración de generación de documentos.||
|2|VALOR|N|NUMBER(18,0)|Valor del proceso. el valor final dependerá de las asociaciones que se realicen con el concepto.||
|3|NIT|N|NUMBER|Número de identificación del tercero que se utilizará para la generación de documentos asociados al concepto||
|4|CCOSTOS|N|VARCHAR2(30)|Centro de costos que se utilizará para los procesos de causaciones contables.||
|5|FECHA_PAGO|N|DATE|Fecha que se utilizará para la generación de documentos asociados al concepto||
|6|CONSECUTIVO|N|NUMBER(10,0)|Código interno. Llave primaria del registro. Este campo es autoincrementado por la secuencia sfcomercial.seq_det_comercial en el trigger SFCOMERCIAL.TRG_INS_DET_COMERCIAL||
|7|CODIGO_COMERCIAL|N|NUMBER(10,0)|Código interno del encabezado, es el campo por el cual se asocian los procesos de carga con el encabezado.||
|8|NUMERO_DOCUMENTO|N|NUMBER(10,0)|Registra el número del documento que se utilizará en la generación de documentos principales y causaciones asociadas al concepto||
|9|VALOR2|Y|NUMBER(10,0)|Campo utilizado para procesamiento de ordenes de pago cuando se aplican varios beneficiarios||
|10|CONSECUTIVO_REF|Y|NUMBER(10,0)|Campo utilizado para relacionar números de documentos que aplica para la configuración del concepto (Ej: Causaciones, Ingresos)||
|11|NIT2|Y|NUMBER(12,1)|Campo utilizado para relacionar identificaciones de terceros que aplica para la configuración del concepto (Ej: Causaciones, Ingresos)||
|12|TIPO|N|VARCHAR2(4)|Indica el tipo comercial que aplicará para en los procesos de generación de documentos||
|13|SEQ|N|NUMBER(10,0)|Consecutivo interno manual utilizado para indicar orden de agrupamiento en los procesos configurados en el concepto||
|14|NOMBRE_TERCERO|Y|VARCHAR2(50)|Nombre del tercero. En caso que se requiera crear||
|15|NO_COMPROMISO|Y|NUMBER(10,0)|Indica el número de compromiso que se utilizará en el proceso de generación de documentos que afectan el presupuesto de gastos. Esta columna se debe ingresar de la siguiente forma [Vigencia-Consecutivo] Ejemplo 2021100 donde 2021 es la vigencia y 100 es el consecutivo||
|16|SEQ_REF|Y|NUMBER(10,0)|Este campo indica la asociación referente a la columna SEQ. Se utiliza para indicar cuando un registro está asociado con otro en la carga y en que orden se procesará||
|17|APELLIDO1|Y|VARCHAR2(20)|Primer apellido del tercero. En caso que se requiera crear||
|18|APELLIDO2|Y|VARCHAR2(20)|Segundo apellido del tercero. En caso que se requiera crear||
|19|NOMBRE1|Y|VARCHAR2(50)|Primer nombre del tercero. En caso que se requiera crear||
|20|NOMBRE2|Y|VARCHAR2(20)|Segundo nombre del tercero. En caso que se requiera crear||
|21|DIRECCION|Y|VARCHAR2(50)|Dirección del tercero. En caso que se requiera crear||
|22|TELEFONO|Y|VARCHAR2(50)|Teléfono del tercero. En caso que se requiera crear||
|23|CODIGO_CIUDAD|Y|VARCHAR2(10)|Código de la ciudad del tercero. En caso que se requiera crear||
|24|CODIGO_DEPARTAMENTO|Y|VARCHAR2(10)|Código del departamento del tercero. En caso que se requiera crear||
|25|TERCERO|N|CHAR(1)|Bandera que indica si se requiere crear un tercero. S:Sí, N:No||
|26|NO_OPAGO|Y|NUMBER(10,0)|Consecutivo de la orden de pago||
|27|NO_DISPONIBILIDAD|Y|NUMBER(10,0)|Indica el número de la disponibilidad que se utilizará en el proceso de generación de documentos que afectan el presupuesto de gastos. Esta columna se debe ingresar de la siguiente forma [Vigencia-Consecutivo] Ejemplo 2021100 donde 2021 es la vigencia y 100 es el consecutivo||
|28|VALOR_DESCUENTA_BASE|Y|NUMBER(18,0)|Contiene el valor que aplica para procesos de retencion en la fuente. Representa elvalor base de la causación.||
|29|NUMERO_CONTRATO|Y|VARCHAR2(30)|Utilizado para procesos de creación de contratos. Indica el número del contrato||
|30|DESCRIPCION_CONTRATO|Y|VARCHAR2(2000)|Utilizado para procesos de creación de contratos. Indica la descripción del contrato||
|31|FECHA_VENCIMIENTO|Y|DATE|Fecha de vencimiento del documento (Utilizado en proceso como Cuentas por Cobrar)||
|32|VALOR_IVA|Y|NUMBER(18,0)|Campo utilizado para indicar valores de iva en los procesos de causación||
|33|CANTIDAD|Y|NUMBER|Cantidad utilizada para procesos de facturación por defecto 1||
|34|USUARIO_EMPRESA|Y|VARCHAR2(30)|Usuario de conexión de la base de datos||
|35|CODIGO_BANCO|Y|VARCHAR2(8)|No utilizado - Código del banco utilizado para procesos de pagos y recaudos||
|36|NUM_CUENTA|Y|VARCHAR2(40)|No utilizado - Número de Cuenta Bancaria||
|37|TIPO_CUENTA|Y|VARCHAR2(2)|No utilizado - Tipo de Cuenta Bancaria||
|38|PORC_IVA|Y|NUMBER(5,3)|Campo utilizado para indicar el porcentaje de iva||
|39|CODIGO_MEMPRESA|Y|VARCHAR2(50)|Campo para registra el código de la empresa de la sesión que realiza la carga||
|40|VALOR_UNITARIO|Y|NUMBER(18,0)|Valor unitario utilizado para procesos de facturación por defecto 1||
|41|REFERENCIA|Y|VARCHAR2(256)|Campo utilizado para almacenar referencias del proceso||
|42|ANULADO|Y|VARCHAR2(1)|No utilizado - Indica estado de anulación de procesamiento para el registro asociado al concepto||
|43|FECHA_REGISTRO|Y|DATE|Fecha de registro del movimiento, es autoasignada por la base de datos por medio de la funcion sysdate||
|44|PORCENTAJE_REFERENCIA|Y|NUMBER|Porcentaje de referencia del proceso||
|45|COD_CONCEPTO_REF_CXC|Y|NUMBER|Concepto referencia (padre) del concepto de la cxc||
|46|PORCENTAJE_DISPERCION|Y|NUMBER|Captura el porcentaje de disperción en casos particulares de clientes||
|47|VALOR3|Y|NUMBER|Catura el valor que se usa en casos partiulares de clientes||

==== SFCOMERCIAL.MAE_COMERCIAL ====

^OWNER |SFCOMERCIAL ^TABLE |MAE_COMERCIAL ^COMMENTS |Almacena el encabezado de la carga y lanza el proceso de generación de documentos.|
^# ^NAME ^NULLEABLE ^TYPE ^COMMENTS ^^  
|1|CONSECUTIVO|N|NUMBER(10,0)|Campo incremental que indica el número de la carga||
|2|FECHA_REGISTRO|N|DATE|Fecha de registro del movimiento, es autoasignada por la base de datos por medio de la funcion sysdate||
|3|TIPO|N|VARCHAR2(4)|Indica el tipo comercial que aplicará para en los procesos de generación de documentos||
|4|DESCRIPCION|N|VARCHAR2(1000)|Descripción general asociada al proceso de generación de documentos||
|5|ESTADO|N|CHAR(1)|Estado del proceso de carga||
|6|FECHA_DOCUMENTO|N|DATE|Fecha general asociada al proceso de generación de documentos||
|7|TOTAL_REGISTROS|N|NUMBER(10,0)|Cantidad de registros que se procesarán en la carga||
|8|CODIGO_COMERCIAL|N|NUMBER(10,0)|Identificador interno de la carga, es la llave primaria y por medio de este campo se consulta del detalle de los registros que se procesarán para la generación de documentos||
|9|CODIGO_USUARIO_REGISTRA|Y|NUMBER(10,0)|Código del usuario sicof que realiza el proceso de carga (Este campo se llena cuando se invoca el proceso desde tesorería)||
|10|CODIGO_DEPENDENCIA|Y|NUMBER(10,0)|Código de la dependencia de la seseión iniciada en sicof cuando se realiza el proceso de carga (Este campo se llena cuando se invoca el proceso desde tesorería)||
|11|CODIGO_BANCO|Y|VARCHAR2(8)|No Utilizado - Indica el banco que se utilizará en el proceso de carga||
|12|FECHA_ANULACION|Y|DATE|No utilizado - Fecha en la que se diligenciarán procesos de anulación de la carga||
|13|CODIGO_MEMPRESA|Y|VARCHAR2(50)|Código de la empresa donde se realuza la carga, por defecto es '9999999999' sin embargo para el entorno multiempresa lleva la empresa en la cuál se inicio seisión en sicof||
|14|USUARIO_EMPRESA|Y|VARCHAR2(30)|Usuario de conexión de base de datos que realizará la carga||
|15|VIGENCIA|Y|NUMBER(4,0)|No utilizado -  vigencia del proceso de carga||
|16|VALOR_TOTAL|Y|NUMBER(10,0)|No utilizado - Total del proceso de carga||

==== SFCOMERCIAL.DET_COMERCIAL_DOCUMENTOS ====

^OWNER |SFCOMERCIAL ^TABLE |DET_COMERCIAL_DOCUMENTOS ^COMMENTS |Almacena el registro de documentos generados en los procesos de carga siempre y cuando se utilicen los modos de invocación [[#Implícito|Implícito]] y [[#Explícito|Explícito]].|
^# ^NAME ^NULLEABLE ^TYPE ^COMMENTS ^^  
|1|CODIGO_COMERCIAL|N|NUMBER(10,0)|Código interno del encabezado, es el campo por el cual se asocian los procesos de carga con el encabezado.||
|2|CODIGO_DOCUMENTO|N|NUMBER(10,0)|Identifica el tipo de documento financiero generado. Este campo se debe interpretrar de acuerdo al código de aplicación. Este valor está registrado en la tabla MAESTRO_DOCUMENTOS.CODIGO_DOCUMENTO||
|3|CODIGO_INTERNO_DOCUMENTO|N|NUMBER(10,0)|Contiene el código interno del documento financiero generado.||
|4|CODIGO_APLICACION|N|NUMBER(10,0)|Contiene el código de la aplicación en la cuál se generó el documento. Este valor está registrado en la tabla SICOF.MAE_APLICACIONES.CODIGO_APLICACION||
|5|CODIGO_ASIENTO|N|NUMBER(10,0)|Contiene el cóigo interno de la causación contable.||
|6|CODIGO_DET_COM_DOCUMENTO|N|NUMBER(10,0)|Identificador interno del registro, es la llave primaria. Este valor es generado por la secuencia sfcomercial.seq_det_com_documento||
|7|CONSECUTIVO|N|NUMBER(10,0)|Indica el orden de generación de documentos asociados al proceso de carga. En los procesos de carga única este campo tendrá valor cero (0)||
|8|CODIGO_MEMPRESA|Y|VARCHAR2(50)|Campo para registra el código de la empresa de la sesión que realiza la carga||
|9|USUARIO_EMPRESA|Y|VARCHAR2(30)|Usuario de conexión de base de datos que realizará la carga||
|10|FECHA_REGISTRO|Y|DATE|Fecha de registro del movimiento, es autoasignada por la base de datos por medio de la funcion sysdate||
|11|GENERE_DOC_REF|Y|VARCHAR2(1)|Indica si la carga referencia otros procesos de carga por defecto 'N'||

==== SFCOMERCIAL.MAE_CONCEPTOS_COMERCIAL ====

^OWNER |SFCOMERCIAL ^TABLE |MAE_CONCEPTOS_COMERCIAL^COMMENTS |Almacena las configuraciones de los conceptos los cuales definen los procesos que pueden ser generados en las cargas.|
^# ^NAME ^NULLEABLE ^TYPE ^COMMENTS ^^  
|1|CODIGO_CONCEPTO|N|VARCHAR2(50)|Código del concepto comercial, este valor debe ser único.||
|2|CODIGO_CONCEPTO_INGRESO|Y|NUMBER(10,0)|Código interno del concepto de cuentas por cobrar. Es utilizado para afectaciones del presupuesto de ingresos.||
|3|DESCRIPCION|N|VARCHAR2(50)|Descripción del concepto. Esta información es utilizada para identificar los procesos que aplican para el concepto.||
|4|TIPO|N|CHAR(1)|Indica el tipo de presupuesto es que afectado por el concepto. Los valores permitidos son I:Presupuesto de ingresos, G:Presupuesto de gastos.||
|5|CODIGO_PLANTILLA|Y|NUMBER(10,0)|Código interno de la plantilla contable que será utilizada para los procesos de causación contable que apliquen en la configuración del concepto.||
|6|CODIGO_RUBRO|Y|NUMBER(10,0)|Código interno del rubro del presupuesto de gastos.||
|7|CRUCE_CUENTAS|N|CHAR(1)|Indica si el conepto aplica para el proceso de cruce de cuentas. Este proceso sólo es utilizado en la versión del cliente Lotería de Medellín.||
|8|CODIGO_CONCEPTO_CONTABLE|Y|NUMBER(10,0)|Código interno del concepto de causación contable.||
|9|CODIGO_TIPO_CONTABLE|Y|NUMBER(10,0)|Código interno del tipo de causación contable.||
|10|CODIGO_ARTICULO|Y|NUMBER(10,0)|Código interno del artículo utilizado en los procesos de creación de compromisos en el presupuesto de gastos.||
|11|SIGNO|N|CHAR(1)|Indica el signo que se utilizará en el concepto en los procesos de asociaciones (+/-). Ejemplo para hacer descuentos en Ordenes de Pago||
|12|GENERA_DISPONIBILIDAD|N|CHAR(1)|Bandera que indica si el concepto genera disponibilidad. Pemite los valores S:Si, N:No||
|13|GENERA_COMPROMISO|N|CHAR(1)|Bandera que indica si el concepto genera compromiso. Pemite los valores S:Si, N:No||
|14|GENERA_OPAGO|N|CHAR(1)|Bandera que indica si el concepto genera ordenes de pago. Pemite los valores S:Si, N:No||
|15|GENERA_COMPROBANTE|N|CHAR(1)|Bandera que indica si el concepto genera comprombante de egreso. Pemite los valores S:Si, N:No||
|16|GENERA_FACTURA|N|CHAR(1)|Bandera que indica si el concepto genera cuentas por cobrar (factura). Pemite los valores S:Si, N:No||
|17|GENERA_INGRESO|N|CHAR(1)|Bandera que indica si el concepto genera comprobante de ingreso. Pemite los valores S:Si, N:No||
|18|CODIGO_INTERNO|N|NUMBER(10,0)|Código interno que representa la llave primaria del registro. Este valor es asignado por la secuencia sfcomercial.seq_mae_conc_comercial||
|19|BORRADO|N|CHAR(1)|Indica si el registro ha sido borrado (lógico). Pemite los valores S:Si, N:No||
|20|CODIGO_TIPO_DOC_DISP|Y|NUMBER(10,0)|Tipo de documento utilizado para la generación de disponibilidades. Este campo está asociado a la ruta del documento.||
|21|CODIGO_TIPO_DOC_COMP|Y|NUMBER(10,0)|Tipo de documento utilizado para la generación de compromisos. Este campo está asociado a la ruta del documento.||
|22|CODIGO_CONCEPTO_REF|Y|NUMBER(10,0)|Campo utilizado para generar asociaciones en las configuraciones de conceptos. Crea relaciones padre-hijo.||
|23|CODIGO_RUBRO_RESERVA|Y|NUMBER(10,0)|Código interno del rubro de reservas del presupuesto de gastos.||
|24|GENERA_PAGO|N|CHAR(1)|Bandera que indica si el concepto genera pagos. Pemite los valores S:Si, N:No||
|25|DESCUENTA_BASE|N|CHAR(1)|Bandera que indica si el concepto se utiliza para procesos de retenciones. Pemite los valores S:Si, N:No||
|26|CODIGO_DEPARTAMENTO|Y|NUMBER(10,0)|No utilizado. Código interno del departamento.||
|27|CODIGO_CIUDAD|Y|NUMBER(10,0)|No utilizado. Código interno de la ciudad.||
|28|ESTADO_DISPONIBILIDAD|Y|CHAR(1)|No utilizado. Indica el estado con el cual se generará la disponibilidad.||
|29|ESTADO_COMPROMISO|Y|CHAR(1)|No utilizado. Indica el estado con el cual se generará el compromiso.||
|30|USUARIO_EMPRESA|Y|VARCHAR2(30)|Usuario de conexión de la base de datos||
|31|CODIGO_MEMPRESA|Y|VARCHAR2(50)|Campo para registra el código de la empresa de la sesión que realiza la carga||
|32|ASOCIA_DOC|Y|NUMBER|Campo utilizado para agrupar detalles en los procesos de generación de ordenes de pago||
|33|CODIGO_TERCERO|Y|NUMBER|Campo para asiganar tercero para generacion de documentos cdp,rp,ce,op...etc.||
|34|FECHA_REGISTRO|Y|DATE|Fecha de registro del movimiento, es autoasignada por la base de datos por medio de la funcion sysdate.||
|35|TIPO_NUMERACION|Y|VARCHAR2(1)|Identifica si el concepto utiliza la numeracion (consecutivo) del encabezado (E) ó del detalle (D).||
|36|CE_IMPRIMIR_CHEQUE|Y|VARCHAR2(1)|Indica si el concepto es utilizado para la impresión de cheques (pago desde tesorería)||
|37|CODIGO_BANCO|Y|VARCHAR2(32)|Código interno del banco que se utilizará para procesos de pagos (egresos).||

===== 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|Implícito]] y [[#Explícito|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.

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

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página