> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta de migração automática

> Consulte os empréstimos que a Dataprev migrou automaticamente para um novo vínculo do trabalhador.

## Visão geral

Quando o vínculo de trabalho de um trabalhador é encerrado e ele passa a ter um novo vínculo, a Dataprev pode transferir automaticamente o empréstimo consignado para esse novo vínculo. Esse processo é chamado de **migração automática**.

Este serviço permite que o parceiro consulte quais dos seus empréstimos foram migrados automaticamente pela Dataprev em um determinado período, para acompanhar a carteira de crédito e apoiar as rotinas de cobrança, conciliação e refinanciamento.

> [!NOTE]
>
> A BMP consulta a Dataprev uma vez por dia, à meia-noite, trazendo as migrações realizadas no dia anterior. Por isso, uma migração feita pela Dataprev fica disponível para consulta a partir do dia seguinte.

### O que muda no empréstimo migrado

Após a migração automática, o empréstimo passa a ter:

* o novo vínculo do trabalhador (matrícula e empregador);
* origem de averbação igual a **Migração Automática**;
* a data em que a migração foi realizada;
* situação **Ativo**.

O tratamento das garantias depende do motivo da migração:

* **Transferência de grupo econômico:** a garantia é mantida e acompanha o contrato para o novo vínculo.
* **Demais casos:** a garantia não acompanha o contrato. Nos contratos com garantia de verbas rescisórias, o indicador de garantia passa a ser **Sem garantia** e o percentual de verbas rescisórias fica nulo.

A migração **não altera** as competências de início e de fim de desconto do contrato.

### Visibilidade dos contratos

Cada parceiro visualiza apenas os empréstimos que ele mesmo originou.

## Requisição e resposta

> [accordion] Headers
>
> **Authorization** `string` *required*
>
> Token de acesso do parceiro.

> [accordion] Parâmetros de consulta
>
> **dataHoraInicio** `string` *required*
>
> Data e hora de início do período consultado, no formato `ddMMyyyyHHmmss`.
>
> Exemplo: `01112026000000` (01/11/2026 às 00:00:00).
>
> **dataHoraFim** `string` *required*
>
> Data e hora de fim do período consultado, no formato `ddMMyyyyHHmmss`.
>
> Exemplo: `09112026235959` (09/11/2026 às 23:59:59).
>
> **nroPagina** `integer` *required*
>
> Número da página que deve ser retornada. A primeira página é `1`.

