InstitucionalBlogService DeskStatus Page

Registro de LTDA, S.A. e TS

stable

Suggest Edits

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é-requisito

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

❗

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

Requisição HTTP

PUT https://api-mtls.sandbox.bankly.com.br/corporation-business/{CNPJ}

curl --location --request PUT 'https://api-mtls.sandbox.bankly.com.br/corporation-business/{CNPJ}' \ 
--header 'api-version: 1' \ 
--header 'Authorization: Bearer ' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ 
    "businessName": "Nísia Floresta Edições LTDA", 
    "tradingName": "Editora Nísia Floresta", 
    "businessEmail": "[email protected]", 
    "businessType": "LTDA", 
    "businessSize": "MEDIUM", 
    "cnaeCode": "5811500", 
    "legalNature": "LTDA", 
    "openingDate": "2022-03-05", 
    "annualBilling": 457869.78,
    "declaredAnnualBilling": "MORE_THAN_TWO_HUNDRED_AND_FIFTY_THOUSAND_UP_TO_FIVE_HUNDRED_THOUSAND",
    "phone": { 
        "countryCode": "55", 
        "number": "23415162342" 
    }, 
    "businessAddress": { 
        "zipCode": "68060100", 
        "addressLine": "Rua 6 de Março", 
        "buildingNumber": "2500", 
        "complement": "", 
        "neighborhood": "Alter do Chão", 
        "city": "Santarém", 
        "state": "PA", 
        "country": "BR" 
    }, 
    "legalRepresentatives": [ 
        { 
            "documentNumber": "47742663023", 
            "registerName": "Nísia Floresta", 
            "socialName": "Nísia Floresta", 
            "birthDate": "1810-10-12", 
            "motherName": "Dionísia Gonçalves Pinto", 
            "email": "[email protected]",
            "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
            "occupation":"OCP0001",
            "pep": {
                "level":"NONE"
            }
            "isPoliticallyExposedPerson": false,
            "memberQualification": "05", 
            "phone": { 
                "countryCode": "55", 
                "number": "23415162342" 
            }, 
            "address": { 
                "zipCode": "68060100", 
                "addressLine": "Rua 6 de Março", 
                "buildingNumber": "2500", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            } 
        } 
    ], 
    "owners": [ 
        { 
            "documentNumber": "47742663023",
            "registerName": "Nísia Floresta", 
            "socialName": "Nísia Floresta", 
            "birthDate": "1810-10-12", 
            "motherName": "Dionísia Gonçalves Pinto", 
            "email": "[email protected]", 
            "incomeDeclared": 1500.78,
            "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
            "occupation":"OCP0001",
            "isPoliticallyExposedPerson": false,
            "pep": {
                "level":"NONE"
            }
            "participationPercentage": "45", 
            "phone": { 
                "countryCode": "55", 
                "number": "23415162342" 
            }, 
            "address": { 
                "zipCode": "68060100", 
                "addressLine": "Rua 6 de Março", 
                "buildingNumber": "2500", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            }, 
        }, 
        { 
            "documentNumber": "34183937000161",
            "businessName": "Quitéria Educação SA", 
            "tradingName": "Escola de Educação Infantil Maria Quitéria de Jesus", 
            "businessType": "SA", 
            "email": "[email protected]", 
            "incomeDeclared": 1,  
            "declaredAnnualBilling":"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND",
            "participationPercentage": "45",
            "phone": { 
                "countryCode": "55", 
                "number": "23415162346" 
            }, 
            "address": { 
                "zipCode": "66617480", 
                "addressLine": "Rua Pedro Teixeira", 
                "buildingNumber": "3000", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            },
            "legalRepresentatives": [ 
                { 
                    "documentNumber": "09992220074", 
                    "registerName": "Maria Quitéria de Jesus", 
                    "socialName": "Maria Quitéria de Jesus", 
                    "birthDate": "1792-07-27", 
                    "motherName": "Quitéria Maria de Jesus", 
                    "email": "[email protected]",
                    "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
                    "occupation":"OCP0001",
                    "isPoliticallyExposedPerson": false,
                    "pep": {
                       "level":"NONE"
                    },
                    "phone": { 
                        "countryCode": "55", 
                        "number": "23415162346" 
                    }, 
                    "address": { 
                        "zipCode": "66617480", 
                        "addressLine": "Rua Pedro Teixeira", 
                        "buildingNumber": "3000", 
                        "complement": "", 
                        "neighborhood": "Alter do Chão", 
                        "city": "Santarém", 
                        "state": "PA", 
                        "country": "BR" 
                    } 
                } 
            ]
        } 
    ], 
    "documentation": { 
        "articlesOfIncorporation": "x8jyTlNcJ0Ps2LIgsilnQedk0dfmwiNg", 
        "lastContractChange": "0T46N.shMbgg_O9hISNDXTVIunfEbNTr", 
        "balanceSheet": "SO6uGDm4VrmIRUExFY3kYZvyXAkSu3vO", 
        "powerOfAttorney": "EDT2YGmXB1B7R72nuk1F2WbGC8nHoOAC", 
        "legalRepresentative": { 
            "documentNumber": "47742663023", 
            "selfie": "hdpNAjux7CvnpDxQT_.rxV4FXdKJy4Uf", 
            "idCardFront": "v.nrEt6PZh9S.IQ14jEivjARHH3H4ikQ", 
            "idCardBack": "PqgD8OKkOtGp1l_Oriwb.pjgEiKzE.sn" 
        } 
    } 
}'

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.

Esta requisição requer o scope descrito a seguir:

ScopeDescrição
business.corporation.writeConcede acesso para criar ou atualizar os dados de um cliente pessoa jurídica do tipo SA, LTDA e TS.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.
authorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

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

NomeTipoDescrição
documentNumberpathObrigatório. Número do documento CNPJ da empresa. Informe somente os números.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

NomeTipoDescrição
businessNamestringObrigatório. Razão social da empresa. Importante: este campo não aceita caracteres especiais.
tradingNamestringNome fantasia da empresa. Importante: este campo não aceita caracteres especiais.
businessEmailstringObrigatório. E-mail comercial da empresa.
businessTypestringObrigatório. Tipo da empresa, podendo ser: LTDA, S.A. ou TS.
businessSizestringObrigatório. Tamanho da empresa, podendo ser SMALL, MEDIUM ou LARGE (pequena, média ou grande, respectivamente).
cnaeCodestringObrigatório. Código CNAE (Classificação Nacional de Atividades Econômicas) da empresa. Informe apenas a subclasse do código CNAE, sem máscara.
legalNaturestringObrigatório. Natureza Jurídica da empresa. Informe o código correspondente à natureza jurídica da empresa conforme descrito na tabela.
openingDatestringObrigatório. Data de abertura da empresa, no formato ISO 8601 - UTC.
declaredAnnualBillingstringObrigatório. Faixa de faturamento anual da empresa, descrito na tabela de faturamento anual.
phoneobjectObrigatório. Objeto que contém informações sobre o telefone da empresa.
phone.countryCodestringObrigatório. Código DDI do país. Por enquanto é permitido apenas 55 ou +55 (Brasil).
phone.numberstringObrigatório. Número de telefone incluindo DDD.
businessAdressobjectObrigatório. Objeto que contém os dados sobre o endereço da empresa.
businessAdress.zipCodestringObrigatório. Código postal do endereço.
businessAdress.addressLinestringObrigatório. Logradouro (nome da rua, avenida etc.).
businessAdress.buildingNumberstringObrigatório. Número do imóvel.
businessAdress.complementstringComplemento do endereço. Exemplo: Apto 123, Casa B etc.
businessAdress.neighborhoodstringObrigatório. Nome do bairro ou distrito.
businessAdress.citystringObrigatório. Nome da cidade.
businessAdress.statestringObrigatório. Sigla do estado brasileiro conforme a ISO 3166-2. Exemplo: MG.
businessAdress.countrystringObrigatório. Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR.
legalRepresentatives[]array of objectsObrigatório. Lista com os representantes legais da empresa.
owners[]array of objectsLista com 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.
documentationobjectObrigatório. Objeto que contém informações dos documentos enviados por meio do endpoint de Envio de documentos de pessoa jurídica (LTDA, S.A. e TS).
documentation.articlesOfIncorporationstringObrigatório. Token correspondente ao documento do Contrato Social ou Estatuto Social da empresa.
documentation.lastContractChangestringObrigatório. Token correspondente ao documento da Última Alteração Contratual ou Última Ata de Eleição.
documentation.balanceSheetstringToken correspondente ao documento de Declaração de Faturamento dos Últimos 12 meses ou Balanço Social.
documentation.powerOfAttorneystringObrigatório. Token correspondente ao documento de Procuração Pública Legal.
documentation.legalRepresentativeobjectObrigatório. Objeto que contém dados do documento de um dos representantes legais. É possível usar o RG, CNH, RNE, DNI ou CRNM.
documentation.legalRepresentative.documentNumberstringObrigatório. Número do documento.
documentation.legalRepresentative.selfiestringObrigatório. Token correspondente à foto do representante legal.
documentation.legalRepresentative.idCardFrontstringObrigatório. Token correspondente à imagem da frente do documento.
documentation.legalRepresentative.idCardBackstringObrigatório. Token correspondente à à imagem do verso do documento.

