Skip to main content

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​

NomeTipoObrigatórioDescrição
idnumber✅ID da triagem

Corpo da Requisição (multipart/form-data)​

CampoTipoObrigatórioDescrição
filefile✅Arquivo enviado
documentTypestring✅Tipo do documento do desfecho (não vazio)
replaceBeforestring❌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 insuficientes
  • Açã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 triagem
  • Erro ao vincular documento à triagem
{
"message": "Erro ao fazer upload do documento da triagem",
"error": "Internal Server Error",
"statusCode": 500
}