Criar uma pessoa do tipo "física"

Esse endpoint deve ser utilizado para cadastrar uma Pessoa do tipo física, usando um nº de CPF como identificador.

Parâmetros do Body

  • name (string, obrigatório): O nome completo da pessoa.
  • personType (string, obrigatório): O tipo da pessoa, informar o valor como "NATURAL" para o cadastro de uma pessoa física. Possíveis valores: NATURAL, LEGAL.
  • taxpayerId (string, obrigatório): O número do documento CPF para identificação da Pessoa.
  • documents (object, obrigatório): 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, obrigatório): Data de nascimento da Pessoa a ser cadastrada no formato "AAAA-MM-DD".
  • motherName (string, obrigatóri): Nome da mãe.
  • pep (boolean, obrigatório): Campo para indica se a pessoa é politicamente exposta.
  • emailAddress (string, obrigatório): Endereço de e-mail para contato com a pessoa 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.

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 física.
Exemplo de JSON:
{
    "id": ""
}

Language
Credentials
Bearer
URL
Click Try It! to start a request and see the response here!