> [accordion] Resposta
>
> > [accordion] Paginação
> >
> > **nroPaginaAtual** `integer`
> >
> > Número da página retornada.
> >
> > **nroTotalPaginas** `integer`
> >
> > Quantidade total de páginas disponíveis para o período consultado.
> >
> > **nroTotalRegistros** `integer`
> >
> > Quantidade total de empréstimos encontrados no período consultado.
> >
> > **qtdRegistrosPorPagina** `integer`
> >
> > Quantidade máxima de empréstimos retornados em cada página.
> >
> > **qtdRegistrosPaginaAtual** `integer`
> >
> > Quantidade de empréstimos retornados na página atual.
> >
> > **dataHoraInicio** `string`
> >
> > Data e hora em que o processamento da consulta foi iniciado, no formato `yyyy-MM-ddTHH:mm:ss.SSS`. Não corresponde ao período informado no filtro.
> >
> > **dataHoraFim** `string`
> >
> > Data e hora em que o processamento da consulta foi finalizado, no formato `yyyy-MM-ddTHH:mm:ss.SSS`. Não corresponde ao período informado no filtro.
>
> > [accordion] Conteúdo
> >
> > **conteudo** `object[]`
> >
> > Lista de empréstimos migrados automaticamente.
> >
> > **propriedades**
> >
> > **ifConcessora** `object`
> >
> > Instituição financeira concessora do empréstimo.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código da instituição financeira.
> >
> > **descricao** `string`
> >
> > Nome da instituição financeira.
> >
> > **contrato** `string`
> >
> > Número do contrato do empréstimo.
> >
> > **cpf** `integer`
> >
> > CPF do trabalhador. Por ser numérico, CPFs iniciados em zero são retornados sem os zeros à esquerda (por exemplo, `01234567890` é retornado como `1234567890`).
> >
> > **matricula** `string`
> >
> > Matrícula do trabalhador no vínculo atual do empréstimo.
> >
> > **inscricaoEmpregador** `object`
> >
> > Tipo de inscrição do empregador.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código do tipo de inscrição:
> >
> > * `1`: CNPJ
> > * `2`: CPF
> >
> > **descricao** `string`
> >
> > Descrição do tipo de inscrição (por exemplo, `CNPJ`).
> >
> > **numeroInscricaoEmpregador** `string`
> >
> > Número de inscrição do empregador.
> >
> > **cnpjEmpregadorCompleto** `boolean`
> >
> > Indica se o número de inscrição do empregador corresponde ao CNPJ completo.
> >
> > **nomeTrabalhador** `string`
> >
> > Nome do trabalhador.
> >
> > **nomeEmpregador** `string`
> >
> > Nome do empregador.
> >
> > **dataInicioContrato** `string`
> >
> > Data de início do contrato, no formato `yyyy-MM-dd`.
> >
> > **dataFimContrato** `string`
> >
> > Data de fim do contrato, no formato `yyyy-MM-dd`.
> >
> > **competenciaInicioDesconto** `integer`
> >
> > Competência do primeiro desconto em folha, no formato `yyyyMM`.
> >
> > **competenciaFimDesconto** `integer`
> >
> > Competência do último desconto em folha, no formato `yyyyMM`.
> >
> > **totalParcelas** `integer`
> >
> > Quantidade total de parcelas do empréstimo.
> >
> > **valorParcela** `number`
> >
> > Valor de cada parcela.
> >
> > **valorEmprestimo** `number`
> >
> > Valor total do empréstimo.
> >
> > **valorLiberado** `number`
> >
> > Valor liberado ao trabalhador.
> >
> > **dataHoraInclusaoEmprestimo** `string`
> >
> > Data e hora em que o empréstimo foi incluído, no formato `yyyy-MM-ddTHH:mm:ss`.
> >
> > **origemAverbacao** `object`
> >
> > Origem da averbação do empréstimo.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código da origem de averbação. Nos empréstimos migrados automaticamente, o código é `8`.
> >
> > * `0`: Averbação banco
> > * `1`: Averbação por troca de titularidade
> > * `2`: Averbação por portabilidade
> > * `3`: Averbação por refinanciamento
> > * `4`: Averbação por reversão de refinanciamento
> > * `5`: Renegociação
> > * `6`: Renegociação de empréstimo legado
> > * `7`: Tombamento compulsório
> > * `8`: Migração automática de contrato
> >
> > **descricao** `string`
> >
> > Descrição da origem de averbação.
> >
> > **dataHoraAtualizacao** `string`
> >
> > Data e hora em que o empréstimo foi migrado automaticamente para o novo vínculo, no formato `yyyy-MM-ddTHH:mm:ss`.
> >
> > **situacaoEmprestimo** `object`
> >
> > Situação atual do empréstimo.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código da situação:
> >
> > * `0`: Ativo
> > * `2`: Excluído
> > * `3`: Encerrado
> > * `7`: Contrato suspenso
> > * `8`: Suspenso banco
> > * `15`: Encerrado por término do vínculo
> > * `16`: Encerrado com renegociação
> > * `17`: Contrato suspenso por antecipação de parcela
> >
> > **descricao** `string`
> >
> > Descrição da situação.
> >
> > **origemExclusao** `object | null`
> >
> > Origem da exclusão do empréstimo. Retorna `null` quando o empréstimo não foi excluído.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código da origem de exclusão:
> >
> > * `1`: Exclusão APS
> > * `2`: Exclusão banco
> > * `3`: Exclusão sistema
> > * `4`: Exclusão por troca de titularidade
> > * `5`: Exclusão por portabilidade
> > * `6`: Exclusão por reversão de refinanciamento
> > * `7`: Exclusão por refinanciamento
> >
> > **descricao** `string`
> >
> > Descrição da origem de exclusão.
> >
> > **dataHoraExclusao** `string | null`
> >
> > Data e hora da exclusão do empréstimo, no formato `yyyy-MM-ddTHH:mm:ss`. Retorna `null` quando o empréstimo não foi excluído.
> >
> > **dataHoraEnvioInfoContrato** `string`
> >
> > Data e hora do envio das informações do contrato, no formato `yyyy-MM-ddTHH:mm:ss`.
> >
> > **valorIOF** `number`
> >
> > Valor do IOF do empréstimo.
> >
> > **valorTaxaAnual** `number`
> >
> > Taxa de juros anual, em percentual.
> >
> > **valorCetAnual** `number`
> >
> > Custo efetivo total (CET) anual, em percentual.
> >
> > **valorTaxaMensal** `number`
> >
> > Taxa de juros mensal, em percentual.
> >
> > **valorCetMensal** `number`
> >
> > Custo efetivo total (CET) mensal, em percentual.
> >
> > **situacaoBloqueioGarantia** `object | null`
> >
> > Situação de bloqueio da garantia. Retorna `null` quando o empréstimo não possui garantia.
> >
> > **propriedades**
> >
> > **codigo** `integer`
> >
> > Código da situação de bloqueio:
> >
> > * `0`: Pendente de bloqueio
> > * `1`: Bloqueio realizado
> > * `2`: Falha de bloqueio
> > * `3`: Bloqueio em reprocessamento
> > * `4`: Bloqueio rejeitado
> >
> > **descricao** `string`
> >
> > Descrição da situação de bloqueio.
> >
> > **garantia** `object`
> >
> > Informações sobre as garantias do empréstimo.
> >
> > **propriedades**
> >
> > **temGarantias** `boolean`
> >
> > Indica se o empréstimo possui garantias.
> >
> > **valorSaldoDisponivelGarantiaFgts** `number | null`
> >
> > Valor do saldo do FGTS disponível como garantia.
> >
> > **valorMultaRescisoriaGarantiaFgts** `number | null`
> >
> > Valor da multa rescisória do FGTS disponível como garantia.
> >
> > **percVerbaRescisoriaGarantia** `number | null`
> >
> > Percentual das verbas rescisórias dado como garantia.

