# 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 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 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 . Example: "2023-01-19" - `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 . 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 , 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: - - - - 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: - - - 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. >: Para ISSSTE México, este valor devolverá . - `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 (), 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.employer` (string) El nombre oficial del empleador. >: 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. >: Para ISSSTE México, este valor devolverá . Example: "780-BAT-88769-CDMX" - `employment_records.start_date` (string) Fecha de inicio del empleo, en formato . Example: "2019-10-10" - `employment_records.end_date` (string,null) Fecha en que finalizó el empleo, en formato . >: Este campo devolverá 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. >: Para ISSSTE México, este valor devolverá . 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 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: - : El empleado fue despedido o renunció. - : El empleado recibió una modificación salarial (aumento o disminución). - : El empleado fue contratado. - : El empleado realizó una contribución voluntaria al IMSS. - : El empleado estuvo ausente (como por vacaciones). - : 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: - : Indica que la información fue recibida del . - : Indica que la información fue recibida de la base de datos central, . - : Indica que la información fue recibida de una institución afiliada, . 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 . - 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 . Example: "2021-09-01" - `employment_scores` (array,null) Un array de puntuaciones de . Cada puntuación proporciona una visión sobre la empleabilidad y el potencial de generación de ingresos en un período determinado. > : Este campo solo está disponible para enlaces creados con el IMSS de México. Para otras instituciones, este campo devolverá . > : Este campo devolverá 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 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 indica que la puntuación se calcula para los próximos meses. > : 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" - `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). > : En nuestro entorno sandbox, este campo devolverá . Example: "=PDF_BINARY=" ## Response 403 fields (application/json): - `code` (string) Un código de error único () 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 , la descripción es: - . 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: ). 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 () 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 , la descripción es: - Example: "Not found" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). 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 () 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 , la descripción es: - . 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: ). 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 () 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 , la descripción es: - . 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: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb"