---
title: "Criar uma pessoa do tipo \"jurídica\""
method: POST
path: "/escrow/api/persons2"
tags: ["Pessoas"]
---

# Criar uma pessoa do tipo "jurídica"

`POST /escrow/api/persons2`

## Request

- Base URL: `https://sandbox.platform.credit.celcoin.com.br`
- URL: `https://sandbox.platform.credit.celcoin.com.br/escrow/api/persons2`
- Auth: none declared

Esse endpoint deve ser utilizado para cadastrar uma Pessoa do tipo jurídica, usando um nº de CNPJ como identificador.

### Parâmetros do Body

- `name` (string, obrigatório): A razão social associada ao CNPJ em cadastro.
    
- `personType` (string, obrigatório): O tipo da pessoa, informar o valor "LEGAL" para cadastrar uma pessoa juridica. Possíveis valores: NATURAL, LEGAL.
    
- `taxpayerId` (string, obrigatório): O número do CNPJ de registro da empresa na Receita Federal.
    
- `documents` (object, obrigatório): Objeto contendo as 'keys' das URLs _'pre-signed'_ do documento de contrato social (documentIdentification) e comprovante de endereço (proofOfAddress).
    
- `idDocument` (object, obrigatório): Objeto para detalhar o documento de identificação que esta sendo enviado.
    
    - `issueDate` (string, obrigatório): Data de emissão do documento.
        
    - `issuer` (string, obrigatório): Orgão responsável pela emissão do documento.
        
    - `number` (string, obrigatório): Número do documento.
        
    - `type` (string, obrigatório): Tipo do documento. Valores aceitos: CNH, PASSPORT, RG, RNE.
        
- `birthDate` (string, obrigatório): Data de abertura da empresa no formato "AAAA-MM-DD".
    
- `emailAddress` (string, obrigatório): Endereço de e-mail para contato com a empresa cadastrada.
    
- `phone` (object, obrigatório): Objeto contendo os dados do telefone de contato.
    
    - `countryCode` (string): Código do país.
        
    - `areaCode` (string): Código de área.
        
    - `number` (string): Número do telefone.
        
- `address` (object, obrigatório): Objeto contendo detalhes do endereço de cadastro.
    
    - `streetNumber` (string): Número do endereço informado.
        
    - `streetName` (string): Nome da rua.
        
    - `postalCode` (string): Código de CEP para o endereço.
        
    - `district` (string): Campo para informar o bairro.
        
    - `city` (string): Nome da cidade.
        
    - `stateCode` (string): Código da UF para o estado do endereço.
        
    - `countryCode` (string): Código do país.
        
    - `extraInfo` (string): Complemento do endereço.
        
- `fundManagerId` (string/uuid v4): ID do gestor do Fundo, se aplicável.
    
- `fundSecuritizerId` (string/uuid v4): ID da securitizadora do Fundo, se aplicável.
    
- `fundAdministratorId` (string/uuid v4): ID do Admnistrador do Fundo, se aplicável.
    
- `representatives` (object): Objeto contendo os detalhes dos representantes da empresa. Deve ser enviado obrigatoriamente quando o tipo da Pessoa for jurídica (LEGAL).
    

##### Objeto "representatives"

- `role` (string, obrigatório): O tipo do relacionamento. Valores aceitos: PARTNER, MANAGER, PROXY, OTHER, EMPLOYEE.
    
- `taxpayerId` (string, obrigatório): O número do documento CPF para identificação da Pessoa.
    
- `fullName` (string, obrigatório): Nome do representante.
    
- `documents` (object): Objeto contendo as 'keys' das URLs _'pre-signed'_ dos documentos de identificação (documentIdentification) e comprovante de endereço (proofOfAddress).
    
- `idDocument` (object, obrigatório): Objeto para detalhar o documento de identificação que esta sendo enviado.
    
    - `issueDate` (string, obrigatório): Data de emissão do documento.
        
    - `issuer` (string, obrigatório): Orgão responsável pela emissão do documento.
        
    - `number` (string, obrigatório): Número do documento.
        
    - `type` (string, obrigatório): Tipo do documento. Valores aceitos: CNH, PASSPORT, RG, RNE.
        
- `birthDate` (string): Data de nascimento no formato "AAAA-MM-DD".
    
- `motherName` (string, obrigatório): Nome da mãe.
    
- `pep` (boolean, obrigatório): Campo para indica se a pessoa é politicamente exposta.
    
- `signContract` (boolean, obrigatório): Indica se a pessoa é representante e pode assinar pela Empresa.
    
- `emailAddress` (string, obrigatório): Endereço de e-mail para contato com a pessoa cadastrada.
    
- `phone` (object): Objeto contendo os dados do telefone de contato.
    
    - `countryCode` (string): Código do país no formato "+99".
        
    - `areaCode` (string): Código de área.
        
    - `number` (string): Número do telefone.
        
- `address` (object): Objeto contendo detalhes do endereço de cadastro.
    
    - `streetNumber` (string): Número do endereço informado.
        
    - `streetName` (string): Nome da rua.
        
    - `postalCode` (string): Código de CEP para o endereço.
        
    - `district` (string): Campo para informar o bairro.
        
    - `city` (string): Nome da cidade.
        
    - `stateCode` (string): Código da UF para o estado do endereço.
        
    - `countryCode` (string): Código do país.
        
    - `extraInfo` (string): Complemento do endereço.
        

### Resposta

A resposta da requisição será um JSON representando o retorno obtido para os campos enviados.

Em caso de sucesso será retornado um _status_code_ "200-OK". Em caso de falha será retornado um código 40x com a mensagem indicativa do erro.

- `id` (string/uuid v4): ID gerado para o cadastro realizado da Pessoa Jurídica.
    

##### Exemplo de JSON:

``` json
{
    "id": ""
}

 ```

## Headers

- `Content-Type` string
- `Accept` string

## Request body

- object

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/celcoin/apis/celcoin-escrow.md) - [All operations](https://skmtc.dev/celcoin/apis/celcoin-escrow/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/celcoin-escrow/revisions/5d55a35a6d51?raw)