Informações sobre os representantes legais


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

NomeTipoDescrição
legalRepresentatives[].documentNumberstringObrigatório. Número do documento CPF. Informe somente os números.
legalRepresentatives[].registerNamestringObrigatório. Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) do representante legal.
legalRepresentatives[].socialNamestringNome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a Cartilha do nome social.
legalRepresentatives[].birthDatestringObrigatório. Data de nascimento do representante legal (formato ISO 8601 - UTC), que deve possuir no mínimo 16 anos.
legalRepresentatives[].motherNamestringObrigatório. Nome da mãe do representante legal conforme consta no documento de identificação.
legalRepresentatives[].emailstringObrigatório. Endereço de e-mail. Um mesmo endereço de e-mail não poderá ser usado por dois representantes legais.
legalRepresentatives[].declaredIncomestringObrigatório. Faixa de renda declarada pelo representante legal, descrito na tabela de renda declarada.
legalRepresentatives[].occupationstringObrigatório. Código de ocupação do cliente. Caso o cliente possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.
legalRepresentatives[].isPoliticallyExposedPersonstringInforme se a pessoa é politicamente exposta (true ou false). Obsoleto. Utilize o objeto pep.
legalRepresentatives[].pepobjectObrigatório. Objeto onde deve ser informado o nível de exposição política do cliente, atendendo à Circular nº 3.978.
legalRepresentatives[].pep.levelstringObrigatório. Nível de exposição política do cliente: "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[].memberQualificationstringObrigató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[].powerOfAttorneyobjectObjeto que contém 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[].phoneobjectObrigatório. Objeto que contém informações sobre o telefone do representante legal.
legalRepresentatives[].phone.countryCodestringObrigatório. Código DDI do país. Atualmente, é permitido apenas 55 ou +55 (Brasil).
legalRepresentatives[].phone.numberstringObrigatório. Número de telefone incluindo DDD.
legalRepresentatives[].addressobjectObrigatório. Objeto que contém os dados sobre o endereço do representante legal.
legalRepresentatives[].address.zipCodestringObrigatório. Código postal do endereço.
legalRepresentatives[].adress.addressLinestringObrigatório. Logradouro (nome da rua, avenida etc.).
legalRepresentatives[].address.buildingNumberstringObrigatório. Número do imóvel.
legalRepresentatives[].address.complementstringComplemento do endereço. Exemplo: Apto 123, Casa B etc.
legalRepresentatives[].address.neighborhoodstringObrigatório. Nome do bairro ou distrito.
legalRepresentatives[].address.citystringObrigatório. Nome da cidade.
legalRepresentatives[].address.statestringObrigatório. Sigla do estado brasileiro conforme a ISO 3166-2. Exemplo: MG.
legalRepresentatives[].address.countrystringObrigatório. Sigla do país (Brasil) conforme a 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:

