Manual Consignado Privado - Movimentação de Vínculos: Webhooks de Movimentação
Esta página cobre os webhooks de movimentação de vínculos. Para entender o ciclo de inelegibilidade que conecta o encerramento de um vínculo à liberação do novo, veja Regras de Negócio — Por que a garantia precisa seguir o trabalhador.
A DATAPREV fornece um serviço de atualização de vínculos empregatícios que é consultado diariamente pela QI Tech. Nesse serviço são informados os contratos que foram encerrados por término de vínculo e os novos vínculos empregatícios dos tomadores que possuem contratos ativos.
Encerramento por término de vínculo
A partir das atualizações de desligamento, são disparados webhooks informando a mudança de status das averbações para o status terminated:
Webhook Body
{
"status": "terminated",
"event_datetime": "2025-03-20T14:47:43Z",
"key": "<Debt Key>",
"webhook_type": "laas.private_payroll.reservation_status_change",
"data": {
"reservation_key": "<Reservation Key>",
"document_number": "12345678901",
"reservation_status": "terminated",
"requester_key": "123e4567-e89b-12d3-a456-426614174000",
"registration_number": "99999999999-A",
"employer_name": "VIPER SERVICOS DO NORDESTE LTDA",
"employer_document_number": "12345678901234",
"external_key": "123e4567-e89b-12d3-a456-426614174000",
"contract_number": "2024001234",
"inclusion_date": "2025-04-02",
"disbursement_date": "2025-04-05",
"reservation_type": "new_credit",
}
}
Novo vínculo empregatício
A partir das atualizações de novos vínculos, são disparados webhooks:
Webhook Body
{
"status": "active",
"event_datetime": "2025-03-20T14:47:43Z",
"key": "<Debt Key>",
"webhook_type": "laas.private_payroll.new_employment_relationship",
"data": {
"document_number": "71742311016",
"registration_number": "123456789ABCDEFR",
"employer_document_number": "02302554000179",
"status": "active",
"employment_relationship_data": {
"name": "LETYCIA AGUILAR DA SILVA",
"eligible": true,
"loan_count": 0,
"employer_name": "VIPER SERVICOS DO NORDESTE LTDA",
"admission_date": "2025-04-02",
"total_due_amount": 1642.16,
"base_margin_amount": 911.67,
"political_exposition": "not_exposed",
"worker_category_code": 101,
"employer_document_type": "CNPJ",
"available_margin_amount": 319.08
}
}
}
Enquanto o contrato do vínculo anterior não for excluído ou reaverbado, o novo vínculo é informado pela DATAPREV como inelegível (eligible: false), mesmo estando ativo — ver o detalhamento do ciclo de motivos 4 e 8 em Regras de Negócio.
É a partir deste webhook que o fluxo de Averbação por Revínculo é iniciado.