Iniciar pré-análise de perfil

POST /pre-profile-analysis

Inicia a análise de perfil dos pretendentes à locação para a imobiliária informada.

Request

{
  "persons": [
    {
      "cpf": "52998224725",
      "fullName": "John Doe",
      "phone": "11999999999",
      "email": "[email protected]",
      "monthlyIncome": 5000.0,
      "isLead": true
    }
  ],
  "realEstate": {
    "name": "Real Estate Ltda.",
    "cnpj": "11444777000161"
  }
}

Campo	Tipo	Obrigatório	Regras
`persons`	array	Sim	Não pode ser vazio
`persons[].cpf`	string	Sim	Exatamente 11 dígitos, sem pontuação, CPF válido
`persons[].fullName`	string	Sim	3 a 80 caracteres
`persons[].phone`	string	Sim	Exatamente 11 dígitos (DDD + número)
`persons[].email`	string	Sim	E-mail válido
`persons[].monthlyIncome`	number	Sim	Maior que zero (mínimo 0.01)
`persons[].isLead`	boolean	Sim	`true` para o pretendente principal
`realEstate.name`	string	Sim	Não vazio
`realEstate.cnpj`	string	Sim	Exatamente 14 dígitos, sem pontuação, CNPJ válido

Sucesso — 200 OK

{
  "preProfileAnalysisId": "rentals_pa_abc123xyz"
}

Erros mapeados

HTTP	`code`	Quando ocorre
400	`PRE_PROFILE_ANALYSIS_INVALID_REQUEST`	Payload estruturalmente inválido segundo a análise
403	`PRE_PROFILE_ANALYSIS_PARTNER_NOT_AUTHORIZED`	Parceiro não possui vínculo ativo com o CNPJ da imobiliária informada
422	`PRE_PROFILE_ANALYSIS_REQUEST_REJECTED`	Regra de negócio rejeitou a solicitação (ex.: CPF inválido na base)
500	`PRE_PROFILE_ANALYSIS_INTEGRATION_FAILURE`	Falha de comunicação interna — repetir com backoff

O resultado da pré-análise não é síncrono. Consulte em GET /pre-profile-analysis (6.2) ou
assine o evento profile_analysis.finished
ou assine o evento greyzone_analysis.finished via webhook para saber quando a análise entra em greyzone.

Greyzone será lançado em versões futuras. Esta funcionalidade está em desenvolvimento e não está disponível em produção ainda.