POST Anexar Documento do Desfecho
Anexa um documento do desfecho da triagem. Recebe o PDF gerado no navegador (prescrição, encaminhamento ou orientação) e o vincula à triagem. Emitir a orientação marca a triagem como impressa.
Só com token de usuário
Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: com x-api-key a resposta é 403 "Ação disponível apenas para usuários autenticados".
Permissão necessária
Exige a permissão decide_triages.
Endpoint
POST https://api-dev.imagemais.com.br/api/triages/{id}/documents
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da triagem |
Corpo da Requisição (multipart/form-data)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
file | file | ✅ | Arquivo enviado |
documentType | string | ✅ | Tipo do documento do desfecho (não vazio) |
replaceBefore | string | ❌ | Instante de início desta emissão, em ISO. Documentos do mesmo tipo criados ANTES dele são marcados como excluídos. Use ao regerar depois de uma retificação, para não deixar duas versões válidas da mesma orientação na triagem. O corte é por data, e não só pelo tipo, porque uma mesma emissão pode render vários arquivos do mesmo tipo — dois encaminhamentos, por exemplo — e eles não podem se apagar entre si. (data ISO 8601) |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/documents' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-F 'file=@arquivo.pdf' \
-F 'documentType=orientacoes' \
-F 'replaceBefore=2026-09-08T14:30:00.000Z'
Respostas
201 Sucesso
{
"id": 169,
"url": "https://storage.exemplo.com.br/triages/20/documents/orientacoes/76d543bdf7aedca837def75306d0ed4c885410b071b9c0786e2f2839e800c796",
"fileType": "pdf",
"name": "Orientações - documento.pdf",
"createdAt": "2026-09-30T18:53:02.581Z",
"updatedAt": "2026-09-30T18:53:02.581Z",
"deletedAt": null,
"accountId": 1
}
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"documentType must be one of the following values: ",
"documentType should not be empty",
"documentType must be a string"
],
"error": "Bad Request",
"statusCode": 400
}
Outras mensagens possíveis:
Validation failed (numeric string is expected)A triagem não registrou o desfecho de {TRIAGE_DOCUMENT_TYPE_LABELSdocumentType}
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
Mensagens possíveis:
Permissões insuficientesAção disponível apenas para usuários autenticados
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Triagem não encontrada",
"error": "Not Found",
"statusCode": 404
}
409 Conflito
{
"message": "Triagem no status {status} não pode {action}",
"error": "Conflict",
"statusCode": 409
}
500 Erro interno
Mensagens possíveis:
Erro ao fazer upload do documento da triagemErro ao vincular documento à triagem
{
"message": "Erro ao fazer upload do documento da triagem",
"error": "Internal Server Error",
"statusCode": 500
}