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

# Cadastra corretor PJ.

`POST /cadastros/corretores/pessoa-juridica`

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