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 BaaS Socinal exige o código do banco mesmo havendo PIX.

Corpo da requisição

cpf_trabalhadorstringobrigatório

mín. 11 car.

nome_trabalhadorstringobrigatório

mín. 2 car.

estado_civilenumopcional

solteirocasadodivorciadoviuvo

cargostringopcional

valor_liberadonumberobrigatório

≥ 0

prazonumberobrigatório

≥ 1

taxa_mensalnumberobrigatório

≥ 0

banco_codigostringobrigatório

banco_nomestringopcional

agenciastringobrigatório

contastringobrigatório

tipo_contaenumobrigatório

correntepoupanca

chave_pixstringobrigatório

data_primeira_parcelastringopcional

data_liberacaostringobrigatório

dados_documentoDadosDocumentoDtoobrigatório

nome_maestringobrigatório

rgstringobrigatório

orgao_expedidorstringobrigatório

uf_emissorstringobrigatório

data_emissao_docstringobrigatório

generoenumobrigatório

enderecoEnderecoDtoobrigatório

cepstringobrigatório

logradourostringobrigatório

numerostringobrigatório

complementostringopcional

bairrostringobrigatório

cidadestringobrigatório

ufstringobrigatório

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

201Empréstimo emitido (status `em_assinatura`).

400Header `Idempotency-Key` ausente (`IDEMPOTENCY_KEY_OBRIGATORIA`). Dados inválidos (`ERRO_VALIDACAO`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

502Integração externa indisponível (`DATAPREV_INDISPONIVEL`).

Request

curl -X POST 'http://localhost:3101/v1/emprestimos' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf_trabalhador": "string",
  "nome_trabalhador": "string",
  "estado_civil": "solteiro",
  "cargo": "string",
  "valor_liberado": 0,
  "prazo": 0,
  "taxa_mensal": 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"
    }
  },
  "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": "averbada",
  "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": "0.0179",
  "parcela_valor": "112.07",
  "cet_anual": "0.2387",
  "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",
  "criado_em": "2026-06-03T00:22:05.057Z",
  "atualizado_em": "2026-06-03T00:34:36.084Z",
  "proxima_acao": "desembolsar"
}