Abertura de conta PJ
Request
ENDPOINT
/accountMÉTODO
POSTRequest Body
{
"account_owner": {
"address": {
"city": "Caraguatatuba",
"complement": "complemento",
"neighborhood": "Jaraguazinho",
"number": "924",
"postal_code": "11675200",
"state": "SP",
"street": "Praça Jorge Vitório de Souza"
},
"cnae_code": "4721-1/02",
"company_statute": "8b0d8c33-01c9-4cf5-a0fa-1d2a96f4b34d",
"company_document_number": "46073462000130",
"company_type": "ltda",
"email": "marcos.alves@yopmail.com",
"foundation_date": "2017-09-16",
"name": "NOME DA EMPRESA",
"person_type": "legal",
"phone": {
"area_code": "19",
"country_code": "055",
"number": "988888888"
},
"trading_name": "Pães e Doces",
"company_representatives": [{
"address": {
"city": "Recife",
"complement": null,
"neighborhood": "Fundão",
"number": "137",
"postal_code": "52221110",
"state": "PE",
"street": "Rua Camapuã"
},
"birth_date": "1972-02-02",
"document_identification_number": "339122924",
"document_identification": "8b0d8c33-01c9-4cf5-a0fa-1d2a96f4b34d",
"email": "marcos.alves@yopmail.com",
"individual_document_number": "08531309069",
"is_pep": false,
"marital_status": "single",
"mother_name": "Sueli Isadora Alves",
"name": "Marcos Felipe Henrique Alves",
"nationality": "Brasileira",
"person_type": "natural",
"phone": {
"area_code": "88",
"country_code": "055",
"number": "995924634"
}
},
{
"person_type": "natural",
"name": "Nome Nogueira",
"mother_name": "Maria Mariane",
"birth_date": "1990-05-06",
"profession": "Deputada",
"nationality": "Brasileira",
"marital_status": "single",
"is_pep": false,
"individual_document_number": "93308440814",
"document_identification_number": "232479719",
"document_identification": "8b0d8c33-01c9-4cf5-a0fa-1d2a96f4b341",
"email": "nogueira@email.com",
"phone": {
"country_code": "055",
"area_code": "19",
"number": "991611145"
},
"address": {
"street": "Mariana Street",
"state": "PA",
"city": "Ananindeua",
"neighborhood": "Águas Lindas",
"number": "660",
"postal_code": "67118003",
"complement": "complemento"
}
}
]
},
"allowed_user": {
"email": "api@qitech.com.br",
"individual_document_number": "34651104630",
"name": "Luiz Alberto Da Silva",
"person_type": "natural",
"phone": {
"country_code": "055",
"area_code": "19",
"number": "991611135"
}
}
}
BODY PARAMS
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
account_owner * | object | Objeto Dono da conta | Objeto account_owner |
allowed_user * | object | Pessoa que terá acesso à conta para fazer movimentações e aprovações. | Objeto allowed_user |
Objeto account_owner
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
address | string | Objeto endereço do cliente | Objeto address |
cnae_code * | string | Classificação Nacional de Atividades Econômicas | - |
company_document_number * | string | CNPJ | - |
company_statute * | string | DOCUMENT_KEY do PDF do estatuto da empresa (enviado previamente). | - |
company_type * | enum | Tipo da empresa | - |
company_representatives * | array of objects | Lista com representantes da empresa | Lista Representantes da Empresa |
directors_election_minute * | string | DOCUMENT_KEY do PDF da Ata de eleição da empresa (obrigatório apenas para emrpresas com company_type "sa") (enviado previamente). | - |
email * | string | Email institucional da empresa. | - |
foundation_date * | string | Data de abertura da empresa (formato "AAAA-MM-DD"). | - |
name * | string | Razão social. | - |
person_type * | string | Identificador de que o objeto enviado é uma pessoa jurídica. Deve conter SEMPRE o valor "legal" para Objeto PJ. | - |
phone | string | Telefone do cliente. | Objeto phone |
trading_name * | string | Nome fantasia. | - |
Objeto allowed_user
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
email * | string | Email do usuário da conta. | - |
individual_document_number * | string | CPF do usuário da conta (apenas números). | - |
name * | string | Nome do usuário da conta. | - |
person_type * | string | Identificador de que o objeto enviado é uma pessoa física. Deve conter SEMPRE o valor "natural". | - |
phone | string | Telefone do usuário. | - |
Objeto company_representatives
Campo | Tipo | Descrição | Caracteres |
---|---|---|---|
name * | string | Nome do representante da empresa | - |
address | string | Objeto endereço do representante da empresa | Objeto address |
email * | string | Email do representante da empresa | - |
birth_date * | string | Data de nascimento representante da empresa (formato "AAAA-MM-DD") | - |
individual_document_number * | string | CPF do representante da empresa (apenas números). | - |
document_identification * | string | DOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente) | - |
is_pep * | string | Declaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep). | - |
mother_name * | string | Nome da mãe do representante da empresa | - |
nationality * | string | Nacionalidade do representante da empresa | - |
person_type * | string | Identificador de que o objeto enviado é uma pessoa física | |
phone | string | Objeto com dados do telefone do representante da empresa | Objeto phone |
Objeto address
Este objeto, presente tanto no objeto PF quanto no objeto PJ, é um simples objeto para representar um endereço.
Campo | Descrição | Exemplo | Máx. Caracteres |
---|---|---|---|
street * | string | Rua do endereço | - |
state * | string | Estado do endereço (com dois caracteres maiúsculos) | - |
city * | string | Cidade do endereço | - |
neighborhood * | string | Bairro do endereço | - |
number * | string | Número da rua | - |
postal_code * | string | CEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) (apenas números) | - |
complement * | string | Complemento do endereço (texto livre) | - |
Objeto phone
Campo | Descrição | Exemplo | Máx. Caracteres |
---|---|---|---|
country_code * | string | Código DDI do telefone (https://ddi.guiamais.com.br/) | - |
area_code * | string | Código DDD do telefone (https://ddd.guiamais.com.br/) | - |
number * | string | Número de telefone (apenas números) | - |
Enumeradores company_type
Enum | Description |
---|---|
ltda | Limitada |
sa | Sociedade Anônima |
micro_enterprise | Micro Empresa |
freelancer | Freelancer |
sa_opened | Sociedade Anônima de Capital Aberto |
sa_closed | Sociedade Anônima de Capital Fechado |
se_ltda | Sociedade Empresária Limitada |
se_cn | Sociedade Empresária em Nome Coletivo |
se_cs | Sociedade Empresária em Comandita Simples |
se_ca | Sociedade Empresária em Comandita por Ações |
scp | Sociedade em Conta de Participação |
ei | Empresário Individual |
ese | Estabelecimento, no Brasil, de Sociedade Estrangeira |
eeab | Estabelecimento, no Brasil, de Empresa Binacional Argentino-Brasileira |
ssp | Sociedade Simples Pura |
ss_ltda | Sociedade Simples Limitada |
ss_cn | Sociedade Simples em Nome Coletivo |
ss_cs | Sociedade Simples em Comandita Simples |
eireli_ne | Empresa Individual de Responsabilidade Limitada (de Natureza Empresária) |
eireli_ns | Empresa Individual de Responsabilidade Limitada (de Natureza Simples) |
eireli | Empresa de Responsabilidade Individual |
mei | Micro Empreendedor Individual |
me | Micro Empresa |
cop | Cooperativa |
private_association | Sociedade Privada |
Enumeradores marital_status
Enum | Description |
---|---|
single | Solteiro(a) |
married | Casado(a) |
widower | Viúvo(a) |
divorced | Divorciado(a) |
Response
STATUS
200Response Body
{
"data": {
"account_info": {
"account_branch": "0001",
"account_digit": "3",
"account_number": "5283431",
"financial_institution_code": "329"
},
"account_owner": {
"document_number": "46073462000130",
"name": "NOME DA EMPRESA"
},
"allowed_user": {
"document_number": "34651104630",
"name": "Luiz Alberto Da Silva"
}
},
"event_datetime": "2023-05-05 14:48:32",
"key": "5b5371ae-279c-4aa7-bc1c-776e01fea7cf",
"status": "pending_kyc_analysis",
"webhook_type": "account"
}
STATUS
400Response Body
{
"data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}