NomeTipoDescrição
owners[].documentNumberstringObrigatório. Número do documento CPF. Informe somente os números.
owners[].registerNamestringObrigatório. Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) da pessoa sócia.
owners[].socialNamestringNome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a Cartilha do nome social.
owners[].birthDatestringObrigatório. Data de nascimento da pessoa sócia (formato ISO 8601 - UTC), que deve possuir no mínimo 16 anos.
owner[].motherNamestringObrigatório. Nome da mãe da pessoa sócia conforme consta no documento de identificação.
owners[].emailstringObrigatório. Endereço de e-mail. Um mesmo endereço de e-mail não poderá ser usado por dois clientes.
owners[].incomeDeclaredstringRenda declarada. Obsoleto. Utilize o campo declaredIncome.
owners[].declaredIncomestringObrigatório. Faixa de renda declarada pelo representante legal, descrito na tabela de renda declarada.
owners[].occupationstringObrigatório. Código de ocupação do cliente. Caso o cliente possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.
owners[].isPoliticallyExposedPersonstringInforme se a pessoa é politicamente exposta (true ou false). Obsoleto. Utilize o objeto pep.
owners[].pepobjectObrigatório. Objeto onde deve ser informado o nível de exposição política do cliente, atendendo à Circular nº 3.978.
owners[].pep.levelstringObrigatório. Nível de exposição política do cliente: "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[].participationPercentagestringObrigatório. Percentual de participação na empresa (0 a 100).
owners[].phoneobjectObrigatório. Objeto que contém informações sobre o telefone da pessoa sócia.
owners[].phone.countryCodestringObrigatório. Código DDI do país. Atualmente, é permitido apenas 55 ou +55 (Brasil).
owners[].phone.numberstringObrigatório. Número de telefone incluindo DDD.
owner[].addressobjectObrigatório. Objeto que contém os dados sobre o endereço da pessoa sócia.
owners[].address.zipCodestringObrigatório. Código postal do endereço.
owners[].address.addressLinestringObrigatório. Logradouro (nome da rua, avenida etc.).
owners[].address.buildingNumberstringObrigatório. Número do imóvel.
owners[].address.complementstringComplemento do endereço. Exemplo: Apto 123, Casa B etc.
owners[].address.neighborhoodstringObrigatório. Nome do bairro ou distrito.
owners[].address.citystringObrigatório. Nome da cidade.
owners[].address.statestringObrigatório. Sigla do estado brasileiro conforme a ISO 3166-2. Exemplo: MG.
owners[].address.countrystringObrigatório. Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR.

Pessoa jurídica

Para sócio pessoa jurídica, informe:

