Registro de LTDA, S.A. e TS

Após esse registro, será feita uma análise manual do perfil do cliente com base nos dados fornecidos.

Pré-requisitos

Para que seja possível utilizar este endpoint, é necessário que:

Os documentos relacionados à pessoa jurídica tenham sido enviados por meio do endpoint de Envio de documentos de pessoa jurídica (LTDA, S.A. e TS);
A selfie e as fotos (frente e verso) do documento do responsável legal tenham sido enviadas para análise por meio do endpoint Envio e análise de documentos pessoais e tenham sido aprovadas;

❗️
Atenção
As informações relacionadas ao CNPJ fornecido devem estar de acordo com os dados mais recentes da empresa, pois realizamos uma verificação em fontes públicas e privadas de informações. Havendo divergência, a análise será reprovada.

Requisição (Request)

Requisição HTTP

POST https://sandbox.hiperbanco.com.br/Onboarding/corporation/{{clientId}}

--request POST 'https://sandbox.hiperbanco.com.br/Onboarding/corporation/{{clientId}}' \
--header 'version: cutting-edge' \
--header 'Content-Type: application/json' \
--data-raw '{
  "password": "Senhateste123@",
  "documentNumber": "50300633859100",
  "businessName": "Techwave Digital Solutions LTDA",
  "tradingName": "Techwave",
  "legalNature": "206-2",
  "cnaeCode": "6201501",
  "businessType": "LTDA",
  "businessEmail": "[email protected]",
  "businessSize": "MEDIUM",
  "declaredAnnualBilling": "MORE_THAN_FIVE_HUNDRED_THOUSAND_UP_TO_ONE_MILLION",
  "openingDate": "2021-04-12",
  "phone": {
    "countryCode": "55",
    "number": "11987654321"
  },
  "documentation": {
    "articlesOfIncorporation": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "lastContractChange": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "balanceSheet": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "proofOfAddress": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "powerOfAttorney": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "legalRepresentative": {
      "documentNumber": "00812689712",
      "selfie": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
      "idCardFront": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
      "idCardBack": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg"
    }
  },
  "legalRepresentatives": [
    {
      "documentNumber": "00812689712",
      "registerName": "Bruno Henrique Alves",
      "socialName": "Bruno Henrique Alves",
      "birthDate": "1987-09-15",
      "motherName": "Luciana Alves da Silva",
      "email": "[email protected]",
      "declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
      "occupation": "OCP0005",
      "memberQualification": "Administrador",
      "isPoliticallyExposedPerson": false,
      "pep": {
        "level": "NONE"
      },
      "phone": {
        "countryCode": "55",
        "number": "11987654321"
      },
      "powerOfAttorney": {
        "startDate": "2022-01-01",
        "endDate": "2026-12-31"
      },
      "address": {
        "zipCode": "04547005",
        "addressLine": "Rua João Cachoeira",
        "buildingNumber": "320",
        "complement": "Apto 104",
        "neighborhood": "Itaim Bibi",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
      }
    }
  ],
  "owners": [
    {
      "documentNumber": "00812689712",
      "registerName": "Carla Mendes Duarte",
      "socialName": "Carla Mendes Duarte",
      "birthDate": "1982-06-21",
      "motherName": "Teresa Duarte Lima",
      "email": "[email protected]",
      "declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
      "occupation": "OCP0004",
      "participationPercentage": "100",
      "gender": "FEMININO",
      "pep": {
        "level": "NONE"
      },
      "isPoliticallyExposedPerson": false,
      "relationshipStatus": "SOLTEIRO",
      "nationality": "BRASILEIRO",
      "education": "SUPERIOR_COMPLETO",
      "memberQualification": "Sócio",
      "phone": {
        "countryCode": "55",
        "number": "11999887766"
      },
      "address": {
        "zipCode": "04547005",
        "addressLine": "Rua João Cachoeira",
        "buildingNumber": "320",
        "complement": "Apto 104",
        "neighborhood": "Itaim Bibi",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
      }
    }
  ],
  "businessAddress": {
    "zipCode": "04547005",
    "addressLine": "Rua João Cachoeira",
    "buildingNumber": "320",
    "complement": "Conjunto 503",
    "neighborhood": "Itaim Bibi",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  }
}'

Cabeçalhos (Headers)

Nome	Propriedade	Descrição
version	cutting-edge	Essa propriedade garante que o response da API seja retornado no formato JSON

