Przejdź do głównej treści
PATCH
Zaktualizuj szczegóły wizyty, takie jak zaplanowana godzina lub lokalizacja badania. Modyfikować można tylko wizyty, dla których pobranie krwi nie zostało jeszcze potwierdzone.
Wizyt nie można modyfikować po potwierdzeniu pobrania krwi ani po ich anulowaniu. Próba aktualizacji takiej wizyty zwraca 409 Conflict. Jedynym wyjątkiem jest results_ready_emails, które nadal możesz zmienić po pobraniu krwi.
Wymaga zakresu appointments_schedule lub appointments_manage.

Żądanie

Parametry ścieżki

string
wymagane
Unikalny identyfikator (UUID) wizyty do aktualizacji.

Parametry treści

Wszystkie parametry w treści żądania są opcjonalne — podaj tylko pola, które chcesz zmienić.
string
Nowa data i godzina wizyty w formacie ISO 8601 (np. 2026-05-20T14:00:00Z lub 2026-05-20T16:00:00+02:00). Musi zawierać oznaczenie strefy czasowej — Z albo jawne przesunięcie, np. +02:00; daty bez strefy czasowej są odrzucane. Musi przypadać w przyszłości.Musi dokładnie odpowiadać początkowi terminu z wolnymi miejscami — zobacz Pobierz dostępność. Przekładana wizyta nigdy nie zmniejsza limitu własnego docelowego terminu, ale przeniesienie na termin, w którym ten sam profil ma już inną wizytę, zwraca 409 z appointment_id tej wizyty.Jeśli docelowa lokalizacja jest prowadzona przez Aniva, nowy termin musi też przypadać co najmniej 12 godzin od teraz — zobacz Minimalne wyprzedzenie.
string
UUID nowej lokalizacji badania. Lokalizacja musi istnieć i być aktywna. Użyj Wyświetl lokalizacje, aby znaleźć dostępne identyfikatory lokalizacji.
string[]
Zastępuje listę maksymalnie 5 adresów, z których każdy otrzymuje jeden e-mail, gdy wszystkie wyniki laboratoryjne są ostateczne. Wyślij [], aby wyłączyć e-maile. To pole pozostaje edytowalne po pobraniu krwi; odrzuca je tylko anulowana wizyta. Po pobraniu krwi wysyłaj je osobno: jeśli w tej samej treści znajdzie się scheduled_at lub location_id, żądanie zwraca 409. Twój klucz wymaga dostępu results_view do pacjenta, w przeciwnym razie zwracane jest 403. Zobacz E-maile o gotowych wynikach.
string | null
Nowa metoda pobrania: capillary lub venous albo null, aby ponownie użyć default_draw_method danej lokalizacji. Lokalizacja musi mieć tę metodę w draw_methods, a zarezerwowane badania muszą być przy niej możliwe, w przeciwnym razie zwracane jest 400. Gdy przenosisz wizytę do innej lokalizacji, przeprowadzane jest tam to samo sprawdzenie: dla jej własnego draw_method, a w przeciwnym razie dla default_draw_method nowej lokalizacji.

Odpowiedź

W przypadku powodzenia API zwraca 200 OK ze zaktualizowaną wizytą i jej osadzonym profilem.
string
wymagane
Unikalny identyfikator wizyty (UUID).
string
wymagane
UUID profilu, do którego należy ta wizyta.
string
UUID lokalizacji badania, w której odbywa się pobranie krwi.
string
Zaplanowana data i godzina wizyty jako punkt w czasie UTC (ISO 8601 z sufiksem Z, np. 2026-05-20T14:00:00Z). Może mieć wartość null.
string
wymagane
Bieżący status wizyty. Jedna z wartości: pending, confirmed, blood_drawn lub cancelled. Szczegółowy stopień gotowości wyników laboratoryjnych wynika z Pobierz wyniki; bardziej szczegółowy postęp przesyłki — z każdego wpisu w dołączonej tablicy shipments (zobacz niżej), który prowadzi do Pobierz przesyłkę.
string
Dowolny tekst powodu zapisany przy anulowaniu wizyty (np. nieobecność, późne anulowanie, „Nieudane. Wymagane powtórzenie”). Ma wartość null, chyba że status to cancelled.
string[]
wymagane
Adresy zapisane małymi literami, z których każdy otrzymuje jednego e-maila, gdy wszystkie wyniki laboratoryjne będą ostateczne. Puste, gdy wyłączone. Zobacz E-maile o gotowych wynikach.
string
wymagane
Sposób pobrania krwi: capillary (z opuszka palca lub ramienia, do mikroprobówek) lub venous (z żyły, do probówek). Jest to metoda ustawiona dla wizyty, a w przeciwnym razie default_draw_method jej lokalizacji. Po pobraniu krwi jest to metoda, której użyto.
string
wymagane
Znacznik czasu ISO 8601 utworzenia wizyty.
string
Znacznik czasu ISO 8601 ostatniej aktualizacji. Może mieć wartość null.
object
wymagane
Profil pacjenta powiązany z tą wizytą.
AppointmentPanel[]
wymagane
Panele aktualnie przypisane do tej wizyty. Nie obejmuje anulowanych przypisań. Szczegóły panelu (nazwę, biomarkery) sprawdzisz przez Lista paneli.
AppointmentIndividualBiomarker[]
wymagane
Pojedyncze biomarkery przypisane do tej wizyty poza panelami (zobacz Dodaj własne biomarkery). Sprawdź każde biomarker_id w Wyświetl biomarkery, aby uzyskać dane do wyświetlenia.
AppointmentShipmentLink[]
wymagane
Przesyłki powiązane z tą wizytą, od najstarszego powiązania. Pusta tablica, gdy brak powiązanych przesyłek. Sprawdź każde id w Pobierz przesyłkę, aby uzyskać pełne dane przesyłki.
string[]
wymagane
Kody laboratoryjne (kody kreskowe probówek) zapisane dla tej wizyty w kolejności skanowania. Puste do momentu potwierdzenia pobrania krwi. Pobranie żylne ma jeden kod wydrukowany na każdej probówce, a pobranie włośniczkowe ma jeden kod na mikroprobówkę. Wyniki i dokumenty w Pobierz wyniki odwołują się do tych kodów przez lab_code.

Odpowiedzi z błędami