| Método | URL |
|---|---|
https://BASE_URL/public/v1/recebiveis/titulos/{id}/documentos/{idLastro}/arquivo |
Baixa o arquivo de um documento do título — o lastro principal ou um documento adicional. O idLastro vem de Listar Documentos do Título.
Path Params¶
| Campo | Tipo | Descrição |
|---|---|---|
id | Número | Identificador do título. |
idLastro | Número | Identificador do documento no título. |
Esta rota não possui Request Body.
Exemplo de cURL
curl -X GET "https://BASE_URL/public/v1/recebiveis/titulos/551203/documentos/98231/arquivo" \
-H "Authorization: Bearer {token}" \
-H "GrupoEconomico: {grupo}" \
-o contrato-mestre.pdf
Resposta¶
200 OK com o conteúdo do arquivo no corpo, o Content-Type correspondente à extensão (ex.: application/pdf, text/xml; application/octet-stream quando desconhecida) e o nome original em Content-Disposition.
Erros¶
Erros retornam o envelope RetornoPadrao.
| HTTP | Quando |
|---|---|
404 Not Found | O título não existe, o documento não pertence ao título ou o documento ainda não tem arquivo (lastro principal sem arquivo). |
400 Bad Request | O arquivo não foi encontrado no armazenamento. |
Response Body — 404 Not Found (documento de outro título)
{
"status": "erro",
"mensagem": "Documento 98231 não encontrado no título 551203."
}
Observações¶
- Escopo pelo título: só é possível baixar um documento que pertence ao título da rota. Um documento compartilhado (contrato mestre) pode ser baixado por qualquer um dos títulos que o usam.