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

**Registros de Emprego**: Acesse contribuições históricas de 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.


**Empregos Atuais**: 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 |
|  --- | --- | --- |
| Registros de Emprego | 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 |
| Empregos Atuais | 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 |


## Instituições Disponíveis

| Nome | Recursos disponíveis | MFA | Produtos suportados |
|  --- | --- | --- | --- |
| IMSS`imss_mx_employment` | 🟢 Registros de Emprego México🟢 Empregos Atuais México | 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 |


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