# Employment Records México

> Descubre valiosos insights sobre el historial laboral y la estabilidad financiera de tus usuarios con el recurso de Employment Records de Belvo para México. Accede a datos completos sobre las contribuciones a la seguridad social y el historial laboral para mejorar tu evaluación de riesgos, agilizar la incorporación y más.


## Introducción

Con los recursos de empleo de Belvo para México, puedes acceder a información completa sobre el estado laboral e historial de empleo de tu usuario. Ofrecemos dos recursos principales, además de un complemento opcional de **Métricas de Empleo**:

**Registros de Empleo**: Accede a las contribuciones históricas de seguridad social e historial laboral. Para cada usuario, proporcionamos:

- datos personales
- historial laboral
- salario base diario histórico y actual
- puntaje de empleo (solo disponible para IMSS)
Un puntaje de empleo proporciona información sobre la probabilidad de que un usuario cumpla con sus obligaciones financieras futuras en un período determinado. Para cada registro de empleo, proporcionamos un puntaje para los próximos 3, 6 y 12 meses.


**Empleos Actuales**: Obtén información sobre el estado laboral actual. Para cada usuario, proporcionamos:

- estado laboral actual (empleado/desempleado)
- información salarial actual (salario base y mensual)
- detalles del empleador actual


## Casos de Uso

| Recurso | Mejor para | Beneficios clave |
|  --- | --- | --- |
| Registros de Empleo | Calificación crediticia, verificaciones de antecedentes completas, análisis histórico | Historial laboral completo, puntaje de empleo, progresión salarial detallada |
| Empleos Actuales | Verificación en tiempo real, incorporación instantánea, verificaciones de estado actual | Verificación rápida, estado laboral actual, datos salariales en tiempo real |
| Métricas de Empleo | Modelado de riesgo crediticio, análisis de estabilidad de ingresos | Antigüedad pre-calculada, rotación de empleadores y métricas de tendencia salarial |


## Instituciones Disponibles

| Nombre | Recursos disponibles | MFA | Productos soportados |
|  --- | --- | --- | --- |
| IMSS`imss_mx_employment` | 🟢 Registros de Empleo México🟢 Empleos Actuales México🟢 Métricas de Empleo | No | Información de Empleo |
| ISSSTE`issste_mx_employment` | 🟢 Registros de Empleo México | No | Información de Empleo |
| Sandbox`planet_mx_employment` | 🟢 Registros de Empleo México | No | Información de Empleo |


Recursos de pago opcionales
**Empleos Actuales** y **Métricas de Empleo** están disponibles como complementos opcionales de pago solo para enlaces de **IMSS** — contacta a tu representante de Belvo para habilitarlos. Como se muestra arriba, la institución Sandbox (`planet_mx_employment`) solo soporta Registros de Empleo, por lo que ninguno de los complementos puede ser probado en Sandbox.

## Métricas de Empleo

Además de los Registros de Empleo y Empleos Actuales, puedes optar por **Métricas de Empleo** — análisis derivados calculados a partir del historial laboral de un usuario, incluyendo:

- permanencia en el empleo y rotación de empleadores (tiempo empleado, tiempo entre trabajos, número de empleadores)
- tendencias salariales (salario mensual mínimo, promedio y máximo durante 1, 3 y 5 años)


Para la lista completa de campos disponibles, consulta la referencia de la API de Métricas de Empleo. Para una explicación más detallada del recurso, consulta nuestra guía de enriquecimiento de métricas de empleo.

## Conectando Usuarios (Enlaces)

Para extraer datos sobre tus usuarios, necesitarán conectar su cuenta utilizando la API de Belvo (consulta las opciones de integración a continuación). Cuando conectan su cuenta, creamos un *link* entre el usuario y la institución.


```mermaid
sequenceDiagram
    participant App as Application
    participant Inst as Institution

    App->>Inst: User connects to the financial institution using Belvo
    Inst-->>App: "Link" established
```

Dependiendo de tu caso de uso, ofrecemos dos tipos de links diferentes:

