Saltar para o conteúdo principal
POST
Regista que uma colheita de sangue foi concluída e aciona o fluxo de pedidos ao laboratório. Envia os códigos de laboratório (códigos de barras dos tubos) do kit de colheita de sangue para associar as amostras físicas à marcação. Uma colheita de sangue tem os seus códigos de uma de duas formas:
  • Um código para toda a colheita — uma colheita venosa, em que o mesmo código de barras está impresso em todos os tubos. Envia-o em lab_code.
  • Um código por microtubo — uma colheita capilar, em que cada microtubo tem o seu próprio código de barras. Envia-os em lab_codes, uma entrada por código com os panel_ids que esse microtubo contém. Cada código torna-se a sua própria requisição laboratorial — o código de barras no tubo é o número de pedido do laboratório. Uma entrada sem panel_ids é uma entrada geral para todos os painéis não indicados noutras entradas. Uma colheita venosa tem, no máximo, uma.
Envia exatamente um dos dois. Cada painel associado tem de ficar sob exatamente um código (a sua própria entrada ou a entrada geral). Numa colheita venosa, os biomarcadores avulsos precisam da entrada geral. Numa colheita capilar, indica cada painel no código do respetivo microtubo. Os biomarcadores avulsos preenchem o espaço livre dos microtubos dos painéis e só abrem novos microtubos quando necessário. Distribuímo-los uniformemente. Cada microtubo comporta no máximo 150 µl destes biomarcadores. Envia uma entrada sem panel_ids por cada microtubo de que precisem só para si, e não mais. Um código que fique sem nenhum painel nem biomarcador é recusado com 409 e reason: "panel_coverage". Todos os códigos são validados antes de qualquer escrita; se algum código não puder ser utilizado ou algum painel ficar por cobrir, nada é registado e a resposta indica o problema. Requer o âmbito appointments_schedule, appointments_manage ou appointments_operate.
Esta ação é irreversível. Depois de confirmares a colheita de sangue, a marcação fica bloqueada — não são possíveis mais alterações, incluindo adicionar painéis.

Pedido

Parâmetros de caminho

string
obrigatório
Identificador único (UUID) da marcação a confirmar.

Parâmetros do corpo

string
Código numérico de laboratório impresso no kit de colheita de sangue, quando um código abrange todos os tubos. Mutuamente exclusivo com lab_codes.
object[]
Todos os códigos de laboratório da colheita, por ordem de leitura (pelo menos uma entrada). Mutuamente exclusivo com lab_code. Um código só pode aparecer uma vez; um painel só pode ser indicado numa única entrada.

Resposta

Em caso de sucesso, a API devolve 200 OK a confirmar que o fluxo de pedidos ao laboratório foi acionado.
boolean
true quando a colheita de sangue foi registada e o fluxo de pedidos ao laboratório foi acionado.
string
Presente apenas quando a colheita de sangue foi registada num dia diferente do dia da marcação. As chaves comuns não o podem fazer — recebem um 409 com reason: "appointment_not_today". Reagenda a marcação para o dia da colheita e depois confirma.
Os códigos registados são devolvidos como lab_codes em Obter marcação, e cada resultado e documento em Obter resultados inclui o lab_code com que foi arquivado.

Respostas de erro