NomeTipoDescrição
owners[].documentNumberstringObrigatório. Número do documento CNPJ da empresa. Informe somente os números.
owners[].businessNamestringObrigatório. Razão social da empresa.
owners[].tradingNamestringNome fantasia da empresa.
owners[].businessTypestringObrigatório. Tipo da empresa, podendo ser: LTDA, S.A. ou TS.
owners[].emailstringObrigatório. E-mail comercial da empresa.
owners[].incomeDeclaredstringRenda declarada. Obsoleto. Utilize o campo declaredAnnualBilling.
owners[].declaredAnnualBillingstringObrigatório. Faixa de faturamento anual da empresa, descrito na tabela de faturamento anual.
owners[].participationPercentagestringObrigatório. Percentual de participação na empresa (0 a 100).
owners[].phoneobjectObrigatório. Objeto que contém informações sobre o telefone da pessoa sócia.
owners[].phone.countryCodestringObrigatório. Código DDI do país. Atualmente, é permitido apenas 55 ou +55 (Brasil).
owners[].phone.numberstringObrigatório. Número de telefone incluindo DDD.
owner[].addressobjectObrigatório. Objeto que contém os dados sobre o endereço da pessoa sócia.
owners[].address.zipCodestringObrigatório. Código postal do endereço.
owners[].address.addressLinestringObrigatório. Logradouro (nome da rua, avenida etc.).
owners[].address.buildingNumberstringObrigatório. Número do imóvel.
owners[].address.complementstringComplemento do endereço. Exemplo: Apto 123, Casa B etc.
owners[].address.neighborhoodstringObrigatório. Nome do bairro ou distrito.
owners[].address.citystringObrigatório. Nome da cidade.
owners[].address.statestringObrigatório. Sigla do estado brasileiro conforme a ISO 3166-2. Exemplo: MG.
owners[].address.countrystringObrigatório. Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR.
owners[].legalRepresentatives[]array of objectsLista com informações dos representantes legais da empresa do sócio. Importante: o envio desse objeto é opcional. Porém, caso seja enviado, deve-se observar a obrigatoriedade de suas propriedades.
owners[].legalRepresentatives[].documentNumberstringObrigatório. Número do documento CPF. Informe somente os números.
owners[].legalRepresentatives[].registerNamestringObrigatório. Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) do representante legal.
owners[].legalRepresentatives[].socialNamestringNome pelo qual a pessoa gostaria de ser chamada. Saiba mais consultando a Cartilha do nome social.
owners[].legalRepresentatives[].birthDatestringObrigatório. Data de nascimento do representante legal (formato ISO 8601 - UTC), que deve possuir no mínimo 16 anos.
owners[].legalRepresentatives[].motherNamestringObrigatório. Nome da mãe do representante legal conforme consta no documento de identificação.
owners[].legalRepresentatives[].emailstringObrigatório. Endereço de e-mail. Um mesmo endereço de e-mail não poderá ser usado por dois representantes legais.
owners[].legalRepresentatives[].declaredIncomestringObrigatório. Faixa de renda declarada pelo representante legal, descrito na tabela de renda declarada.
owners[].legalRepresentatives[].occupationstringObrigatório. Código de ocupação do cliente. Caso o cliente possua mais de uma ocupação, esse campo deve ser preenchido com a sua principal fonte de renda.
owners[].legalRepresentatives[].isPoliticallyExposedPersonstringInforme se a pessoa é politicamente exposta (true ou false). Obsoleto. Utilize o objeto pep.
owners[].legalRepresentatives[].pepobjectObrigatório. Objeto onde deve ser informado o nível de exposição política do cliente, atendendo à Circular nº 3.978.
owners[].legalRepresentatives[].pep.levelstringObrigatório. Nível de exposição política do cliente: "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[].legalRepresentatives[].phoneobjectObrigatório. Objeto que contém informações sobre o telefone do representante legal.
owners[].legalRepresentatives[].phone.countryCodestringObrigatório. Código DDI do país. Atualmente, é permitido apenas 55 ou +55 (Brasil).
owners[].legalRepresentatives[].phone.numberstringObrigatório. Número de telefone incluindo DDD.
owners[].legalRepresentatives[].addressobjectObrigatório. Objeto que contém os dados sobre o endereço do representante legal.
owners[].legalRepresentatives[].address.zipCodestringObrigatório. Código postal do endereço.
owners[].legalRepresentatives[].adress.addressLinestringObrigatório. Logradouro (nome da rua, avenida etc.).
owners[].legalRepresentatives[].address.buildingNumberstringObrigatório. Número do imóvel.
owners[].legalRepresentatives[].address.complementstringComplemento do endereço. Exemplo: Apto 123, Casa B etc.
owners[].legalRepresentatives[].address.neighborhoodstringObrigatório. Nome do bairro ou distrito.
owners[].legalRepresentatives[].address.citystringObrigatório. Nome da cidade.
owners[].legalRepresentatives[].address.statestringObrigatório. Sigla do estado brasileiro conforme a ISO 3166-2. Exemplo: MG.
owners[].legalRepresentatives[].address.countrystringObrigatório. Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR.

