Gerenciamento dos documentos do cedente e de suas pessoas vinculadas.
Upload de Documento¶
| Método | URL |
|---|---|
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 |
|---|---|
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).