Salt la conținutul principal
PATCH
Actualizează adresa de livrare, panelul, metadatele sau e-mailurile pentru rezultate gata ale unei comenzi de kit de testare la domiciliu. Include doar câmpurile pe care vrei să le modifici. Adresa de livrare și panelul pot fi modificate doar cât timp comanda este pending, deoarece kitul fizic pleacă la expediere. metadata este pentru evidența ta proprie și poate fi editat pe toată durata comenzii. Nu există endpointuri de adăugare/eliminare de paneluri: un kit de testare la domiciliu conține exact un panel (corespunde 1:1 cu un produs de kit fizic), deci singura operațiune relevantă pentru panel este înlocuirea pe care o faci aici. Necesită scope-ul home_kit_orders_manage.

Cerere

Parametri de cale

string
obligatoriu
Identificator unic (UUID) al comenzii de kit de testare la domiciliu de actualizat.

Parametri de corp

Toți parametrii din body sunt opționali — include doar câmpurile pe care vrei să le modifici.
object
Adresa la care se trimite kitul — în una dintre cele două forme: fie { location_id }, care face referire la o locație de testare cunoscută, fie câmpurile de adresă inline (name, street, city, postal_code, country_code; opțional company_name / house_number / address_line_2 / state / phone / email — același vocabular ca în API-ul de locații). Furnizează exact una dintre variante — o referință de locație sau o adresă inline, nu ambele.
Packstation sau Postfiliale (doar în Germania): setează street la Packstation sau Postfiliale, house_number la numărul de trei cifre al stației și address_line_2 la DHL Postnummer al destinatarului (6–10 cifre, spațiile sunt permise). Fără Postnummer, expedierea coletului nu poate fi înregistrată. Postfach nu este acceptat.
string
UUID-ul panelului de atașat în locul celui curent — cum există exact un panel per kit, înlocuirea este singura operațiune relevantă. Posibilă doar cât timp comanda este pending și doar către un panel configurat de Aniva cu un produs de kit pentru expediere (altfel 422); înlocuirea cu panelul deja atașat nu are niciun efect.
object
Propriile tale perechi cheie/valoare. Se combină cu metadatele existente în loc să le înlocuiască: cheile pe care le omiți se păstrează, o cheie trimisă cu valoarea null este ștearsă, iar un obiect gol {} șterge tot. Limitele sunt aceleași ca la Creare comandă de kit de testare la domiciliu, iar validarea este de tip totul-sau-nimic — dacă o cheie este respinsă, nu se salvează nimic. Nu pune niciodată date personale sau clinice în metadata — acestea nu sunt tratate ca date ale pacientului.
string[]
Înlocuiește lista de până la 5 adrese care primesc câte un e-mail odată ce toate rezultatele de laborator sunt finale. Trimite [] pentru a dezactiva e-mailurile. Editabil în orice status, cu excepția cancelled. Cheia ta are nevoie de acces results_view la pacient, altfel 403. Vezi E-mailuri pentru rezultate gata.

Răspuns

La succes, API-ul returnează 200 OK cu comanda de kit de testare la domiciliu actualizată și profilul său încorporat.
string
obligatoriu
Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu.
string
obligatoriu
UUID-ul profilului căruia îi aparține această comandă de kit de testare la domiciliu.
string
obligatoriu
Statusul curent al comenzii de kit de testare la domiciliu. Una dintre valorile pending, dispatched, activated sau cancelled.
object
obligatoriu
Adresa la care se trimite kitul — în una dintre două forme: fie { location_id } cu referire la o locație de testare cunoscută, fie câmpurile de adresă inline (name, street, city, postal_code, country_code; company_name / house_number / address_line_2 / state / phone / email opționale — același vocabular ca în API-ul de locații). Furnizează exact una dintre ele — o referință de locație sau o adresă inline, nu ambele.
string
Codul de probă de laborator sub care sunt raportate rezultatele — tipărit pe kitul fizic, pe care pacientul îl citește de pe cutie ca cod de activare. null până când kitul este ambalat. Doar citire.
string
obligatoriu
Marcajul temporal al recoltării raportat prin Activează — momentul în care pacientul și-a recoltat proba. null până când kitul este activat.
string
Comanda de kit de testare la domiciliu pe care o înlocuiește aceasta, când este un kit de înlocuire. null pentru o comandă obișnuită. Vezi Creează comandă de kit de testare la domiciliu.
string
Motivul pentru care a fost trimis kitul de înlocuire. null pentru o comandă obișnuită.
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.
object
obligatoriu
Perechi cheie/valoare definite de partener, returnate exact așa cum au fost trimise. Întotdeauna prezent — {} când nu este setat.
string
obligatoriu
Marcajul temporal ISO 8601 al momentului în care a fost creată comanda de kit de testare la domiciliu.
string
Timestamp ISO 8601 al ultimei actualizări. Poate fi null.
object
obligatoriu
Profilul pacientului asociat acestei comenzi de kit de testare la domiciliu.
HomeKitOrderPanel[]
obligatoriu
Panelul atașat acestei comenzi de kit de testare la domiciliu — întotdeauna exact unul (un kit de testare la domiciliu corespunde 1:1 cu un produs de kit fizic), înlocuit direct când trimiți panel_id. Consultă detaliile panelului (nume, biomarkeri) prin Listare paneluri.
HomeKitOrderIndividualBiomarker[]
obligatoriu
Biomarkeri individuali atașați acestei comenzi de kit de testare la domiciliu, în afara oricărui panel. Corelează fiecare biomarker_id cu Listare biomarkeri folosind home_kit=true pentru datele de afișare.
HomeKitOrderShipmentLink[]
obligatoriu
Coletele asociate acestei comenzi de kit de testare la domiciliu, începând cu cea mai veche asociere — de obicei kitul către pacient și proba înapoi la laborator. Gol până când centrul de expediere tipărește o etichetă. Citește coletele complete cu Listare expedieri și ?home_kit_order_id=.

Răspunsuri de eroare