📘

Nota

Para os representantes legais dos sócios, não é necessário o preenchimento dos campos memberQualification e powerOfAttorney.

{ 
    "businessName": "Nísia Floresta Edições LTDA", 
    "tradingName": "Editora Nísia Floresta", 
    "businessEmail": "[email protected]", 
    "businessType": "LTDA", 
    "businessSize": "MEDIUM", 
    "cnaeCode": "5811500", 
    "legalNature": "201-1", 
    "openingDate": "2022-03-05", 
    "declaredAnnualBilling": "MORE_THAN_TWO_HUNDRED_AND_FIFTY_THOUSAND_UP_TO_FIVE_HUNDRED_THOUSAND",
    "phone": { 
        "countryCode": "55", 
        "number": "23415162342" 
    }, 
    "businessAddress": { 
        "zipCode": "68060100", 
        "addressLine": "Rua 6 de Março", 
        "buildingNumber": "2500", 
        "complement": "", 
        "neighborhood": "Alter do Chão", 
        "city": "Santarém", 
        "state": "PA", 
        "country": "BR" 
    }, 
    "legalRepresentatives": [ 
        { 
            "documentNumber": "47742663023", 
            "registerName": "Nísia Floresta", 
            "socialName": "Nísia Floresta", 
            "birthDate": "1810-10-12", 
            "motherName": "Dionísia Gonçalves Pinto", 
            "email": "[email protected]",
            "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
            "occupation":"OCP0001",
            "pep": {
                "level":"NONE"
            },
            "isPoliticallyExposedPerson": false,
            "memberQualification": "05", 
            "phone": { 
                "countryCode": "55", 
                "number": "23415162342" 
            }, 
            "address": { 
                "zipCode": "68060100", 
                "addressLine": "Rua 6 de Março", 
                "buildingNumber": "2500", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            } 
        } 
    ], 
    "owners": [ 
        { 
            "documentNumber": "47742663023",
            "registerName": "Nísia Floresta", 
            "socialName": "Nísia Floresta", 
            "birthDate": "1810-10-12", 
            "motherName": "Dionísia Gonçalves Pinto", 
            "email": "[email protected]", 
            "incomeDeclared": 1500.78,
            "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
            "occupation":"OCP0001",
            "isPoliticallyExposedPerson": false,
            "pep": {
                "level":"NONE"
            },
            "participationPercentage": "45", 
            "phone": { 
                "countryCode": "55", 
                "number": "23415162342" 
            }, 
            "address": { 
                "zipCode": "68060100", 
                "addressLine": "Rua 6 de Março", 
                "buildingNumber": "2500", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            }, 
        }, 
        { 
            "documentNumber": "34183937000161",
            "businessName": "Quitéria Educação SA", 
            "tradingName": "Escola de Educação Infantil Maria Quitéria de Jesus", 
            "businessType": "SA", 
            "email": "[email protected]", 
            "incomeDeclared": 1,  
            "declaredAnnualBilling":"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND",
            "participationPercentage": "45",
            "phone": { 
                "countryCode": "55", 
                "number": "23415162346" 
            }, 
            "address": { 
                "zipCode": "66617480", 
                "addressLine": "Rua Pedro Teixeira", 
                "buildingNumber": "3000", 
                "complement": "", 
                "neighborhood": "Alter do Chão", 
                "city": "Santarém", 
                "state": "PA", 
                "country": "BR" 
            },
            "legalRepresentatives": [ 
                { 
                    "documentNumber": "09992220074", 
                    "registerName": "Maria Quitéria de Jesus", 
                    "socialName": "Maria Quitéria de Jesus", 
                    "birthDate": "1792-07-27", 
                    "motherName": "Quitéria Maria de Jesus", 
                    "email": "[email protected]",
                    "declaredIncome":"FROM_FIVE_THOUSAND_TO_TEN_THOUSAND",
                    "occupation":"OCP0001",
                    "isPoliticallyExposedPerson": false,
                    "pep": {
                       "level":"NONE"
                    },
                    "phone": { 
                        "countryCode": "55", 
                        "number": "23415162346" 
                    }, 
                    "address": { 
                        "zipCode": "66617480", 
                        "addressLine": "Rua Pedro Teixeira", 
                        "buildingNumber": "3000", 
                        "complement": "", 
                        "neighborhood": "Alter do Chão", 
                        "city": "Santarém", 
                        "state": "PA", 
                        "country": "BR" 
                    } 
                } 
            ]
        } 
    ], 
    "documentation": { 
        "articlesOfIncorporation": "x8jyTlNcJ0Ps2LIgsilnQedk0dfmwiNg", 
        "lastContractChange": "0T46N.shMbgg_O9hISNDXTVIunfEbNTr", 
        "balanceSheet": "SO6uGDm4VrmIRUExFY3kYZvyXAkSu3vO", 
        "powerOfAttorney": "EDT2YGmXB1B7R72nuk1F2WbGC8nHoOAC", 
        "legalRepresentative": { 
            "documentNumber": "47742663023", 
            "selfie": "hdpNAjux7CvnpDxQT_.rxV4FXdKJy4Uf", 
            "idCardFront": "v.nrEt6PZh9S.IQ14jEivjARHH3H4ikQ", 
            "idCardBack": "PqgD8OKkOtGp1l_Oriwb.pjgEiKzE.sn" 
        } 
    } 
}

