Salt la conținutul principal
PATCH
Actualizează detaliile programării, cum ar fi ora programată sau locația de testare. Doar programările pentru care recoltarea de sânge nu a fost încă confirmată pot fi modificate.
Programările nu pot fi modificate după ce recoltarea de sânge a fost confirmată sau dacă sunt deja anulate. Încercarea de a actualiza o astfel de programare returnează 409 Conflict. Singura excepție este results_ready_emails, pe care îl poți modifica în continuare după recoltarea de sânge.
Necesită scope-ul appointments_schedule sau appointments_manage.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul unic (UUID) al programării de actualizat.

Parametri de corp

Toți parametrii din body sunt opționali — include doar câmpurile pe care vrei să le modifici.
string
Noua dată și oră a programării în format ISO 8601 (de ex., 2026-05-20T14:00:00Z sau 2026-05-20T16:00:00+02:00). Trebuie să includă un indicator de fus orar — fie Z, fie un decalaj explicit precum +02:00; valorile fără fus orar sunt respinse. Trebuie să fie în viitor.Trebuie să fie exact ora de început a unui interval cu capacitate disponibilă — vezi Obține disponibilitatea. Programarea reprogramată nu se contorizează niciodată în propriul interval țintă, dar mutarea într-un interval în care același profil are deja o altă programare returnează 409 cu appointment_id al acelei programări.Dacă locația țintă este operată de Aniva, noua oră trebuie să fie și cu cel puțin 12 ore în avans — vezi Preaviz minim.
string
UUID-ul noii locații de testare. Locația trebuie să existe și să fie activă. Folosește Listează locațiile pentru a găsi ID-urile locațiilor disponibile.
string[]
Înlocuiește lista de până la 5 adrese care primesc fiecare câte un e-mail odată ce toate rezultatele de laborator sunt finale. Trimite [] pentru a dezactiva e-mailurile. Acest câmp rămâne editabil după recoltarea de sânge; doar o programare anulată îl respinge. După recoltarea de sânge, trimite-l singur: cu scheduled_at sau location_id în același body, cererea returnează 409. Cheia ta are nevoie de acces results_view pentru pacient, altfel primești 403. Vezi E-mailuri pentru rezultate gata.
string | null
Noua metodă de recoltare: capillary sau venous, ori null pentru a folosi din nou default_draw_method al locației. Locația trebuie să includă metoda în draw_methods, iar analizele programate trebuie să fie posibile cu aceasta, altfel primești 400. Când muți o programare la o altă locație, aceeași verificare rulează acolo: pe propriul draw_method sau, în lipsa lui, pe default_draw_method al noii locații.

Răspuns

În caz de succes, API-ul returnează 200 OK cu programarea actualizată și profilul integrat al acesteia.
string
obligatoriu
Identificatorul unic al programării (UUID).
string
obligatoriu
UUID-ul profilului căruia îi aparține această programare.
string
UUID-ul locației de testare unde are loc recoltarea de sânge.
string
Data și ora programării ca moment UTC (ISO 8601 cu sufixul Z, de ex. 2026-05-20T14:00:00Z). Poate fi null.
string
obligatoriu
Statusul curent al programării. Una dintre valorile pending, confirmed, blood_drawn sau cancelled. Detaliile privind finalizarea rezultatelor de laborator se obțin din Obține rezultatele; evoluția detaliată a expedierii se obține din fiecare intrare din lista inline shipments (vezi mai jos), urmată de Obține expedierea.
string
Motivul în text liber înregistrat la anularea programării (de ex. neprezentare, anulare tardivă, „Eșuat. Necesită repetare”). Este null dacă status nu este cancelled.
string[]
obligatoriu
Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu litere mici. Gol când este dezactivat. Vezi E-mailuri pentru rezultate gata.
string
obligatoriu
Cum se face recoltarea de sânge: capillary (din vârful degetului sau partea superioară a brațului, în microtainere) sau venous (din venă, în eprubete). Este metoda setată pe programare sau default_draw_method al locației acesteia. După recoltarea de sânge, este metoda care a fost folosită.
string
obligatoriu
Timestamp ISO 8601 al creării programării.
string
Timestamp ISO 8601 al ultimei actualizări. Poate fi null.
object
obligatoriu
Profilul pacientului asociat cu această programare.
AppointmentPanel[]
obligatoriu
Panelurile atașate în prezent acestei programări. Exclude atașările anulate. Consultă detaliile panelului (nume, biomarkeri) prin Listează panelurile.
AppointmentIndividualBiomarker[]
obligatoriu
Biomarkeri à la carte asociați cu această programare în afara unui panel (vezi Adaugă biomarkeri personalizați). Corelează fiecare biomarker_id cu Listează biomarkeri pentru datele de afișare.
AppointmentShipmentLink[]
obligatoriu
Expedierile asociate acestei programări, în ordinea celei mai vechi asocieri. Array gol când nu există expedieri asociate. Corelează fiecare id cu Obține expedierea pentru payload-ul complet al expedierii.
string[]
obligatoriu
Codurile de laborator (codurile de bare de pe eprubete) înregistrate pentru această programare, în ordinea scanării. Gol până la confirmarea recoltării de sânge. O recoltare venoasă are un singur cod tipărit pe fiecare eprubetă; o recoltare capilară are câte un cod per microtainer. Rezultatele și documentele din Obține rezultate fac referire la aceste coduri prin lab_code.

Răspunsuri de eroare