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).||

==== SFCOMERCIAL.TIPOS_COMERCIAL ====

^OWNER |SFCOMERCIAL ^TABLE |TIPOS_COMERCIAL^COMMENTS |Almacena las configuraciones espciales de procesos. Esta tabla es utilizada para extender las funcionalidaddes de generación de documentos ya que no se pueden modificar la definiciones de funciones y procedimiento por temas de compatibilidad.|
^# ^NAME ^NULLEABLE ^TYPE ^COMMENTS ^^  
|1|DATO|N|VARCHAR2(4)|Código de Tipo Comercial||
|2|DESCRIPCION|N|VARCHAR2(50)|Descripción del Tipo Comercial||
|3|SIGNO|N|CHAR(1)|Signo que puede ser utilizado en las agrupaciones que determinan la generación de un documento, tambien puede usado para procesos de causación.||
|4|TIPO_REFERENCIA|Y|VARCHAR2(4)|Referencia un tipo comercial padre||
|5|BORRADO|N|CHAR(1)|Estado del registro||
|6|DOCUMENTO_REFERENCIA|N|CHAR(1)|Indica si el documento generado es una referencia de otro tipo comercial||
|7|DOCUMENTO_ORIGINAL|N|CHAR(1)|Indica si el documento generado es el principal que genera el tipo comercial||
|8|USUARIO_EMPRESA|Y|VARCHAR2(30)|Usuario empresa que genera el registro||
|9|CODIGO_MEMPRESA|Y|VARCHAR2(50)|Código de la empresa que genera el registro||
|10|FECHA_REGISTRO|Y|DATE|Fecha del sistema||
|11|CI_TERCERO_AC|Y|VARCHAR2(1)|Determina si en el proceso de la causacion de lso ingreso se incluye el tercero en el encabezado||
|12|TRUNCAR_NIT|Y|VARCHAR2(1)|Indica si el proceso trunca el nit para la validaciones del proceso||
|13|NETGOLD|Y|VARCHAR2(1)|Utilizado para los procesos de Netgold||
|14|SEPARA_ASIENTO_DOCUMENTO|Y|VARCHAR2(1)|Separa los asientos por número de documento||
|15|ESTADO_DOCUMENTO|Y|VARCHAR2(64)|Utilizado para asumir estados de documentos||
|16|TIPO_DOCUMENTO_CXC|Y|NUMBER|Tipo de factura que puede generar una cuenta por cobrar||
|17|CODIGO_USUARIO_ELA_CXC|Y|NUMBER|Utilizado para indicar el usuario elaborador||
|18|CODIGO_USUARIO_APR_CXC|Y|NUMBER|Utilizado para indicar el usuario aprobador||
|19|CODIGO_DEPENDENCIA_CXC|Y|NUMBER|Utilizado para indicar la dependencia||
|20|CODIGO_CCOSTOS_DEFAULT|Y|NUMBER|Utilizado para indicar el centro de costos||
|21|CODIGO_TERCERO_DEFAULT|Y|NUMBER|Utilizado para indicar el tercero||
|22|CODIGO_APLICACION|Y|NUMBER|Utilizado para indicar el código de la aplicación||

===== 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|Almcacena 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