Herramientas de usuario
ada:howto:sicoferp:factory:interface
¡Esta es una revisión vieja del documento!
Tabla de Contenidos
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. Esta rama esta registrada en el siguiente repositorio 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 | |
| 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 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
| Fecha | Versión | Estado | Notas de Versión |
|---|---|---|---|
| 23/04/2021 | 1.1 | Vigente | Tunnig |
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
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.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 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 y 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 y 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.
| TIPO1) | NOMBRE2) | MODOS3) | COMMENTS4) |
|---|---|---|---|
| PROCEDURE | SP_GENERE_PLANTILLA | E/I/S | Procedimiento para la causacion contable, recibe como parametro de salida el codigo del asiento y como parametros de entrada la descripcion, el codigo comercial, el usuario que registra, el consecutivo registrado en mae_comercial y el tipo de asiento que indica si es contrasiento a o no. Se adiciona el Plan Contable para el soporte de multiples planes contables. |
| PROCEDURE | SP_PLANTILLA_CAUSACION_DEB | E/I/S | Procedimiento que se encarga de realizar la causación débito de la plantilla |
| PROCEDURE | SP_PLANTILLA_CAUSACION_CRE | E/I/S | Procedimiento que se encarga de realizar la causación crédito de la plantilla |
| PROCEDURE | SP_PLANTILLA_CAUSACION_CRERET | E/I/S | Procedimiento que se encarga de realizar la causación de la retención |
| PROCEDURE | SP_PLANTILLA_CAUSACION_CRECON | E/I/S | Procedimiento que se encarga de realizar la causación de la retención contratista Art. 383 |
| PROCEDURE | SP_INSERTE_TEMP_DET_ASIENTO | E/I/S | Procedimiento para el registro de las cuentas con su valor debito o credito, recibe como parametro de salida el codigo de la cuenta contable, y como parametros de entrada el valor, el tercero, el centro de costos, el tipo de operacion (debito/credito), el tipo de cuenta(por pagar/por cobrar), el codigo del banco, el numero de documento referencia y el codigo de la plantilla |
| PROCEDURE | SP_INSERTE_TEMP_DET_ASIENTO | E/I/S | Sobrecarga para soportar version estandar |
| PROCEDURE | SP_INSERTE_TEMP_ASIENTO | E/I/S | Procedimiento para la generacion de aaientos contables, recibe como parametro de salida el codigo del asiento y como parametros de entrada la descripcion, el codigo comercial, el usuario que registra, el consecutivo registrado en mae_comercial y el tipo comercial registrado en mae_comercial |
| PROCEDURE | SP_GENERE_ASIENTO | E/I/S | Procedimiento para la causacion contable, recibe como parametro de salida el codigo del asiento y como parametros de entrada la descripcion, el usuario que registra, el numero del documento, el codigo del concepto y tipo contable |
| FUNCTION | FN_UPD_CPCOBRAR_FE | E/I/S | Proceso que prepara la cuenta por cobrar para procesos de factura electrónica |
| PROCEDURE | SP_INSERTE_TEMP_CPCOBRAR | E/I | Procedimiento para insertar los conceptos y terceros con los cuales se van a generar las cuentas por cobrar, recibe como parametro de salida el codigo de la cuenta por cobrar(fectura) y como parametros de entrada el codigo comercial, el codigo del usuario que registra, la descripcion y el consecutivo registrado en mae_comercial |
| PROCEDURE | SP_GENERE_CPCOBRAR | E/I/S | Procedimiento para la generacion de la cuenta por cobrar(factura), recibe como parametro de salida el codigo de la cuenta por cobrar y el codigo del documento y como parametros de entrada la descripcion, el usuario que registra |
| PROCEDURE | SP_APRUEBE_CPCOBRAR | E/I/S | Procedimiento para la aprobacion de la orden factura. Recibe como parametro de salida el codigo de la cuenta por cobrar y como parametro de entrada el numero de factura |
| PROCEDURE | SP_ANULE_CPCOBRAR | E/I/S | Este procedimiento anula una factura y recibe como parametros de entrada un consecutivo de documento, una descripción, la fecha de afectación, el usuario que anula la factura, el numero de factura a anular y como parametro de salida el codigo interno de la factura |
| PROCEDURE | SP_ANULE_CEGRESO | E/I/S | Este procedimiento anula una factura y recibe como parametros de entrada un consecutivo de documento, una descripción, la fecha de afectación, el usuario que anula la factura, el numero de factura a anular y como parametro de salida el codigo interno de la factura |
| PROCEDURE | SP_APRUEBE_DISPONIBILIDAD | E/I/S | Procedimiento para la aprobacion de disponibilidades y afectacion de rubros en presupuesto. Recibe como parametro de salida código de la disponibilidad |
| PROCEDURE | SP_APRUEBE_COMPROMISO | E/I/S | Procedimiento para la aprobacion de compromisos y afectacion de disponibilidades y rubros en presupuesto Recive como parametro de salida codigo del compromiso |
| PROCEDURE | SP_APRUEBE_OPAGO | E/I/S | Procedimiento para la aprobacion de la orden de pago y afectacion de compromisos. Recibe como parametro de salida codigo de la orden de pago |
| PROCEDURE | SP_INSERTE_TEMP_CEGRESO | E/I | Procedimiento para la generacion de comprobantes de egreso, recibe como parametro de salida el codigo del comprobante de egreso y como parametros de entrada la descripcion, el codigo comercial, el usuario que registra, el consecutivo registrado en mae_comercial y el tipo comercial registrado en mae_comercial |
| PROCEDURE | SP_GENERE_CEGRESO_03 | E/I/S | Procedimiento para la generacion del comprobante de egreso sin afectación presupuestal, recibe como parametro de salida el codigo del comprobante de eegreso y como parametros de entrada el usuario que registra el proceso |
| PROCEDURE | SP_GENERE_CEGRESO | E/I/S | Procedimiento para la generacion del comprobante de egreso,recibe como parametro de salida el codigo del comprobante de eegreso y como parametros de entrada el codigo de la orden de pago y el usuario que registra |
| FUNCTION | F_FIND_HOMOLOGACION | E/I/S | Devuelve la cuenta homologada |
| FUNCTION | F_AFECTACION_INGRESOS | E/I/S | Realiza la afectación de ingresos |
| FUNCTION | F_SALDOS_BANCOS | E/I/S | Realiza la actualización de saldos de bancos |
| PROCEDURE | SP_IMPRESION_CHEQUE | E/I/S | Procedimiento que realiza el pago de tesoreria |
| FUNCTION | F_IMCH00_INIT_PARAM | E/I/S | Inicializar los parametros para el proceso de impresion de cheques |
| PROCEDURE | SP_IMCH00_INIT_PARAM | E/I/S | Incializar los parametros general para lanzar cargas de supertabla |
| FUNCTION | F_IMCH01_VAL_PUC_BANCO | E/I/S | Realizar la validación del PUC de Bancos |
| FUNCTION | F_IMCH02_VAL_BANCO | E/I/S | Realiza las validaciones del banco |
| FUNCTION | F_IMCH03_UPD_CE | E/I/S | Actualiza el movimento del comprobante de egreso que agrupa con los movimientos que tiene cada comprobante del detalle |
| FUNCTION | F_IMCH04_UPD_CE_NOMINA | E/I/S | Actualiza el movimento del comprobante de egreso que agrupa con los movimientos que tiene cada comprobante del detalle |
| FUNCTION | F_IMCH05_DESC_OP | E/I/S | Devuelve el texto para la descripción del Pago |
| FUNCTION | F_IMCH06_GET_VALOR_CXP | E/I/S | Función que devuelve el saldo de los asientos asociados al egreso menor o igual a la fecha consultada |
| FUNCTION | F_IMCH07_SET_ASIGNE_CXP | E/I/S | Procesar la asignación de cuentas por pagar |
| FUNCTION | F_IMCH08_TOTAL_DOC_PUC | E/I/S | Devuelve el total por PUC |
| FUNCTION | F_IMCH09_VAL_EMBARGO_BANCO | E/I/S | Valida si hay embargos |
| FUNCTION | F_IMCH10_CUENTA_CCOSTOS | E/I/S | Valida si la cuenta aplica pocentro de costos |
| FUNCTION | F_IMCH11_AFECTE_RUBROS | E/I/S | Realiza la afectación del rubro del egreso |
| FUNCTION | F_IMCH12_UPD_DATE_CE_NOMINA | E/I/S | Actualiza la fecha en los egresos de nómina |
| FUNCTION | F_IMCH13_UPD_CE_EFECTUA_PAGO | E/I/S | Actualiza la afectación del rubro del egreso |
| FUNCTION | F_IMCH14_UPD_CE_EFECTUA_ANTICI | E/I/S | Esta funcion registra lo reecepcionado en tesoreria que son las equivalentes a la generacion de las cuentas por pagar en tesoreria |
| FUNCTION | F_IMCH15_UPD_PROCESO_PRESUPUES | E/I/S | Realiza la afectación presupuestal de la generacion de las cuentas por pagar en tesoreria |
| FUNCTION | F_IMCH16_UPD_INSERTE_RUBRO | E/I/S | Valida que el rubro se encuentre en el periodo que se va a actualizar si no se inserta |
| FUNCTION | F_IMCH17_SALDOS_CUENTAS_PPTO | E/I/S | Actualiza los saldos de presupuesto |
| FUNCTION | F_IMCH18_CAMBIA_ESTADO_CE | E/I/S | Cambia el estado del egreso |
| PROCEDURE | SP_INSERTE_TEMP_CINGRESO | E/I | Procedimiento para la generacion de comprobantes de ingreso, recibe como parametro de salida el codigo del comprobante de ingreso y como parametros de entrada la descripcion, el codigo comercial, el usuario que registra, el consecutivo registrado en mae_comercial y el tipo comercial registrado en mae_comercial |
| PROCEDURE | SP_GENERE_CINGRESO | E/I/S | Procedimiento para la generacion del comprobante de ingreso, recibe como parametro de salida el codigo del comprobante de ingreso y como parametros de entrada el codigo del tercero, la descripcion y el usuario que registra |
| PROCEDURE | SP_GENERE_REMISION_OP | E/I/S | Procedimiento que se encarga de generar la remisión de la Orden de Pago |
| PROCEDURE | SP_INSERTE_TEMP_OPAGO | E/I/S | Procedimiento para la generacion de ordenes de pago, recibe como parametro de salida el codigo de la orden de pago y como parametros de entrada la descripcion, el codigo comercial, el usuario que registra, el consecutivo registrado en mae_comercial y el tipo comercial registrado en mae_comercial |
| PROCEDURE | SP_RECEPCIONE_PEDIDO | E/I/S | Procedimiento para la generacion causacion contable, recibe como parametro de salida el codigo del documento y como parametros de entrada la descripcion, el usuario que registra, el consecutivo registrado en mae_comercial y el codigo del tercero |
| FUNCTION | F_GET_LOGMSG | E/I/S | Devuelve el estado de la variable de mensajes de log de procesos |
| FUNCTION | F_UPDATE_DESC_DOC | E/I/S | Actualiza la descripcion de los documentos hijo del documento generado |
| FUNCTION | F_MSG | E/I/S | Función de registro de mensajes |
| PROCEDURE | P_MSG | S | Procedimiento de registro de mensajes |
| PROCEDURE | P_CLEAR_MSG | S | Limpiar el array de mensajes |
| PROCEDURE | P_CLEAR_TMP_TABLE | S | Limpiar las tablas temporales |
| PROCEDURE | P_INIT_CONSTANTES | S | Limpiar las tablas temporales |
| PROCEDURE | P_BULK_MESSAGE_LOGGER | S | Registra en bloque los mensajes generados en un proceso |
| PROCEDURE | F_IS_CONTROLAR_CONSECUTIVO | S | Función que valida la badera de control de consecutivo |
| PROCEDURE | F_REG_COD_INTER_CARGA | S | Registra el código comercial del documento procesado |
| PROCEDURE | F_UPD_CONSEC_CARGA | S | Actualiza con los codigos internos de la carga con los consecutivos siguientes en la configuración |
| PROCEDURE | F_GET_LOG_MENSAJE | S | Devuelve la variable global de mensajes |
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 [3SFCOMERCIAL.DET_COMERCIAL|SFCOMERCIAL.DET_COMERCIAL] y [#SFCOMERCIAL.MAE_COMERCIAL|SFCOMERCIAL.MAE_COMERCIAL] pero se mantienen las mismas reglas de configuración y el resultado esperado es el mismo del modo anteior.
Modo de Ejecución Específico
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, en este modo el usuarioconfigura un archivo de texto el cual es configurado de acuerdo al tipo de proceso que se va a generar.
ada/howto/sicoferp/factory/interface.1643032232.txt.gz · Última modificación: 2022/01/24 13:50 por administraidor
Herramientas de la página