Parâmetros da rota (Path)

No path desta requisição envie os seguintes campos:

Nome	Tipo	Descrição
clientId	path	Id do cliente. (Esse ID é fornecido junto com as credenciais do cliente)

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

Nome	Tipo	Descrição	Especificação
password	string	Obrigatório. Senha de acesso
documentNumber	string	Obrigatório. Número do documento da empresa (CNPJ).
businessName	string	Obrigatório. Razão social da empresa.	Este campo não aceita caracteres especiais.
tradingName	string	Obrigatório. Nome fantasia da empresa.	Este campo não aceita caracteres especiais.
businessEmail	string	Obrigatório. E-mail comercial da empresa.
businessType	string	Obrigatório. Tipo da empresa, que pode ser "LTDA", "S.A". ou "TS".
businessSize	string	Obrigatório. Porte da empresa.
cnaeCode	string	Obrigatório. Código CNAE (Classificação Nacional de Atividades Econômicas) da empresa. Informe apenas a subclasse do código CNAE, sem máscara.
legalNature	string	Obrigatório. Natureza Jurídica da empresa. Informe o código correspondente à natureza jurídica da empresa conforme descrito na tabela.
openingDate	string (date)	Obrigatório. Data de abertura da empresa.	Formato ISO 8601 - UTC.
declaredAnnualBilling	string	Obrigatório. Faixa de faturamento anual da empresa.
phone	object	Obrigatório. Objeto que deverá conter informações sobre o telefone da empresa.
phone.countryCode	string	Obrigatório. Código DDI do país. Permitido apenas 55 (Brasil).
phone.number	string	Obrigatório. Número de telefone incluindo DDD.
documentation	object	Obrigatório. Objeto contendo documentos da empresa
documentation.articlesOfIncorporation	string	Obrigatório. Token correspondente ao documento do Contrato Social ou Estatuto Social da empresa.
documentation.lastContractChange	string	Obrigatório. Token correspondente ao documento da Última Alteração Contratual ou Última Ata de Eleição.
documentation.balanceSheet	string	Obrigatório. Token correspondente ao documento de Declaração de Faturamento dos Últimos 12 meses ou Balanço Social.
documentation.proofOfAddress	string	Obrigatório. Token correspondente ao comprovante de endereço.
documentation.powerOfAttorney	string	Obrigatório. Token correspondente ao documento de Procuração Pública Legal.
documentation.legalRepresentative	object	Obrigatório. Objeto que deverá conter informações sobre o documento de um dos representantes legais. É possível usar o RG e CNH.
documentation.legalRepresentative.documentNumber	string	Obrigatório. Número do documento.
documentation.legalRepresentative.selfie	string	Obrigatório. Token correspondente à foto do representante legal.
documentation.legalRepresentative.idCardFront	string	Obrigatório. Token correspondente à imagem da frente do documento.
documentation.legalRepresentative.idCardBack	string	Obrigatório. Token correspondente à imagem do verso do documento.
legalRepresentatives[]	array of objects	Obrigatório. Lista de objetos contendo informações sobre os representantes legais da empresa.
owners[]	array of objects	Lista de objetos contendo informações sobre o quadro societário da empresa. Obrigatório somente para empresas do tipo LTDA. Para S.A. e TS, a utilização desse objeto é opcional.
businessAddress	object	Obrigatório. Objeto que deverá conter informações sobre o endereço da empresa.
businessAddress.zipCode	string	Obrigatório. Código postal do endereço.
businessAddress.addressLine	string	Obrigatório. Logradouro (nome da rua, avenida etc.).
businessAddress.buildingNumber	string	Obrigatório. Número do imóvel.
businessAddress.complement	string	Complemento do endereço. Exemplo: Apto 123, Casa B etc.
businessAddress.neighborhood	string	Obrigatório. Nome do bairro ou distrito.
businessAddress.city	string	Obrigatório. Nome da cidade.
businessAddress.state	string	Obrigatório. Sigla do estado brasileiro.	Formato ISO 3166-2:BR. Exemplo: MG.
businessAddress.country	string	Obrigatório. Sigla do país (Brasil).	Formato ISO 3166-2:BR. Exemplo: BR.

Porte da empresa (businessSize)

Tamanho	Descrição
SMALL	Faturamento até R$ 4,8 milhões por ano.
MEDIUM	Faturamento acima de R$ 4.8 milhões até R$ 20 milhões no ano.
LARGE	Faturamento acima de R$ 20 milhões no ano.

