Przejdź do głównej treści
POST
Zgłoś, że pacjent pobrał próbkę. To odpowiednik Potwierdź pobranie krwi dla domowego zestawu testowego — bez kodu kreskowego, ponieważ kod zestawu jest umieszczany podczas pakowania. Przekazujesz tylko znacznik czasu pobrania. Znacznik czasu ma znaczenie kliniczne: to czas pobrania, który znajdzie się w raporcie laboratoryjnym. Wyślij faktyczny moment pobrania przez pacjenta, a nie moment przetworzenia go przez twój system. Ponowne wysłanie takiego samego activated_at zwraca 200 z aktywowanym zamówieniem; inne zwraca 409. Zobacz Idempotentność. Aktywacja zmienia status zamówienia na activated — status końcowy. Aktywowanego zamówienia nie można już anulować, a jego skład i adres dostawy są zablokowane. Aktywacja jest akceptowana, gdy zamówienie ma status pending lub dispatched, o ile ma lab_code — pacjent może już mieć zestaw w ręku, zanim nasz system odnotuje wysyłkę, a faktyczny czas pobrania zawsze ma pierwszeństwo przed naszą ewidencją. Zamówienie bez lab_code zwraca 409: bez tego kodu próbki nie da się dopasować do pacjenta w laboratorium. Aktywacja składa również zlecenie w laboratorium na panel z zestawu pod lab_code zamówienia, dzięki czemu laboratorium oczekuje na próbkę, a wyniki mogą zostać przypisane w chwili ich zaraportowania. Dzieje się to asynchronicznie po wysłaniu odpowiedzi — problem po stronie laboratorium nigdy nie powoduje błędu twojego żądania. Od tego momentu Pobierz wyniki pokazuje markery jako planned, dopóki laboratorium ich nie zaraportuje. Webhook home_kit_order.results.updated informuje cię, gdy się zmienią. Jeśli próbka dotrze do laboratorium, zanim aktywujesz zestaw, aktywuje go Aniva. activated_at to poranek pierwszego zdarzenia śledzenia przesyłki zwrotnej albo poranek dnia, w którym próbka dotarła do laboratorium, jeśli brakuje śledzenia. Późniejsze wywołanie z innym activated_at zwróci wtedy 409. Wymaga zakresu home_kit_orders_manage lub węższego zakresu home_kit_orders_activate.

Żądanie

Parametry ścieżki

string
wymagane
Unikalny identyfikator (UUID) zamówienia domowego zestawu testowego do aktywacji.

Parametry treści

string
wymagane
Moment pobrania próbki przez pacjenta jako znacznik czasu UTC (ISO 8601 z sufiksem Z, np. 2026-08-28T07:30:00Z). Nie może być w przyszłości ani starszy niż 30 dni.

Odpowiedź

W razie powodzenia API zwraca 200 OK ze zaktualizowanym zamówieniem domowego zestawu testowego — status ma wartość activated, a activated_at zawiera wysłany przez ciebie znacznik czasu.

Odpowiedzi z błędami