> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zipdin.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Proposta de E-Consignado

> Crie uma nova proposta de crédito consignado privado para seu cliente

# Criar Proposta

Inicie o processo de consignado privado para um funcionário. A proposta será analisada automaticamente e você receberá o resultado via webhook.

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/authentication) para obter suas credenciais e gerar um token.
</Info>

## Parâmetros

<ParamField body="nu_cpf" type="string" required>
  CPF do funcionário (somente números)
</ParamField>

<ParamField body="nu_cnpj_conveniada" type="string" required>
  CNPJ da empresa conveniada
</ParamField>

<ParamField body="vl_emprestimo" type="number" required>
  Valor do empréstimo desejado (R\$)
</ParamField>

<ParamField body="qt_parcela" type="integer" required>
  Número de parcelas (6 a 96)
</ParamField>

<ParamField body="dados_bancarios" type="object" required>
  Conta para depósito do valor

  <Expandable>
    <ParamField body="dados_bancarios.pix" type="string">Chave PIX do cliente</ParamField>
    <ParamField body="dados_bancarios.banco" type="string">Código do banco (3 dígitos)</ParamField>
    <ParamField body="dados_bancarios.agencia" type="string">Agência</ParamField>
    <ParamField body="dados_bancarios.conta" type="string">Conta com dígito</ParamField>
  </Expandable>
</ParamField>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.zipdin.com.br/api/v1/propostas \
    -H "Authorization: Bearer SEU_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "nu_cpf": "12345678901",
      "nu_cnpj_conveniada": "12345678000190",
      "vl_emprestimo": 5000.00,
      "qt_parcela": 24,
      "dados_bancarios": { "pix": "12345678901" }
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.zipdin.com.br/api/v1/propostas",
      headers={"Authorization": f"Bearer {token}"},
      json={
          "nu_cpf": "12345678901",
          "nu_cnpj_conveniada": "12345678000190",
          "vl_emprestimo": 5000.00,
          "qt_parcela": 24,
          "dados_bancarios": {"pix": "12345678901"}
      }
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.zipdin.com.br/api/v1/propostas", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      nu_cpf: "12345678901",
      nu_cnpj_conveniada: "12345678000190",
      vl_emprestimo: 5000.00,
      qt_parcela: 24,
      dados_bancarios: { pix: "12345678901" }
    })
  });
  ```
</CodeGroup>

<ResponseExample>
  ```json 201 - Proposta criada theme={null}
  {
    "nu_proposta": 789456,
    "status": "em_analise",
    "dt_criacao": "2026-08-06T10:30:00-03:00",
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
  ```

  ```json 422 - Regra de negócio theme={null}
  {
    "error": "BUSINESS_RULE_VIOLATION",
    "message": "Funcionário não encontrado na empresa informada"
  }
  ```
</ResponseExample>

## Próximos Passos

Após criar a proposta, você receberá o resultado da análise via [webhook](/guides/webhooks) `proposta.pre_aprovada` ou `proposta.negada`. Se aprovada, prossiga com a [simulação](/docs/e-consignado/simular).

Para acompanhar todo o ciclo de vida da proposta, veja os status possíveis em [Consultar Status](/docs/e-consignado/consultar-status).