# Obtener los detalles de un registro de empleo

Obtén los detalles de un registro de empleo específico.

Endpoint: GET /api/employment-records/{id}/
Version: 1.223.0
Security: basicAuth

## Path parameters:

  - `id` (string, required)
    El employment-record.id sobre el cual deseas obtener información detallada.

## Query parameters:

  - `omit` (string)
    Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `fields` (string)
    Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El link.id al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `created_at` (string)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `collected_at` (string)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `report_date` (string)
    La fecha en que se generó el informe del registro de empleo, en formato YYYY-MM-DD.
    Example: "2023-01-19"

  - `days_since_extraction` (integer)
    El número de días que han pasado desde que los datos de empleo fueron extraídos originalmente de la institución.
    Example: 42

  - `internal_identification` (string)
    ID único para el usuario según la institución. Para IMSS e ISSSTE México, este es el CURP.
    Example: "BLPM951331IONVGR54"

  - `personal_data` (object)
    Detalles sobre la información personal del individuo.

  - `personal_data.official_name` (string,null)
    El nombre legal del individuo.
    Example: "Bruce Banner del Torro"

  - `personal_data.first_name` (string,null)
    El primer nombre del individuo.
    Example: "Bruce"

  - `personal_data.last_name` (string,null)
    El apellido del individuo.
    Example: "Banner del Torro"

  - `personal_data.birth_date` (string,null)
    La fecha de nacimiento del individuo, en formato YYYY-MM-DD.
    Example: "2022-02-09"

  - `personal_data.entitlements` (object)
    Detalles sobre los beneficios a los que tiene derecho el individuo.

  - `personal_data.entitlements.entitled_to_health_insurance` (boolean)
    Indica si el individuo tiene derecho o no a un seguro de salud.
    Example: true

  - `personal_data.entitlements.entitled_to_company_benefits` (boolean)
    Indica si el individuo tiene derecho o no a beneficios de la empresa.
    Example: true

  - `personal_data.entitlements.valid_until` (string,null)
    Fecha hasta la cual el individuo está cubierto por el seguro de salud y/o beneficios de la empresa. Si es null, el empleado está trabajando actualmente y no se requiere una fecha de finalización.

  - `personal_data.entitlements.status` (string)
    Indica el estado laboral del individuo. Devolvemos una de las siguientes respuestas:

  - EMPLOYED
  - RETIRED
  - UNEMPLOYED
  - null
    Enum: "EMPLOYED", "RETIRED", "UNEMPLOYED", "null"

  - `personal_data.document_ids` (array)
    Detalles sobre los documentos de identificación del individuo.

  - `personal_data.document_ids.document_type` (string,null)
    El tipo de documento relacionado con el individuo. Devolvemos uno de los siguientes valores:

  - NSS
  - CURP
  - RFC
    Enum: "NSS", "CURP", "RFC"

  - `personal_data.document_ids.document_number` (string,null)
    El número del documento de identificación (como una cadena).
    Example: "10277663582"

  - `personal_data.email` (string,null)
    La dirección de correo electrónico del individuo.
    Example: "bruce.banner@avengers.com"

  - `social_security_summary` (object,null)
    Detalles sobre las contribuciones al seguro social del individuo, de acuerdo con el IMSS.

>Nota: Para ISSSTE México, este valor devolverá null.

  - `social_security_summary.weeks_redeemed` (integer,null)
    Número de semanas que el individuo necesitó retirar de su pensión.

  - `social_security_summary.weeks_reinstated` (integer,null)
    Número de semanas que el individuo ha vuelto a cotizar en su pensión (AFORE), después de haberlas retirado previamente.

  - `social_security_summary.weeks_contributed` (integer,null)
    Número de semanas que el individuo ha contribuido a su seguridad social, basado en el número de semanas que el individuo ha trabajado según el IMSS.
    Example: 188

  - `employment_records` (array)
    Detalles sobre el historial laboral del individuo.

  - `employment_records.collected_at` (string)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2020-04-23T21:32:55.336854+00:00"

  - `employment_records.employer` (string)
    El nombre oficial del empleador.

