Herramientas de usuario

Herramientas del sitio


ada:sicoferp:financiero:contabilidad:maestros:terceros

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

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 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 tercerosolo 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 tercerosse 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]]
ada/sicoferp/financiero/contabilidad/maestros/terceros.1717516588.txt.gz · Última modificación: 2024/06/04 15:56 por 192.168.175.136