{ "error": "duplicate_document", "message": "This file is already on this profile", "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"}
Carica un file su un profilo. Invialo come multipart/form-data. Senza extract_results, Aniva si
limita a salvare il file. Con extract_results: true, Aniva legge anche i valori di laboratorio dal file.Non devi indicare di che tipo di referto si tratta. Decide Aniva. Un file senza risultati di laboratorio, come
una lettera medica, termina in stato stored e non è un errore.Leggi i valori con Ottieni risultati del documento. Non devi fare
polling: iscriviti ai webhookdocument.results.*.Richiede lo scope documents_upload su un gruppo di profili del profilo. extract_results: true
richiede anche lo scope documents_extract_results sullo stesso gruppo. Chiedi ad Aniva di aggiungerli. Il
documento appartiene a quel gruppo: le chiavi con results_view su quel gruppo possono leggere il documento e i suoi risultati.Invia un header opzionale Idempotency-Key per rendere sicuro un nuovo tentativo di caricamento. Consulta
Idempotenza.
Cosa fa l’estrazione
Con extract_results: true:
Aniva invia il file ai suoi sub-responsabili OCR e AI per leggere i valori.
I valori compaiono nell’app Aniva del membro, come ogni altro risultato.
Ogni valore ha origin: partner_upload e lo stesso status di ogni altro risultato. Un valore
su cui il controllo automatico di Aniva ha dubbi ha stato likely_wrong.
Senza di essa, il file non viene inviato a nessun servizio esterno se invii anche document_date.
Accuratezza e protezione dei dati
La lettura automatica può leggere in modo errato un valore, un’unità o una data. Il file
originale resta la fonte di riferimento. Verifica un valore sul file prima di usarlo per una
decisione medica. I valori estratti non sono una diagnosi.
I sub-responsabili sono Mistral AI (OCR, UE) e Google Cloud Vertex AI, raggiunto tramite Vercel
AI Gateway (estrazione, può elaborare dati fuori dall’UE). Elaborano il file solo per leggerlo.
Ti serve una base giuridica per caricare i dati sanitari di un membro, di norma il suo consenso
esplicito. La responsabilità è tua.
Richiesta
Campi del modulo
file
obbligatorio
Il file. PDF, DOC, DOCX, PNG o JPEG, al massimo 4 MB.
string
obbligatorio
UUID del profilo a cui appartiene il documento.
boolean
predefinito:"false"
true per leggere i valori di laboratorio dal file. Invia true o false.
string
La data del campione in formato YYYY-MM-DD, se la conosci. Se non la invii, Aniva legge la data
dal file.
Risposta
L’API restituisce 201 Created quando ha solo archiviato il file e 202 Accepted quando esegue l’estrazione.
Un campo del modulo non è valido oppure il body non è multipart/form-data.
403
Alla tua chiave API manca uno scope, il profilo è fuori dal tuo contesto di accesso oppure hai inviato extract_results: true senza documents_extract_results.
404
Profilo non trovato.
409
duplicate_document: lo stesso file è già presente su questo profilo. document_id lo indica, oppure è null se non puoi leggerlo. Inviato anche in caso di conflitto di Idempotency-Key.
413
file_too_large: il file supera i 4 MB.
415
unsupported_media_type: il file non è un PDF, DOC, DOCX, PNG o JPEG. Il nome del file deve terminare con .pdf, .doc, .docx, .png, .jpg o .jpeg.
500
Errore interno del server. extraction_not_started: il file è archiviato come document_id, ma non è stato possibile avviare l’estrazione. Contatta Aniva.
{ "error": "duplicate_document", "message": "This file is already on this profile", "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Aniva API","description":"REST API for lab testing in Germany and the EU: book blood draws at pharmacies and practices, ship home test kits, and get lab results.","colors":{"primary":"#e76c2b","light":"#e76c2b","dark":"#e76c2b"},"logo":{"light":"https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/aniva.svg?fit=max\u0026auto=format\u0026n=3R-RUSdQmYnR_d5s\u0026q=85\u0026s=07e4ee4fd57b9ccbe6809fe000f33fdd","dark":"https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/aniva.svg?fit=max\u0026auto=format\u0026n=3R-RUSdQmYnR_d5s\u0026q=85\u0026s=07e4ee4fd57b9ccbe6809fe000f33fdd"},"favicon":{"light":"https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/aniva.png?fit=max\u0026auto=format\u0026n=3R-RUSdQmYnR_d5s\u0026q=85\u0026s=37c01b349855726e2009a8d5aca4487b","dark":"https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/aniva.png?fit=max\u0026auto=format\u0026n=3R-RUSdQmYnR_d5s\u0026q=85\u0026s=37c01b349855726e2009a8d5aca4487b"},"api":{"openapi":"https://anivahealth.com/api/v1/openapi.json","mdx":{"auth":{"method":"key","name":"x-api-key"}}},"navbar":{"links":[{"href":"/changelog","label":"Changelog"},{"href":"/status","label":"Status"}]},"footer":{"links":[{"items":[{"label":"Aniva Diagnostics","href":"https://anivahealth.com/diagnostics"},{"label":"hello@anivahealth.com","href":"mailto:hello@anivahealth.com"}]}]},"seo":{"metatags":{"og:locale":"en_US","og:site_name":"Aniva Partner API","keywords":"blood test API, lab testing API, home test kit API, lab results API, biomarker API, pharmacy blood test, Germany, EU"},"indexing":"navigable"},"fonts":{"heading":{"family":"Switzer","weight":600,"source":"https://anivahealth.com/fonts/Switzer-Variable.woff2","format":"woff2"},"body":{"family":"Switzer","source":"https://anivahealth.com/fonts/Switzer-Variable.woff2","format":"woff2"}},"styling":{"latex":false},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":""},{"language":"de","navbar":{"links":[{"href":"/de/changelog","label":"Changelog"},{"href":"/de/status","label":"Status"}]},"href":"de"},{"language":"ca","navbar":{"links":[{"href":"/ca/changelog","label":"Registre de canvis"},{"href":"/ca/status","label":"Estat"}]},"href":"ca"},{"language":"cs","navbar":{"links":[{"href":"/cs/changelog","label":"Seznam změn"},{"href":"/cs/status","label":"Stav"}]},"href":"cs"},{"language":"da","navbar":{"links":[{"href":"/da/changelog","label":"Ændringslog"},{"href":"/da/status","label":"Status"}]},"href":"da"},{"language":"es","navbar":{"links":[{"href":"/es/changelog","label":"Registro de cambios"},{"href":"/es/status","label":"Estado"}]},"href":"es"},{"language":"fi","navbar":{"links":[{"href":"/fi/changelog","label":"Muutosloki"},{"href":"/fi/status","label":"Tila"}]},"href":"fi"},{"language":"fr","navbar":{"links":[{"href":"/fr/changelog","label":"Journal des modifications"},{"href":"/fr/status","label":"Statut"}]},"href":"fr"},{"language":"hu","navbar":{"links":[{"href":"/hu/changelog","label":"Változásnapló"},{"href":"/hu/status","label":"Állapot"}]},"href":"hu"},{"language":"it","navbar":{"links":[{"href":"/it/changelog","label":"Changelog"},{"href":"/it/status","label":"Stato"}]},"href":"it"},{"language":"lv","navbar":{"links":[{"href":"/lv/changelog","label":"Izmaiņu žurnāls"},{"href":"/lv/status","label":"Statuss"}]},"href":"lv"},{"language":"nl","navbar":{"links":[{"href":"/nl/changelog","label":"Changelog"},{"href":"/nl/status","label":"Status"}]},"href":"nl"},{"language":"no","navbar":{"links":[{"href":"/no/changelog","label":"Endringslogg"},{"href":"/no/status","label":"Status"}]},"href":"no"},{"language":"pl","navbar":{"links":[{"href":"/pl/changelog","label":"Dziennik zmian"},{"href":"/pl/status","label":"Status"}]},"href":"pl"},{"language":"pt","navbar":{"links":[{"href":"/pt/changelog","label":"Registo de alterações"},{"href":"/pt/status","label":"Estado"}]},"href":"pt"},{"language":"ro","navbar":{"links":[{"href":"/ro/changelog","label":"Jurnal de modificări"},{"href":"/ro/status","label":"Stare"}]},"href":"ro"},{"language":"ru","navbar":{"links":[{"href":"/ru/changelog","label":"История изменений"},{"href":"/ru/status","label":"Статус"}]},"href":"ru"},{"language":"sv","navbar":{"links":[{"href":"/sv/changelog","label":"Ändringslogg"},{"href":"/sv/status","label":"Status"}]},"href":"sv"},{"language":"tr","navbar":{"links":[{"href":"/tr/changelog","label":"Değişiklik günlüğü"},{"href":"/tr/status","label":"Durum"}]},"href":"tr"},{"language":"uk","navbar":{"links":[{"href":"/uk/changelog","label":"Історія змін"},{"href":"/uk/status","label":"Статус"}]},"href":"uk"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"anivahealth","hasAudioNarration":false,"actualSubdomain":"anivahealth","customDomains":["docs.anivahealth.com"],"gitSource":{"type":"github","owner":"anivahealth","repo":"web","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0344de3ca2a55c0067aa73","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"en","tag":"API Reference","count":61},{"language":"ca","tag":"Referència de l'API","count":61},{"language":"cs","tag":"Reference API","count":61},{"language":"da","tag":"API-reference","count":61},{"language":"de","tag":"API-Referenz","count":61},{"language":"es","tag":"Referencia de la API","count":61},{"language":"fi","tag":"API-viite","count":61},{"language":"fr","tag":"Référence API","count":61},{"language":"hu","tag":"API-referencia","count":61},{"language":"it","tag":"Riferimento API","count":61},{"language":"lv","tag":"API uzziņa","count":61},{"language":"nl","tag":"API-referentie","count":61},{"language":"no","tag":"API-referanse","count":61},{"language":"pl","tag":"Dokumentacja API","count":61},{"language":"pt","tag":"Referência da API","count":61},{"language":"ro","tag":"Referință API","count":61},{"language":"ru","tag":"Справочник API","count":61},{"language":"sv","tag":"API-referens","count":61},{"language":"tr","tag":"API referansı","count":61},{"language":"uk","tag":"Довідник API","count":61},{"language":"en","tag":"Documentation","count":18},{"language":"ca","tag":"Documentació","count":18},{"language":"cs","tag":"Dokumentace","count":18},{"language":"da","tag":"Dokumentation","count":18},{"language":"de","tag":"Dokumentation","count":18},{"language":"es","tag":"Documentación","count":18},{"language":"fi","tag":"Dokumentaatio","count":18},{"language":"fr","tag":"Documentation","count":18},{"language":"hu","tag":"Dokumentáció","count":18},{"language":"it","tag":"Documentazione","count":18},{"language":"lv","tag":"Dokumentācija","count":18},{"language":"nl","tag":"Documentatie","count":18},{"language":"no","tag":"Dokumentasjon","count":18},{"language":"pl","tag":"Dokumentacja","count":18},{"language":"pt","tag":"Documentação","count":18},{"language":"ro","tag":"Documentație","count":18},{"language":"ru","tag":"Документация","count":18},{"language":"sv","tag":"Dokumentation","count":18},{"language":"tr","tag":"Dokümantasyon","count":18},{"language":"uk","tag":"Документація","count":18},{"language":"en","tag":"Appointments","count":13},{"language":"ca","tag":"Cites","count":13},{"language":"cs","tag":"Termíny","count":13},{"language":"da","tag":"Tider","count":13},{"language":"de","tag":"Termine","count":13},{"language":"es","tag":"Citas","count":13},{"language":"fi","tag":"Ajanvaraukset","count":13},{"language":"fr","tag":"Rendez-vous","count":13},{"language":"hu","tag":"Időpontok","count":13},{"language":"it","tag":"Appuntamenti","count":13},{"language":"lv","tag":"Pieraksti","count":13},{"language":"nl","tag":"Afspraken","count":13},{"language":"no","tag":"Timer","count":13},{"language":"pl","tag":"Wizyty","count":13},{"language":"pt","tag":"Marcações","count":13},{"language":"ro","tag":"Programări","count":13},{"language":"ru","tag":"Записи","count":13},{"language":"sv","tag":"Bokningar","count":13},{"language":"tr","tag":"Randevular","count":13},{"language":"uk","tag":"Записи","count":13},{"language":"en","tag":"Home Kit Orders","count":10},{"language":"ca","tag":"Comandes de kits de prova a casa","count":10},{"language":"cs","tag":"Objednávky domácích testovacích sad","count":10},{"language":"da","tag":"Ordrer på hjemmetestkit","count":10},{"language":"de","tag":"Heimtest-Kit-Bestellungen","count":10},{"language":"es","tag":"Pedidos de kits de prueba en casa","count":10},{"language":"fi","tag":"Kotitestipakkausten tilaukset","count":10},{"language":"fr","tag":"Commandes de kits à domicile","count":10},{"language":"hu","tag":"Otthoni tesztkészlet-rendelések","count":10},{"language":"it","tag":"Ordini di kit domiciliari","count":10},{"language":"lv","tag":"Mājas testa komplektu pasūtījumi","count":10},{"language":"nl","tag":"Thuistestkitbestellingen","count":10},{"language":"no","tag":"Bestillinger av hjemmetestsett","count":10},{"language":"pl","tag":"Zamówienia domowych zestawów testowych","count":10},{"language":"pt","tag":"Encomendas de kits de teste em casa","count":10},{"language":"ro","tag":"Comenzi de kituri de testare la domiciliu","count":10},{"language":"ru","tag":"Заказы наборов для домашнего теста","count":10},{"language":"sv","tag":"Beställningar av hemtestkit","count":10},{"language":"tr","tag":"Evde test kiti siparişleri","count":10},{"language":"uk","tag":"Замовлення наборів для домашнього тесту","count":10},{"language":"en","tag":"Webhooks","count":9},{"language":"en","tag":"Core Concepts","count":9},{"language":"ca","tag":"Webhooks","count":9},{"language":"ca","tag":"Conceptes clau","count":9},{"language":"cs","tag":"Webhooky","count":9},{"language":"cs","tag":"Základní koncepty","count":9},{"language":"da","tag":"Webhooks","count":9},{"language":"da","tag":"Kernebegreber","count":9},{"language":"de","tag":"Webhooks","count":9},{"language":"de","tag":"Grundkonzepte","count":9},{"language":"es","tag":"Webhooks","count":9},{"language":"es","tag":"Conceptos clave","count":9},{"language":"fi","tag":"Webhookit","count":9},{"language":"fi","tag":"Peruskäsitteet","count":9},{"language":"fr","tag":"Webhooks","count":9},{"language":"fr","tag":"Concepts clés","count":9},{"language":"hu","tag":"Webhookok","count":9},{"language":"hu","tag":"Alapfogalmak","count":9},{"language":"it","tag":"Webhook","count":9},{"language":"it","tag":"Concetti di base","count":9},{"language":"lv","tag":"Tīmekļa aizķeres","count":9},{"language":"lv","tag":"Pamatjēdzieni","count":9},{"language":"nl","tag":"Webhooks","count":9},{"language":"nl","tag":"Kernconcepten","count":9},{"language":"no","tag":"Webhooks","count":9},{"language":"no","tag":"Kjernekonsepter","count":9},{"language":"pl","tag":"Webhooki","count":9},{"language":"pl","tag":"Podstawowe pojęcia","count":9},{"language":"pt","tag":"Webhooks","count":9},{"language":"pt","tag":"Conceitos principais","count":9},{"language":"ro","tag":"Webhook-uri","count":9},{"language":"ro","tag":"Concepte de bază","count":9},{"language":"ru","tag":"Вебхуки","count":9},{"language":"ru","tag":"Основные понятия","count":9},{"language":"sv","tag":"Webhooks","count":9},{"language":"sv","tag":"Grundkoncept","count":9},{"language":"tr","tag":"Webhook'lar","count":9},{"language":"tr","tag":"Temel kavramlar","count":9},{"language":"uk","tag":"Вебхуки","count":9},{"language":"uk","tag":"Основні поняття","count":9},{"language":"en","tag":"Shipments","count":8},{"language":"ca","tag":"Enviaments","count":8},{"language":"cs","tag":"Zásilky","count":8},{"language":"da","tag":"Forsendelser","count":8},{"language":"de","tag":"Sendungen","count":8},{"language":"es","tag":"Envíos","count":8},{"language":"fi","tag":"Lähetykset","count":8},{"language":"fr","tag":"Expéditions","count":8},{"language":"hu","tag":"Szállítmányok","count":8},{"language":"it","tag":"Spedizioni","count":8},{"language":"lv","tag":"Sūtījumi","count":8},{"language":"nl","tag":"Zendingen","count":8},{"language":"no","tag":"Forsendelser","count":8},{"language":"pl","tag":"Przesyłki","count":8},{"language":"pt","tag":"Envios","count":8},{"language":"ro","tag":"Expedieri","count":8},{"language":"ru","tag":"Отправления","count":8},{"language":"sv","tag":"Försändelser","count":8},{"language":"tr","tag":"Gönderiler","count":8},{"language":"uk","tag":"Відправлення","count":8},{"language":"en","tag":"Get Started","count":6},{"language":"ca","tag":"Primers passos","count":6},{"language":"cs","tag":"Začínáme","count":6},{"language":"da","tag":"Kom i gang","count":6},{"language":"de","tag":"Erste Schritte","count":6},{"language":"es","tag":"Primeros pasos","count":6},{"language":"fi","tag":"Aloitus","count":6},{"language":"fr","tag":"Démarrer","count":6},{"language":"hu","tag":"Első lépések","count":6},{"language":"it","tag":"Per iniziare","count":6},{"language":"lv","tag":"Sākt darbu","count":6},{"language":"nl","tag":"Aan de slag","count":6},{"language":"no","tag":"Kom i gang","count":6},{"language":"pl","tag":"Pierwsze kroki","count":6},{"language":"pt","tag":"Começar","count":6},{"language":"ro","tag":"Primii pași","count":6},{"language":"ru","tag":"Начало работы","count":6},{"language":"sv","tag":"Kom igång","count":6},{"language":"tr","tag":"Başlangıç","count":6},{"language":"uk","tag":"Початок роботи","count":6},{"language":"en","tag":"Locations","count":5},{"language":"en","tag":"Profiles","count":5},{"language":"ca","tag":"Ubicacions","count":5},{"language":"ca","tag":"Perfils","count":5},{"language":"cs","tag":"Lokality","count":5},{"language":"cs","tag":"Profily","count":5},{"language":"da","tag":"Lokationer","count":5},{"language":"da","tag":"Profiler","count":5},{"language":"de","tag":"Standorte","count":5},{"language":"de","tag":"Profile","count":5},{"language":"es","tag":"Ubicaciones","count":5},{"language":"es","tag":"Perfiles","count":5},{"language":"fi","tag":"Toimipisteet","count":5},{"language":"fi","tag":"Profiilit","count":5},{"language":"fr","tag":"Lieux","count":5},{"language":"fr","tag":"Profils","count":5},{"language":"hu","tag":"Helyszínek","count":5},{"language":"hu","tag":"Profilok","count":5},{"language":"it","tag":"Sedi","count":5},{"language":"it","tag":"Profili","count":5},{"language":"lv","tag":"Atrašanās vietas","count":5},{"language":"lv","tag":"Profili","count":5},{"language":"nl","tag":"Locaties","count":5},{"language":"nl","tag":"Profielen","count":5},{"language":"no","tag":"Steder","count":5},{"language":"no","tag":"Profiler","count":5},{"language":"pl","tag":"Lokalizacje","count":5},{"language":"pl","tag":"Profile","count":5},{"language":"pt","tag":"Locais","count":5},{"language":"pt","tag":"Perfis","count":5},{"language":"ro","tag":"Locații","count":5},{"language":"ro","tag":"Profiluri","count":5},{"language":"ru","tag":"Локации","count":5},{"language":"ru","tag":"Профили","count":5},{"language":"sv","tag":"Platser","count":5},{"language":"sv","tag":"Profiler","count":5},{"language":"tr","tag":"Konumlar","count":5},{"language":"tr","tag":"Profiller","count":5},{"language":"uk","tag":"Локації","count":5},{"language":"uk","tag":"Профілі","count":5}],"searchSettings":{"showContentSnippets":true,"maxResults":8}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=\"update-label\"]{background:transparent;color:rgb(107 114 128);padding-left:0.25rem;padding-right:0;font-weight:400}.dark [data-component-part=\"update-label\"]{color:rgb(156 163 175)}[data-component-part=\"update-tag-list\"]{margin-top:0.25rem;column-gap:0.25rem}[data-component-part=\"update-tag\"]:not(:last-child)::after{content:'·';margin-left:0.25rem}@media (max-width: 1023px){.update-container>div:first-child{flex-direction:row;flex-wrap:wrap;align-items:center;column-gap:0.75rem}.update-container [data-component-part=\"update-tag-list\"]{margin-top:0}}@media (min-width: 640px){[data-component-part=\"update-content\"] img{max-width:85%}}[data-component-part=\"update-content\"] video{cursor:zoom-in}.video-zoom{position:fixed;inset:0;z-index:100;display:flex;align-items:center;justify-content:center;padding:2rem;background:rgb(255 255 255 / 0.9);cursor:zoom-out}.dark .video-zoom{background:rgb(0 0 0 / 0.9)}.video-zoom video{width:100%;max-height:100%;object-fit:contain}.video-zoom-close{position:absolute;top:calc(0.75rem + env(safe-area-inset-top, 0px));right:0.75rem;display:inline-flex;align-items:center;justify-content:center;width:2.25rem;height:2.25rem;border:1px solid rgb(0 0 0 / 0.2);border-radius:9999px;background:rgb(255 255 255 / 0.55);color:rgb(23 23 23);box-shadow:0 0.5px 1px rgb(0 0 0 / 0.12),\n 0 1px 2px rgb(0 0 0 / 0.08),\n inset 0 0.5px 0 rgb(255 255 255 / 0.65);backdrop-filter:blur(40px) saturate(1.5);cursor:pointer}.video-zoom-close:focus{outline:none}.video-zoom-close:focus-visible{outline:2px solid rgb(0 0 0 / 0.25)}.dark .video-zoom-close{border-color:rgb(255 255 255 / 0.25);background:rgb(23 23 23 / 0.45);color:white;box-shadow:0 0 0 0.5px #000,\n 0 0.5px 1px rgb(0 0 0 / 0.45),\n 0 1px 2px rgb(0 0 0 / 0.35),\n inset 0 0.5px 0 rgb(255 255 255 / 0.14)}[data-component-part=\"update-content\"] h2>.absolute{display:none}#content{margin-bottom:2rem}[data-assistant-bar].invisible{display:none}#footer>div{flex-direction:row;flex-wrap:wrap;align-items:center;gap:1rem 2rem;padding-top:5rem;padding-bottom:3rem}#footer>div>div:first-child{flex:1;flex-direction:row;align-items:center;min-height:0}#footer>div>div:first-child>div:last-child{display:flex;justify-content:flex-end}#footer>div>div:first-child>div:last-child>div{align-items:flex-end}#footer>div>div:first-child>div:last-child>div>div{flex-direction:row;gap:1.5rem}#footer>div>div:first-child a{max-width:none}#footer>div>.h-px{display:none}#footer>div>div:last-child{gap:1.5rem}"}]}
{"page":{"pagePath":"it/api/documents/upload-document","slug":"/it/api/documents/upload-document","pageMetadata":{"title":"Carica documento","description":"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio","api":"POST https://anivahealth.com/api/v1/documents","href":"/it/api/documents/upload-document"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Heading,ParamField,ResponseField,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Carica un file su un profilo. Invialo come `,_jsx(_components.code,{children:`multipart/form-data`}),`. Senza `,_jsx(_components.code,{children:`extract_results`}),`, Aniva si\nlimita a salvare il file. Con `,_jsx(_components.code,{children:`extract_results: true`}),`, Aniva legge anche i valori di laboratorio dal file.`]}),`\n`,_jsxs(_components.p,{children:[`Non devi indicare di che tipo di referto si tratta. Decide Aniva. Un file senza risultati di laboratorio, come\nuna lettera medica, termina in stato `,_jsx(_components.code,{children:`stored`}),` e non è un errore.`]}),`\n`,_jsxs(_components.p,{children:[`Leggi i valori con `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),`. Non devi fare\npolling: iscriviti ai `,_jsx(_components.a,{href:`/it/concepts/webhooks`,children:`webhook`}),` `,_jsx(_components.code,{children:`document.results.*`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Richiede lo scope `,_jsx(_components.code,{children:`documents_upload`}),` su un gruppo di profili del profilo. `,_jsx(_components.code,{children:`extract_results: true`}),`\nrichiede anche lo scope `,_jsx(_components.code,{children:`documents_extract_results`}),` sullo stesso gruppo. Chiedi ad Aniva di aggiungerli. Il\ndocumento appartiene a quel gruppo: le chiavi con `,_jsx(_components.code,{children:`results_view`}),` su quel gruppo possono leggere il documento e i suoi risultati.`]}),`\n`,_jsxs(_components.p,{children:[`Invia un header opzionale `,_jsx(_components.code,{children:`Idempotency-Key`}),` per rendere sicuro un nuovo tentativo di caricamento. Consulta\n`,_jsx(_components.a,{href:`/it/concepts/idempotency`,children:`Idempotenza`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cosa-fa-l’estrazione`,children:`Cosa fa l’estrazione`}),`\n`,_jsxs(_components.p,{children:[`Con `,_jsx(_components.code,{children:`extract_results: true`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Aniva invia il file ai suoi sub-responsabili OCR e AI per leggere i valori.`}),`\n`,_jsx(_components.li,{children:`I valori compaiono nell’app Aniva del membro, come ogni altro risultato.`}),`\n`,_jsxs(_components.li,{children:[`Ogni valore ha `,_jsx(_components.code,{children:`origin: partner_upload`}),` e lo stesso `,_jsx(_components.code,{children:`status`}),` di ogni altro risultato. Un valore\nsu cui il controllo automatico di Aniva ha dubbi ha stato `,_jsx(_components.code,{children:`likely_wrong`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Senza di essa, il file non viene inviato a nessun servizio esterno se invii anche `,_jsx(_components.code,{children:`document_date`}),`.`]}),`\n`,_jsx(Accordion,{title:`Accuratezza e protezione dei dati`,id:`accuratezza-e-protezione-dei-dati`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`La lettura automatica può leggere in modo errato un valore, un’unità o una data. Il file\noriginale resta la fonte di riferimento. Verifica un valore sul file prima di usarlo per una\ndecisione medica. I valori estratti non sono una diagnosi.`}),`\n`,_jsx(_components.li,{children:`I sub-responsabili sono Mistral AI (OCR, UE) e Google Cloud Vertex AI, raggiunto tramite Vercel\nAI Gateway (estrazione, può elaborare dati fuori dall’UE). Elaborano il file solo per leggerlo.`}),`\n`,_jsx(_components.li,{children:`Ti serve una base giuridica per caricare i dati sanitari di un membro, di norma il suo consenso\nesplicito. La responsabilità è tua.`}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`richiesta`,children:`Richiesta`}),`\n`,_jsx(Heading,{level:`3`,id:`campi-del-modulo`,children:`Campi del modulo`}),`\n`,_jsx(ParamField,{body:`file`,type:`file`,required:true,id:`param-file`,children:_jsx(_components.p,{children:`Il file. PDF, DOC, DOCX, PNG o JPEG, al massimo 4 MB.`})}),`\n`,_jsx(ParamField,{body:`profile_id`,type:`string`,required:true,id:`param-profile-id`,children:_jsx(_components.p,{children:`UUID del profilo a cui appartiene il documento.`})}),`\n`,_jsx(ParamField,{body:`extract_results`,type:`boolean`,default:`false`,id:`param-extract-results`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` per leggere i valori di laboratorio dal file. Invia `,_jsx(_components.code,{children:`true`}),` o `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsx(ParamField,{body:`document_date`,type:`string`,id:`param-document-date`,children:_jsxs(_components.p,{children:[`La data del campione in formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, se la conosci. Se non la invii, Aniva legge la data\ndal file.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`risposta`,children:`Risposta`}),`\n`,_jsxs(_components.p,{children:[`L’API restituisce `,_jsx(_components.code,{children:`201 Created`}),` quando ha solo archiviato il file e `,_jsx(_components.code,{children:`202 Accepted`}),` quando esegue l’estrazione.`]}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`ID del documento (UUID). Usalo con `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),` e\n`,_jsx(_components.a,{href:`/it/api/documents/download-document`,children:`Scarica documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`processing`}),` mentre Aniva estrae i valori, oppure `,_jsx(_components.code,{children:`stored`}),` quando il file viene solo archiviato.`]})}),`\n`,_jsx(ResponseField,{name:`profile_id`,type:`string`,required:true,id:`param-profile-id-1`,children:_jsx(_components.p,{children:`Il profilo a cui appartiene il documento.`})}),`\n`,_jsx(ResponseField,{name:`document_date`,type:`string`,id:`param-document-date-1`,children:_jsxs(_components.p,{children:[`La data del campione che hai inviato o quella letta da Aniva da un file archiviato. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`results_url`,type:`string`,required:true,id:`param-results-url`,children:_jsxs(_components.p,{children:[`L’URL di `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),` per questo documento.`]})}),`\n`,_jsx(ResponseField,{name:`file_name`,type:`string`,required:true,id:`param-file-name`,children:_jsxs(_components.p,{children:[`Nome del file da mostrare, lo stesso inviato da `,_jsx(_components.a,{href:`/it/api/documents/download-document`,children:`Scarica documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`original_file_name`,type:`string`,required:true,id:`param-original-file-name`,children:_jsx(_components.p,{children:`Il nome del file che hai caricato.`})}),`\n`,_jsx(ResponseField,{name:`origin`,type:`string`,required:true,id:`param-origin`,children:_jsxs(_components.p,{children:[`Sempre `,_jsx(_components.code,{children:`partner_upload`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`content_type`,type:`string`,required:true,id:`param-content-type`,children:_jsxs(_components.p,{children:[`Tipo di media del file, ad es. `,_jsx(_components.code,{children:`application/pdf`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`etag`,type:`string`,id:`param-etag`,children:_jsxs(_components.p,{children:[`Versione del contenuto del file. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`size_bytes`,type:`integer`,id:`param-size-bytes`,children:_jsxs(_components.p,{children:[`Dimensione del file in byte. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`lab_code`,type:`string`,id:`param-lab-code`,children:_jsxs(_components.p,{children:[`Sempre `,_jsx(_components.code,{children:`null`}),` per un documento caricato.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`risposte-di-errore`,children:`Risposte di errore`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stato`}),_jsx(_components.th,{children:`Descrizione`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Un campo del modulo non è valido oppure il body non è `,_jsx(_components.code,{children:`multipart/form-data`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`Alla tua chiave API manca uno scope, il profilo è fuori dal tuo contesto di accesso oppure hai inviato `,_jsx(_components.code,{children:`extract_results: true`}),` senza `,_jsx(_components.code,{children:`documents_extract_results`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`Profilo non trovato.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`duplicate_document`}),`: lo stesso file è già presente su questo profilo. `,_jsx(_components.code,{children:`document_id`}),` lo indica, oppure è `,_jsx(_components.code,{children:`null`}),` se non puoi leggerlo. Inviato anche in caso di conflitto di `,_jsx(_components.code,{children:`Idempotency-Key`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`413`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`file_too_large`}),`: il file supera i 4 MB.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`415`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`unsupported_media_type`}),`: il file non è un PDF, DOC, DOCX, PNG o JPEG. Il nome del file deve terminare con `,_jsx(_components.code,{children:`.pdf`}),`, `,_jsx(_components.code,{children:`.doc`}),`, `,_jsx(_components.code,{children:`.docx`}),`, `,_jsx(_components.code,{children:`.png`}),`, `,_jsx(_components.code,{children:`.jpg`}),` o `,_jsx(_components.code,{children:`.jpeg`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsxs(_components.td,{children:[`Errore interno del server. `,_jsx(_components.code,{children:`extraction_not_started`}),`: il file è archiviato come `,_jsx(_components.code,{children:`document_id`}),`, ma non è stato possibile avviare l’estrazione. Contatta Aniva.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Carica documento","description":"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio","api":"POST https://anivahealth.com/api/v1/documents","href":"/it/api/documents/upload-document"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Carica un file su un profilo. Invialo come `,_jsx(_components.code,{children:`multipart/form-data`}),`. Senza `,_jsx(_components.code,{children:`extract_results`}),`, Aniva si\nlimita a salvare il file. Con `,_jsx(_components.code,{children:`extract_results: true`}),`, Aniva legge anche i valori di laboratorio dal file.`]}),`\n`,_jsxs(_components.p,{children:[`Non devi indicare di che tipo di referto si tratta. Decide Aniva. Un file senza risultati di laboratorio, come\nuna lettera medica, termina in stato `,_jsx(_components.code,{children:`stored`}),` e non è un errore.`]}),`\n`,_jsxs(_components.p,{children:[`Leggi i valori con `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),`. Non devi fare\npolling: iscriviti ai `,_jsx(_components.a,{href:`/it/concepts/webhooks`,children:`webhook`}),` `,_jsx(_components.code,{children:`document.results.*`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Richiede lo scope `,_jsx(_components.code,{children:`documents_upload`}),` su un gruppo di profili del profilo. `,_jsx(_components.code,{children:`extract_results: true`}),`\nrichiede anche lo scope `,_jsx(_components.code,{children:`documents_extract_results`}),` sullo stesso gruppo. Chiedi ad Aniva di aggiungerli. Il\ndocumento appartiene a quel gruppo: le chiavi con `,_jsx(_components.code,{children:`results_view`}),` su quel gruppo possono leggere il documento e i suoi risultati.`]}),`\n`,_jsxs(_components.p,{children:[`Invia un header opzionale `,_jsx(_components.code,{children:`Idempotency-Key`}),` per rendere sicuro un nuovo tentativo di caricamento. Consulta\n`,_jsx(_components.a,{href:`/it/concepts/idempotency`,children:`Idempotenza`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cosa-fa-l’estrazione`,children:`Cosa fa l’estrazione`}),`\n`,_jsxs(_components.p,{children:[`Con `,_jsx(_components.code,{children:`extract_results: true`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Aniva invia il file ai suoi sub-responsabili OCR e AI per leggere i valori.`}),`\n`,_jsx(_components.li,{children:`I valori compaiono nell’app Aniva del membro, come ogni altro risultato.`}),`\n`,_jsxs(_components.li,{children:[`Ogni valore ha `,_jsx(_components.code,{children:`origin: partner_upload`}),` e lo stesso `,_jsx(_components.code,{children:`status`}),` di ogni altro risultato. Un valore\nsu cui il controllo automatico di Aniva ha dubbi ha stato `,_jsx(_components.code,{children:`likely_wrong`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Senza di essa, il file non viene inviato a nessun servizio esterno se invii anche `,_jsx(_components.code,{children:`document_date`}),`.`]}),`\n`,_jsx(Accordion,{title:`Accuratezza e protezione dei dati`,id:`accuratezza-e-protezione-dei-dati`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`La lettura automatica può leggere in modo errato un valore, un’unità o una data. Il file\noriginale resta la fonte di riferimento. Verifica un valore sul file prima di usarlo per una\ndecisione medica. I valori estratti non sono una diagnosi.`}),`\n`,_jsx(_components.li,{children:`I sub-responsabili sono Mistral AI (OCR, UE) e Google Cloud Vertex AI, raggiunto tramite Vercel\nAI Gateway (estrazione, può elaborare dati fuori dall’UE). Elaborano il file solo per leggerlo.`}),`\n`,_jsx(_components.li,{children:`Ti serve una base giuridica per caricare i dati sanitari di un membro, di norma il suo consenso\nesplicito. La responsabilità è tua.`}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`richiesta`,children:`Richiesta`}),`\n`,_jsx(Heading,{level:`3`,id:`campi-del-modulo`,children:`Campi del modulo`}),`\n`,_jsx(ParamField,{body:`file`,type:`file`,required:true,id:`param-file`,children:_jsx(_components.p,{children:`Il file. PDF, DOC, DOCX, PNG o JPEG, al massimo 4 MB.`})}),`\n`,_jsx(ParamField,{body:`profile_id`,type:`string`,required:true,id:`param-profile-id`,children:_jsx(_components.p,{children:`UUID del profilo a cui appartiene il documento.`})}),`\n`,_jsx(ParamField,{body:`extract_results`,type:`boolean`,default:`false`,id:`param-extract-results`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` per leggere i valori di laboratorio dal file. Invia `,_jsx(_components.code,{children:`true`}),` o `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsx(ParamField,{body:`document_date`,type:`string`,id:`param-document-date`,children:_jsxs(_components.p,{children:[`La data del campione in formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, se la conosci. Se non la invii, Aniva legge la data\ndal file.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`risposta`,children:`Risposta`}),`\n`,_jsxs(_components.p,{children:[`L’API restituisce `,_jsx(_components.code,{children:`201 Created`}),` quando ha solo archiviato il file e `,_jsx(_components.code,{children:`202 Accepted`}),` quando esegue l’estrazione.`]}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`ID del documento (UUID). Usalo con `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),` e\n`,_jsx(_components.a,{href:`/it/api/documents/download-document`,children:`Scarica documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`processing`}),` mentre Aniva estrae i valori, oppure `,_jsx(_components.code,{children:`stored`}),` quando il file viene solo archiviato.`]})}),`\n`,_jsx(ResponseField,{name:`profile_id`,type:`string`,required:true,id:`param-profile-id-1`,children:_jsx(_components.p,{children:`Il profilo a cui appartiene il documento.`})}),`\n`,_jsx(ResponseField,{name:`document_date`,type:`string`,id:`param-document-date-1`,children:_jsxs(_components.p,{children:[`La data del campione che hai inviato o quella letta da Aniva da un file archiviato. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`results_url`,type:`string`,required:true,id:`param-results-url`,children:_jsxs(_components.p,{children:[`L’URL di `,_jsx(_components.a,{href:`/it/api/documents/get-document-results`,children:`Ottieni risultati del documento`}),` per questo documento.`]})}),`\n`,_jsx(ResponseField,{name:`file_name`,type:`string`,required:true,id:`param-file-name`,children:_jsxs(_components.p,{children:[`Nome del file da mostrare, lo stesso inviato da `,_jsx(_components.a,{href:`/it/api/documents/download-document`,children:`Scarica documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`original_file_name`,type:`string`,required:true,id:`param-original-file-name`,children:_jsx(_components.p,{children:`Il nome del file che hai caricato.`})}),`\n`,_jsx(ResponseField,{name:`origin`,type:`string`,required:true,id:`param-origin`,children:_jsxs(_components.p,{children:[`Sempre `,_jsx(_components.code,{children:`partner_upload`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`content_type`,type:`string`,required:true,id:`param-content-type`,children:_jsxs(_components.p,{children:[`Tipo di media del file, ad es. `,_jsx(_components.code,{children:`application/pdf`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`etag`,type:`string`,id:`param-etag`,children:_jsxs(_components.p,{children:[`Versione del contenuto del file. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`size_bytes`,type:`integer`,id:`param-size-bytes`,children:_jsxs(_components.p,{children:[`Dimensione del file in byte. Può essere `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`lab_code`,type:`string`,id:`param-lab-code`,children:_jsxs(_components.p,{children:[`Sempre `,_jsx(_components.code,{children:`null`}),` per un documento caricato.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`risposte-di-errore`,children:`Risposte di errore`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stato`}),_jsx(_components.th,{children:`Descrizione`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Un campo del modulo non è valido oppure il body non è `,_jsx(_components.code,{children:`multipart/form-data`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`Alla tua chiave API manca uno scope, il profilo è fuori dal tuo contesto di accesso oppure hai inviato `,_jsx(_components.code,{children:`extract_results: true`}),` senza `,_jsx(_components.code,{children:`documents_extract_results`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`Profilo non trovato.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`duplicate_document`}),`: lo stesso file è già presente su questo profilo. `,_jsx(_components.code,{children:`document_id`}),` lo indica, oppure è `,_jsx(_components.code,{children:`null`}),` se non puoi leggerlo. Inviato anche in caso di conflitto di `,_jsx(_components.code,{children:`Idempotency-Key`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`413`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`file_too_large`}),`: il file supera i 4 MB.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`415`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`unsupported_media_type`}),`: il file non è un PDF, DOC, DOCX, PNG o JPEG. Il nome del file deve terminare con `,_jsx(_components.code,{children:`.pdf`}),`, `,_jsx(_components.code,{children:`.doc`}),`, `,_jsx(_components.code,{children:`.docx`}),`, `,_jsx(_components.code,{children:`.png`}),`, `,_jsx(_components.code,{children:`.jpg`}),` o `,_jsx(_components.code,{children:`.jpeg`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsxs(_components.td,{children:[`Errore interno del server. `,_jsx(_components.code,{children:`extraction_not_started`}),`: il file è archiviato come `,_jsx(_components.code,{children:`document_id`}),`, ma non è stato possibile avviare l’estrazione. Contatta Aniva.`]})]})]})]}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://anivahealth.com/api/v1/documents`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-api-key: YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'file=@lab-report.pdf'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'extract_results=true'`})]}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`202`,numberOfLines:`14`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"processing\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"profile_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"document_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"file_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20261023 - lab-report.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"original_file_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"lab-report.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"origin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"partner_upload\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"etag\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"56104b36f860cfd5b41efc716fdf7b6f\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size_bytes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`312480`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lab_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"duplicate_document\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"This file is already on this profile\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"document_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Carica documento","description":"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio","api":"POST https://anivahealth.com/api/v1/documents","href":"/it/api/documents/upload-document"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Cosa fa l’estrazione","slug":"cosa-fa-l’estrazione","depth":2,"children":[]},{"title":"Richiesta","slug":"richiesta","depth":2,"children":[{"title":"Campi del modulo","slug":"campi-del-modulo","depth":3,"children":[]}]},{"title":"Risposta","slug":"risposta","depth":2,"children":[]},{"title":"Risposte di errore","slug":"risposte-di-errore","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --url\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://anivahealth.com/api/v1/documents\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'x-api-key: YOUR_API_KEY'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --form\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'file=@lab-report.pdf'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --form\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --form\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'extract_results=true'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"202","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"14\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"processing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"profile_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"document_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"results_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"file_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"20261023 - lab-report.pdf\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"original_file_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"lab-report.pdf\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"origin\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"partner_upload\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"content_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/pdf\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"etag\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"56104b36f860cfd5b41efc716fdf7b6f\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"size_bytes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">312480\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"lab_code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"409","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"duplicate_document\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"This file is already on this profile\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"document_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Carica documento","path":"/api/v1/documents","servers":[{"url":"https://anivahealth.com"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"x-api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"file":[{"type":"file","description":"Il file. PDF, DOC, DOCX, PNG o JPEG, al massimo 4 MB.","required":true}],"profile_id":[{"type":"string","description":"UUID del profilo a cui appartiene il documento.","required":true}],"extract_results":[{"type":"boolean","description":"`true` per leggere i valori di laboratorio dal file. Invia `true` o `false` ."}],"document_date":[{"type":"string","description":"La data del campione in formato `YYYY-MM-DD` , se la conosci. Se non la invii, Aniva legge la data dal file."}]}}],"examples":{"example":{"value":{"profile_id":"\u003cstring>","extract_results":true,"document_date":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"ID del documento (UUID). Usalo con Ottieni risultati del documento e Scarica documento .","required":true}],"status":[{"type":"string","description":"`processing` mentre Aniva estrae i valori, oppure `stored` quando il file viene solo archiviato.","required":true}],"profile_id":[{"type":"string","description":"Il profilo a cui appartiene il documento.","required":true}],"document_date":[{"type":"string","description":"La data del campione che hai inviato o quella letta da Aniva da un file archiviato. Può essere `null` ."}],"results_url":[{"type":"string","description":"L’URL di Ottieni risultati del documento per questo documento.","required":true}],"file_name":[{"type":"string","description":"Nome del file da mostrare, lo stesso inviato da Scarica documento .","required":true}],"original_file_name":[{"type":"string","description":"Il nome del file che hai caricato.","required":true}],"origin":[{"type":"string","description":"Sempre `partner_upload` .","required":true}],"content_type":[{"type":"string","description":"Tipo di media del file, ad es. `application/pdf` .","required":true}],"etag":[{"type":"string","description":"Versione del contenuto del file. Può essere `null` ."}],"size_bytes":[{"type":"integer","description":"Dimensione del file in byte. Può essere `null` ."}],"lab_code":[{"type":"string","description":"Sempre `null` per un documento caricato."}]}}],"examples":{"example":{"value":{"id":"\u003cstring>","status":"\u003cstring>","profile_id":"\u003cstring>","document_date":"\u003cstring>","results_url":"\u003cstring>","file_name":"\u003cstring>","original_file_name":"\u003cstring>","origin":"\u003cstring>","content_type":"\u003cstring>","etag":"\u003cstring>","size_bytes":123,"lab_code":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/anivahealth/5d0d870ff743f803/video-zoom.js"],"subdomain":"anivahealth","siteName":"Aniva API","title":"Carica documento - Aniva API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/documents/upload-document","matchLevel":1},"de":{"href":"/de/api/documents/upload-document","matchLevel":1},"ca":{"href":"/ca/api/documents/upload-document","matchLevel":1},"cs":{"href":"/cs/api/documents/upload-document","matchLevel":1},"da":{"href":"/da/api/documents/upload-document","matchLevel":1},"es":{"href":"/es/api/documents/upload-document","matchLevel":1},"fi":{"href":"/fi/api/documents/upload-document","matchLevel":1},"fr":{"href":"/fr/api/documents/upload-document","matchLevel":1},"hu":{"href":"/hu/api/documents/upload-document","matchLevel":1},"it":{"href":"/it/api/documents/upload-document","matchLevel":0},"lv":{"href":"/lv/api/documents/upload-document","matchLevel":1},"nl":{"href":"/nl/api/documents/upload-document","matchLevel":1},"no":{"href":"/no/api/documents/upload-document","matchLevel":1},"pl":{"href":"/pl/api/documents/upload-document","matchLevel":1},"pt":{"href":"/pt/api/documents/upload-document","matchLevel":1},"ro":{"href":"/ro/api/documents/upload-document","matchLevel":1},"ru":{"href":"/ru/api/documents/upload-document","matchLevel":1},"sv":{"href":"/sv/api/documents/upload-document","matchLevel":1},"tr":{"href":"/tr/api/documents/upload-document","matchLevel":1},"uk":{"href":"/uk/api/documents/upload-document","matchLevel":1}}},"lastModified":"2026-11-22T10:00:15.564Z","originalFileLocation":"it/api/documents/upload-document.mdx","locale":"it"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\">\u003cmeta data-mint-head name=\"keywords\" content=\"blood test API, lab testing API, home test kit API, lab results API, biomarker API, pharmacy blood test, Germany, EU\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aniva API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Carica documento - Aniva API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aniva Partner API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.anivahealth.com/it/api/documents/upload-document\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://anivahealth.mintlify.site/_mintlify/api/og/v2?division=Documenti\u0026amp;title=Carica+documento\u0026amp;description=Carica+un+referto+di+laboratorio+o+qualsiasi+altro+documento+su+un+profilo+e%2C+facoltativamente%2C+estrai+i+relativi+valori+di+laboratorio\u0026amp;theme=ee63c32abd41d12dcedcfed1\u0026amp;signature=58d3f20070d2893b751aee20f24291343e5e11517d1788559e3894f36deffbea\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Carica documento - Aniva API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://anivahealth.mintlify.site/_mintlify/api/og/v2?division=Documenti\u0026amp;title=Carica+documento\u0026amp;description=Carica+un+referto+di+laboratorio+o+qualsiasi+altro+documento+su+un+profilo+e%2C+facoltativamente%2C+estrai+i+relativi+valori+di+laboratorio\u0026amp;theme=ee63c32abd41d12dcedcfed1\u0026amp;signature=58d3f20070d2893b751aee20f24291343e5e11517d1788559e3894f36deffbea\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/anivahealth/xxvf_NPPRJ8RsT4T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aniva API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#e76c2b\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.anivahealth.com/it/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/it/api/documents/upload-document.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.anivahealth.com/it/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.anivahealth.com/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.anivahealth.com/de/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ca\" href=\"https://docs.anivahealth.com/ca/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"cs\" href=\"https://docs.anivahealth.com/cs/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"da\" href=\"https://docs.anivahealth.com/da/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.anivahealth.com/es/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fi\" href=\"https://docs.anivahealth.com/fi/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.anivahealth.com/fr/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hu\" href=\"https://docs.anivahealth.com/hu/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"lv\" href=\"https://docs.anivahealth.com/lv/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"nl\" href=\"https://docs.anivahealth.com/nl/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"no\" href=\"https://docs.anivahealth.com/no/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pl\" href=\"https://docs.anivahealth.com/pl/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.anivahealth.com/pt/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ro\" href=\"https://docs.anivahealth.com/ro/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.anivahealth.com/ru/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"sv\" href=\"https://docs.anivahealth.com/sv/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.anivahealth.com/tr/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uk\" href=\"https://docs.anivahealth.com/uk/api/documents/upload-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.anivahealth.com/api/documents/upload-document\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.anivahealth.com/#organization\",\"name\":\"Aniva API\",\"url\":\"https://docs.anivahealth.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/aniva.svg?fit=max\u0026auto=format\u0026n=3R-RUSdQmYnR_d5s\u0026q=85\u0026s=07e4ee4fd57b9ccbe6809fe000f33fdd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.anivahealth.com#website\",\"name\":\"Aniva API\",\"url\":\"https://docs.anivahealth.com\",\"publisher\":{\"@id\":\"https://docs.anivahealth.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.anivahealth.com/it/api/documents/upload-document#webpage\",\"url\":\"https://docs.anivahealth.com/it/api/documents/upload-document\",\"name\":\"Carica documento\",\"description\":\"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\",\"dateModified\":\"2026-11-22T10:00:15.564Z\",\"isPartOf\":{\"@id\":\"https://docs.anivahealth.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.anivahealth.com/it/api/documents/upload-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.anivahealth.com/it/api/documents/upload-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Aniva API\",\"item\":\"https://docs.anivahealth.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Carica documento\",\"item\":\"https://docs.anivahealth.com/it/api/documents/upload-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.anivahealth.com/it/api/documents/upload-document#apireference\",\"headline\":\"Carica documento\",\"name\":\"Carica documento\",\"description\":\"Carica un referto di laboratorio o qualsiasi altro documento su un profilo e, facoltativamente, estrai i relativi valori di laboratorio\",\"url\":\"https://docs.anivahealth.com/it/api/documents/upload-document\",\"mainEntityOfPage\":{\"@id\":\"https://docs.anivahealth.com/it/api/documents/upload-document#webpage\"},\"dateModified\":\"2026-11-22T10:00:15.564Z\",\"publisher\":{\"@id\":\"https://docs.anivahealth.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.anivahealth.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aniva API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Aniva API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/it/api/documents/upload-document.md","siteName":"Aniva API","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/api/documents/upload-document"}]},{"language":"de","navbar":{"links":[{"href":"/de/changelog","label":"Changelog"},{"href":"/de/status","label":"Status"}]},"pages":[{"title":"de","href":"/de/api/documents/upload-document"}]},{"language":"ca","navbar":{"links":[{"href":"/ca/changelog","label":"Registre de canvis"},{"href":"/ca/status","label":"Estat"}]},"pages":[{"title":"ca","href":"/ca/api/documents/upload-document"}]},{"language":"cs","navbar":{"links":[{"href":"/cs/changelog","label":"Seznam změn"},{"href":"/cs/status","label":"Stav"}]},"pages":[{"title":"cs","href":"/cs/api/documents/upload-document"}]},{"language":"da","navbar":{"links":[{"href":"/da/changelog","label":"Ændringslog"},{"href":"/da/status","label":"Status"}]},"pages":[{"title":"da","href":"/da/api/documents/upload-document"}]},{"language":"es","navbar":{"links":[{"href":"/es/changelog","label":"Registro de cambios"},{"href":"/es/status","label":"Estado"}]},"pages":[{"title":"es","href":"/es/api/documents/upload-document"}]},{"language":"fi","navbar":{"links":[{"href":"/fi/changelog","label":"Muutosloki"},{"href":"/fi/status","label":"Tila"}]},"pages":[{"title":"fi","href":"/fi/api/documents/upload-document"}]},{"language":"fr","navbar":{"links":[{"href":"/fr/changelog","label":"Journal des modifications"},{"href":"/fr/status","label":"Statut"}]},"pages":[{"title":"fr","href":"/fr/api/documents/upload-document"}]},{"language":"hu","navbar":{"links":[{"href":"/hu/changelog","label":"Változásnapló"},{"href":"/hu/status","label":"Állapot"}]},"pages":[{"title":"hu","href":"/hu/api/documents/upload-document"}]},{"language":"it","navbar":{"links":[{"href":"/it/changelog","label":"Changelog"},{"href":"/it/status","label":"Stato"}]},"tabs":[{"tab":"Documentazione","pages":[{"title":"Documentazione","href":"/it"}]},{"tab":"Riferimento API","groups":[{"group":"Salute","pages":[{"title":"Controllo di stato","api":"GET https://anivahealth.com/api/v1/health","href":"/it/api/health/check-health"}]},{"group":"Profili","pages":[{"title":"Elenca profili","api":"GET https://anivahealth.com/api/v1/profiles","href":"/it/api/profiles/list-profiles"},{"title":"Crea profilo","api":"POST https://anivahealth.com/api/v1/profiles","href":"/it/api/profiles/create-profile"},{"title":"Ottieni profilo","api":"GET https://anivahealth.com/api/v1/profiles/{id}","href":"/it/api/profiles/get-profile"},{"title":"Aggiorna profilo","api":"PATCH https://anivahealth.com/api/v1/profiles/{id}","href":"/it/api/profiles/update-profile"},{"title":"Crea sessione embed","api":"POST https://anivahealth.com/api/v1/profiles/{id}/embed-sessions","href":"/it/api/profiles/create-embed-session"}]},{"group":"Appuntamenti","pages":[{"title":"Elenca appuntamenti","api":"GET https://anivahealth.com/api/v1/appointments","href":"/it/api/appointments/list-appointments"},{"title":"Crea appuntamento","api":"POST https://anivahealth.com/api/v1/appointments","href":"/it/api/appointments/create-appointment"},{"title":"Ottieni appuntamento","api":"GET https://anivahealth.com/api/v1/appointments/{id}","href":"/it/api/appointments/get-appointment"},{"title":"Aggiorna appuntamento","api":"PATCH https://anivahealth.com/api/v1/appointments/{id}","href":"/it/api/appointments/update-appointment"},{"title":"Annulla appuntamento","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}","href":"/it/api/appointments/cancel-appointment"},{"title":"Aggiungi pannelli","api":"POST https://anivahealth.com/api/v1/appointments/{id}/panels","href":"/it/api/appointments/add-panels"},{"title":"Rimuovi pannelli","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}/panels","href":"/it/api/appointments/remove-panels"},{"title":"Aggiungi singoli biomarcatori","api":"PATCH https://anivahealth.com/api/v1/appointments/{id}/biomarkers","href":"/it/api/appointments/add-individual-biomarkers"},{"title":"Rimuovi singoli biomarcatori","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}/biomarkers","href":"/it/api/appointments/remove-individual-biomarkers"},{"title":"Anteprima appuntamento","api":"GET https://anivahealth.com/api/v1/appointments/{id}/preview","href":"/it/api/appointments/preview-containers"},{"title":"Conferma prelievo di sangue","api":"POST https://anivahealth.com/api/v1/appointments/{id}/confirm","href":"/it/api/appointments/confirm-blood-draw"},{"title":"Ottieni risultati di laboratorio","api":"GET https://anivahealth.com/api/v1/appointments/{id}/results","href":"/it/api/appointments/get-results"},{"title":"Invia risultati via email","api":"POST https://anivahealth.com/api/v1/appointments/{id}/results/email","href":"/it/api/appointments/email-results"}]},{"group":"Ordini di kit domiciliari","pages":[{"title":"Elenca ordini di kit domiciliari","api":"GET https://anivahealth.com/api/v1/home-kit-orders","href":"/it/api/home-kit-orders/list-home-kits"},{"title":"Crea ordine di kit domiciliare","api":"POST https://anivahealth.com/api/v1/home-kit-orders","href":"/it/api/home-kit-orders/create-home-kit"},{"title":"Ottieni ordine di kit domiciliare","api":"GET https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/it/api/home-kit-orders/get-home-kit"},{"title":"Aggiorna ordine di kit domiciliare","api":"PATCH https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/it/api/home-kit-orders/update-home-kit"},{"title":"Annulla ordine di kit domiciliare","api":"DELETE https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/it/api/home-kit-orders/cancel-home-kit"},{"title":"Attiva ordine di kit domiciliare","api":"POST https://anivahealth.com/api/v1/home-kit-orders/{id}/activate","href":"/it/api/home-kit-orders/activate-home-kit"},{"title":"Aggiungi singoli biomarcatori","api":"PATCH https://anivahealth.com/api/v1/home-kit-orders/{id}/biomarkers","href":"/it/api/home-kit-orders/add-individual-biomarkers"},{"title":"Rimuovi singoli biomarcatori","api":"DELETE https://anivahealth.com/api/v1/home-kit-orders/{id}/biomarkers","href":"/it/api/home-kit-orders/remove-individual-biomarkers"},{"title":"Ottieni risultati di laboratorio","api":"GET https://anivahealth.com/api/v1/home-kit-orders/{id}/results","href":"/it/api/home-kit-orders/get-results"},{"title":"Invia risultati via email","api":"POST https://anivahealth.com/api/v1/home-kit-orders/{id}/results/email","href":"/it/api/home-kit-orders/email-results"}]},{"group":"Catalogo dei test","pages":[{"title":"Elenca biomarcatori","api":"GET https://anivahealth.com/api/v1/biomarkers","href":"/it/api/biomarkers/list-biomarkers"},{"title":"Ottieni biomarcatore","api":"GET https://anivahealth.com/api/v1/biomarkers/{id}","href":"/it/api/biomarkers/get-biomarker"},{"title":"Elenca pannelli","api":"GET https://anivahealth.com/api/v1/panels","href":"/it/api/panels/list-panels"}]},{"group":"Prezzi","pages":[{"title":"Ottieni tariffario","api":"GET https://anivahealth.com/api/v1/pricing/rate-card","href":"/it/api/pricing/get-rate-card"},{"title":"Calcola preventivo carrello","api":"POST https://anivahealth.com/api/v1/pricing/quote","href":"/it/api/pricing/quote-cart"}]},{"group":"Unità","pages":[{"title":"Elenca unità","api":"GET https://anivahealth.com/api/v1/units","href":"/it/api/units/list-units"}]},{"group":"Sedi","pages":[{"title":"Elenca sedi","api":"GET https://anivahealth.com/api/v1/locations","href":"/it/api/locations/list-locations"},{"title":"Ottieni sede","api":"GET https://anivahealth.com/api/v1/locations/{id}","href":"/it/api/locations/get-location"},{"title":"Ottieni disponibilità","api":"GET https://anivahealth.com/api/v1/locations/{id}/availability","href":"/it/api/locations/get-availability"},{"title":"Elenca prezzi al pubblico","api":"GET https://anivahealth.com/api/v1/locations/retail-prices","href":"/it/api/locations/list-retail-prices"},{"title":"Ottieni prezzi al pubblico","description":"Recupera i prezzi di pannelli e biomarcatori singoli che una sede applica ai clienti senza appuntamento","api":"GET https://anivahealth.com/api/v1/locations/{id}/retail-prices","href":"/it/api/locations/get-retail-prices"}]},{"group":"Documenti","pages":[{"title":"Carica documento","api":"POST https://anivahealth.com/api/v1/documents","href":"/it/api/documents/upload-document"},{"title":"Ottieni risultati del documento","description":"Leggi lo stato e i valori di laboratorio estratti di un documento che hai caricato","api":"GET https://anivahealth.com/api/v1/documents/{id}/results","href":"/it/api/documents/get-document-results"},{"title":"Scarica documento","api":"GET https://anivahealth.com/api/v1/documents/{id}","href":"/it/api/documents/download-document"},{"title":"Elimina documento","api":"DELETE https://anivahealth.com/api/v1/documents/{id}","href":"/it/api/documents/delete-document"}]},{"group":"Spedizioni","pages":[{"title":"Crea spedizione","api":"POST https://anivahealth.com/api/v1/shipments","href":"/it/api/shipments/create-shipment"},{"title":"Elenca spedizioni","api":"GET https://anivahealth.com/api/v1/shipments","href":"/it/api/shipments/list-shipments"},{"title":"Ottieni spedizione","api":"GET https://anivahealth.com/api/v1/shipments/{id}","href":"/it/api/shipments/get-shipment"},{"title":"Aggiorna spedizione","api":"PATCH https://anivahealth.com/api/v1/shipments/{id}","href":"/it/api/shipments/update-shipment"},{"title":"Annulla spedizione","api":"DELETE https://anivahealth.com/api/v1/shipments/{id}","href":"/it/api/shipments/cancel-shipment"},{"title":"Elenca appuntamenti della spedizione","api":"GET https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/it/api/shipments/list-shipment-appointments"},{"title":"Collega appuntamenti alla spedizione","api":"POST https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/it/api/shipments/attach-appointments-to-shipment"},{"title":"Scollega appuntamenti dalla spedizione","api":"DELETE https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/it/api/shipments/detach-appointments-from-shipment"}]},{"group":"Webhook","pages":[{"title":"Elenca webhook","api":"GET https://anivahealth.com/api/v1/webhooks","href":"/it/api/webhooks/list-webhooks"},{"title":"Crea webhook","api":"POST https://anivahealth.com/api/v1/webhooks","href":"/it/api/webhooks/create-webhook"},{"title":"Ottieni webhook","api":"GET https://anivahealth.com/api/v1/webhooks/{id}","href":"/it/api/webhooks/get-webhook"},{"title":"Aggiorna webhook","api":"PATCH https://anivahealth.com/api/v1/webhooks/{id}","href":"/it/api/webhooks/update-webhook"},{"title":"Elimina webhook","api":"DELETE https://anivahealth.com/api/v1/webhooks/{id}","href":"/it/api/webhooks/delete-webhook"},{"title":"Ruota segreto","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/rotate-secret","href":"/it/api/webhooks/rotate-secret"},{"title":"Invia evento di test","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/ping","href":"/it/api/webhooks/send-test-event"},{"title":"Elenca consegne","api":"GET https://anivahealth.com/api/v1/webhooks/{id}/deliveries","href":"/it/api/webhooks/list-deliveries"},{"title":"Reinvia consegna","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/deliveries/{delivery_id}/resend","href":"/it/api/webhooks/resend-delivery"}]}]}]},{"language":"lv","navbar":{"links":[{"href":"/lv/changelog","label":"Izmaiņu žurnāls"},{"href":"/lv/status","label":"Statuss"}]},"pages":[{"title":"lv","href":"/lv/api/documents/upload-document"}]},{"language":"nl","navbar":{"links":[{"href":"/nl/changelog","label":"Changelog"},{"href":"/nl/status","label":"Status"}]},"pages":[{"title":"nl","href":"/nl/api/documents/upload-document"}]},{"language":"no","navbar":{"links":[{"href":"/no/changelog","label":"Endringslogg"},{"href":"/no/status","label":"Status"}]},"pages":[{"title":"no","href":"/no/api/documents/upload-document"}]},{"language":"pl","navbar":{"links":[{"href":"/pl/changelog","label":"Dziennik zmian"},{"href":"/pl/status","label":"Status"}]},"pages":[{"title":"pl","href":"/pl/api/documents/upload-document"}]},{"language":"pt","navbar":{"links":[{"href":"/pt/changelog","label":"Registo de alterações"},{"href":"/pt/status","label":"Estado"}]},"pages":[{"title":"pt","href":"/pt/api/documents/upload-document"}]},{"language":"ro","navbar":{"links":[{"href":"/ro/changelog","label":"Jurnal de modificări"},{"href":"/ro/status","label":"Stare"}]},"pages":[{"title":"ro","href":"/ro/api/documents/upload-document"}]},{"language":"ru","navbar":{"links":[{"href":"/ru/changelog","label":"История изменений"},{"href":"/ru/status","label":"Статус"}]},"pages":[{"title":"ru","href":"/ru/api/documents/upload-document"}]},{"language":"sv","navbar":{"links":[{"href":"/sv/changelog","label":"Ändringslogg"},{"href":"/sv/status","label":"Status"}]},"pages":[{"title":"sv","href":"/sv/api/documents/upload-document"}]},{"language":"tr","navbar":{"links":[{"href":"/tr/changelog","label":"Değişiklik günlüğü"},{"href":"/tr/status","label":"Durum"}]},"pages":[{"title":"tr","href":"/tr/api/documents/upload-document"}]},{"language":"uk","navbar":{"links":[{"href":"/uk/changelog","label":"Історія змін"},{"href":"/uk/status","label":"Статус"}]},"pages":[{"title":"uk","href":"/uk/api/documents/upload-document"}]}]},"basePath":"","title":"Carica documento - Aniva API","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","Page-DuqezyvM.js","CodeSnippet-B373COAT.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","getApiPlaygroundDisplay-CfL-UuDS.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js"]}