---
title: "Cadastra corretor PJ."
method: POST
path: "/cadastros/corretores/pessoa-juridica"
tags: ["Corretor"]
---

# Cadastra corretor PJ.

`POST /cadastros/corretores/pessoa-juridica`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/cadastros/corretores/pessoa-juridica`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **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)

Essa integração coleta informações de requisições realizadas por sistemas legados e verifica se o dado inserido no campo documento ou idcorretor_int (identificador do sistema legado) existe ou não no Construtor de Vendas. Se já existir um corretor cadastrado com o mesmo documento ou identificador, essa API irá atualizar os dados solicitados na requisição, senão irá cadastrá-los. **Obs: Para esta verificação, o documento CNPJ deve ser válido. Somente será aceito um cadastro por CNPJ.**

## Headers

- `email` string, required: E-mail para autenticação do usuário em cadastro de corretor pessoa jurídica
- `token` string, required: Token para autenticação do usuário em cadastro de corretor pessoa jurídica

## Request body

- CadastroCorretorPessoaJuridica: Cadastro de corretor do tipo Pessoa Jurídica
  - `idcorretor_int` string: Identificador do Corretor PJ no sistema legado.
  - `documento` string, required: Documento CNPJ do Corretor.
  - `razao_social` string, required: Razão social do Corretor.
  - `nome_fantasia` string, required: Nome fantasia do Corretor.
  - `data_nasc` string, required: Data de registro.
  - `inscricao_estadual` string: Inscrição Estadual do Corretor PJ.
  - `representante_nome` string: Nome representante do Corretor.
  - `representante_ddi_telefone` string: DDI do Telefone do representante.
  - `representante_telefone` string, required: Telefone do representante.
  - `representante_email` string, required: E-mail do representante.
  - `representante_documento` string: Documento do representante.
  - `cep` string: CEP do corretor PJ.
  - `logradouro` string: Logradouro do Endereço do corretor PJ.
  - `endereco` string: Endereço do corretor PJ.
  - `bairro` string: Bairro do corretor PJ.
  - `numero` string: Número do Endereço do corretor PJ.
  - `complemento` string: Complemento do corretor PJ.
  - `estado` string: Estado do corretor PJ.
  - `cidade` string: Cidade do corretor PJ.
  - `email` string, required: E-mail do corretor PJ.
  - `idimobiliaria_int` string: Identificador da imobiliária que o corretor PJ é vinculado no sistema legado.
  - `idimobiliaria` integer: Identificador da imobiliária que o corretor PJ é vinculado no CV.
  - `notificar_novos_leads` string, required: Informar o Aviso das notificações do Lead para corretor PJ.
  - `receber_email_leads_a_vencer` string, required: Informar o Recebimento de e-mail dos leads à vencer.
  - `creci` string, required: CRECI do Corretor PJ.
  - `tipo_conta` string: Tipo de Conta do Corretor PJ.
  - `banco` string: Nome do banco do Corretor PJ.
  - `nome_agencia` string: Nome da Agência do Corretor PJ.
  - `numero_agencia` string: Número da Agência do Corretor PJ.
  - `digito_agencia` string: Dígito da Agência do Corretor PJ.
  - `numero_conta` string: Número da Conta do Corretor PJ.
  - `digito_conta` string: Dígito da Conta do Corretor PJ.
  - `ativo_login` string: Informa se o Corretor PJ poderá se relacionar com outras funcionalidades (S ou N).

## Response `200`

Cadastro de corretor PJ realizado com sucesso.

- CadastroCorretorPessoaJuridicaSucesso: Retorna mensagem de corretor PJ cadastrado com sucesso.
  - `codigo` string
  - `mensagem` string

## Other responses

- `400`: Requisição de cadastro de corretor PJ inválida!

---

[API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)