Saltar para o conteúdo principal
PATCH
Adiciona um ou mais biomarcadores avulso a uma encomenda de kit de teste em casa existente, fora de qualquer painel predefinido. Este endpoint é idempotente — os biomarcadores já associados são mantidos. Requer o âmbito home_kit_orders_manage e o âmbito de capacidade home_kit_orders_individual_biomarker_selection. Os kits de teste em casa são encomendados por painel, pelo que os marcadores individuais são ativados por parceiro. Pede à Aniva se a tua integração precisar.
Só é possível adicionar biomarcadores enquanto o kit estiver pending. Assim que o kit estiver dispatched, a sua composição fica bloqueada e esta chamada devolve 409 Conflict — o kit físico é enviado com um número fixo de tubos definido pelos painéis e biomarcadores selecionados, pelo que o seu conteúdo não pode mudar depois de enviado. Os kits activated e cancelled também ficam bloqueados. Se precisares de alterar as análises de um kit bloqueado, contacta diretamente a Aniva — normalmente ainda é possível e fazemos a alteração por ti para manter o conteúdo do kit consistente.

Pedido

Parâmetros de caminho

string
obrigatório
Identificador único (UUID) da encomenda de kit de teste em casa à qual adicionar biomarcadores.

Parâmetros do corpo

integer[]
obrigatório
Array de identificadores de biomarcadores a adicionar à encomenda de kit de teste em casa. Tem de conter pelo menos um item. Usa Listar biomarcadores com home_kit=true para descobrir os IDs dos biomarcadores.

Resposta

Em caso de sucesso, a API devolve 200 OK a confirmar que os biomarcadores foram adicionados.
boolean
true quando os biomarcadores foram adicionados com sucesso à encomenda de kit de teste em casa.

Respostas de erro