post https://sandbox.auth.flowfinance.com.br/persons
Esse endpoint deve ser utilizado para cadastrar uma Pessoa.
Para criar uma nova conta, é necessário criar de forma antecipada as "pessoas", físicas e jurídicas, que farão parte da nova conta, seja como um titular ou como uma "parte" da conta.
Parâmetros do Body
name
(string, obrigatório): O nome completo da pessoa.
personType
(string, obrigatório): O tipo da pessoa. 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 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.
representatives
(object): Objeto contendo os detalhes dos representantes. Deve ser enviado 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
Exemplo de JSON:
{
"id": ""
}