Desembolsar

POST/v1/emprestimos/{id}/desembolso

🔒 Requer Bearer token

Escopo desembolso:write. Requer header Idempotency-Key (move dinheiro). Não recebe dados: o corpo é um objeto vazio {} (opcional). O empréstimo precisa estar averbada (averbação é passo interno da Socinal). **Assíncrono**: responde **202** com o empréstimo já em desembolso_agendado. A chamada solicita o pagamento PIX e o empréstimo passa a desembolso_agendado; a **data efetiva do pagamento é definida no processamento** (não é escolhida na chamada). A confirmação do PIX é assíncrona e só então o empréstimo vira desembolsada — acompanhe pelos webhooks desembolso.liquidado / desembolso.falhou. Regras que impeçam a liquidação retornam 422 ERRO_NEGOCIO com o motivo; indisponibilidade real retorna 502. Há ainda dois pré-requisitos **provisionados pela Socinal**, não pela requisição: a conta corrente da linha de crédito do parceiro cadastrada no sistema de liquidação e a CCB registrada lá como proposta. Se algum deles faltar, a resposta é 503 OPERACAO_NAO_PROVISIONADA — a requisição está correta: não altere o payload nem a Idempotency-Key, acione o suporte da Socinal com o número do empréstimo e repita a chamada com a **mesma** Idempotency-Key após a confirmação.

Parâmetros

idstringpathobrigatório

Respostas

Corpo da resposta 202

idstring<uuid>obrigatório

parceiro_idstring<uuid>obrigatório

numerostringobrigatório

statusstringobrigatório

emitindoem_assinaturaaguardando_averbacaoaverbadadesembolso_agendadodesembolsadaem_atrasoliquidadacanceladarefinanciada

cpf_trabalhadorstringobrigatório

nome_trabalhadorstringobrigatórionullable

estado_civilstringobrigatórionullable

solteirocasadodivorciadoviuvo

cnpj_empregadorstringobrigatórionullable

nome_empregadorstringobrigatórionullable

matriculastringobrigatórionullable

valor_liberadostringobrigatórionullable

prazointegerobrigatórionullable

taxa_mensalstringobrigatórionullable

parcela_valorstringobrigatórionullable

cet_anualstringobrigatórionullable

iofstringobrigatórionullable

total_a_pagarstringobrigatórionullable

saldo_devedorstringobrigatórionullable

parcelas_pagasintegerobrigatório

chave_pixstringobrigatórionullable

data_emissaostring<date-time>obrigatórionullable

data_primeira_parcelastring<date-time>obrigatórionullable

data_liberacaostring<date-time>obrigatórionullable

d4sign_uuidstring<uuid>obrigatórionullable

d4sign_statusstringobrigatórionullable

aguardando_assinaturaassinadoassinado_externo

assinatura_socinalbooleanobrigatório

docs_dataprev_statusstringobrigatórionullable

aguardandoentregue

docs_dataprev_prazostring<date-time>obrigatórionullable

criado_emstring<date-time>obrigatório

atualizado_emstring<date-time>obrigatório

proxima_acaostringobrigatórionullable

aguardar_emissaoenviar_assinaturaregistrar_assinaturainiciar_averbacaoaguardar_validacaodesembolsaraguardar_desembolso

entrega_docs_dataprevobjectobrigatórionullable

statusstringobrigatório

aguardandoentregue

prazostring<date-time>obrigatórionullable

proxima_acaostringobrigatórionullable

aguardar_averbacaoentregar_documentos_dataprev

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/emprestimos/:id/desembolso' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

{
  "id": "24f70ed1-76f3-4604-b341-f2bef2b34d05",
  "parceiro_id": "3f67b7e7-5de9-4a76-b108-d3469b8c6292",
  "numero": "A7565141-000",
  "status": "desembolso_agendado",
  "cpf_trabalhador": "93871045675",
  "nome_trabalhador": "João da Silva",
  "estado_civil": "solteiro",
  "cnpj_empregador": "12674953000114",
  "nome_empregador": "Alves Teixeira - EI",
  "matricula": "MAT-5646996721",
  "valor_liberado": "1000",
  "prazo": 10,
  "taxa_mensal": "1.79",
  "parcela_valor": "112.07",
  "cet_anual": "23.87",
  "iof": "17.86",
  "total_a_pagar": "1120.7",
  "saldo_devedor": "1120.7",
  "parcelas_pagas": 0,
  "chave_pix": "joao@example.com",
  "data_emissao": "2026-06-10T00:00:00.000Z",
  "data_primeira_parcela": "2026-08-28T00:00:00.000Z",
  "data_liberacao": "2026-06-10T00:00:00.000Z",
  "d4sign_uuid": "e9c02dc2-ab60-4e2f-a401-c263f443282d",
  "d4sign_status": "assinado",
  "assinatura_socinal": true,
  "docs_dataprev_status": null,
  "docs_dataprev_prazo": null,
  "criado_em": "2026-06-03T00:22:05.057Z",
  "atualizado_em": "2026-06-03T00:34:36.084Z",
  "proxima_acao": "aguardar_desembolso",
  "entrega_docs_dataprev": null
}