Saltar para o conteúdo principal
POST
Comunica que o paciente recolheu a sua amostra. Este é o equivalente para kit de teste em casa de Confirmar colheita de sangue — sem código de barras, porque o código do kit é aplicado quando o kit é embalado. Envias apenas a data e hora da colheita. A data e hora têm relevância clínica: são a hora de colheita que vai constar no relatório do laboratório. Envia o momento real em que o paciente fez a colheita, não o momento em que o teu sistema o processou. Reenviar o mesmo activated_at devolve 200 com a encomenda ativada; um diferente devolve 409. Consulta Idempotência. A ativação passa a encomenda para activated — um estado final. Uma encomenda ativada já não pode ser cancelada, e a sua composição e morada de entrega ficam bloqueadas. A ativação é aceite enquanto a encomenda estiver em pending ou dispatched, desde que tenha um lab_code — o paciente pode já ter o kit na mão antes de o nosso registo indicar expedido, e a hora real da colheita prevalece sempre sobre o nosso registo interno. Uma encomenda sem lab_code devolve 409: sem o código, não é possível associar a amostra ao paciente no laboratório. A ativação também faz o pedido ao laboratório para o painel do kit com o lab_code da encomenda, para que a amostra fique prevista no laboratório e os resultados possam ser associados assim que forem comunicados. Isto acontece de forma assíncrona após a resposta — um problema no laboratório nunca faz falhar o teu pedido. A partir daqui, Obter resultados mostra os marcadores como planned até o laboratório os comunicar. Um webhook home_kit_order.results.updated avisa-te quando mudam. Se a amostra chegar ao laboratório antes de ativares o kit, a Aniva ativa-o. activated_at corresponde à manhã do primeiro evento de seguimento da encomenda de devolução, ou à manhã em que a amostra chegou ao laboratório se não houver seguimento. Uma chamada posterior com um activated_at diferente devolve então 409. Requer o âmbito home_kit_orders_manage ou o âmbito mais restrito home_kit_orders_activate.

Pedido

Parâmetros de caminho

string
obrigatório
Identificador único (UUID) da encomenda de kit de teste em casa a ativar.

Parâmetros do corpo

string
obrigatório
Quando o paciente recolheu a amostra, como instante UTC (ISO 8601 com sufixo Z, por ex., 2026-08-28T07:30:00Z). Não pode estar no futuro nem estar mais de 30 dias no passado.

Resposta

Em caso de sucesso, a API devolve 200 OK com a encomenda de kit de teste em casa atualizada — status é activated e activated_at contém a data e hora que enviaste.

Respostas de erro