Código da natureza jurídica (legalNature)

CódigoDescrição
399-9Associação Privada.
214-3Cooperativa.
201-1Empresa Pública.
322-0Organização Religiosa.
330-1Organização Social (OS).
204-6Sociedade Anônima Aberta.
205-4Sociedade Anônima Fechada.
203-8Sociedade de Economia Mista.
212-7Sociedade em Conta de Participação.
209-7Sociedade Empresária em Comandita por Ações.
208-9Sociedade Empresária em Comandita Simples.
207-0Sociedade Empresária em Nome Coletivo.
206-2Sociedade Empresária Limitada.
412-0Produtor Rural (Pessoa Física).
215-1Consórcio de Sociedades.
216-0Grupo de Sociedades.
221-6Empresa Domiciliada no Exterior.
223-2Sociedade Simples Pura.
224-0Sociedade Simples Limitada.
225-9Sociedade Simples em Nome Coletivo.
226-7Sociedade Simples em Comandita Simples.
229-1Consórcio Simples.
231-3Empresa Individual de Responsabilidade Limitada (de Natureza Simples).
233-0Cooperativas de Consumo.
306-9Fundação Privada.
313-1Entidade Sindical.
321-2Fundação ou Associação Domiciliada no Exterior.
230-5Empresa Individual de Responsabilidade Limitada (de Natureza Empresária).
327-1Órgão de Direção Local de Partido Político.
326-3Órgão de Direção Regional de Partido Político.
328-0Comitê Financeiro de Partido Político.
303-4Serviço Notarial e Registral (Cartório).
329-8Frente Plebiscitária ou Referendaria.
307-7Serviço Social Autônomo.
308-5Condomínio Edilício.
310-7Comissão de Conciliação Prévia.
311-5Entidade de Mediação e Arbitragem.
320-4Estabelecimento, no Brasil, de Fundação ou Associação Estrangeiras.
323-9Comunidade Indígena.
324-7Fundo Privado.
325-5Órgão de Direção Nacional de Partido Político.
213-5Empresário (Individual).
222-4Clube/Fundo de Investimento.


Faixa de faturamento anual da empresa

