# Registros de Emprego México

> Desbloqueie insights valiosos sobre o histórico de emprego e a estabilidade financeira dos seus usuários com o recurso de Registros de Emprego da Belvo para o México. Acesse dados abrangentes sobre contribuições à seguridade social e histórico de emprego para aprimorar sua avaliação de risco, agilizar o onboarding e muito mais.


## Introdução

Com os recursos de emprego da Belvo para o México, você pode acessar informações abrangentes sobre o status e o histórico de emprego do seu usuário. Oferecemos dois recursos principais, além de um complemento opcional **Employment Metrics**:

**Employment Records**: Acesse contribuições históricas à seguridade social e histórico de emprego. Para cada usuário, retornamos:

- dados pessoais
- histórico de trabalho
- salário base diário histórico e atual
- pontuação de emprego (disponível apenas para IMSS)
Uma pontuação de emprego fornece insights sobre a probabilidade de um usuário cumprir suas obrigações financeiras futuras em um determinado período. Para cada registro de emprego, fornecemos uma pontuação para os próximos 3, 6 e 12 meses.


**Current Employments**: Obtenha informações sobre o status de emprego atual. Para cada usuário, retornamos:

- status de emprego atual (empregado/desempregado)
- informações salariais atuais (salário base e mensal)
- detalhes do empregador atual


## Casos de Uso

| Recurso | Melhor para | Benefícios principais |
|  --- | --- | --- |
| Employment Records | Pontuação de crédito, verificações de antecedentes abrangentes, análise histórica | Histórico completo de emprego, pontuação de emprego, progressão salarial detalhada |
| Current Employments | Verificação em tempo real, integração instantânea, verificações de status atual | Verificação rápida, status de emprego atual, dados salariais em tempo real |
| Employment Metrics | Modelagem de risco de crédito, análise de estabilidade de renda | Métricas pré-calculadas de tempo de serviço, rotatividade de empregador e tendências salariais |


## Instituições Disponíveis

| Nome | Recursos disponíveis | MFA | Produtos suportados |
|  --- | --- | --- | --- |
| IMSS`imss_mx_employment` | 🟢 Registros de Emprego México🟢 Empregos Atuais México🟢 Métricas de Emprego | Não | Informações de Emprego |
| ISSSTE`issste_mx_employment` | 🟢 Registros de Emprego México | Não | Informações de Emprego |
| Sandbox`planet_mx_employment` | 🟢 Registros de Emprego México | Não | Informações de Emprego |


Recursos pagos opcionais
**Empregos Atuais** e **Métricas de Emprego** estão disponíveis como complementos pagos opcionais apenas para links do **IMSS** — entre em contato com seu representante da Belvo para habilitá-los. Como mostrado acima, a instituição Sandbox (`planet_mx_employment`) suporta apenas Registros de Emprego, portanto, nenhum dos complementos pode ser testado no Sandbox.

## Métricas de Emprego

Além dos Registros de Emprego e Empregos Atuais, você pode optar por **Métricas de Emprego** — análises derivadas calculadas a partir do histórico de emprego de um usuário, incluindo:

- tempo de permanência no emprego e rotatividade de empregadores (tempo empregado, tempo entre empregos, número de empregadores)
- tendências salariais (salário mensal mínimo, médio e máximo ao longo de 1, 3 e 5 anos)


Para a lista completa de campos disponíveis, consulte a referência da API de Métricas de Emprego. Para uma explicação mais detalhada do recurso, veja nosso guia de enriquecimento de métricas de emprego.

## Conectando Usuários (Links)

Para extrair dados sobre seus usuários, eles precisarão conectar suas contas usando a Belvo API (veja as opções de integração abaixo). Quando eles conectam suas contas, criamos um *link* entre o usuário e a instituição.


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

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

Dependendo do seu caso de uso, oferecemos dois tipos diferentes de links:

| Tipo de Link  | Descrição |
|  --- | --- |
| Recorrente | Os dados são automaticamente recuperados em um intervalo determinado (diário, semanal, mensal) e você é notificado via webhook. Ideal para monitoramento contínuo e insights atualizados. |
| Único | Os dados são recuperados "sob demanda". Útil para avaliações únicas ou solicitações iniciadas pelo usuário. |


Para mais informações sobre tipos de links, os intervalos de atualização e quais dados são extraídos automaticamente, consulte nosso artigo dedicado a Links.

## Opções de Integração

Para extrair dados de emprego no México, você pode usar as seguintes opções de integração:

### Belvo Hosted Widget

Para aplicativos nativos (mobile) e também web-based, criamos uma versão **hosted** do nosso **widget** que simplifica significativamente o seu processo de desenvolvimento e integração. Tudo o que é necessário é que você crie uma **webview** em seu aplicativo e tenha algum conhecimento sobre como lidar com redirecionamentos de **deeplink**.


```mermaid
sequenceDiagram
  autonumber

  participant App as Aplicativo
  participant Belvo as Belvo
  participant EI as Instituição de Emprego

  App->>Belvo: POST /token/<br/>fetch_resources =<br/>["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]
  Belvo-->>App: 200 - Token Gerado
  App->>App: Direcione seu usuário para o Hosted Widget
  App->>EI: Usuário faz login na sua instituição
  EI-->>Belvo: Belvo recupera informações históricas de emprego para o ID do link
  Belvo-->>App: Usuário redirecionado de volta para o seu aplicativo. Você recebe um ID de link para o usuário.

  Note over App,EI: Para cada recurso listado em fetch_resources, você receberá um webhook historical_update.

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

  Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
  App->>Belvo: GET /current-employments/?link={id}
  Belvo-->>App: 200 + Detalhes do Emprego Atual

  Note over App,EI: Se estiver usando links recorrentes, na frequência de atualização agendada você receberá um webhook.

  Belvo->>App: WEBHOOK new_employment_records_available
  App->>Belvo: GET /employment-records/?link={id}
  Belvo-->>App: 200 + Detalhes do Registro de Emprego
```

Notificações de mudança de status de emprego
Se você usar links recorrentes ou realizar uma atualização histórica em um único link, também poderá receber notificações sobre mudanças de status de emprego (como aumentos salariais, mudanças de emprego ou transições entre empregado e desempregado). Para mais informações, veja Mudanças de status de emprego.

### API Direta

Você também pode integrar diretamente com nossa API, dando a você controle total do processo de integração e coleta de credenciais.


```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 e confirmar a criação do link
    Belvo-->>App: 201 - Created
    EI-->>Belvo: Belvo recupera informações históricas de emprego para o ID do link

    Note over App,EI: Para cada recurso listado em fetch_resources, você receberá um webhook historical_update.

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

    Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
    App->>Belvo: GET /current-employments/?link={id}
    Belvo-->>App: 200 + Detalhes do Emprego Atual

    Note over App,EI: Se estiver usando links recorrentes, na frequência de atualização agendada você receberá um webhook.

    Belvo->>App: WEBHOOK new_employment_records_available
    App->>Belvo: GET /employment-records/?link={id}
    Belvo-->>App: 200 + Detalhes do Registro de Emprego
```