Pular para o conteúdo principal

Abertura de conta PJ

Request​

ENDPOINT
/account
MÉTODO
POST
Request 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​

CampoTipoDescriçãoCaracteres
account_owner *objectObjeto Dono da contaObjeto account_owner
allowed_user *objectPessoa que terá acesso à conta para fazer movimentações e aprovações.Objeto allowed_user

Objeto account_owner​

CampoTipoDescriçãoCaracteres
addressstringObjeto endereço do clienteObjeto address
cnae_code *stringClassificação Nacional de Atividades Econômicas-
company_document_number *stringCNPJ-
company_statute *stringDOCUMENT_KEY do PDF do estatuto da empresa (enviado previamente).-
company_type *enumTipo da empresa-
company_representatives *array of objectsLista com representantes da empresaLista Representantes da Empresa
directors_election_minute *stringDOCUMENT_KEY do PDF da Ata de eleição da empresa (obrigatório apenas para emrpresas com company_type "sa") (enviado previamente).-
email *stringEmail institucional da empresa.-
foundation_date *stringData de abertura da empresa (formato "AAAA-MM-DD").-
name *stringRazão social.-
person_type *stringIdentificador de que o objeto enviado é uma pessoa jurídica. Deve conter SEMPRE o valor "legal" para Objeto PJ.-
phonestringTelefone do cliente.Objeto phone
trading_name *stringNome fantasia.-

Objeto allowed_user​

CampoTipoDescriçãoCaracteres
email *stringEmail do usuário da conta.-
individual_document_number *stringCPF do usuário da conta (apenas números).-
name *stringNome do usuário da conta.-
person_type *stringIdentificador de que o objeto enviado é uma pessoa física. Deve conter SEMPRE o valor "natural".-
phonestringTelefone do usuário.-

Objeto company_representatives​

CampoTipoDescriçãoCaracteres
name *stringNome do representante da empresa-
addressstringObjeto endereço do representante da empresaObjeto address
email *stringEmail do representante da empresa-
birth_date *stringData de nascimento representante da empresa (formato "AAAA-MM-DD")-
individual_document_number *stringCPF do representante da empresa (apenas números).-
document_identification *stringDOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)-
is_pep *stringDeclaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).-
mother_name *stringNome da mãe do representante da empresa-
nationality *stringNacionalidade do representante da empresa-
person_type *stringIdentificador de que o objeto enviado é uma pessoa física
phonestringObjeto com dados do telefone do representante da empresaObjeto phone

Objeto address​

Este objeto, presente tanto no objeto PF quanto no objeto PJ, é um simples objeto para representar um endereço.

CampoDescriçãoExemploMáx. Caracteres
street *stringRua do endereço-
state *stringEstado do endereço (com dois caracteres maiúsculos)-
city *stringCidade do endereço-
neighborhood *stringBairro do endereço-
number *stringNúmero da rua-
postal_code *stringCEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) (apenas números)-
complement *stringComplemento do endereço (texto livre)-

Objeto phone​

CampoDescriçãoExemploMáx. Caracteres
country_code *stringCódigo DDI do telefone (https://ddi.guiamais.com.br/)-
area_code *stringCódigo DDD do telefone (https://ddd.guiamais.com.br/)-
number *stringNúmero de telefone (apenas números)-

Enumeradores company_type​

EnumDescription
ltdaLimitada
saSociedade Anônima
micro_enterpriseMicro Empresa
freelancerFreelancer
sa_openedSociedade Anônima de Capital Aberto
sa_closedSociedade Anônima de Capital Fechado
se_ltdaSociedade Empresária Limitada
se_cnSociedade Empresária em Nome Coletivo
se_csSociedade Empresária em Comandita Simples
se_caSociedade Empresária em Comandita por Ações
scpSociedade em Conta de Participação
eiEmpresário Individual
eseEstabelecimento, no Brasil, de Sociedade Estrangeira
eeabEstabelecimento, no Brasil, de Empresa Binacional Argentino-Brasileira
sspSociedade Simples Pura
ss_ltdaSociedade Simples Limitada
ss_cnSociedade Simples em Nome Coletivo
ss_csSociedade Simples em Comandita Simples
eireli_neEmpresa Individual de Responsabilidade Limitada (de Natureza Empresária)
eireli_nsEmpresa Individual de Responsabilidade Limitada (de Natureza Simples)
eireliEmpresa de Responsabilidade Individual
meiMicro Empreendedor Individual
meMicro Empresa
copCooperativa
private_associationSociedade Privada

Enumeradores marital_status​

EnumDescription
singleSolteiro(a)
marriedCasado(a)
widowerViúvo(a)
divorcedDivorciado(a)

Response​

STATUS
200
Response 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
400
Response Body
{
  "data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}