>Nota: Para ISSSTE México, este es el nombre oficial de la entidad junto con la entidad responsable de gestionar la información del empleado, separados por un punto y coma (;). Por ejemplo: SECRETARIA DE EDUCACION PUBLICA (SEP);SECRETARIA DE EDUCACION PUBLICA (SEP).
    Example: "Batman Enterprises CDMX"

  - `employment_records.employer_id` (string,null)
    El ID oficial del empleador, según el país.

>Nota: Para ISSSTE México, este valor devolverá null.
    Example: "780-BAT-88769-CDMX"

  - `employment_records.start_date` (string)
    Fecha de inicio del empleo, en formato YYYY-MM-DD.
    Example: "2019-10-10"

  - `employment_records.end_date` (string,null)
    Fecha en que finalizó el empleo, en formato YYYY-MM-DD.

>Nota: Este campo devolverá null para el empleo actual del usuario.
    Example: "2019-12-31"

  - `employment_records.weeks_employed` (integer)
    Número de semanas que el individuo estuvo empleado.
    Example: 12

  - `employment_records.state` (string,null)
    En qué estado geográfico estaba empleado el individuo, según el país.

>Nota: Para ISSSTE México, este valor devolverá null.
    Example: "DISTRITO FEDERAL"

  - `employment_records.most_recent_base_salary` (number)
    El salario base más reciente que la persona ganó.

- Para el IMSS México, este valor se calcula incluyendo las prestaciones a las que la persona tiene derecho durante todo el año.
- Para el ISSSTE México, este valor se calcula dividiendo monthly_salary entre 30 (días) y excluye las prestaciones de la persona.
    Example: 762.54

  - `employment_records.monthly_salary` (number)
    El salario mensual del individuo, incluyendo cualquier beneficio adicional.

- Para IMSS México, este valor se calcula incluyendo los beneficios a los que el individuo tiene derecho a lo largo del año.
- Para ISSSTE México, este valor se calcula excluyendo los beneficios.
    Example: 23193.925

  - `employment_records.currency` (string)
    El código de moneda de tres letras en el que se paga el salario.
    Example: "MXN"

  - `employment_records.employment_status_updates` (array,null)
    Detalles sobre cualquier cambio de empleo del individuo.

  - `employment_records.employment_status_updates.event` (string,null)
    Para el IMSS en México, este es el evento que causó el cambio en el estado de empleo o salario. Devolvemos uno de los siguientes valores:

  - DISMISSED_RESIGNED: El empleado fue despedido o renunció.
  - SALARY_MODIFICATION: El empleado recibió una modificación salarial (aumento o disminución).
  - HIRED: El empleado fue contratado.
  - VOLUNTARY_CONTRIBUTION: El empleado realizó una contribución voluntaria al IMSS.
  - ABSENCE: El empleado estuvo ausente (como por vacaciones).
  - SICK_LEAVE: El empleado estuvo de baja por enfermedad.

Para el ISSSTE en México, esta es la fuente de información respecto al cambio en el estado de empleo o salario. Devolvemos uno de los siguientes valores:

  - NORMAL: Indica que la información fue recibida del Instituto de Seguridad y Servicios Sociales de los Trabajadores del Estado (ISSSTE).
  - BDUTA_CERTIFICATE: Indica que la información fue recibida de la base de datos central, Base de Datos Única de Trabajadores Activos (BDUTA).
  - DYE_CERTIFICATE: Indica que la información fue recibida de una institución afiliada, Dependencia y Entidad (DYE).
    Enum: "DISMISSED_RESIGNED", "SALARY_MODIFICATION", "HIRED", "VOLUNTARY_CONTRIBUTION", "ABSENCE", "SICK_LEAVE", "NORMAL", "BDUTA_CERTIFICATE", "DYE_CERTIFICATE"

  - `employment_records.employment_status_updates.base_salary` (number)
    El salario base del individuo, vigente a partir de la update_date.

  - Para IMSS México, este valor se calcula incluyendo las prestaciones a las que el individuo tiene derecho durante todo el año.
  - Para ISSSTE México, este valor se calcula excluyendo las prestaciones del individuo.
    Example: 1033.09

  - `employment_records.employment_status_updates.update_date` (string)
    La fecha en que ocurrió el evento de empleo, en formato YYYY-MM-DD.
    Example: "2021-09-01"

  - `employment_scores` (array,null)
    Un array de puntuaciones de employment_record. Cada puntuación proporciona una visión sobre la empleabilidad y el potencial de generación de ingresos en un período determinado.