Informações sobre os representantes legais

A entidade de representante legal da empresa é composta pelos seguintes campos obrigatórios:

Nome	Tipo	Descrição	Especificação
legalRepresentatives[].documentNumber	string	Obrigatório. Número do documento (CPF).	Informe somente os números.
legalRepresentatives[].registerName	string	Obrigatório. Nome conforme consta no documento de identificação (RG ou CNH) do representante legal.
legalRepresentatives[].socialName	string	Nome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a Cartilha do nome social.
legalRepresentatives[].birthDate	string	Obrigatório. Data de nascimento do representante legal, que deve possuir no mínimo 18 anos.	Formato ISO 8601 - UTC.
legalRepresentatives[].motherName	string	Obrigatório. Nome da mãe do representante legal conforme consta no documento de identificação.
legalRepresentatives[].email	string	Obrigatório. Endereço de e-mail.	Um mesmo endereço de e-mail não poderá ser usado por dois representantes legais.
legalRepresentatives[].declaredIncome	string	Obrigatório. Faixa de renda declarada pelo representante legal.
legalRepresentatives[].occupation	string	Obrigatório. Código de ocupação do cliente. Caso o representante legal possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.
legalRepresentatives[].memberQualification	string	Obrigatório. De acordo com a natureza jurídica, indique a qualificação da pessoa física, conforme a tabela do Anexo 5 da Instrução Normativa RFB nº 1863/2018.
legalRepresentatives[].isPoliticallyExposedPerson	boolean	Indica se é PEP
legalRepresentatives[].pep	object	Obrigatório. Objeto que deverá conter informações sobre o nível de exposição política do cliente, atendendo à Circular nº 3.978.
legalRepresentatives[].pep.level	string	Obrigatório. Nível de exposição política do cliente, que pode ser "NONE" (o cliente não é e nem tem vínculo com pessoa exposta politicamente), "SELF" (o cliente é pessoa exposta politicamente) e "RELATED" (o cliente tem vínculo familiar, possui sociedade ou é estreito colaborador de pessoa exposta politicamente).
legalRepresentatives[].phone	object	Obrigatório. Objeto que deverá conter informações sobre o telefone do representante legal.
legalRepresentatives[].phone.countryCode	string	Obrigatório. Código DDI do país. Permitido apenas 55 (Brasil).
legalRepresentatives[].phone.number	string	Obrigatório. Número de telefone incluindo DDD.
legalRepresentatives[].powerOfAttorney	object	Objeto que deverá conter informações sobre a data de início da procuração (startDate) e a data fim (endDate). Não é possível utilizar uma procuração que irá vencer em até 30 dias, a partir da data de envio da requisição.
legalRepresentatives[].powerOfAttorney.startDate	string	Data de início da procuração.	Formato (YYYY-MM-DD)
legalRepresentatives[].powerOfAttorney.endDate	string	Data do fim da procuração.
legalRepresentatives[].address	object	Obrigatório. Objeto que deverá conter informações sobre o endereço do representante legal.
legalRepresentatives[].address.zipCode	string	Obrigatório. Código postal do endereço.
legalRepresentatives[].adress.addressLine	string	Obrigatório. Logradouro (nome da rua, avenida etc.).
legalRepresentatives[].address.buildingNumber	string	Obrigatório. Número do imóvel.
legalRepresentatives[].address.complement	string	Complemento do endereço. Exemplo: Apto 123, Casa B etc.
legalRepresentatives[].address.neighborhood	string	Obrigatório. Nome do bairro ou distrito.
legalRepresentatives[].address.city	string	Obrigatório. Nome da cidade.
legalRepresentatives[].address.state	string	Obrigatório. Sigla do estado brasileiro.	Formato ISO 3166-2. Exemplo: MG.
legalRepresentatives[].address.country	string	Obrigatório. Sigla do país (Brasil).	Formato ISO 3166-2. Exemplo: BR.

Informações sobre o quadro societário da empresa (LTDA)

Para as empresas LTDA, é obrigatório informar o quadro societário (owners). Para S.A. e TS, a utilização desse campo é opcional.

O quadro societário da empresa deverá ser preenchido de acordo com o tipo de pessoa societária, podendo ser física ou jurídica.

Pessoa física

Para sócio pessoa física, informe:

