Enviar Anexo (PDF) para um Contrato
Utilize o token obtido na autenticação e o id do contrato (obtido na consulta por CPF) para enviar um documento PDF a ser anexado ao contrato.
📝 Campos
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| contract_id | number (path) | ✅ | ID do contrato, obtido na consulta por CPF |
| title | string | ✅ | Título/descrição do documento |
| file.originalFileName | string | ✅ | Nome do arquivo — deve terminar em .pdf |
| file.base64 | string | ✅ | Conteúdo do PDF codificado em base64 |
Apenas PDF
Somente arquivos com extensão .pdf são aceitos. Qualquer outra extensão é rejeitada com erro de validação (400).
Exemplo de Requisição
POST /integration/contract/123/attachment
Authorization: Bearer <token>
Content-Type: application/json
{
"title": "Contrato assinado",
"file": {
"originalFileName": "contrato-assinado.pdf",
"base64": "JVBERi0xLjQKJ..."
}
}
Exemplo de Resposta (201)
{
"id": 987,
"contract_id": 123,
"companie_user_id": 45,
"title": "Contrato assinado",
"path": "https://.../contract/9b1c...-....pdf",
"created_at": "2026-09-21T14:32:00.000Z",
"mrce_evidence_type_id": null
}
⚠️ Respostas
| Código | Descrição |
|---|---|
| 201 | Anexo criado com sucesso |
| 400 | Erro de validação (ex: arquivo não é PDF, campo obrigatório ausente) |
| 401 | Token ausente ou inválido |
| 404 | Contrato não encontrado (error_contract_id_not_exist) |
| 409 | Contrato é do tipo Energia, não suportado por esta integração (error_contract_type_energy_not_supported) |