| Tipo de Link  | Descripción |
|  --- | --- |
| Recurrente | Los datos se recuperan automáticamente a un intervalo dado (diario, semanal, mensual) y se te notifica a través de webhook. Ideal para monitoreo continuo y obtener información actualizada. |
| Único | Los datos se recuperan "a pedido". Útil para evaluaciones únicas o solicitudes iniciadas por el usuario. |


Para obtener más información sobre los tipos de enlaces, los intervalos de actualización y qué datos se extraen automáticamente, consulte nuestro artículo dedicado a Enlaces.

## Opciones de Integración

Para extraer datos de empleo en México, puedes utilizar las siguientes opciones de integración:

### Belvo Hosted Widget

Para aplicaciones nativas móviles y basadas en la web, hemos creado una versión hosted de nuestro widget que simplifica significativamente tu proceso de desarrollo e integración. Todo lo que necesitas es crear un webview en tu aplicación y tener algo de conocimiento sobre el manejo de redirecciones deeplink.


```mermaid
sequenceDiagram
  autonumber

  participant App as Aplicación
  participant Belvo as Belvo
  participant EI as Institución de Empleo

  App->>Belvo: POST /token/<br/>fetch_resources =<br/>["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]
  Belvo-->>App: 200 - Token Generado
  App->>App: Dirige a tu usuario al Hosted Widget
  App->>EI: El usuario inicia sesión en su institución
  EI-->>Belvo: Belvo recupera información histórica de empleo para el ID del enlace
  Belvo-->>App: El usuario es redirigido de vuelta a tu aplicación. Recibes un ID de enlace para el usuario.

  Note over App,EI: Por cada recurso listado en fetch_resources, recibirás un webhook de historical_update.

  Belvo->>App: WEBHOOK historical_update (EMPLOYMENT_RECORDS)
  App->>Belvo: GET /employment-records/?link={id}
  Belvo-->>App: 200 + Detalles del Registro de Empleo

  Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
  App->>Belvo: GET /current-employments/?link={id}
  Belvo-->>App: 200 + Detalles del Empleo Actual

  Note over App,EI: Si usas enlaces recurrentes, en la frecuencia de actualización programada recibirás un webhook.

  Belvo->>App: WEBHOOK new_employment_records_available
  App->>Belvo: GET /employment-records/?link={id}
  Belvo-->>App: 200 + Detalles del Registro de Empleo
```

Notificaciones de cambio de estado laboral
Si utilizas enlaces recurrentes o realizas una actualización histórica en un solo enlace, también puedes recibir notificaciones sobre cambios en el estado laboral (como aumentos salariales, cambios de trabajo o transiciones entre empleado y desempleado). Para más información, consulta Cambios en el estado laboral.

### API Directa

También puedes integrarte directamente con nuestra API, dándote control completo del proceso de incorporación y recopilación de credenciales.


```mermaid
sequenceDiagram
    participant App as Application
    participant Belvo as Belvo
    participant EI as Employment Institution

    App->>Belvo: POST /links/<br/>fetch_resources = ["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]
    Belvo->>EI: Conectar y confirmar la creación del enlace
    Belvo-->>App: 201 - Creado
    EI-->>Belvo: Belvo recupera información histórica de empleo para el ID del enlace

    Note over App,EI: Por cada recurso listado en fetch_resources, recibirás un webhook de historical_update.

    Belvo->>App: WEBHOOK historical_update (EMPLOYMENT_RECORDS)
    App->>Belvo: GET /employment-records/?link={id}
    Belvo-->>App: 200 + Detalles del Registro de Empleo

    Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
    App->>Belvo: GET /current-employments/?link={id}
    Belvo-->>App: 200 + Detalles del Empleo Actual

    Note over App,EI: Si usas enlaces recurrentes, en la frecuencia de actualización programada recibirás un webhook.

    Belvo->>App: WEBHOOK new_employment_records_available
    App->>Belvo: GET /employment-records/?link={id}
    Belvo-->>App: 200 + Detalles del Registro de Empleo
```