> Nota 1: Este campo solo está disponible para enlaces creados con el IMSS de México. Para otras instituciones, este campo devolverá null.

> Nota 2: Este campo devolverá null para los registros de empleo recuperados antes del 16-04-2024. Para los registros de empleo generados antes del 16-04-2024, necesitarás hacer una nueva solicitud POST para recuperar los registros de empleo y calcular las puntuaciones.
    Example: [{"score":722,"period":3,"version":"1.0.0"},{"score":612,"period":6,"version":"1.0.0"},{"score":570,"period":12,"version":"1.0.0"}]

  - `employment_scores.score` (integer,null)
    Una puntuación entre 300 y 900 que proporciona una visión sobre la empleabilidad y el potencial de generación de ingresos.

- Una puntuación baja (más cercana a 300) podría indicar una menor empleabilidad y potencial de generación de ingresos, sugiriendo posibles desafíos para asegurar empleo o alcanzar niveles de ingresos más altos en el futuro.
- Una puntuación alta (más cercana a 900) podría sugerir una mayor probabilidad de asegurar empleo y generar niveles de ingresos más altos.

La puntuación puede devolver null si el individuo no tiene historial laboral.
    Example: 612

  - `employment_scores.period` (integer)
    El número de meses (en el futuro) para los cuales se calcula la puntuación.

Por ejemplo, un período de 6 indica que la puntuación se calcula para los próximos 6 meses.

> Nota: Actualmente, Belvo calcula la puntuación para 3, 6 y 12 meses.
    Example: 6

  - `employment_scores.version` (string)
    La versión de nuestro modelo de puntuación de empleo utilizada para realizar el cálculo.
    Example: "1.0.0"

  - `salary_estimation` (object,null)
    Proporciona una estimación modelada del salario base actual del usuario y su estado de empleo.

> Nota: Este campo solo está disponible para enlaces creados con el IMSS de México. Para otras instituciones (como el ISSSTE), este campo devolverá null.

  - `salary_estimation.employment_status_estimate` (string,null, required)
    El estado de empleo actual se estima utilizando un registro de empleo con una fecha de informe pasada. Devuelve "EMPLOYED" (si el base_salary_estimate es mayor que 0) o "UNEMPLOYED".
    Example: "EMPLOYED"

  - `salary_estimation.base_salary_estimate` (number,null, required)
    Salario base actual (monto diario) estimado utilizando un registro de empleo con una fecha de informe pasada.
    Example: 1000

  - `salary_estimation.currency` (string, required)
    El código de moneda de tres letras (ISO-4217). Por ejemplo, "MXN".
    Example: "MXN"

  - `files` (array,null)
    Archivos binarios PDF adicionales relacionados con el empleo del individuo.

  - `files.type` (string)
    El título del documento.
    Example: "ReporteSemanasCotizadas_190123"

  - `files.value` (string,null)
    El binario PDF del archivo (como una cadena).

> Nota: En nuestro entorno sandbox, este campo devolverá null.
    Example: "=PDF_BINARY="

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único (access_to_resource_denied) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores access_to_resource_denied, la descripción es:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único (not_found) que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores not_found, la descripción es:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único (request_timeout) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de request_timeout, la descripción es:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único (unexpected_error) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores unexpected_error, la descripción es:

- Belvo no puede procesar la solicitud debido a un problema interno del sistema o a una respuesta no soportada de una institución.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"