Nome	Tipo	Descrição	Especificação
owners[].documentNumber	string	Obrigatório. Número do documento (CPF).	Informe somente os números.
owners[].registerName	string	Obrigatório. Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) da pessoa sócia.	—
owners[].socialName	string	Obrigatório. Nome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a Cartilha do nome social.	—
owners[].birthDate	string (date)	Obrigatório. Data de nascimento da pessoa sócia, que deve possuir no mínimo 18 anos.	Formato ISO 8601 - UTC. YYYY-MM-DD
owners[].motherName	string	Obrigatório. Nome da mãe da pessoa sócia conforme consta no documento de identificação.	—
owners[].email	string	Obrigatório. Endereço de e-mail.	Um mesmo endereço de e-mail não poderá ser usado por dois clientes.
owners[].declaredIncome	string	Obrigatório. Faixa de renda declarada pelo socio.	—
owners[].occupation	string	Obrigatório. Código de ocupação do cliente. Caso o sócio possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.	—
owners[].participationPercentage	string	Obrigatório. Percentual de participação na empresa (0 a 100).	—
owners[].gender	string	Gênero	—
owners[].pep	object	Obrigatório. Objeto que deverá conter informações sobre o nível de exposição política do cliente, atendendo à Circular nº 3.978.	—
owners[].pep.level	string	Obrigatório. Nível de exposição política do cliente, que pode ser "NONE" (o cliente não é e nem tem vínculo com pessoa exposta politicamente), "SELF" (o cliente é pessoa exposta politicamente) e "RELATED" (o cliente tem vínculo familiar, possui sociedade ou é estreito colaborador de pessoa exposta politicamente).	—
owners[].isPoliticallyExposedPerson	boolean	Indica se é PEP	—
owners[].relationshipStatus	string	Estado civil	—
owners[].nationality	string	Nacionalidade	—
owners[].education	string	Escolaridade	—
owners[].memberQualification	string	Obrigatório. De acordo com a natureza jurídica, indique a qualificação da pessoa física, conforme a tabela do Anexo 5 da Instrução Normativa RFB nº 1863/2018 .	—
owners[].phone	object	Obrigatório. Objeto com informações sobre o telefone da pessoa sócia.	—
owners[].phone.countryCode	string	Obrigatório. Código DDI do país.	Atualmente, permitido apenas 55 ou +55 (Brasil).
owners[].phone.number	string	Obrigatório. Número de telefone incluindo DDD.	—
owners[].address	object	Obrigatório. Objeto que deverá conter informações sobre o endereço da pessoa sócia.	—
owners[].address.zipCode	string	Obrigatório. Código postal do endereço.	—
owners[].address.addressLine	string	Obrigatório. Logradouro (nome da rua, avenida etc.).	—
owners[].address.buildingNumber	string	Obrigatório. Número do imóvel.	—
owners[].address.complement	string	Complemento do endereço.	Exemplo: Apto 123, Casa B etc.
owners[].address.neighborhood	string	Obrigatório. Nome do bairro ou distrito.	—
owners[].address.city	string	Obrigatório. Nome da cidade.	—
owners[].address.state	string	Obrigatório. Sigla do estado brasileiro.	Formato ISO 3166-2. Exemplo: MG.
owners[].address.country	string	Obrigatório. Sigla do país (Brasil).	Formato ISO 3166-2. Exemplo: BR.

Pessoa Jurídica

Para sócio pessoa jurídica, informe:

