Criar proposta e link de autocontratação (fluxo do leilão)

POST/v1/jornadas/autocontratacao

🔒 Requer Bearer token

Escopo jornadas:write. Cria a proposta da solicitação arrematada e devolve o **link** da jornada, pronto para ir em contatos[] no envio da proposta à Socinal.

**Não exige telefone** — de propósito. No fluxo do operador o link vai por WhatsApp e o telefone é obrigatório; aqui quem entrega o link é a Socinal, e o payload do leilão não traz telefone.

Idempotente na prática: a proposta é deduplicada por CPF + linha entre as não finalizadas, e uma jornada já aberta para a mesma proposta é reaproveitada em vez de gerar um segundo link. Os campos proposta_reaproveitada e jornada_reaproveitada dizem o que aconteceu.

url é null quando o ambiente não tem APP_PUBLIC_URL/WEB_URL configurada — devolver link quebrado seria pior. Nesse caso o token ainda vem, e o chamador monta a URL.

⚠️ O link vale **7 dias** e a proposta da Socinal costuma valer **24 h**: um link vivo pode apontar para uma proposta já expirada.

Corpo da requisição

cpf_trabalhadorstringobrigatório

CPF do trabalhador (11 dígitos, sem pontuação).

padrão: ^\d{11}$

nome_trabalhadorstringobrigatório

mín. 2 car. · máx. 120 car.

taxa_mensalnumberobrigatório

Taxa mensal em **% a.m.** (1.85 = 1,85% a.m.), a arrematada no leilão. Fica travada na jornada: o trabalhador escolhe valor e prazo, nunca a taxa.

leilao_numerostringobrigatório

Número do leilão de origem. Além de rastrear, é o que põe a garantia FGTS no canal CTPS Digital (cobertura 100%).

mín. 1 car. · máx. 30 car.

numero_linhastringopcional

Linha de crédito da contratação. Omitida, vale a regra padrão da autocontratação: a linha ATIVA de menor número, preferindo o lado com seguro prestamista.

mín. 1 car. · máx. 20 car.

valornumberopcional

Valor arrematado. Junto com `prazo`, vira a condição pré-aprovada que o trabalhador vê primeiro na jornada.

≥ 1

prazonumberopcional

Prazo arrematado, em meses. Só vira condição pré-aprovada junto com `valor`.

≥ 1

garantiaobjectopcional

Garantia FGTS desta contratação. Com ao menos um componente marcado, a jornada ganha a etapa de garantia; a composição é montada quando o trabalhador aceita a condição, dimensionada para cobrir o valor bruto dela. Exige taxa dentro do teto legal do FGTS (1,99% a.m.).

Respostas

Corpo da resposta 201

Corpo não descrito no spec desta API.

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/jornadas/autocontratacao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf_trabalhador": "12345678901",
  "nome_trabalhador": "Maria Souza",
  "taxa_mensal": 1.85,
  "leilao_numero": "LEI-9001",
  "numero_linha": "92",
  "valor": 10000,
  "prazo": 24,
  "garantia": null
}'

Response

Sem corpo de resposta documentado.