Empréstimo consignado CTPS (averbação e ciclo de vida)
Sete operações que cobrem o ciclo de vida do empréstimo consignado do trabalhador CLT na Plataforma Crédito do Trabalhador (Dataprev): consulta de margem, averbação, envio do kit do contrato, saldo devedor e consultas de acompanhamento.
Diferente das consultas de proposta e saldo FGTS, estas rotas alteram a vida financeira do trabalhador — a averbação gera desconto real em folha. Por isso a liberação é individual por conta e a documentação não é listada no menu.
Habilitação
Estas rotas exigem duas liberações, e não uma:
| Liberação | Escopo | Observação |
|---|---|---|
| eConsignado Trabalhador | Instituição e conta | Já exigida pelas demais rotas eConsignado |
| Empréstimo consignado | Conta | Exclusiva destas sete rotas |
A segunda é concedida conta a conta e não acompanha a primeira: ter o eConsignado habilitado não libera a averbação. Sem ela, todas as chamadas desta seção respondem 403. Fale com o time da Onz para solicitar.
Equivalência com a API da Dataprev
Cada rota corresponde a uma operação da Dataprev. Os nomes seguem a convenção do portal: leitura termina em -inquiries, escrita usa o substantivo do recurso.
| Operação na Dataprev | Rota na Onz | Tipo |
|---|---|---|
/trabalhadores/consultar-dados-trabalhador | POST /econsigado/loans/worker-data-inquiries | Leitura |
/emprestimos/averbar-consignado-trabalhador | POST /econsigado/loans/endorsements | Escrita |
/emprestimos/incluir-informacoes-contrato-trabalhador | POST /econsigado/loans/contract-information | Escrita |
/emprestimos/incluir-saldo-devedor-trabalhador | POST /econsigado/loans/debt-balances | Escrita |
/emprestimos/incluir-saldo-devedor-lote-trabalhador | POST /econsigado/loans/debt-balances/batch | Escrita |
/emprestimos/consultar-emprestimo-trabalhador | POST /econsigado/loans/contract-inquiries | Leitura |
/emprestimos/garantias-emprestimos-trabalhador | POST /econsigado/loans/guarantee-inquiries | Leitura |
Todas são POST com corpo JSON, inclusive as de leitura: CPF e matrícula não devem trafegar em query string.
Ordem do fluxo
- Consultar dados do trabalhador — margem disponível, elegibilidade e bloqueios. Exige autorização do trabalhador já aceita (a mesma da consulta de saldo FGTS).
- Averbar consignado — registra o contrato e o desconto em folha.
- Incluir saldo devedor — o MTE exige o saldo informado já na averbação e atualizado mensalmente.
- Enviar informações do contrato — CCB assinada e prova de identidade de quem assinou.
- Consultar empréstimo — acompanhamento do contrato, pagamentos e escriturações.
Os passos 3 e 4 não têm dependência técnica entre si: valem em qualquer ordem, desde que o contrato esteja averbado.
Identificação do vínculo
Seis das sete rotas identificam o trabalhador pela combinação de quatro campos, e não só pelo CPF:
| Campo | Descrição |
|---|---|
cpf | CPF do trabalhador |
employee_id | Matrícula do trabalhador naquele empregador |
employer_registration_type | 1=CNPJ, 2=CPF, 3=CAEPF, 4=CNO |
employer_registration_number | Número de inscrição do empregador (8, 11 ou 14 caracteres) |
Copie os quatro da listagem de leads (employee_registration é o employee_id). Qualquer divergência — inclusive um sufixo a mais na matrícula — faz a Dataprev responder que o trabalhador é inexistente, porque a busca é pelo vínculo, não pela pessoa.
Formatos de data
| Formato | Onde se usa | Exemplo |
|---|---|---|
ddMMyyyy | Datas de contrato e desconto | 21082026 |
ddMMyyyyHHmmss | Data/hora de assinatura e janelas de consulta | 21082026161500 |
yyyyMM | Competência de desconto | 202610 |
A Dataprev interpreta data e hora em horário de Brasília. Enviar o valor em UTC joga o horário cerca de 3 horas no futuro, e ela recusa a requisição como data futura.
Valores monetários
Os campos de valor seguem NUMERO(16,2): no máximo 14 dígitos inteiros e 2 casas decimais, nunca negativos. Fora disso a Dataprev responde GE (campo com valor inválido).