Muestra las diferencias entre dos versiones de la página.
| Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
|
ada:sicoferp:financiero:contabilidad:maestros:terceros [2024/06/04 15:56] 192.168.175.136 |
ada:sicoferp:financiero:contabilidad:maestros:terceros [2026/05/08 19:55] (actual) brahian.castaneda |
||
|---|---|---|---|
| Línea 14: | Línea 14: | ||
| ===== Pestaña: Encabezado ===== | ===== Pestaña: Encabezado ===== | ||
| - | |||
| - | {{:ada:sicoferp:financiero:contabilidad:maestros:det_encabezado_tercero.png?600|}} | ||
| {{:ada:sicoferp:financiero:contabilidad:maestros:maestro_terceros_005.png?600|}} | {{:ada:sicoferp:financiero:contabilidad:maestros:maestro_terceros_005.png?600|}} | ||
| Línea 52: | Línea 50: | ||
| - Los **NOMBRES Y APELLIDOS** siembre tienen que ir en **MAYUSCULA** sostenida. | - Los **NOMBRES Y APELLIDOS** siembre tienen que ir en **MAYUSCULA** sostenida. | ||
| - El campo NOMBRE_COMPLETO **NO** se diligencia, este lo realiza el sistema cuando se realiza la carga. | - El campo NOMBRE_COMPLETO **NO** se diligencia, este lo realiza el sistema cuando se realiza la carga. | ||
| - | - El código de la ciudad es **001**, tener presente que se debe ingresar con los ceros a la izquierda. | + | - El código de la ciudad de Medellín **CODIGO_CIUDAD** es **001**, tener presente que se debe ingresar con los ceros a la izquierda. Consulte los códigos de los municipios [[https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2007/Codigos_municipios_2007.pdf|aquí]].(Tener presente, que los primeros dos dígitos corresponden al código del departamento, por lo cual en el archivo de Excel solo se diligencian los últimos 3 dígitos correspondientes al municipio). |
| - | - El código de la ciudad es **05**, tener presente que se debe ingresar con los ceros a la izquierda. | + | - El código del departamento de Antioquia **CODIGO_DEPARTAMENTO** es **05**, tener presente que se debe ingresar con el cero a la izquierda. Consulte los códigos de departamentos [[https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2012/departamentos_2012.pdf|aquí]]. |
| - Solo se pueden cargar dos tipos de documentos **cedula y tarjeta de identidad**. | - Solo se pueden cargar dos tipos de documentos **cedula y tarjeta de identidad**. | ||
| * 1 cedula | * 1 cedula | ||
| Línea 63: | Línea 61: | ||
| - El campo de la columna **X** siempre va **vacío**. | - El campo de la columna **X** siempre va **vacío**. | ||
| - El campo de la columna **Y** **(TIPO_DE_VINCULO)** siempre va **11**. | - El campo de la columna **Y** **(TIPO_DE_VINCULO)** siempre va **11**. | ||
| - | - Los campos de las columnas **Z,AA,AC,AD,AE** siempre van a ir en **blanco**. | + | - Los campos de las columnas **Z,AA,AC,AD,AE** Pueden ir en **blanco**, sin embargo si se requiere subir uno de estos datos, se puede diligenciar en el formato. |
| - | - El campo de la columna AB **(ESTADO)** siempre va ir A mayúscula. | + | - El campo de la columna AB **(ESTADO)** siempre va a ir **A** mayúscula. |
| - El campo TELEFONO – CELULAR en ambos se ingresa el mismo numero indicado por el usuario. | - El campo TELEFONO – CELULAR en ambos se ingresa el mismo numero indicado por el usuario. | ||
| - Es necesario para la creación, mínimo un nombre y un apellido y se ingresan debidamente en el campo APELLIDO 1 y NOMBRE 1. | - Es necesario para la creación, mínimo un nombre y un apellido y se ingresan debidamente en el campo APELLIDO 1 y NOMBRE 1. | ||
| Línea 71: | Línea 69: | ||
| - Este es el archivo en Excel **"Estructura"** a diligenciar [[http://10.1.20.89/lib/exe/fetch.php?media=ada:sicoferp:financiero:contabilidad:maestros:estructura_carga_de_terceros.xlsx|Estructura_carga_de_terceros.xlsx]] | - Este es el archivo en Excel **"Estructura"** a diligenciar [[http://10.1.20.89/lib/exe/fetch.php?media=ada:sicoferp:financiero:contabilidad:maestros:estructura_carga_de_terceros.xlsx|Estructura_carga_de_terceros.xlsx]] | ||
| - Inicialmente deben guardar el archivo como **TEXTO DELIMITADO POR TABULACIONES** {{ :ada:sicoferp:financiero:contabilidad:maestros:guardar_archivo.png?600 |}} | - Inicialmente deben guardar el archivo como **TEXTO DELIMITADO POR TABULACIONES** {{ :ada:sicoferp:financiero:contabilidad:maestros:guardar_archivo.png?600 |}} | ||
| - | - Se deben dirigir a la ruta del maestro de tercero, solo que se ingresa por la opción CARGA, Siguiendo las indicaciones que se enumeran en la imagen. {{ :ada:sicoferp:financiero:contabilidad:maestros:carga_archivo.png?600 |}} | + | - Se deben dirigir a la ruta del maestro de terceros, y se pasa directamente a la opción de **CARGA**, Siguiendo las indicaciones que se enumeran en la imagen. {{ :ada:sicoferp:financiero:contabilidad:maestros:carga_archivo.png?600 |}} |
| - Cuando se cargue el archivo se va a visualizar el siguiente mensaje. Dan clic en aceptar. {{ :ada:sicoferp:financiero:contabilidad:maestros:validacion_carga.png?600 |}} | - Cuando se cargue el archivo se va a visualizar el siguiente mensaje. Dan clic en aceptar. {{ :ada:sicoferp:financiero:contabilidad:maestros:validacion_carga.png?600 |}} | ||
| - | - Por último, se da clic en la opción guardar y el sistema va informar que los terceros fueron creados de manera exitosa. {{ :ada:sicoferp:financiero:contabilidad:maestros:ejecucion_de_carga.png?600 |}} | + | - Por último, se da clic en la opción **Cargar** y el sistema va informar que los terceros fueron creados de manera exitosa. {{ :ada:sicoferp:financiero:contabilidad:maestros:ejecucion_de_carga.png?600 |}} |
| + | ===== Limpieza Automática de Datos en maestro_terceros ===== | ||
| + | 📝 Metadatos del Documento | ||
| + | |||
| + | Componente: Base de Datos (Oracle 11g) | ||
| + | |||
| + | Objeto: Trigger trg_clean_maestro_terceros | ||
| + | |||
| + | Tabla Afectada: maestro_terceros | ||
| + | |||
| + | Autor/Responsable: Miguel Muñoz | ||
| + | |||
| + | Fecha de Implementación: 08 de Mayo de 2026 | ||
| + | |||
| + | === 🎯 1. Objetivo y Contexto del Cambio === | ||
| + | El objetivo de este desarrollo es garantizar la calidad e integridad de los datos almacenados en la tabla maestro_terceros. Frecuentemente, la captura de datos (copiar/pegar desde Excel, correos o entradas directas de usuario) introduce caracteres no visibles como saltos de línea (Enters) o espacios en blanco adicionales. | ||
| + | |||
| + | Estos caracteres ocultos generan comportamientos anómalos en el frontend, descuadres en la generación de reportes y problemas en integraciones con otros módulos (como facturación, inventario o contabilidad). Este trigger intercepta la transacción de base de datos para sanear la información de forma transparente antes de que se persista. | ||
| + | |||
| + | === ⚙️ 2. Especificaciones Técnicas === | ||
| + | |||
| + | Tipo de Trigger: BEFORE INSERT OR UPDATE | ||
| + | |||
| + | Nivel: FOR EACH ROW | ||
| + | |||
| + | Estrategia de Rendimiento: Se optó por el uso anidado de funciones nativas de cadena (TRIM y REPLACE) en lugar de expresiones regulares (REGEXP_REPLACE) para minimizar el consumo de CPU durante operaciones masivas (DML) típicas en maestros de terceros. | ||
| + | |||
| + | Prevención de Errores: Se incluyen validaciones IS NOT NULL previas a la manipulación para evitar procesamiento innecesario. | ||
| + | |||
| + | === 🛠️ 3. Lógica de Limpieza Aplicada === | ||
| + | |||
| + | El script ejecuta las siguientes acciones exclusivamente sobre los campos alfanuméricos (VARCHAR2 y CHAR): | ||
| + | |||
| + | REPLACE(campo, CHR(10), ''): Elimina los saltos de línea (Line Feed). | ||
| + | REPLACE(campo, CHR(13), ''): Elimina los retornos de carro (Carriage Return). | ||
| + | TRIM(campo): Elimina los espacios residuales que puedan quedar al inicio o al final de la cadena de texto, preservando los espacios intermedios (ej. manteniendo intacto "CALLE 10"). | ||
| + | === ⚠️ Nota de Diseño (Exclusiones): === | ||
| + | Se han excluido de forma deliberada todos los campos con tipos de dato NUMBER, DATE y LONG RAW (como NIT, FECHA_CREACION, FIRMA_DIGITAL). Aplicar funciones de texto a estos campos forzaría una conversión implícita por parte de Oracle, arriesgando la generación de excepciones ORA-01722: invalid number o corrupciones en el formato de fecha nativo. | ||
| + | === Desarrollado por: [Miguel Muñoz] Fecha: [08/05/2026] Versión de PB: 12.5 === | ||
| [[ada:sicoferp:financiero:contabilidad:maestros|←Volver atras]] | [[ada:sicoferp:financiero:contabilidad:maestros|←Volver atras]] | ||