Envio de documentos LTDA, S.A. e TS

stable

Este endpoint possibilita enviar os documentos necessários para o cadastro de empresas do tipo LTDA, S.A. e Terceiro Setor. Tais documentos são:

  • Contratos Sociais;
  • Estatutos Sociais;
  • Últimas Alterações Contratuais, Eleição do Síndico ou Responsável Legal;
  • Balanços Sociais/DRE;
  • Declarações de Faturamento;
  • Procurações Públicas Legais.

Requisição

Requisição HTTP

PUT https://api-mtls.sandbox.bankly.com.br/document-analysis/{documentNumber}/corporation-business
curl --request PUT \
     --url 'https://api-mtls.sandbox.bankly.com.br/document-analysis/34183937000161/corporation-business' \
     --header 'accept: application/json' \
     --header 'api-version: 1.0' \
     --header 'content-type: multipart/form-data' \
     --form documentType=BALANCE_SHEET \
     --form file=@F%20de%20status%20do%20.jpg

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
kyc.document.writeConcede acesso para upload de imagens para análise KYC.

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. CNPJ da empresa. Informe somente números.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato de formulário:

NomeTipoDescrição
documentTypetextObrigatório. Tipo de documento que está sendo enviado.
filefileObrigatório. Arquivo do documento. Só são aceitos envios de arquivos do tipo PDF, e não devem ser superiores a 8.5 MB. Caso o arquivo ultrapasse esse tamanho, recomendamos a sua compactação.

Tipos de documentos (documentType)

TipoContexto de envio
ARTICLES_OF_INCORPORATIONPara Contrato Social ou Estatuto Social
LAST_CONTRACT_CHANGEPara Última Alteração Contratual ou Última Ata de Eleição do Síndico ou Responsável Legal
POWER_OF_ATTORNEYPara Procuração Pública Legal
BALANCE_SHEETPara Balanço Social/DRE ou Declaração de Faturamento dos Últimos 12 meses. O envio desse tipo de documento é opcional.

Resposta (Response)

status code 201 indicará sucesso no envio das imagens.
Sendo bem-sucedido, o retorno irá trazer o seguinte campo em formato JSON:

NomeTipoDescrição
tokenstringToken que identifica a imagem enviada.
{ 
    "token": "tokenDoDocumentoEnviado" 
}

👍

Dica

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

Erros

Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.

Eventos

Este endpoint não possui eventos relacionados a ele.