Ir para o conteúdo

Gerenciamento dos documentos do cedente e de suas pessoas vinculadas.


Upload de Documento

Método URL
POST https://BASE_URL/api/cedentes/{idEmpresa}/documentos

O envio do documento é feito via multipart/form-data.

Request — cURL
curl -X POST https://BASE_URL/api/cedentes/123/documentos \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: multipart/form-data" \
  -F "arquivo=@/caminho/para/contrato_social.pdf" \
  -F "tipoDocumentoIntegracao=social_contract" \
  -F "idEmpresaPessoa=" \
  -F "observacao=Contrato social consolidado 2025"
Response Body
{
  "idDocumento": 78,
  "idEmpresa": 123,
  "arquivoNome": "contrato_social.pdf",
  "tipoDocumentoIntegracao": "social_contract",
  "statusDocumento": "created",
  "status": "Documento enviado com sucesso."
}

Remover Documento

Método URL
DELETE https://BASE_URL/api/cedentes/{idEmpresa}/documentos/{idDocumento}
Response Body
{
  "status": "Documento removido com sucesso."
}

Modelo de Dados

Requisição — Documento (multipart/form-data)

Campo Tipo Obrigatório Descrição
arquivo Arquivo (binário) Arquivo do documento (PDF, JPG, PNG)
tipoDocumentoIntegracao Texto Tipo do documento. Ver Tipo de Documento
idEmpresaPessoa Número Opcional ID da pessoa vinculada (quando documento é de representante/sócio/avalista)
observacao Texto Opcional Observação sobre o documento

Retorno

Campo Tipo Descrição
idDocumento Número ID do documento
idEmpresa Número ID da empresa cedente
arquivoNome Texto Nome do arquivo enviado
tipoDocumentoIntegracao Texto Tipo do documento
statusDocumento Texto Status atual do documento. Ver Status do Documento
status Texto Mensagem de status da operação

Documentos Obrigatórios

Documentos da Empresa

Tipo Descrição Obrigatório
social_contract Contrato Social / Estatuto Social
bylaws Estatuto Social (S.A.) Condicional¹
minutes_of_election Ata de Eleição / Assembleia Condicional¹
balance_sheet Balanço Patrimonial
income_statement DRE — Demonstração do Resultado do Exercício
power_of_attorney Procuração Opcional

Documentos da Pessoa

Tipo Descrição Obrigatório
cnh CNH ✅²
rg_front RG — Frente ✅²
rg_back RG — Verso ✅²
address_proof Comprovante de Endereço

Notas

¹ Obrigatório para Sociedade Anônima (S.A.).
² CNH substitui RG — envie CNH ou RG (frente + verso).