Campo	Tipo	Descrição	Especificação
owners[].documentNumber	string	Obrigatório. Número do documento da empresa (CNPJ).	Informe somente os números.
owners[].businessName	string	Obrigatório. Razão social da empresa.	—
owners[].tradingName	string	Nome fantasia da empresa.	—
owners[].businessType	string	Obrigatório. Tipo da empresa, que pode ser "LTDA", "S.A". ou "TS".	—
owners[].email	string	Obrigatório. E-mail comercial da empresa.	—
owners[].declaredAnnualBilling	string	Obrigatório. Faixa de faturamento anual da empresa	—
owners[].participationPercentage	string	Obrigatório. Percentual de participação na empresa (0 a 100).	—
owners[].phone	object	Obrigatório. Objeto com informações sobre o telefone da pessoa sócia.	—
owners[].phone.countryCode	string	Obrigatório. Código DDI do país.	Permitido apenas 55 (Brasil).
owners[].phone.number	string	Obrigatório. Número de telefone incluindo DDD.	—
owners[].address	object	Obrigatório. Objeto com informações sobre o endereço da pessoa sócia.	—
owners[].address.zipCode	string	Obrigatório. Código postal do endereço.	—
owners[].address.addressLine	string	Obrigatório. Logradouro (nome da rua, avenida etc.).	—
owners[].address.buildingNumber	string	Obrigatório. Número do imóvel.	—
owners[].address.complement	string	Complemento do endereço. Exemplo: Apto 123, Casa B etc.	—
owners[].address.neighborhood	string	Obrigatório. Nome do bairro ou distrito.	—
owners[].address.city	string	Obrigatório. Nome da cidade.	—
owners[].address.state	string	Obrigatório. Sigla do estado brasileiro.	Formato ISO 3166-2. Exemplo: MG.
owners[].address.country	string	Obrigatório. Sigla do país (Brasil).	Formato ISO 3166-2. Exemplo: BR.
owners[].legalRepresentatives[]	array of objects	Lista de representantes legais da empresa do sócio. Opcional, mas seus campos são obrigatórios se enviados.	—
owners[].legalRepresentatives[].documentNumber	string	Obrigatório. Número do documento (CPF).	Informe somente os números.
owners[].legalRepresentatives[].registerName	string	Obrigatório. Nome conforme documento de identificação.	—
owners[].legalRepresentatives[].socialName	string	Nome social.	—
owners[].legalRepresentatives[].birthDate	string	Obrigatório. Data de nascimento (mínimo 18 anos).	Formato ISO 8601 - UTC.
owners[].legalRepresentatives[].motherName	string	Obrigatório. Nome da mãe conforme documento de identificação.	—
owners[].legalRepresentatives[].email	string	Obrigatório. Endereço de e-mail.	Não pode ser repetido entre representantes.
owners[].legalRepresentatives[].declaredIncome	string	Obrigatório. Faixa de renda declarada.	—
owners[].legalRepresentatives[].occupation	string	Obrigatório. Código da ocupação principal.	—
owners[].legalRepresentatives[].pep	object	Obrigatório. Informações sobre exposição política.	—
owners[].legalRepresentatives[].pep.level	string	Obrigatório. Nível de exposição política: "NONE", "SELF" ou "RELATED".	—
owners[].legalRepresentatives[].phone	object	Obrigatório. Objeto com telefone do representante legal.	—
owners[].legalRepresentatives[].phone.countryCode	string	Obrigatório. Código DDI do país.	Permitido apenas 55 (Brasil).
owners[].legalRepresentatives[].phone.number	string	Obrigatório. Número de telefone com DDD.	—
owners[].legalRepresentatives[].address	object	Obrigatório. Objeto com endereço do representante legal.	—
owners[].legalRepresentatives[].address.zipCode	string	Obrigatório. Código postal.	—
owners[].legalRepresentatives[].address.addressLine	string	Obrigatório. Logradouro.	—
owners[].legalRepresentatives[].address.buildingNumber	string	Obrigatório. Número do imóvel.	—
owners[].legalRepresentatives[].address.complement	string	Complemento (ex: Apto 123, Casa B).	—
owners[].legalRepresentatives[].address.neighborhood	string	Obrigatório. Bairro ou distrito.	—
owners[].legalRepresentatives[].address.city	string	Obrigatório. Cidade.	—
owners[].legalRepresentatives[].address.state	string	Obrigatório. Estado.	Formato ISO 3166-2. Exemplo: MG.
owners[].legalRepresentatives[].address.country	string	Obrigatório. País.	Formato ISO 3166-2. Exemplo: BR.

