Emitir CCB

POST/v1/emprestimos

🔒 Requer Bearer token

Escopo emprestimos:write. Requer header Idempotency-Key (replay devolve a resposta original com X-Idempotency-Replayed: true). Envie os dados do trabalhador (data_nascimento_trabalhador, telefone_trabalhador, email_trabalhador), empregador (cnpj_empregador, nome_empregador, matricula, salario_bruto, margem), numero_linha e a referência consulta_margem_id de uma consulta de margem válida (< 30 dias, obtida em POST /v1/margem/consulta). taxa_mensal é informada em **percentual a.m.** (ex.: 1.79). São obrigatórios chave_pix **e** os dados bancários completos (banco_codigo, agencia, conta, tipo_conta) — o código do banco é exigido mesmo havendo PIX. Em dados_documento, só nome_mae, genero e endereco são obrigatórios: os dados do RG (rg, orgao_expedidor, uf_emissor, data_emissao_doc) são **opcionais** — o consignado não os exige e, sem rg, o número de documento registrado é o próprio CPF. Se informar qualquer um deles, data_emissao_doc passa a ser obrigatória.

Corpo da requisição

taxa_mensalnumberobrigatório

Taxa mensal em % a.m. (1.79 = 1,79% a.m.), a mesma unidade da simulação e da resposta. Enviar em fração (0.0179) é recusado com 400.

iofnumberopcional

IOF do empréstimo (da simulação). Compõe o valor bruto usado como base da cobertura FGTS. Se omitido, o servidor estima.

≥ 0

cpf_trabalhadorstringobrigatório

mín. 11 car.

nome_trabalhadorstringobrigatório

mín. 2 car.

estado_civilstringopcional

solteirocasadodivorciadoviuvo

cargostringopcional

valor_liberadonumberobrigatório

≥ 0

prazonumberobrigatório

≥ 1

banco_codigostringobrigatório

banco_nomestringopcional

agenciastringobrigatório

contastringobrigatório

tipo_contastringobrigatório

correntepoupanca

chave_pixstringobrigatório

data_primeira_parcelastringopcional

data_liberacaostringobrigatório

dados_documentoDadosDocumentoDtoobrigatório

nome_maestringobrigatório

rgstringopcional

orgao_expedidorstringopcional

uf_emissorstringopcional

data_emissao_docstringopcional

generostringobrigatório

enderecoEnderecoDtoobrigatório

cepstringobrigatório

logradourostringobrigatório

numerostringobrigatório

complementostringopcional

bairrostringobrigatório

cidadestringobrigatório

ufstringobrigatório

garantia_fgtsobjectopcional

Garantia FGTS a congelar nesta CCB (canal próprio IF). Os tetos (saldo/multa) e a autorização são reconsultados e validados no servidor no momento da emissão; a cobertura mínima por canal e o teto de taxa de 1,99% a.m. são obrigatórios. Omita para emitir sem garantia FGTS. Ignorado quando `proposta_id` é fornecido (a garantia é copiada/congelada da proposta).

numero_linhastringobrigatório

Número da linha de crédito (do `GET /v1/linhas-credito`).

padrão: ^\d+$

consulta_margem_idstring<uuid>obrigatório

Referência a uma consulta de margem válida (< 30 dias) obtida em `POST /v1/margem/consulta`.

data_nascimento_trabalhadorstringobrigatório

Data de nascimento (YYYY-MM-DD).

telefone_trabalhadorstringobrigatório

Telefone (DDD + número).

email_trabalhadorstringobrigatório

E-mail do trabalhador.

cnpj_empregadorstringobrigatório

CNPJ do empregador.

nome_empregadorstringobrigatório

Nome do empregador.

matriculastringobrigatório

Matrícula no empregador.

salario_brutonumberobrigatório

Salário bruto.

≥ 0

margemnumberobrigatório

Margem disponível.

≥ 0

Respostas

Corpo da resposta 201

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' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{
  "taxa_mensal": 1.79,
  "iof": 22.44,
  "cpf_trabalhador": "string",
  "nome_trabalhador": "string",
  "estado_civil": "solteiro",
  "cargo": "string",
  "valor_liberado": 0,
  "prazo": 0,
  "banco_codigo": "string",
  "banco_nome": "string",
  "agencia": "string",
  "conta": "string",
  "tipo_conta": "corrente",
  "chave_pix": "string",
  "data_primeira_parcela": "string",
  "data_liberacao": "string",
  "dados_documento": {
    "nome_mae": "string",
    "rg": "string",
    "orgao_expedidor": "string",
    "uf_emissor": "string",
    "data_emissao_doc": "string",
    "genero": "M",
    "endereco": {
      "cep": "string",
      "logradouro": "string",
      "numero": "string",
      "complemento": "string",
      "bairro": "string",
      "cidade": "string",
      "uf": "string"
    }
  },
  "garantia_fgts": null,
  "numero_linha": "92",
  "consulta_margem_id": "3f1c8a90-0000-4000-8000-000000000000",
  "data_nascimento_trabalhador": "1985-03-22",
  "telefone_trabalhador": "11999998888",
  "email_trabalhador": "joao@email.com",
  "cnpj_empregador": "12674953000114",
  "nome_empregador": "Alves Teixeira - EI",
  "matricula": "MAT-5646996721",
  "salario_bruto": 3559.35,
  "margem": 1035.65
}'

Response

{
  "id": "24f70ed1-76f3-4604-b341-f2bef2b34d05",
  "parceiro_id": "3f67b7e7-5de9-4a76-b108-d3469b8c6292",
  "numero": "A7565141-000",
  "status": "em_assinatura",
  "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": null,
  "d4sign_uuid": null,
  "d4sign_status": null,
  "assinatura_socinal": true,
  "docs_dataprev_status": null,
  "docs_dataprev_prazo": null,
  "criado_em": "2026-06-03T00:22:05.057Z",
  "atualizado_em": "2026-06-03T00:22:05.057Z",
  "proxima_acao": "enviar_assinatura",
  "entrega_docs_dataprev": null
}