POST/api/consultation-reports/{id}/return

Devolver laudo

O médico desfaz o próprio laudo para outro médico assumir o exame, que volta a pendente. O laudo devolvido continua guardado, com o motivo.

Exige o token de acesso — como obter

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Bearer {access_token}, com o token que o login devolve.
`Content-Type`	string	Sim	application/json

Parâmetros do caminho

Nome	Tipo	Obrig.	Descrição
`id`	uuid	Sim	O laudo.

Corpo da requisição

Nome	Tipo	Obrig.	Descrição
`motivo`	string	Sim	Por que o laudo está sendo devolvido.

Campos da resposta

Nome	Tipo	Descrição
`exam_id`	uuid	O exame, que voltou a pendente.

Request URL

https://api-endosystem.imagemais.com.br/api/consultation-reports/c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5b/return

curl -X POST "https://api-endosystem.imagemais.com.br/api/consultation-reports/c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5b/return" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"motivo":"Vou entrar de férias — outro médico assume."}'

{
  "motivo": "Vou entrar de férias — outro médico assume."
}

{
  "motivo": "Vou entrar de férias — outro médico assume."
}

Respostas

{
  "exam_id": "b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f"
}

{
  "exam_id": "b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f"
}

{
  "error": "Informe o motivo da devolução.",
  "code": "motivo_obrigatorio"
  ...

{
  "error": "Informe o motivo da devolução.",
  "code": "motivo_obrigatorio"
}

{
  "error": "Este tipo de laudo não pode ser devolvido.",
  "code": "tipo_sem_devolucao"
  ...

{
  "error": "Este tipo de laudo não pode ser devolvido.",
  "code": "tipo_sem_devolucao"
}

{
  "error": "ID inválido"
}

{
  "error": "ID inválido"
}

{
  "error": "Laudo não encontrado"
}

{
  "error": "Laudo não encontrado"
}

{
  "error": "Este laudo é de outro médico. Só quem assinou pode devolvê-lo."
}

{
  "error": "Este laudo é de outro médico. Só quem assinou pode devolvê-lo."
}

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}