6.1. Criar Proposta¶

Especificação — em construção

Os serviços descritos nesta área ainda não estão disponíveis.

🔗 Endpoint¶

Método	URL
	`/credito/esteiras/{idEsteira}/propostas`

🧾 Descrição¶

Cria a proposta com os dados do tomador. É o primeiro passo que persiste algo — até aqui, a jornada era só cotação.

Ao criar, a plataforma:

cadastra ou atualiza o tomador (e seus sócios, se pessoa jurídica);
cria a proposta no status Em digitação (1);
monta a lista de documentos exigidos, conforme o tipo de pessoa e o papel de cada pessoa vinculada.

🔹 Path Parameter¶

Parâmetro	Tipo	Descrição
idEsteira	integer	Identificador da esteira, obtido em 3.1

🔹 Headers¶

Além dos headers padrão, use Idempotency-Key. Sem ele, um timeout de rede seguido de retry cria uma segunda proposta para o mesmo cliente.

📤 Requisição¶

O corpo é um objeto tomador, cujo formato completo está em 4.2. Pessoa Física e Situação de Renda e 4.3. Pessoa Jurídica e Representantes.

📋 Payload — pessoa física¶

{
  "tomador": {
    "tipo": 1,
    "nome": "João da Silva",
    "documento": "12345678900",
    "data": "1988-04-12",
    "rg": "123456789",
    "telefone": "47999998888",
    "email": "joao@exemplo.com",
    "paisNacionalidade": "Brasil",
    "sexo": 1,
    "nomeMae": "Maria da Silva",
    "pessoaPoliticamenteExposta": false,
    "estadoCivil": 2,
    "conjuge": { "nome": "Ana da Silva", "cpf": "98765432100" },
    "escolaridade": 5,
    "cnh": 2,
    "vinculoEmpregaticio": {
      "situacaoRenda": 1,
      "empresa": { "cnpj": "12345678000199", "razaoSocial": "Empresa X LTDA" },
      "dataAdmissao": "2020-03-01",
      "cargo": 252105,
      "salario": 6500.00
    },
    "endereco": {
      "cep": "89010000",
      "endereco": "Rua das Flores",
      "numero": "120",
      "complemento": "Apto 302",
      "bairro": "Centro",
      "cidade": "Blumenau",
      "uf": "SC",
      "tipoEndereco": 1
    }
  }
}

📋 Payload — pessoa jurídica¶

{
  "tomador": {
    "tipo": 2,
    "nome": "Comércio Silva LTDA",
    "documento": "12345678000199",
    "data": "2012-05-20",
    "telefone": "4733334444",
    "email": "financeiro@silva.com.br",
    "nomeFantasia": "Silva Materiais",
    "quantidadeFilial": 2,
    "quantidadeFuncionario": 35,
    "inscricaoMunicipal": "123456",
    "inscricaoEstadual": "2547896321",
    "faturamento": [ { "data": "2026-07-01", "valor": 480000.00 } ],
    "cnae": [ { "codigo": "4744001", "principalAtividade": true } ],
    "pessoas": [
      {
        "tipo": 1,
        "nome": "José Silva",
        "documento": "11122233344",
        "data": "1970-02-09",
        "telefone": "47988887777",
        "email": "jose@silva.com.br",
        "nomeMae": "Cida Silva",
        "estadoCivil": 1,
        "escolaridade": 5,
        "cnh": 2,
        "socio": true,
        "socioPercentualParticipacao": 60.00,
        "representanteLegal": true,
        "socioDesde": "2012-05-20",
        "endereco": { "cep": "89010000", "endereco": "Rua das Palmeiras", "numero": "45", "bairro": "Centro", "cidade": "Blumenau", "uf": "SC" }
      }
    ],
    "endereco": { "cep": "89010000", "endereco": "Rua do Comércio", "numero": "1000", "bairro": "Industrial", "cidade": "Blumenau", "uf": "SC" }
  }
}

🧪 Exemplo de cURL¶

curl -X POST "https://api.vehub.com.br/credito/esteiras/12/propostas" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Idempotency-Key: 8f14e45f-ea4f-4e2c-9c3e-9b1a72d0c5f1" \
  -H "Content-Type: application/json" \
  -d @tomador.json

📥 Responses¶

✅ 201 Created¶

{
  "sucesso": true,
  "mensagem": "Proposta criada com sucesso.",
  "dados": {
    "idProposta": 1001
  }
}

Guarde o idProposta: ele endereça todas as etapas seguintes.

❌ 400 Bad Request¶

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "status": 400,
  "errors": [
    { "campo": "tomador.documento", "mensagem": "CPF inválido." },
    { "campo": "tomador.nomeMae", "mensagem": "Campo obrigatório para pessoa física." },
    { "campo": "tomador.vinculoEmpregaticio.salario", "mensagem": "Campo obrigatório quando a situação de renda é com vínculo empregatício." }
  ]
}

❌ 422 Unprocessable Entity¶

Tipo de pessoa não permitido pela esteira:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.21",
  "status": 422,
  "errors": [
    { "campo": "tomador.tipo", "mensagem": "Esta esteira aceita somente pessoa física." }
  ]
}

🧭 Próximo passo¶

A ordem das etapas depende da configuração da esteira. Em vez de fixá-la, consulte a proposta recém-criada e siga proximaEtapa:

curl -X GET "https://api.vehub.com.br/credito/propostas/1001" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"

Ver 6.10. Consultar, Listar e Pendências.

⚠️ Observações¶

Reaproveite o cadastro. Consulte 4.1 antes de montar a ficha: se o tomador já existe, você evita pedir tudo de novo ao cliente e reaproveita documentos ainda válidos.
A criação sobrescreve o cadastro do tomador. Os dados enviados aqui atualizam o cadastro existente para aquele documento. Confirme com o cliente antes de enviar dados vindos de um cache antigo.
Documentos exigidos são definidos pela plataforma, na criação. Se você alterar depois o tipo de pessoa ou os representantes legais, a lista é recalculada.
Na jornada simplificada (dadosSimplificadosAnaliseCredito = true), você pode criar a proposta com o mínimo do tomador, simular, submeter ao motor e só completar a ficha depois da aprovação — via PUT /credito/propostas/{idProposta}/tomador. Ver 9.3. Roteiro - Jornada simplificada.