Renegociar um consignado encerrado do parceiro

POST/v1/renegociacao

🔒 Requer Bearer token

Escopo renegociacao:write. Requer header Idempotency-Key (replay devolve a resposta original com X-Idempotency-Replayed: true). Averba uma renegociação na Socinal em substituição ao contrato original. numero_contrato deve ser um contrato do próprio parceiro.

Corpo da requisição

numero_contratostringobrigatório

Novo contrato resultante da renegociação.

máx. 60 car.

numero_contrato_encerradostringobrigatório

Contrato encerrado sendo renegociado.

máx. 60 car.

cpf_trabalhadorstringobrigatório

CPF do trabalhador (11 dígitos).

padrão: ^\d{11}$

matriculastringobrigatório

Matrícula do trabalhador.

máx. 30 car.

codigo_inscricao_empregadornumberobrigatório

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

numero_inscricao_empregadorstringobrigatório

Número de inscrição do empregador, como retornado pela Socinal. É **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}$

nome_trabalhadorstringobrigatório

Nome do trabalhador.

máx. 100 car.

data_inicio_contratostringobrigatório

Data de início do contrato (ddMMyyyy).

data_fim_contratostringobrigatório

Data de fim do contrato (ddMMyyyy).

numero_parcelasnumberobrigatório

Número de parcelas.

≥ 1 · ≤ 999

valor_emprestimonumberobrigatório

Valor do empréstimo.

valor_parcelanumberobrigatório

Valor da parcela.

valor_iofnumberobrigatório

Valor do IOF.

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.

data_primeiro_descontostringobrigatório

Data do primeiro desconto (ddMMyyyy).

competencia_inicio_descontostringopcional

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

cnpj_operadorstringopcional

CNPJ do operador (opcional).

Respostas

Corpo da resposta 201

codigo_sucessostringobrigatório

mensagemstringobrigatório

numero_contratostringobrigatório

competencia_inicio_descontointegerobrigatório

hash_operacaointegerobrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/renegociacao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{
  "numero_contrato": "A100002-001",
  "numero_contrato_encerrado": "A100001-001",
  "cpf_trabalhador": "87070728050",
  "matricula": "MAT213",
  "codigo_inscricao_empregador": 1,
  "numero_inscricao_empregador": "R7ZW4H8H000140",
  "nome_trabalhador": "Trabalhador Fulano de tal",
  "data_inicio_contrato": "01012024",
  "data_fim_contrato": "12012024",
  "numero_parcelas": 10,
  "valor_emprestimo": 1010,
  "valor_parcela": 100,
  "valor_iof": 1,
  "valor_taxa_anual": 5,
  "valor_cet_anual": 5,
  "valor_taxa_mensal": 0.3,
  "valor_cet_mensal": 0.3,
  "data_primeiro_desconto": "02012024",
  "competencia_inicio_desconto": "202401",
  "cnpj_operador": "22222222222222"
}'

Response

{
  "codigo_sucesso": "000",
  "mensagem": "Renegociação averbada com sucesso.",
  "numero_contrato": "A100011-001",
  "competencia_inicio_desconto": 202508,
  "hash_operacao": 123456789
}