Criar empréstimo consignado averbado

POST/v1/massa-dados/emprestimo

🔒 Requer Bearer token

Escopo emprestimos:write. **Disponível apenas em staging e homologação.** Popula a base de HOMOLOGAÇÃO da Dataprev com dados fictícios; em produção esta rota não existe (404). Cria um contrato de consignado já averbado, pulando o fluxo de originação — use para testar refinanciamento, renegociação, portabilidade e repasses. O trabalhador (cpf_trabalhador + matricula) precisa existir na massa. A resposta traz a escrituração da primeira parcela, gerada junto com o contrato.

Corpo da requisição

tem_garantiasbooleanobrigatório

Se a operação tem garantias FGTS. Obrigatório — envie `false` quando não houver.

valor_saldo_disponivel_garantia_fgtsnumberopcional

Valor do saldo FGTS disponível oferecido em garantia.

≥ 0

valor_multa_rescisoria_garantia_fgtsnumberopcional

Valor da multa rescisória do FGTS oferecido em garantia.

≥ 0

perc_verba_rescisoria_garantianumberopcional

Percentual das verbas rescisórias oferecido em garantia (0 a 100).

≥ 0 · ≤ 100

numero_contratostringobrigatório

Número do contrato a ser criado.

máx. 60 car.

cpf_trabalhadorstringobrigatório

CPF do trabalhador (11 dígitos).

padrão: ^\d{11}$

matriculastringobrigatório

Matrícula do trabalhador no empregador.

máx. 30 car.

codigo_inscricao_empregadornumberobrigatório

Código do tipo de inscrição do empregador (1=CNPJ, 2=CPF).

numero_inscricao_empregadorstringobrigatório

Número de inscrição do empregador. É **string**: o CNPJ pode ser alfanumérico (IN RFB 2.229/2024, ex.: `R7ZW4H8H000140`) e zeros à esquerda são significativos. Máscara (`.`, `/`, `-`) é aceita e removida.

máx. 30 car. · padrão: ^[A-Z0-9]{1,30}$

data_inicio_contratostringobrigatório

Data de início do contrato (ISO `YYYY-MM-DD`).

data_fim_contratostringobrigatório

Data de fim do contrato (ISO `YYYY-MM-DD`).

data_primeiro_descontostringobrigatório

Data do primeiro desconto em folha (ISO `YYYY-MM-DD`).

numero_parcelasnumberobrigatório

Quantidade de parcelas.

≥ 1 · ≤ 999

valor_parcelanumberobrigatório

Valor da parcela.

≥ 0

valor_emprestimonumberobrigatório

Valor do empréstimo.

≥ 0

competencia_inicio_descontostringopcional

Competência de início do desconto (`yyyyMM`).

padrão: ^\d{6}$

valor_iofnumberobrigatório

Valor do IOF.

valor_liberadonumberobrigatório

Valor líquido liberado.

valor_troconumberopcional

Valor de troco da operação.

valor_taxa_anualnumberobrigatório

Taxa de juros anual (%).

valor_cet_anualnumberobrigatório

CET anual (%).

valor_taxa_mensalnumberobrigatório

Taxa de juros mensal (%).

valor_cet_mensalnumberobrigatório

CET mensal (%).

codigo_situacao_emprestimonumberobrigatório

Código da situação do empréstimo (1=ativo).

Respostas

Corpo da resposta 201

numero_contrato_escrituracaostringobrigatório

codigo_if_escrituracaointegerobrigatório

id_eventostringobrigatório

periodo_referenciastringobrigatório

valor_parcela_descontonumberobrigatório

valor_parcela_emprestimonumberobrigatório

codigo_if_emprestimointegerobrigatório

numero_contrato_emprestimostringobrigatório

cpf_trabalhadorstringobrigatório

matriculastringobrigatório

codigo_inscricao_empregadorintegerobrigatório

numero_inscricao_empregadorstringobrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/massa-dados/emprestimo' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "tem_garantias": true,
  "valor_saldo_disponivel_garantia_fgts": 500,
  "valor_multa_rescisoria_garantia_fgts": 200,
  "perc_verba_rescisoria_garantia": 15,
  "numero_contrato": "199912345678",
  "cpf_trabalhador": "87070728050",
  "matricula": "MAT-99999999999999213",
  "codigo_inscricao_empregador": 1,
  "numero_inscricao_empregador": "66106660000160",
  "data_inicio_contrato": "2020-01-01",
  "data_fim_contrato": "2021-01-01",
  "data_primeiro_desconto": "2020-02-01",
  "numero_parcelas": 10,
  "valor_parcela": 100,
  "valor_emprestimo": 1000,
  "competencia_inicio_desconto": "202401",
  "valor_iof": 33.73,
  "valor_liberado": 966.27,
  "valor_troco": 0,
  "valor_taxa_anual": 34.49,
  "valor_cet_anual": 40.9,
  "valor_taxa_mensal": 2.5,
  "valor_cet_mensal": 2.9,
  "codigo_situacao_emprestimo": 1
}'

Response

{
  "numero_contrato_escrituracao": "199912345678",
  "codigo_if_escrituracao": 997,
  "id_evento": "ID.999999.202504.0001",
  "periodo_referencia": "202504",
  "valor_parcela_desconto": 200,
  "valor_parcela_emprestimo": 200,
  "codigo_if_emprestimo": 997,
  "numero_contrato_emprestimo": "199912345678",
  "cpf_trabalhador": "87070728050",
  "matricula": "MAT-99999999999999213",
  "codigo_inscricao_empregador": 1,
  "numero_inscricao_empregador": "11111111111111"
}