Przejdź do głównej treści
DELETE
Anuluj wizytę, ustawiając jej status na cancelled. Anulować można tylko wizyty, dla których pobranie krwi nie zostało jeszcze potwierdzone. Anulowanie wizyty, która ma już status cancelled, zwraca 200 z tą wizytą i nic nie zapisuje — drugie anulowanie nie jest rejestrowane. Odpowiedź zawiera Idempotent-Replayed: true, dzięki czemu odróżnisz powtórzenie od wywołania, które wykonało operację. Powtórzenie z innym cancellation_reason zwraca zamiast tego 409: zapisany powód nigdy nie jest nadpisywany. Zobacz Idempotentność.
Wizyt nie można anulować po potwierdzeniu pobrania krwi — zwraca to 409 Conflict.
Wymaga zakresu appointments_schedule lub appointments_manage.

Żądanie

Parametry ścieżki

string
wymagane
Unikalny identyfikator (UUID) wizyty do anulowania.

Parametry treści

Treść żądania jest opcjonalna — nie wysyłaj jej wcale, aby anulować bez zapisywania powodu.
string
Dowolny tekst powodu anulowania, do 500 znaków (np. Patient no-show). Zapisywany przy wizycie i zwracany jako cancellation_reason w tym oraz kolejnych odczytach.

Odpowiedź

W razie powodzenia API zwraca 200 OK z anulowaną 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 w formacie UTC (ISO 8601 z sufiksem Z, np. 2026-05-15T10:30:00Z). Może mieć wartość null.
string
wymagane
Status wizyty. Po pomyślnym anulowaniu będzie to cancelled.
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 przypisane do tej wizyty przed jej anulowaniem. Sprawdź szczegóły panelu (nazwę, biomarkery) w Wyświetl panele.
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ą przed jej anulowaniem. Każde id odnosi się do Pobierz przesyłkę.
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