FaturamentoDescrição
UP_TO_FIFTY_THOUSANDAté 50 mil.
MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSANDDe 50 mil a 100 mil.
MORE_THAN_ONE_HUNDRED_THOUSAND_UP_TO_TWO_HUNDRED_AND_FIFTY_THOUSANDDe 100 mil a 250 mil.
MORE_THAN_TWO_HUNDRED_AND_FIFTY_THOUSAND_UP_TO_FIVE_HUNDRED_THOUSANDDe 250 mil a 500 mil.
MORE_THAN_FIVE_HUNDRED_THOUSAND_UP_TO_ONE_MILLIONDe 500 mil a 1 milhão.
MORE_THAN_ONE_MILLION_UP_TO_TWO_MILLION_AND_FIVE_HUNDRED_THOUSANDDe 1 milhão a 2 milhões e 500 mil.
MORE_THAN_TWO_MILLION_AND_FIVE_HUNDRED_THOUSAND_UP_TO_FIVE_MILLIONDe 2 milhões e 500 mil a 5 milhões.
MORE_THAN_FIVE_MILLION_UP_TO_TEN_MILLIONDe 5 milhões a 10 milhões.
MORE_THAN_TEN_MILLION_UP_TO_TWENTY_FIVE_MILLIONDe 10 milhões a 25 milhões.
MORE_THAN_TWENTY_FIVE_MILLION_UP_TO_FIFTY_MILLIONDe 25 milhões a 50 milhões.
MORE_THAN_FIFTY_MILLION_UP_TO_ONE_HUNDRED_MILLIONDe 50 milhões a 100 milhões.
MORE_THAN_ONE_HUNDRED_MILLION_UP_TO_TWO_HUNDRED_AND_FIFTY_MILLIONDe 100 milhões a 250 milhões.
MORE_THAN_TWO_HUNDRED_AND_FIFTY_MILLION_UP_TO_FIVE_HUNDRED_MILLIONDe 250 milhões a 500 milhões.
MORE_THAN_FIVE_HUNDRED_MILLIONMais de 500 milhões.
EXEMPT_COMPANYEmpresa isenta.
INACTIVE_COMPANYEmpresa inativa.


Faixa de renda declarada

FaturamentoDescrição
LESS_THAN_ONE_THOUSANDInferior a mil.
FROM_ONE_THOUSAND_TO_TWO_THOUSANDDe mil a dois mil.
FROM_TWO_THOUSAND_TO_THREE_THOUSANDDe 2 mil a 3 mil.
FROM_THREE_THOUSAND_TO_FIVE_THOUSANDDe 3 mil a 5 mil.
FROM_FIVE_THOUSAND_TO_TEN_THOUSANDDe 5 mil a 10 mil.
FROM_TEN_THOUSAND_TO_TWENTY_THOUSANDDe 10 mil a 20 mil.
OVER_TWENTY_THOUSANDAcima de 20 mil.

Resposta (Response)

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

👍

Dica

Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

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

Status codeCódigoMensagemDescrição
409BUSINESS_REGISTRATION_CANNOT_BE_REPLACEDBusiness 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.
409BUSINESS_AWAIT_EVALUATIONBusiness await evaluation.Empresa ainda em análise.
422INVALID_OPENING_DATEBusiness opening date must be older than today.A data de abertura da empresa deve ser posterior à data atual.
422INVALID_CORPORATION_BUSINESS_SIZEInvalid business size to corporation business.O porte da empresa é inválido para LTDA, SA ou TS.
422INVALID_BUSINESS_TYPEInvalid business type to corporation business.O tipo da empresa é inválido para LTDA, SA ou TS.
422POWER_OF_ATTORNEY_NOT_INITIATEDPower of attorney must have start date older than today.A procuração do representante legal deve possuir data posterior à atual.
422POWER_OF_ATTORNEY_THIRTY_DAYS_TO_EXPIREPower 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.
422OWNERS_NOT_INFORMEDOwner(s) not informed.Sócios não informados.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês 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 eventoDescrição
BUSINESS_WAS_RECEIVEDA solicitação de cadastro do cliente foi recebida.

Updated 13 days ago