--- title: "Valores de Retorno del Método" description: "Parámetros de Salida La respuesta se retorna dentro del objeto raíz listdetalle como un array de registros en formato JSON. Cada registro corresponde a un trabajador y contiene 125 campos organizados…" url: "https://legadmi.helpdocs.io/article/tpfzfiv575-body-del-m-todo" category: "API GET de Empleados" updated_at: "2026-06-08T19:39:27Z" --- # Valores de Retorno del Método **Parámetros de Salida** La respuesta se retorna dentro del objeto raíz `listdetalle` como un array de registros en formato JSON. Cada registro corresponde a un trabajador y contiene 125 campos organizados por origen de datos. ##### **Datos de empresa, sucursal y contrato** | | | | | | | |----|-----------------|--------------|-------|----------------|-----------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 1 | COD\_EMPRESA | Numérico | 4 | `TRABAJADORES` | Código de la empresa | | 2 | NOMBRE\_EMPRESA | Alfanumérico | 90 | `EMPRESAS` | Nombre de la empresa | | 3 | COD\_SUCURSAL | Numérico | 4 | `TRABAJADORES` | Código de la sucursal | | 4 | NB\_SUCURSAL | Alfanumérico | 40 | `SUCURSALES` | Nombre de la sucursal | | 5 | COD\_CONTRATO | Numérico | 4 | `TRABAJADORES` | Código del contrato | | 6 | NB\_CONTRATO | Alfanumérico | 60 | `CONTRATOS` | Nombre del contrato | ##### **Datos básicos del trabajador** | | | | | | | |-----|------------------|--------------|-------|----------------|---------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 7 | COD\_TRABAJADOR | Numérico | 15 | `TRABAJADORES` | Código del trabajador | | 8 | NOMBRE\_TRAB | Alfanumérico | 215 | `TRABAJADORES` | Nombre completo | | 9 | INGRESO | Fecha | — | `TRABAJADORES` | Fecha de ingreso | | 10 | EGRESO | Fecha | — | `TRABAJADORES` | Fecha de egreso | | 11 | TIPO\_PAGO | Alfanumérico | 1 | `TRABAJADORES` | Tipo de pago: B = Banco, C = Cheque, E = Efectivo | | 98 | ULTIMA\_NOMINA | Fecha | — | `TRABAJADORES` | Fecha de última nómina procesada | | 99 | ULTIMA\_ROTACION | Fecha | — | `TRABAJADORES` | Fecha de última rotación | | 100 | ULTIMO\_ANTICIPO | Fecha | — | `TRABAJADORES` | Fecha de último anticipo | ##### **Expediente básico** | | | | | | | |-----|-----------------------|--------------|-------|----------------------|--------------------------------------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 12 | ESTADO\_CIVIL | Alfanumérico | 1 | `RR_HH_TRABAJADORES` | D = Divorciado, C = Casado, S = Soltero, V = Viudo, U = Unión Libre, O = Otros | | 13 | SEXO | Alfanumérico | 1 | `RR_HH_TRABAJADORES` | Masculino / Femenino | | 14 | ZURDO | Alfanumérico | 1 | `RR_HH_TRABAJADORES` | Indica si el trabajador es zurdo | | 15 | ESTATURA | Numérico | 4,2 | `RR_HH_TRABAJADORES` | Estatura en metros | | 16 | FUMA | Alfanumérico | 1 | `RR_HH_TRABAJADORES` | Indicador de fumador | | 17 | CASILLA | Numérico | 20 | `RR_HH_TRABAJADORES` | Número de casilla postal | | 18 | PESO | Numérico | 5,2 | `RR_HH_TRABAJADORES` | Peso en kilogramos | | 19 | SITUACION\_SSO | Alfanumérico | 2 | `RR_HH_TRABAJADORES` | Situación de seguridad social | | 20 | LIBRETA\_MILITAR | Alfanumérico | 20 | `RR_HH_TRABAJADORES` | Número de libreta militar | | 21 | LICENCIA | Alfanumérico | 20 | `RR_HH_TRABAJADORES` | Número de licencia de conducir | | 22 | NUMERO\_SSO | Alfanumérico | 20 | `RR_HH_TRABAJADORES` | Número de seguridad social | | 23 | COD\_RETIRO | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de causa de retiro | | 24 | COD\_CAUSA\_INGRESO | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de causa de ingreso | | 25 | COD\_EDUCATIVO | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de nivel educativo | | 26 | COD\_TIPO\_CONTRATACI | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de tipo de contratación | | 27 | GRUPO\_SANGINEO | Alfanumérico | 10 | `RR_HH_TRABAJADORES` | Grupo sanguíneo | | 28 | WORLDWIDE\_ID | Alfanumérico | 20 | `RR_HH_TRABAJADORES` | Identificador global corporativo | | 29 | INICIALES | Alfanumérico | 4 | `RR_HH_TRABAJADORES` | Iniciales del trabajador | | 30 | TNUMBER | Alfanumérico | 10 | `RR_HH_TRABAJADORES` | Número T corporativo | | 31 | EMAIL\_EMPRESA | Alfanumérico | 60 | `RR_HH_TRABAJADORES` | Correo electrónico corporativo | | 32 | COD\_RAZON | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de razón de terminación | | 33 | COMENTARIO | Alfanumérico | 40 | `RR_HH_TRABAJADORES` | Comentario del expediente | | 34 | COD\_TIPO\_TRABAJADOR | Alfanumérico | 8 | `RR_HH_TRABAJADORES` | Código de tipo de trabajador | | 35 | DISCAPACITADO | Alfanumérico | 1 | `RR_HH_TRABAJADORES` | Indicador de discapacidad | | 117 | MARCAS\_PAGO | Alfanumérico | 2 | `RR_HH_TRABAJADORES` | SI / NO | | 118 | RESPETA\_HORARIOS | Alfanumérico | 2 | `RR_HH_TRABAJADORES` | SI / NO | | 119 | INTERPRETA | Alfanumérico | 2 | `RR_HH_TRABAJADORES` | Interpreta registros: SI / NO | ##### **Domicilio** | | | | | | | |-----|----------------------|--------------|-------|--------------------------|----------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 36 | CALLE\_AVE | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Calle o avenida | | 37 | DIRECCION\_DOMICILIO | Alfanumérico | 200 | `DOMICILIO_TRABAJADORES` | Dirección completa | | 38 | SECTOR\_URBA | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Sector / barrio / urbanización | | 39 | NB\_CASA\_EDIF | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Nombre de casa o edificio | | 40 | PISO | Alfanumérico | 8 | `DOMICILIO_TRABAJADORES` | Número de piso | | 41 | NUMERO | Alfanumérico | 8 | `DOMICILIO_TRABAJADORES` | Número de inmueble | | 42 | COD\_AREA\_TELEFONO | Alfanumérico | 5 | `DOMICILIO_TRABAJADORES` | Código de área telefónica | | 43 | TELEFONO | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Número de teléfono | | 44 | COD\_AREA\_CELULAR | Alfanumérico | 5 | `DOMICILIO_TRABAJADORES` | Código de área celular | | 45 | CELULAR | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Número de celular | | 46 | EMAIL\_PERSONAL | Alfanumérico | 60 | `DOMICILIO_TRABAJADORES` | Correo electrónico personal | | 47 | PAIS\_DOMICILIO | Alfanumérico | 8 | `DOMICILIO_TRABAJADORES` | Código del país de domicilio | | 48 | CIUDAD\_DOMICILIO | Alfanumérico | 8 | `DOMICILIO_TRABAJADORES` | Código de la ciudad de domicilio | | 49 | ZIP\_CODE | Alfanumérico | 20 | `DOMICILIO_TRABAJADORES` | Código postal | | 104 | OBSERVACION | Alfanumérico | 600 | `DOMICILIO_TRABAJADORES` | Observación adicional (ej. contacto de emergencia) | ##### **Origen del trabajador** | | | | | | | |----|-------------------------|--------------|-------|-----------------------|-------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 50 | CEDULA | Numérico | 30 | `ORIGEN_TRABAJADORES` | Documento de identidad | | 51 | EXTRANJERO | Alfanumérico | 1 | `ORIGEN_TRABAJADORES` | Indicador de extranjero | | 52 | FECHA\_NACIMIENTO | Fecha | — | `ORIGEN_TRABAJADORES` | Fecha de nacimiento | | 53 | PASAPORTE | Alfanumérico | 20 | `ORIGEN_TRABAJADORES` | Número de pasaporte | | 54 | FECHA\_NACIONALIZACION | Fecha | — | `ORIGEN_TRABAJADORES` | Fecha de nacionalización | | 55 | CEDULA\_ANTERIOR | Numérico | 30 | `ORIGEN_TRABAJADORES` | Documento de identidad anterior | | 56 | PAIS\_ORIGEN | Alfanumérico | 8 | `ORIGEN_TRABAJADORES` | Código del país de origen | | 57 | CIUDAD\_ORIGEN | Alfanumérico | 8 | `ORIGEN_TRABAJADORES` | Código de la ciudad de origen | | 58 | COD\_PAIS\_NACIONALIDAD | Alfanumérico | 8 | `ORIGEN_TRABAJADORES` | Código del país de nacionalidad | | 59 | IDENTIFICADOR | Alfanumérico | 30 | `ORIGEN_TRABAJADORES` | Identificador adicional | | 60 | ID\_FISCAL | Alfanumérico | 20 | `ORIGEN_TRABAJADORES` | ID fiscal principal | | 61 | ID\_FISCAL1 | Alfanumérico | 20 | `ORIGEN_TRABAJADORES` | ID fiscal secundario | | 93 | FECHA\_VENC\_CEDULA | Fecha | — | `ORIGEN_TRABAJADORES` | Fecha de vencimiento del documento de identidad | ##### **Históricos (último registro según parámetro FECHA)** > Para todos los campos de esta sección el servicio toma el registro más reciente cuya fecha sea menor o igual al parámetro FECHA. Si no se envía FECHA, toma el registro más reciente disponible. Si no existe registro, devuelve el valor por defecto indicado. | | | | | | | |-----|------------------------|--------------|-------|------------------------------|----------------------| | \# | Campo | Tipo | Long. | Tabla | Defecto si no existe | | 62 | COD\_DIRECCION | Alfanumérico | 13 | `HISTORICO_DEPARTAMENTOS` | Sin Dirección | | 63 | NOMBRE\_DIRECCION | Alfanumérico | 40 | `HISTORICO_DEPARTAMENTOS` | Sin Dirección | | 64 | COD\_GERENCIA | Alfanumérico | 12 | `HISTORICO_DEPARTAMENTOS` | Sin Gerencia | | 65 | NOMBRE\_GERENCIA | Alfanumérico | 40 | `HISTORICO_DEPARTAMENTOS` | Sin Gerencia | | 66 | COD\_DEPARTAMENTO | Alfanumérico | 9 | `HISTORICO_DEPARTAMENTOS` | Sin Dpto. | | 67 | NOMBRE\_DPTO | Alfanumérico | 40 | `HISTORICO_DEPARTAMENTOS` | Sin Dpto. | | 68 | COD\_CENTRO\_COSTO | Alfanumérico | 20 | `HISTORICO_DEPARTAMENTOS` | Sin Centro Costo. | | 69 | NOMBRE\_CENTRO\_COSTO | Alfanumérico | 40 | `HISTORICO_DEPARTAMENTOS` | Sin Centro Costo. | | 70 | COD\_AREA\_DESEMPENO | Alfanumérico | 8 | `HISTORICO_AREAS` | Sin Area | | 71 | NOMBRE\_AREA | Alfanumérico | 40 | `AREAS_DESEMPENOS` | Sin Area | | 72 | AUXILIAR\_AREA | Alfanumérico | 20 | `AREAS_DESEMPENOS` | Sin Auxiliar en Area | | 73 | COD\_CARGO | Alfanumérico | 9 | `HISTORICOS_CARGOS` | Sin Cargo | | 74 | NOMBRE\_CARGO | Alfanumérico | 100 | `HISTORICOS_CARGOS` | Sin Cargo | | 75 | COD\_ACTIVIDAD | Alfanumérico | 13 | `HISTORICO_ACTIVIDADES` | Sin Actividad | | 76 | NOMBRE\_ACTIVIDAD | Alfanumérico | 40 | `HISTORICO_ACTIVIDADES` | Sin Actividad | | 91 | COD\_OCUPACION | Alfanumérico | 20 | `HISTORICO_OCUPACIONES` | Sin ocupación | | 92 | DESCRIPCION\_OCUPACION | Alfanumérico | 200 | `HISTORICO_OCUPACIONES` | Sin ocupación | | 94 | NIVEL | Alfanumérico | 51 | `HISTORICOS_CLASIFICACIONES` | Sin Nivel | | 95 | BANDA | Alfanumérico | 51 | `BANDAS` | Sin Banda | | 96 | NIVEL\_CLASIFICACION | Alfanumérico | 51 | `BANDAS_CLASIFICACIONES` | Sin Clasificación | | 102 | NUMERO\_TURNO | Numérico | — | `TURNOS_TRABAJADORES` | — | | 103 | NOMBRE\_TURNO | Alfanumérico | 40 | `TURNOS_TRABAJADORES` | — | ##### **Banco (base de valoración NETO)** | | | | | | | |----|---------------|--------------|-------|-----------------------|----------------------------------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 77 | COD\_BANCO | Alfanumérico | 40 | `BANCOS_TRABAJADORES` | Código del banco asignado para pago neto. Si no existe: Sin Banco asignado | | 78 | NOMBRE\_BANCO | Alfanumérico | 60 | `BANCOS` | Nombre del banco | | 79 | NU\_CUENTA | Alfanumérico | 40 | `BANCOS_TRABAJADORES` | Número de cuenta | | 80 | TIPO\_CUENTA | Alfanumérico | 18 | `BANCOS_TRABAJADORES` | AHORRO, CORRIENTE, LIQUIDO, UNIVERSAL | ##### **Datos varios** | | | | | | | |-----|----------------------------|--------------|-------|-----------------------------|-------------------------------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 81 | GRADO\_LICENCIA | Alfanumérico | 8 | `DATOS_VARIOS_TRABAJADORES` | Grado de licencia de conducir | | 82 | FECHA\_VENC\_LICENCIA | Fecha | — | `DATOS_VARIOS_TRABAJADORES` | Vencimiento de licencia | | 83 | FECHA\_VENC\_CERTIFICADO | Fecha | — | `DATOS_VARIOS_TRABAJADORES` | Vencimiento de certificado | | 84 | FECHA\_VENC\_PERM\_ARMA | Fecha | — | `DATOS_VARIOS_TRABAJADORES` | Vencimiento de portación de armas | | 85 | MARCA\_VEHICULO | Alfanumérico | 30 | `DATOS_VARIOS_TRABAJADORES` | Marca del vehículo | | 86 | MODELO\_VEHICULO | Alfanumérico | 30 | `DATOS_VARIOS_TRABAJADORES` | Modelo del vehículo | | 87 | COLOR\_VEHICULO | Alfanumérico | 30 | `DATOS_VARIOS_TRABAJADORES` | Color del vehículo | | 88 | ANO\_VEHICULO | Numérico | 4 | `DATOS_VARIOS_TRABAJADORES` | Año del vehículo | | 89 | PLACA\_VEHICULO | Alfanumérico | 30 | `DATOS_VARIOS_TRABAJADORES` | Placa del vehículo | | 90 | ASIGNADO | Alfanumérico | 1 | `DATOS_VARIOS_TRABAJADORES` | Vehículo asignado por la empresa | | 97 | NIVEL\_EDUCATIVO | Alfanumérico | 51 | `NIVEL_EDUCATIVOS` | Código y nombre del nivel educativo. Si no existe: Sin Código Educativo | | 101 | AUXILIAR\_CONTABLE | Alfanumérico | 100 | `DATOS_VARIOS_TRABAJADORES` | Auxiliar contable | | 107 | ASOCIACION\_SOLIDARISTA | Alfanumérico | 1 | `DATOS_VARIOS_TRABAJADORES` | Inscrito en asociación solidarista | | 108 | PADECIMIENTOS | Alfanumérico | 500 | `DATOS_VARIOS_TRABAJADORES` | Padecimientos o enfermedades registradas | | 115 | ANOS\_EXPE\_TOTAL | Numérico | 6 | `DATOS_VARIOS_TRABAJADORES` | Años de experiencia total | | 116 | ANOS\_EX\_TOT\_PUESTO\_MAN | Numérico | 6 | `DATOS_VARIOS_TRABAJADORES` | Años de experiencia en puesto de mando | ##### **Línea de mando** | | | | | | | |-----|--------------------------|--------------|-------|---------------------|----------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 109 | EMPRESA\_JEFE | Alfanumérico | 133 | `LINEAS_TRABAJADOR` | Empresa del jefe directo | | 110 | CODIGO\_TRABAJADOR\_JEFE | Alfanumérico | 106 | `LINEAS_TRABAJADOR` | Código y nombre del jefe directo | ##### **Nombres resueltos de países y ciudades** | | | | | | | |-----|---------------------------|--------------|-------|------------|-----------------------------------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 111 | NOMBRE\_PAIS\_ORIGEN | Alfanumérico | 30 | `PAISES` | Nombre del país de origen (resuelve PAIS\_ORIGEN) | | 112 | NOMBRE\_PAIS\_DOMICILIO | Alfanumérico | 30 | `PAISES` | Nombre del país de domicilio (resuelve COD\_PAIS\_NACIONALIDAD) | | 113 | NOMBRE\_CIUDAD\_ORIGEN | Alfanumérico | 40 | `CIUDADES` | Nombre de la ciudad de origen (resuelve CIUDAD\_ORIGEN) | | 114 | NOMBRE\_CIUDAD\_DOMICILIO | Alfanumérico | 40 | `CIUDADES` | Nombre de la ciudad de domicilio (resuelve CIUDAD\_DOMICILIO) | ##### **Campos de remuneración (condicionales)** Estos campos solo se incluyen en la respuesta si la opción **"Mostrar información de sueldos"** está habilitada en **Administración de APIS → Consulta Información de Empleados**. Si está deshabilitada, los campos no aparecen en el JSON. | | | | | | | |-----|--------------------------|--------------|-------|---------------------|---------------------------------------| | \# | Campo | Tipo | Long. | Tabla | Descripción | | 120 | SUELDO\_ACTUAL | Numérico | — | `HISTORICO_SUELDOS` | Sueldo actual del trabajador | | 121 | FECHA\_SUELDO\_ACTUAL | Fecha | — | `HISTORICO_SUELDOS` | Fecha de vigencia del sueldo actual | | 122 | MONEDA\_SUELDO\_ACTUAL | Alfanumérico | — | `HISTORICO_SUELDOS` | Moneda del sueldo actual | | 123 | SUELDO\_ANTERIOR | Numérico | — | `HISTORICO_SUELDOS` | Sueldo anterior del trabajador | | 124 | FECHA\_SUELDO\_ANTERIOR | Fecha | — | `HISTORICO_SUELDOS` | Fecha de vigencia del sueldo anterior | | 125 | MONEDA\_SUELDO\_ANTERIOR | Alfanumérico | — | `HISTORICO_SUELDOS` | Moneda del sueldo anterio | Para habilitar estos campos ir a **RPS → Administración de APIS → Consulta Información de Empleados** y seleccionar **"Sí"** en la opción de mostrar información de sueldos. Ver [Administración de APIS](https://legadmi.helpdocs.io/article/ezf2srdpxg-administraci-n-de-apis).