Refinanciar um consignado do parceiro

POST/v1/refinanciamento

🔒 Requer Bearer token

Escopo refinanciamento:write. Requer header Idempotency-Key (replay devolve a resposta original com X-Idempotency-Replayed: true). Averba um refinanciamento na Socinal, quitando o(s) contrato(s) anterior(es) (devolvidos em contratos_quitados). numero_contrato deve ser um contrato do próprio parceiro.

Corpo da requisição

numero_contratostringobrigatório

Contrato existente sendo refinanciado.

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_troconumberopcional

Valor do troco (opcional).

valor_pagonumberopcional

Valor pago para quitação (opcional).

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).

contratos_quitadosarray<ContratoQuitadoDto>opcional

Contratos a quitar com o refinanciamento.

numero_contratostringobrigatório

Número do contrato a quitar.

máx. 60 car.

Respostas

Corpo da resposta 201

codigo_sucessostringobrigatório

mensagemstringobrigatório

numero_contratostringobrigatório

competencia_inicio_descontointegerobrigatório

contratos_quitadosarray<object>obrigatório

numero_contratostringobrigatório

saldo_devedornumberobrigatório

hash_operacaointegerobrigatório

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/refinanciamento' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{
  "numero_contrato": "A100001-001",
  "cpf_trabalhador": "87070728050",
  "matricula": "MAT213",
  "codigo_inscricao_empregador": 1,
  "numero_inscricao_empregador": "R7ZW4H8H000140",
  "nome_trabalhador": "Trabalhador Fulano de tal",
  "data_inicio_contrato": "01012020",
  "data_fim_contrato": "01012030",
  "numero_parcelas": 120,
  "valor_emprestimo": 10000,
  "valor_parcela": 250,
  "valor_iof": 100,
  "valor_troco": 500,
  "valor_pago": 2000,
  "valor_taxa_anual": 20,
  "valor_cet_anual": 22,
  "valor_taxa_mensal": 1.5,
  "valor_cet_mensal": 1.7,
  "data_primeiro_desconto": "01012020",
  "competencia_inicio_desconto": "202401",
  "cnpj_operador": "22222222222222",
  "contratos_quitados": [
    {
      "numero_contrato": "A100001-001"
    }
  ]
}'

Response

{
  "codigo_sucesso": "000",
  "mensagem": "Refinanciamento averbado com sucesso.",
  "numero_contrato": "A100010-001",
  "competencia_inicio_desconto": 202508,
  "contratos_quitados": [
    {
      "numero_contrato": "A100001-001",
      "saldo_devedor": 1200.75
    }
  ],
  "hash_operacao": 987654321
}