```bash cURL theme={null}
curl --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/consultar-migracao-automatica?dataHoraInicio=01112026000000&dataHoraFim=09112026235959&nroPagina=1' \
--header 'Authorization: <seu-token>' \
--header 'Accept: application/json' \
--header 'Content-type: application/json'
```

```json 200 theme={null}
{
  "nroPaginaAtual": 1,
  "nroTotalPaginas": 1,
  "nroTotalRegistros": 2,
  "qtdRegistrosPorPagina": 250,
  "qtdRegistrosPaginaAtual": 2,
  "dataHoraInicio": "2026-11-10T09:30:12.114",
  "dataHoraFim": "2026-11-10T09:30:12.389",
  "conteudo": [
    {
      "ifConcessora": { "codigo": 531, "descricao": "BMP Money Plus" },
      "contrato": "0123456789",
      "cpf": 12345678901,
      "matricula": "000784512",
      "inscricaoEmpregador": { "codigo": 1, "descricao": "CNPJ" },
      "numeroInscricaoEmpregador": "45678912000155",
      "cnpjEmpregadorCompleto": true,
      "nomeTrabalhador": "MARIA DA SILVA SANTOS",
      "nomeEmpregador": "NOVA EMPRESA EXEMPLO LTDA",
      "dataInicioContrato": "2026-01-15",
      "dataFimContrato": "2028-12-15",
      "competenciaInicioDesconto": 202602,
      "competenciaFimDesconto": 202812,
      "totalParcelas": 36,
      "valorParcela": 412.35,
      "valorEmprestimo": 9800.00,
      "valorLiberado": 9450.12,
      "dataHoraInclusaoEmprestimo": "2026-01-15T14:32:10",
      "origemAverbacao": { "codigo": 8, "descricao": "Migração automática de contrato" },
      "dataHoraAtualizacao": "2026-11-03T02:14:37",
      "situacaoEmprestimo": { "codigo": 0, "descricao": "Ativo" },
      "origemExclusao": null,
      "dataHoraExclusao": null,
      "dataHoraEnvioInfoContrato": "2026-01-15T14:35:00",
      "valorIOF": 189.21,
      "valorTaxaAnual": 42.58,
      "valorCetAnual": 47.30,
      "valorTaxaMensal": 3.00,
      "valorCetMensal": 3.35,
      "situacaoBloqueioGarantia": null,
      "garantia": {
        "temGarantias": false,
        "valorSaldoDisponivelGarantiaFgts": null,
        "valorMultaRescisoriaGarantiaFgts": null,
        "percVerbaRescisoriaGarantia": null
      }
    },
    {
      "ifConcessora": { "codigo": 531, "descricao": "BMP Money Plus" },
      "contrato": "0987654321",
      "cpf": 98765432100,
      "matricula": "000921347",
      "inscricaoEmpregador": { "codigo": 1, "descricao": "CNPJ" },
      "numeroInscricaoEmpregador": "98765432000291",
      "cnpjEmpregadorCompleto": true,
      "nomeTrabalhador": "JOAO PEREIRA LIMA",
      "nomeEmpregador": "COMERCIAL MODELO FILIAL SUL S.A.",
      "dataInicioContrato": "2025-08-01",
      "dataFimContrato": "2027-07-01",
      "competenciaInicioDesconto": 202509,
      "competenciaFimDesconto": 202707,
      "totalParcelas": 24,
      "valorParcela": 355.90,
      "valorEmprestimo": 6200.00,
      "valorLiberado": 5980.00,
      "dataHoraInclusaoEmprestimo": "2025-08-01T09:05:51",
      "origemAverbacao": { "codigo": 8, "descricao": "Migração automática de contrato" },
      "dataHoraAtualizacao": "2026-11-05T03:02:11",
      "situacaoEmprestimo": { "codigo": 0, "descricao": "Ativo" },
      "origemExclusao": null,
      "dataHoraExclusao": null,
      "dataHoraEnvioInfoContrato": "2025-08-01T09:10:00",
      "valorIOF": 120.55,
      "valorTaxaAnual": 39.10,
      "valorCetAnual": 43.80,
      "valorTaxaMensal": 2.80,
      "valorCetMensal": 3.10,
      "situacaoBloqueioGarantia": { "codigo": 1, "descricao": "Bloqueio realizado" },
      "garantia": {
        "temGarantias": true,
        "valorSaldoDisponivelGarantiaFgts": 5230.40,
        "valorMultaRescisoriaGarantiaFgts": 1840.00,
        "percVerbaRescisoriaGarantia": 10.0
      }
    }
  ]
}
```