Webhook de migração automática de contrato
A DATAPREV pode migrar, por conta própria, um contrato de consignado privado para outro vínculo empregatício do mesmo trabalhador: outro empregador ou outra matrícula no mesmo empregador. A QI Tech consulta essas migrações na DATAPREV, aplica cada uma à averbação do contrato e envia este webhook informando o vínculo anterior e o novo.
Diferença para o revínculo
No revínculo, a QI Tech cria uma nova averbação no novo vínculo, que passa por autorização e averbação na DATAPREV. Na migração automática, quem move o contrato é a própria DATAPREV:
- O número do contrato (
contract_number) continua o mesmo. - A averbação continua a mesma: mesma
reservation_key, agora com o empregador e a matrícula do novo vínculo. - Não há autorização do parceiro nem nova tentativa de averbação.
Quando o webhook é enviado
O webhook é enviado uma vez por migração aplicada, quando o vínculo da averbação muda. Uma averbação em terminated (encerrada por término de vínculo) volta para reserved ao ser migrada. Essa mudança de status é informada por este webhook, sem um laas.private_payroll.reservation_status_change separado.
Status
O campo status traz o status da averbação depois da migração:
| Status | Significado |
|---|---|
reserved | O contrato segue averbado, agora no novo vínculo. |
settled | A DATAPREV migrou o contrato e o informou como liquidado. A averbação foi migrada e encerrada. |
Corpo do webhook
| Campo | Tipo | Obrigatório | Descrição | Tamanho |
|---|---|---|---|---|
webhook_type | string | Sim | Sempre laas.private_payroll.reservation_automatic_transfer. | — |
key | uuid | Sim | Chave da dívida (CCB) à qual a averbação pertence. É a mesma key dos outros webhooks da averbação. | 36 |
status | string | Sim | Status da averbação depois da migração: reserved ou settled. Veja Status. | — |
event_datetime | string | Sim | Data e hora do envio, em UTC, no formato AAAA-MM-DDTHH:MM:SSZ. | 20 |
data | object | Sim | Dados da migração. Veja a tabela abaixo. | — |
O webhook não traz a data em que a DATAPREV fez a migração: a consulta de migrações da DATAPREV não informa esse instante.
Atributos de data
| Campo | Tipo | Obrigatório | Descrição | Tamanho |
|---|---|---|---|---|
reservation_key | uuid | Sim | Chave da averbação migrada. Não muda com a migração. | 36 |
contract_number | string | Sim | Número do contrato na DATAPREV. Não muda com a migração. | — |
previous_employer_document_type | string | Sim | Tipo do documento do empregador do vínculo anterior: cnpj ou cpf. | — |
previous_employer_document_number | string | Sim | Documento do empregador do vínculo anterior, só dígitos, como estava na averbação. | — |
previous_registration_number | string | Sim | Matrícula do trabalhador no vínculo anterior. | — |
employer_document_type | string | Sim | Tipo do documento do empregador do novo vínculo: cnpj ou cpf. | — |
employer_document_number | string | Sim | Documento do empregador do novo vínculo, só dígitos, como a DATAPREV informou. | 8 a 14 |
registration_number | string | Sim | Matrícula do trabalhador no novo vínculo. | — |
Para um empregador cnpj, a DATAPREV pode informar a raiz do CNPJ (8 dígitos) ou o CNPJ completo (14 dígitos). Para um empregador cpf, o documento tem 11 dígitos.
Exemplo
{
"webhook_type": "laas.private_payroll.reservation_automatic_transfer",
"key": "123e4567-e89b-12d3-a456-426614174000",
"status": "reserved",
"event_datetime": "2026-10-20T13:05:12Z",
"data": {
"reservation_key": "9b2f6c1e-4d3a-4f8b-a1c7-2e5d8f0b3a64",
"contract_number": "2024001234",
"previous_employer_document_type": "cnpj",
"previous_employer_document_number": "12345678000190",
"previous_registration_number": "99999999999-A",
"employer_document_type": "cnpj",
"employer_document_number": "98765432",
"registration_number": "88888888888-B"
}
}
Próximo passo
- Consulta de Reservas: a averbação migrada já aparece com o novo vínculo.
- Regras de Negócio: o ciclo do término de vínculo até o revínculo.