El código externo es el identificador estable de cada valor de una lista de selección. Mientras la etiqueta es el texto que ve el usuario, el código externo es lo que leen las importaciones, las integraciones y los procesos que trabajan con el valor por detrás de la pantalla. En la lista AR_ModalidadTrabajo del caso del curso, el valor Presencial tiene el código externo PRES, Híbrida tiene HIBR y Remota tiene REMO.
La diferencia entre etiqueta y código externo es la clave para entender por qué el código importa tanto. Las etiquetas pueden cambiar todas las veces que el cliente quiera: se pueden corregir, traducir a otro idioma o reformular para que se entiendan mejor. El código externo, en cambio, no debería cambiar nunca. Si una integración con la nómina recibe el valor PRES para identificar a quien trabaja de forma presencial, y alguien cambia el código, la integración deja de reconocerlo.
Por eso la L6 y sus tips proponen algunas reglas simples para elegirlos. Códigos cortos, sin tildes ni espacios, que se entiendan sin necesidad de traducción. Y una vez definidos, no se tocan. Si el significado de un valor cambia de verdad, lo correcto suele ser crear un valor nuevo y marcar el anterior como obsoleto, no reutilizar el código.
El código externo es también el puente con los archivos de importación. Cuando se importa un empleado o un objeto de fundamento que usa una lista, el archivo no lleva la etiqueta sino el código externo del valor. Si el archivo trae un código que no existe en la lista, la fila se rechaza. En una migración desde otro sistema, por eso, una tarea habitual es armar la tabla de equivalencias entre los códigos del sistema de origen y los códigos externos de las listas de EC.
En las plantillas CSV de valores de listas, el código externo es una de las columnas obligatorias, junto con el código de la lista al que pertenece el valor y las etiquetas por idioma. En el Video 6.2 se completan las filas de Híbrida y Remota con sus códigos HIBR y REMO.
El código externo también ayuda al diagnóstico. Cuando un reporte o una integración muestra un valor inesperado, comparar el código externo con la lista permite saber si el problema está en el dato, en la lista o en el proceso que lo lee.
En la Tabla 6.1 de la L6 figura como una de las partes de una lista. En el ejercicio de la L6, una de las consignas pide diseñar AR_ModalidadTrabajo con el código externo y las etiquetas en español y en inglés de cada valor.
Para la certificación, el dato a recordar es que las importaciones trabajan con el código externo, no con la etiqueta.
