# 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 y el historial laboral de tu usuario. Ofrecemos dos recursos clave:

**Registros de Empleo**: Accede a las contribuciones históricas de seguridad social y al 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 la información del 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 |


## Instituciones Disponibles

| Nombre | Recursos disponibles | MFA | Productos compatibles |
|  --- | --- | --- | --- |
| IMSS`imss_mx_employment` | 🟢 Registros de Empleo México🟢 Empleos Actuales México | 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 |


## 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
```