{
  "password": "SenhaTeste123@",
  "documentNumber": "50300633859100",
  "businessName": "Techwave Digital Solutions LTDA",
  "tradingName": "Techwave",
  "legalNature": "206-2",
  "cnaeCode": "6201501",
  "businessType": "LTDA",
  "businessEmail": "[email protected]",
  "businessSize": "MEDIUM",
  "declaredAnnualBilling": "MORE_THAN_FIVE_HUNDRED_THOUSAND_UP_TO_ONE_MILLION",
  "openingDate": "2021-04-12",
  "phone": {
    "countryCode": "55",
    "number": "11987654321"
  },
  "documentation": {
    "articlesOfIncorporation": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "lastContractChange": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "balanceSheet": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "proofOfAddress": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "powerOfAttorney": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
    "legalRepresentative": {
      "documentNumber": "00812689712",
      "selfie": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
      "idCardFront": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
      "idCardBack": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg"
    }
  },
  "legalRepresentatives": [
    {
      "documentNumber": "00812689712",
      "registerName": "Bruno Henrique Alves",
      "socialName": "Bruno Henrique Alves",
      "birthDate": "1987-09-15",
      "motherName": "Luciana Alves da Silva",
      "email": "[email protected]",
      "declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
      "occupation": "OCP0005",
      "memberQualification": "Administrador",
      "isPoliticallyExposedPerson": false,
      "pep": {
        "level": "NONE"
      },
      "phone": {
        "countryCode": "55",
        "number": "11987654321"
      },
      "powerOfAttorney": {
        "startDate": "2022-01-01",
        "endDate": "2026-12-31"
      },
      "address": {
        "zipCode": "04547005",
        "addressLine": "Rua João Cachoeira",
        "buildingNumber": "320",
        "complement": "Apto 104",
        "neighborhood": "Itaim Bibi",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
      }
    }
  ],
  "owners": [
    {
      "documentNumber": "00812689712",
      "registerName": "Carla Mendes Duarte",
      "socialName": "Carla Mendes Duarte",
      "birthDate": "1982-06-21",
      "motherName": "Teresa Duarte Lima",
      "email": "[email protected]",
      "declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
      "occupation": "OCP0004",
      "participationPercentage": "100",
      "gender": "FEMININO",
      "pep": {
        "level": "NONE"
      },
      "isPoliticallyExposedPerson": false,
      "relationshipStatus": "SOLTEIRO",
      "nationality": "BRASILEIRO",
      "education": "SUPERIOR_COMPLETO",
      "memberQualification": "Sócio",
      "phone": {
        "countryCode": "55",
        "number": "11999887766"
      },
      "address": {
        "zipCode": "04547005",
        "addressLine": "Rua João Cachoeira",
        "buildingNumber": "320",
        "complement": "Apto 104",
        "neighborhood": "Itaim Bibi",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
      }
    }
  ],
  "businessAddress": {
    "zipCode": "04547005",
    "addressLine": "Rua João Cachoeira",
    "buildingNumber": "320",
    "complement": "Conjunto 503",
    "neighborhood": "Itaim Bibi",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  }
}

Resposta (Response)

O retorno 202 indicará que a requisição foi aceita e está sendo processada.

Erros

Este endpoint pode retornar erros específicos, conforme a tabela a seguir:

Status code	Código	Mensagem	Descrição
409	BUSINESS_REGISTRATION_CANNOT_BE_REPLACED	Business registration has already been approved or still being analyzed. Consider update register using PATCH if is already approved.	A empresa já está aprovada ou ainda está em análise.
409	BUSINESS_AWAIT_EVALUATION	Business await evaluation.	Empresa ainda em análise.
422	INVALID_OPENING_DATE	Business opening date must be older than today.	A data de abertura da empresa deve ser posterior à data atual.
422	INVALID_CORPORATION_BUSINESS_SIZE	Invalid business size to corporation business.	O porte da empresa é inválido para LTDA, SA ou TS.
422	INVALID_BUSINESS_TYPE	Invalid business type to corporation business.	O tipo da empresa é inválido para LTDA, SA ou TS.
422	POWER_OF_ATTORNEY_NOT_INITIATED	Power of attorney must have start date older than today.	A procuração do representante legal deve possuir data posterior à atual.
422	POWER_OF_ATTORNEY_THIRTY_DAYS_TO_EXPIRE	Power of attorney end date must be greater than thirty days to expire.	A data de vencimento da procuração do representante legal deve apresentar 30 dias a mais que a data do envio da procuração.
422	OWNERS_NOT_INFORMED	Owner(s) not informed.	Sócios não informados.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints que acompanham os erros 400 (se houver).

Eventos

Caso o parceiro deseje receber mensagens referentes aos eventos relacionados a esse endpoint, é preciso configurar o webhook. Os eventos são:

Nome do evento	Descrição
BUSINESS_WAS_RECEIVED	A solicitação de cadastro do cliente foi recebida.
BUSINESS_WAS_APPROVED	O cadastro do cliente foi aprovado.
BUSINESS_WAS_REPROVED	O cadastro do cliente foi reprovado.