Salt la conținutul principal
POST
Creează o programare de recoltare de sânge pentru profilul unui pacient la o anumită locație de testare. Odată creată, programarea intră implicit în statusul confirmed (unele locații pot folosi implicit pending — aceasta este o setare specifică fiecărei locații). Folosește Adaugă paneluri pentru a atașa paneluri de analize de sânge înainte de confirmarea recoltării de sânge.
Un profil poate avea cel mult o programare per locație și oră. Crearea unei programări pentru un interval pe care profilul îl ocupă deja returnează 409 cu appointment_id existent în loc de o a doua programare — astfel, o cerere reîncercată sau repetată din greșeală nu poate duplica niciodată o programare. Vezi Programări duplicate.
Trimite un antet opțional Idempotency-Key pentru ca această creare să poată fi reîncercată în siguranță — repetarea aceleiași chei returnează răspunsul inițial în loc să creeze încă una. Vezi Idempotență. Necesită scope-ul appointments_schedule.

Cerere

Parametri de corp

string
obligatoriu
UUID-ul profilului pacientului pentru care creezi programarea.
string
obligatoriu
UUID-ul locației de testare unde va avea loc recoltarea de sânge. Folosește Listează locațiile pentru a găsi ID-urile locațiilor disponibile.
string
obligatoriu
Data și ora programării în format ISO 8601 (de ex., 2026-05-15T10:30:00Z sau 2026-05-15T12:30: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 ora exactă de început a unui interval din grila locației, iar intervalul trebuie să mai aibă capacitate — consultă mai întâi Obține disponibilitatea. Orele din afara grilei returnează 400; un interval ocupat complet returnează 409. La locațiile operate de Aniva trebuie să fie și cu cel puțin 12 ore în avans — vezi Preaviz minim.
string[]
Până la 5 adrese care primesc fiecare câte un email odată ce toate rezultatele de laborator sunt finale. Emailul conține un link către pagina de rezultate din panoul de administrare Aniva. Cheia ta are nevoie de acces results_view pentru pacient, altfel returnează 403. Omite câmpul pentru a folosi adresele implicite setate pentru grupul pacientului. O listă goală dezactivează emailurile. Vezi Emailuri când rezultatele sunt gata.
string
Cum se face recoltarea de sânge: capillary sau venous. Omite câmpul pentru a folosi default_draw_method al locației. Locația trebuie să includă metoda în draw_methods, altfel returnează 400.

Răspuns

În caz de succes, API-ul returnează 201 Created împreună cu noua programare.
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 în format UTC (ISO 8601 cu sufixul Z, de ex. 2026-05-15T10:30: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ă.
object
obligatoriu
Profilul pacientului asociat cu această programare.
AppointmentPanel[]
obligatoriu
Panelurile atașate în prezent acestei programări. Listă goală pentru programările nou create — atașează-le prin Adaugă paneluri. Consultă detaliile panelurilor (nume, biomarkeri) prin Listează panelurile.
AppointmentIndividualBiomarker[]
obligatoriu
Biomarkeri individuali atașați acestei programări în afara unui panel. Listă goală pentru programările nou create — atașează-i prin Adaugă biomarkeri individuali. Corelează fiecare biomarker_id cu Listează biomarkerii pentru datele de afișare.
AppointmentShipmentLink[]
obligatoriu
Expedierile asociate acestei programări, începând cu cea mai veche asociere. Listă goală pentru programările nou create — asociază-le prin Creează expediere (cu appointment_id) sau Atașează programări la expediere.
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.

Preaviz minim

Programările la locațiile operate de Aniva trebuie făcute cu cel puțin 12 ore în avans; programarea în acea fereastră returnează 400. Obține disponibilitatea exclude deja acele intervale, așa că tot ce citești din acea grilă poate fi programat. Locațiile pe care le operezi tu nu au preaviz minim — programările în aceeași zi și cele pe loc rămân neschimbate.

Programări duplicate

Un profil poate avea cel mult o programare neanulată per locație și moment — o persoană nu poate face două recoltări de sânge în același loc și în același moment, indiferent câte scaune are locația. Crearea unei programări pentru un interval pe care profilul îl ocupă deja returnează 409 cu un appointment_id care indică programarea deja existentă:
Tratează situația ca și cum cererea ar fi fost deja aplicată: preia programarea cu Obține programarea, mut-o cu Actualizează programarea sau renunță la ea cu Anulează programarea. Nu reîncerca crearea — va continua să returneze 409. Astfel, creările repetate sunt sigure: o cerere pe care o retrimiți după un timeout sau un formular trimis de două ori nu poate genera două programări pentru același pacient la aceeași oră.
appointment_id este prezent doar în cazul 409 pentru duplicat. Codul 409 de capacitate — intervalul este plin deoarece alți pacienți îl ocupă — returnează doar error, iar soluția potrivită în acel caz este să alegi un alt interval din Obține disponibilitatea.

Răspunsuri de eroare