Registro de LTDA, S.A. e TS

stable

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.
legalNaturestringObrigatório. Natureza Jurídica da empresa.
openingDatestringObrigatório. Data de abertura da empresa, no formato YYYY-MM-DDTHH:mm:SS.
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.balanceSheetstringObrigatório. Token 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 YYYY-MM-DDTHH:mm:SS), 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 YYYY-MM-DDTHH:mm:SS), 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 YYYY-MM-DDTHH:mm:SS), 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": "LTDA", 
    "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" 
        } 
    } 
}


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ódigoDescrição
400INVALID_PARMETERSCódigo de erro genérico que indica preenchimento incorreto de um ou mais campos da requisição. O valor incorreto será apresentado no retorno através do campo messages. Verifique as instruções de preenchimento do cURL.
409BUSINESS_REGISTRATION_CANNOT_BE_REPLACEDA empresa já está aprovada ou ainda está em análise.
409BUSINESS_AWAIT_EVALUATIONEmpresa ainda em análise.
422INVALID_OPENING_DATEA data de abertura da empresa deve ser posterior à data atual.
422INVALID_CORPORATION_BUSINESS_SIZEO porte da empresa é inválido para LTDA, SA ou TS.
422INVALID_BUSINESS_TYPEO tipo da empresa é inválido para LTDA, SA ou TS.
422POWER_OF_ATTORNEY_NOT_INITIATEDA procuração do representante legal deve possuir data posterior à atual.
422POWER_OF_ATTORNEY_THIRTY_DAYS_TO_EXPIREA 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_INFORMEDSócios não informados.

Válido lembrar que a API também poderá retornar erros comuns entre todos os endpoints. Além disso, por meio da página de erros comuns é possível saber quais mensagens em inglês os erros 400 (caso haja) podem retornar.

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.