Registro de LTDA, S.A. e TS
Este endpoint permite realizar o registro de clientes pessoa jurídica do tipo 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);
- As fotos enviadas, incluindo a selfie e as imagens frente e verso do documento do responsável legal, foram submetidas para análise por meio dos endpoints Criação de Processo Selfie - Representante Legal e Envio e Análise de Documentos Pessoais, tendo sido devidamente aprovadas.
AtençãoAs 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": "SenhaForte123@",
"documentNumber": "50257686101102",
"businessName": "Quantum Group SA",
"tradingName": "Quantum Group",
"legalNature": "212-7",
"cnaeCode": "7319002",
"businessType": "SA",
"businessEmail": "[email protected]",
"businessSize": "MEDIUM",
"declaredAnnualBilling": "UP_TO_FIFTY_THOUSAND",
"openingDate": "2020-05-06",
"phone": {
"countryCode": "55",
"number": "61940988176"
},
"documentation": {
"articlesOfIncorporation": "eDMnFa.OKXTdgqyOTUsH1EAxjWvEypRA",
"lastContractChange": "yyNXKdiSyMNGL8z6a.CHF9Yq3UC_u9fA",
"balanceSheet": "vCPe_I_kSJ70jnSlS.I2AcMEpfuBoheq",
"proofOfAddress": "hhA3xsGBN65.kxRQPFtiRbXYCsKneDIM",
"powerOfAttorney": "wO0avLj.gjzeAbWCeRvamHY0HZ_Au8Fg",
"legalRepresentative": {
"documentNumber": "90207323909",
"selfie": "Yh0oy4Kor4izOcHLb5gkVDw41EHFlJId",
"idCardFront": "jUNrN1uSokCEC7W5IwPojMcsSprkXJ0F",
"idCardBack": "OukBCBN3bX72KAwyoP0cB33m0PDxyoui"
}
},
"legalRepresentatives": [
{
"documentNumber": "90207323909",
"registerName": "Patrícia Ana Nascimento",
"socialName": "Patrícia Nascimento",
"birthDate": "1997-05-13",
"motherName": "Patrícia Silva Oliveira",
"email": "[email protected]",
"declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
"occupation": "OCP0102",
"memberQualification": "17",
"isPoliticallyExposedPerson": false,
"pep": {
"level": "SELF"
},
"phone": {
"countryCode": "55",
"number": "61940988176"
},
"powerOfAttorney": {
"startDate": "2025-06-09",
"endDate": "2026-12-09"
},
"address": {
"zipCode": "29200260",
"addressLine": "Rua Joaquim da Silva Lima",
"buildingNumber": "776",
"complement": "Sala 38",
"neighborhood": "Centro",
"city": "Guarapari",
"state": "ES",
"country": "BR"
}
}
],
"owners": [
{
"documentNumber": "90207323909",
"registerName": "Patrícia Ana Nascimento",
"socialName": "Patrícia Nascimento",
"birthDate": "1997-02-25",
"motherName": "Patrícia Silva Oliveira",
"email": "[email protected]",
"declaredIncome": "FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND",
"occupation": "OCP0102",
"participationPercentage": "100.00",
"gender": "FEMININO",
"pep": {
"level": "SELF"
},
"isPoliticallyExposedPerson": false,
"relationshipStatus": "SOLTEIRO",
"nationality": "BRASILEIRO",
"education": "NAO_ALFABETIZADO",
"memberQualification": "17",
"phone": {
"countryCode": "55",
"number": "61940988176"
},
"address": {
"zipCode": "29200260",
"addressLine": "Rua Joaquim da Silva Lima",
"buildingNumber": "776",
"complement": "Sala 38",
"neighborhood": "Centro",
"city": "Guarapari",
"state": "ES",
"country": "BR"
}
}
],
"businessAddress": {
"zipCode": "29200260",
"addressLine": "Rua Joaquim da Silva Lima",
"buildingNumber": "776",
"complement": "Sala 38",
"neighborhood": "Centro",
"city": "Guarapari",
"state": "ES",
"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. |
Updated about 1 month ago
