Skip to main content

POST Solicitar Etiqueta Original

Solicita a captura da etiqueta original. Enfileira a captura para um pedido que ainda não tem etiqueta — o gatilho automático só cobre pedidos concluídos depois que a feature foi ligada. É idempotente: se a etiqueta já foi capturada, devolve a existente sem reabrir o portal. Acompanhe o desfecho pelo GET ou pelo stream SSE.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige ao menos uma das permissões collect_laboratory ou assign_laboratory.


Endpoint​

POST https://api-dev.imagemais.com.br/api/integrations/diagnostics-brazil/orders/{orderId}/original-label

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
orderIdnumber✅ID do pedido

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/integrations/diagnostics-brazil/orders/1/original-label' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

400 Requisição inválida​

Mensagens possíveis:

  • Validation failed (numeric string is expected)
  • Este pedido não tem exames do fornecedor integrado, e por isso não tem etiqueta original
  • Credenciais do portal do Diagnósticos do Brasil não configuradas para esta conta
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Pedido não encontrado ou não existe",
"error": "Not Found",
"statusCode": 404
}

503 Serviço indisponível​

{
"message": "A captura da etiqueta original está desabilitada nesta instalação",
"error": "Service Unavailable",
"statusCode": 503
}