---
title: "Cadastra o Pré-cadastro"
method: POST
path: "/v1/comercial/precadastro"
tags: ["Pré-cadastro"]
---

# Cadastra o Pré-cadastro

`POST /v1/comercial/precadastro`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

A interface viabiliza o cadastro de um pré-cadastro do sistema CV, juntamente com o cadastro ou modificação da pessoa vinculada àquele pré-cadastro. É possível realizar associação de pessoas à pessoa titular do pré-cadastro. Todas as automações e associações disponíveis no sistema são possibilitadas nesta API, tais como envio de e-mail para os gestores informando o cadastro, envio de e-mail para a pessoa concluir o registro dos dados, criação de leads para cada pessoa do pré-cadastro.

## Headers

- `email` string, required
- `token` string, required

## Request body

- CadastrarPrecadastro
  - `idempreendimento` integer, required
  - `idunidade` integer
  - `idcorretor` integer, required
  - `codigointerno` string
  - `valor_avaliacao` string, required
  - `valor_aprovado` string
  - `valor_subsidio` string
  - `valor_fgts` string
  - `valor_total` string — Deve ser a soma dos valores dos campos valor_aprovado, valor_subsidio e valor_fgts.
  - `saldo_devedor` string
  - `prazo` string
  - `tabela` string
  - `valor_prestacao` string
  - `carta_credito` string
  - `vencimento_aprovacao` string
  - `pausar_hook` boolean
  - `observacoes` string
  - `idlead` integer — Ao informar, será realizada verificações: - Se o e-mail e o telefone do lead correspondem exatamente aos dados das pessoas do pré-cadastro. - Se o lead informado está sob responsabilidade do mesmo corretor informado no pré-cadastro. Caso alguma dessas condições não seja atendida, o pré-cadastro será criado sem vínculo ao lead informado.
  - `pessoa` object, required
    - `idpessoa` integer — Identificador da pessoa do pré-cadastro caso ela já exista no sistema.
    - `documento_tipo` string — Campo obrigatório. Deve ser do tipo "cpf" ou "cnpj".
    - `documento` string — Campo obrigatório. Deve ser um CPF ou CNPJ válido.
    - `codigointerno` string
    - `nome` string
    - `reconhecimento_firma` string
    - `sexo` string — Gênero da pessoa do pré-cadastro. Deve ser preenchido com "M", "F" ou "NDI"
    - `data_nasc` string
    - `estado_civil` string
    - `data_casamento` string
    - `pacto_antenupcial_livro` string
    - `folha` string
    - `cartorio` string
    - `pais` string — Será ignorado caso seja passado um idpais.
    - `idpais` integer
    - `naturalidade` string
    - `possui_dependentes` string
    - `quantidade_dependentes` integer
    - `possui_procuracao` string
    - `possui_pacto_antenupcial` string
    - `menor_nao_emancipado` string
    - `grau_instrucao` string
    - `renda_familiar` string
    - `marketing_pos_venda` string
    - `rg` string
    - `rg_orgao_emissor` string
    - `rg_data_emissao` string
    - `rne` string
    - `rne_orgao_emissor` string
    - `rne_data_emissao` string
    - `passaporte` string
    - `passaporte_orgao_emissor` string
    - `passaporte_data_emissao` string
    - `cnh` string
    - `cnh_orgao_emissor` string
    - `data_primeira_habilitacao_cnh` string
    - `cnh_data_validade` string
    - `cnh_data_emissao` string
    - `rnm` string
    - `rnm_orgao_emissor` string
    - `rnm_data_emissao` string
    - `filiacao_mae` string
    - `filiacao_pai` string
    - `cep` string
    - `idlogradouro` string — Identificador ou nome do logradouro do cliente do pré-cadastro.
    - `endereco` string
    - `bairro` string
    - `numero` string
    - `complemento` string
    - `estado` string — Estado em que a pessoa reside. Será ignorado caso seja passado o idestado.
    - `idestado` integer
    - `cidade` string — Cidade em que a pessoa reside. Será ignorado caso seja passado o idcidade.
    - `idcidade` integer
    - `endereco_idpais` integer
    - `tipo_residencia` string
    - `reside_com` string — Forma que o cliente reside. Deve ser umas das opções: "SZ", "CP", "CC" ou "OT".
    - `valor_aluguel` string
    - `tempo_residencia` integer — Tempo que mora na residência (informar em meses).
    - `tipo_correspondencia` string — Tipo de correspondência do cliente. Deve ser umas das opções: "R", "C" ou "T".
    - `politicamente_exposta` string
    - `ppe_cargo` string
    - `ppe_exercicio` string
    - `suspeito` string
    - `residente_municipio_fronteira` string
    - `relacionamento_ppe` string
    - `relacionamento_ppe_nome` string
    - `relacionamento_ppe_parentesco` string
    - `relacionamento_ppe_cargo` string
    - `relacionamento_ppe_exercicio` string
    - `relacionamento_ppe_identificacao` string
    - `relacionamento_ppe_orgao_emissor` string
    - `relacionamento_ppe_data_nasc` string
    - `relacionamento_ppe_cpf` string
    - `idclassificacao` string
    - `numero_pis` string
    - `observacoes` string
    - `senha` string
    - `confirma` string — Confirmação de senha. Obrigatório se for informado o campo "senha".
    - `email` string
    - `email_confirmacao` string — Confirmação de e-mail. Obrigatório se for informado o campo "email".
    - `telefone` string
    - `celular` string
    - `referencia_nome` string
    - `referencia_telefone` string
    - `referencia_parentesco` string
    - `cep_contato_relacionamento` string
    - `endereco_contato_relacionamento` string
    - `bairro_contato_relacionamento` string
    - `numero_contato_relacionamento` string
    - `complemento_contato_relacionamento` string
    - `idestado_contato_relacionamento` integer
    - `idcidade_contato_relacionamento` integer
    - `idpais_contato_relacionamento` integer
    - `telefone_contato_relacionamento` string
    - `celular_contato_relacionamento` string
    - `email_contato_relacionamento` string
    - `email_confirmacao_contato_relacionamento` string — Confirmação de e-mail de contato e relacionamento. Obrigatório se for informado o campo "email_contato_relacionamento".
    - `trabalho_nome_empresa` string
    - `trabalho_cnpj` string
    - `trabalho_idpais` integer
    - `trabalho_site` string
    - `trabalho_data_admissao` string
    - `idprofissao` integer
    - `profissao` string
    - `trabalho_cargo` string
    - `remuneracao_bruta` string
    - `remuneracao_liquida` string
    - `trabalho_participacao_proprietario` string — Deve ser menor ou igual a 100.
    - `trabalho_telefone` string
    - `trabalho_celular` string
    - `trabalho_email` string
    - `trabalho_cep` string
    - `idlogradouro_trabalho` string — Identificador ou nome do logradouro da empresa.
    - `trabalho_endereco` string
    - `trabalho_bairro` string
    - `trabalho_numero` string
    - `complemento_trabalho` string
    - `trabalho_estado` string — Estado da empresa. Será ignorado caso seja passado trabalho_idestado.
    - `trabalho_idestado` string
    - `trabalho_cidade` string — Cidade da empresa. Será ignorado caso seja passado trabalho_idcidade.
    - `trabalho_idcidade` string
    - `trabalho_endereco_idpais` integer
    - `trabalho_anterior_nome_empresa` string
    - `trabalho_anterior_cnpj` string
    - `trabalho_anterior_data_admissao` string
    - `trabalho_anterior_data_desligamento` string
    - `possui_outras_rendas` string
    - `valor_mensal_bruto` string
    - `valor_mensal_liquido` string
    - `renda_proveniente_de` string
    - `renda_comprovada_atraves_de` string
    - `possui_aplicacao_financeira` string
    - `valor_total_aplicacao` string
    - `rendimento_mensal_aplicacao` string
    - `banco_aplicacao` string
    - `pretende_utilizar_fgts` string
    - `valor_fgts` string
    - `possui_imovel` string
    - `possui_onus_imovel` string
    - `cep_imovel_proprietario` string
    - `endereco_imovel_proprietario` string
    - `bairro_imovel_proprietario` string
    - `idestado_imovel_proprietario` integer
    - `idcidade_imovel_proprietario` integer
    - `endereco_idpais_imovel_proprietario` integer
    - `possui_bem` string
    - `quantidade_imoveis_possui` integer
    - `quais_bens` string
    - `situacao_do_bem` string — Deve ser umas das opções: "QU" ou "FI".
    - `valor_do_bem` string
    - `idbanco` string
    - `banco_nome` string
    - `banco_agencia` string
    - `banco_conta` string
    - `banco_nome_titular` string
    - `banco_tipo_doc` string
    - `banco_cpf_titular` string
    - `banco_cnpj_titular` string
    - `banco_chave_pix` string
    - `banco_observacoes` string
  - `fator_social` object[]
    - `nome` string — Nome do dependente.
    - `cpf` string — cpf do dependente.
    - `grau_parentesco` string — So aceita: "pai","mae","irmao","irma","tio","tia","avo_m","avo_f","sobrinho","sobrinha"
    - `pessoa_estrangeira` string — "S" - Sim ou "N" - Não.
  - `associado` object
    - `idtipo` integer — Campo obrigatório. Identificador do tipo de associação.
    - `idpessoa` integer — Identificador da pessoa do pré-cadastro caso ela já exista no sistema.
    - `documento_tipo` string — Campo obrigatório. Deve ser do tipo "cpf" ou "cnpj".
    - `documento` string — Campo obrigatório. Deve ser um CPF ou CNPJ válido.
    - `codigointerno` string
    - `nome` string
    - `reconhecimento_firma` string
    - `sexo` string — Gênero da pessoa do pré-cadastro. Deve ser preenchido com "M", "F" ou "NDI"
    - `data_nasc` string
    - `estado_civil` string
    - `data_casamento` string
    - `pacto_antenupcial_livro` string
    - `folha` string
    - `cartorio` string
    - `pais` string — Será ignorado caso seja passado um idpais.
    - `idpais` integer
    - `naturalidade` string
    - `possui_dependentes` string
    - `quantidade_dependentes` integer
    - `possui_procuracao` string
    - `possui_pacto_antenupcial` string
    - `menor_nao_emancipado` string
    - `grau_instrucao` string
    - `renda_familiar` string
    - `marketing_pos_venda` string
    - `rg` string
    - `rg_orgao_emissor` string
    - `rg_data_emissao` string
    - `rne` string
    - `rne_orgao_emissor` string
    - `rne_data_emissao` string
    - `passaporte` string
    - `passaporte_orgao_emissor` string
    - `passaporte_data_emissao` string
    - `cnh` string
    - `cnh_orgao_emissor` string
    - `data_primeira_habilitacao_cnh` string
    - `cnh_data_validade` string
    - `cnh_data_emissao` string
    - `rnm` string
    - `rnm_orgao_emissor` string
    - `rnm_data_emissao` string
    - `filiacao_mae` string
    - `filiacao_pai` string
    - `cep` string
    - `idlogradouro` string — Identificador ou nome do logradouro do cliente do pré-cadastro.
    - `endereco` string
    - `bairro` string
    - `numero` string
    - `complemento` string
    - `estado` string — Estado em que a pessoa reside. Será ignorado caso seja passado o idestado.
    - `idestado` integer
    - `cidade` string — Cidade em que a pessoa reside. Será ignorado caso seja passado o idcidade.
    - `idcidade` integer
    - `endereco_idpais` integer
    - `tipo_residencia` string
    - `reside_com` string — Forma que o cliente reside. Deve ser umas das opções: "SZ", "CP", "CC" ou "OT".
    - `valor_aluguel` string
    - `tempo_residencia` integer — Tempo que mora na residência (informar em meses).
    - `tipo_correspondencia` string — Tipo de correspondência do cliente. Deve ser umas das opções: "R", "C" ou "T".
    - `politicamente_exposta` string
    - `ppe_cargo` string
    - `ppe_exercicio` string
    - `suspeito` string
    - `residente_municipio_fronteira` string
    - `relacionamento_ppe` string
    - `relacionamento_ppe_nome` string
    - `relacionamento_ppe_parentesco` string
    - `relacionamento_ppe_cargo` string
    - `relacionamento_ppe_exercicio` string
    - `relacionamento_ppe_identificacao` string
    - `relacionamento_ppe_orgao_emissor` string
    - `relacionamento_ppe_data_nasc` string
    - `relacionamento_ppe_cpf` string
    - `idclassificacao` string
    - `numero_pis` string
    - `observacoes` string
    - `senha` string
    - `confirma` string — Confirmação de senha. Obrigatório se for informado o campo "senha".
    - `email` string
    - `email_confirmacao` string — Confirmação de e-mail. Obrigatório se for informado o campo "email".
    - `telefone` string
    - `celular` string
    - `referencia_nome` string
    - `referencia_telefone` string
    - `referencia_parentesco` string
    - `cep_contato_relacionamento` string
    - `endereco_contato_relacionamento` string
    - `bairro_contato_relacionamento` string
    - `numero_contato_relacionamento` string
    - `complemento_contato_relacionamento` string
    - `idestado_contato_relacionamento` integer
    - `idcidade_contato_relacionamento` integer
    - `idpais_contato_relacionamento` integer
    - `telefone_contato_relacionamento` string
    - `celular_contato_relacionamento` string
    - `email_contato_relacionamento` string
    - `email_confirmacao_contato_relacionamento` string — Confirmação de e-mail de contato e relacionamento. Obrigatório se for informado o campo "email_contato_relacionamento".
    - `trabalho_nome_empresa` string
    - `trabalho_cnpj` string
    - `trabalho_idpais` integer
    - `trabalho_site` string
    - `trabalho_data_admissao` string
    - `idprofissao` integer
    - `profissao` string
    - `trabalho_cargo` string
    - `remuneracao_bruta` string
    - `remuneracao_liquida` string
    - `trabalho_participacao_proprietario` string — Deve ser menor ou igual a 100.
    - `trabalho_telefone` string
    - `trabalho_celular` string
    - `trabalho_email` string
    - `trabalho_cep` string
    - `idlogradouro_trabalho` string — Identificador ou nome do logradouro da empresa.
    - `trabalho_endereco` string
    - `trabalho_bairro` string
    - `trabalho_numero` string
    - `complemento_trabalho` string
    - `trabalho_estado` string — Estado da empresa. Será ignorado caso seja passado trabalho_idestado.
    - `trabalho_idestado` string
    - `trabalho_cidade` string — Cidade da empresa. Será ignorado caso seja passado trabalho_idcidade.
    - `trabalho_idcidade` string
    - `trabalho_endereco_idpais` integer
    - `trabalho_anterior_nome_empresa` string
    - `trabalho_anterior_cnpj` string
    - `trabalho_anterior_data_admissao` string
    - `trabalho_anterior_data_desligamento` string
    - `possui_outras_rendas` string
    - `valor_mensal_bruto` string
    - `valor_mensal_liquido` string
    - `renda_proveniente_de` string
    - `renda_comprovada_atraves_de` string
    - `possui_aplicacao_financeira` string
    - `valor_total_aplicacao` string
    - `rendimento_mensal_aplicacao` string
    - `banco_aplicacao` string
    - `pretende_utilizar_fgts` string
    - `valor_fgts` string
    - `possui_imovel` string
    - `possui_onus_imovel` string
    - `cep_imovel_proprietario` string
    - `endereco_imovel_proprietario` string
    - `bairro_imovel_proprietario` string
    - `idestado_imovel_proprietario` integer
    - `idcidade_imovel_proprietario` integer
    - `endereco_idpais_imovel_proprietario` integer
    - `possui_bem` string
    - `quantidade_imoveis_possui` integer
    - `quais_bens` string
    - `situacao_do_bem` string — Deve ser umas das opções: "QU" ou "FI".
    - `valor_do_bem` string
    - `idbanco` string
    - `banco_nome` string
    - `banco_agencia` string
    - `banco_conta` string
    - `banco_nome_titular` string
    - `banco_tipo_doc` string
    - `banco_cpf_titular` string
    - `banco_cnpj_titular` string
    - `banco_chave_pix` string
    - `banco_observacoes` string

## Response `200`

Operação realizada com sucesso.

- object
  - `sucesso` boolean
  - `mensagem` string

## Other responses

- `400` — Requisição Incorreta! Algum dos dados obrigatórios não foi informado ou foi informado de forma incorreta.
- `401` — E-mail e/ou token incorreto(s).
- `404` — Requisição Incorreta! Algum dos dados informados não foi encontrado no sistema.

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/revisions/42bf5add8bf3/schema)