{ "error": "duplicate_document", "message": "This file is already on this profile", "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"}
Carrega um ficheiro para um perfil. Envia-o como multipart/form-data. Sem extract_results, a Aniva apenas
guarda o ficheiro. Com extract_results: true, a Aniva também lê os valores de laboratório a partir do ficheiro.Não indicas que tipo de relatório é o ficheiro. A Aniva decide. Um ficheiro sem resultados de laboratório, como
uma carta médica, termina como stored e não é um erro.Lê os valores com Obter resultados do documento. Não precisas de
fazer polling: subscreve os webhooksdocument.results.*.Requer o âmbito documents_upload num grupo de perfis do perfil. extract_results: true
também requer o âmbito documents_extract_results no mesmo grupo. Pede à Aniva para os adicionar. O
documento pertence a esse grupo: as chaves com results_view nesse grupo leem o documento e os seus resultados.Envia um cabeçalho opcional Idempotency-Key para tornar seguro repetir o carregamento. Consulta
Idempotência.
O que faz a extração
Com extract_results: true:
A Aniva envia o ficheiro aos seus subcontratantes de OCR e IA para ler os valores.
Os valores aparecem na app Aniva do membro, como qualquer outro resultado.
Cada valor inclui origin: partner_upload e o mesmo status que qualquer outro resultado. Um valor
de que a verificação automática da Aniva duvida tem o estado likely_wrong.
Sem isso, o ficheiro não vai para nenhum serviço externo quando também envias document_date.
Precisão e proteção de dados
A leitura automática pode ler mal um valor, uma unidade ou uma data. O ficheiro original continua
a ser a fonte de verdade. Confirma o valor com ele antes de o usares para uma decisão médica.
Os valores extraídos não são um diagnóstico.
Os subcontratantes são a Mistral AI (OCR, UE) e o Google Cloud Vertex AI, acedido através do
Vercel AI Gateway (extração, pode processar fora da UE). Processam o ficheiro apenas para o
ler.
Precisas de uma base legal para carregar os dados de saúde de um membro, normalmente o
consentimento explícito do membro. És responsável por isso.
Pedido
Campos do formulário
file
obrigatório
O ficheiro. PDF, DOC, DOCX, PNG ou JPEG, no máximo 4 MB.
string
obrigatório
UUID do perfil a que o documento pertence.
boolean
padrão:"false"
true para ler os valores laboratoriais do ficheiro. Envia true ou false.
string
A data da amostra no formato YYYY-MM-DD, quando a conheces. Sem ela, a Aniva lê a data do
ficheiro.
Resposta
A API devolve 201 Created quando apenas guardou o ficheiro e 202 Accepted quando a extração é executada.
Tipo de média do ficheiro, por ex., application/pdf.
string
Versão do conteúdo do ficheiro. Pode ser null.
integer
Tamanho do ficheiro em bytes. Pode ser null.
string
Sempre null para um documento carregado.
Respostas de erro
Estado
Descrição
400
Um campo do formulário é inválido ou o corpo não é multipart/form-data.
403
Falta um âmbito à tua chave de API, o perfil está fora do teu contexto de acesso ou enviaste extract_results: true sem documents_extract_results.
404
Perfil não encontrado.
409
duplicate_document: o mesmo ficheiro já existe neste perfil. document_id indica-o, ou é null quando não o podes ler. Também enviado em caso de conflito de Idempotency-Key.
413
file_too_large: o ficheiro tem mais de 4 MB.
415
unsupported_media_type: o ficheiro não é um PDF, DOC, DOCX, PNG ou JPEG. O nome do ficheiro tem de terminar em .pdf, .doc, .docx, .png, .jpg ou .jpeg.
500
Erro interno do servidor. extraction_not_started: o ficheiro está guardado como document_id, mas a extração não pôde começar. Contacta a 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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":"pt/api/documents/upload-document","slug":"/pt/api/documents/upload-document","pageMetadata":{"title":"Carregar documento","description":"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais","api":"POST https://anivahealth.com/api/v1/documents","href":"/pt/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: \"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\"\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:[`Carrega um ficheiro para um perfil. Envia-o como `,_jsx(_components.code,{children:`multipart/form-data`}),`. Sem `,_jsx(_components.code,{children:`extract_results`}),`, a Aniva apenas\nguarda o ficheiro. Com `,_jsx(_components.code,{children:`extract_results: true`}),`, a Aniva também lê os valores de laboratório a partir do ficheiro.`]}),`\n`,_jsxs(_components.p,{children:[`Não indicas que tipo de relatório é o ficheiro. A Aniva decide. Um ficheiro sem resultados de laboratório, como\numa carta médica, termina como `,_jsx(_components.code,{children:`stored`}),` e não é um erro.`]}),`\n`,_jsxs(_components.p,{children:[`Lê os valores com `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),`. Não precisas de\nfazer polling: subscreve os `,_jsx(_components.a,{href:`/pt/concepts/webhooks`,children:`webhooks`}),` `,_jsx(_components.code,{children:`document.results.*`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Requer o âmbito `,_jsx(_components.code,{children:`documents_upload`}),` num grupo de perfis do perfil. `,_jsx(_components.code,{children:`extract_results: true`}),`\ntambém requer o âmbito `,_jsx(_components.code,{children:`documents_extract_results`}),` no mesmo grupo. Pede à Aniva para os adicionar. O\ndocumento pertence a esse grupo: as chaves com `,_jsx(_components.code,{children:`results_view`}),` nesse grupo leem o documento e os seus resultados.`]}),`\n`,_jsxs(_components.p,{children:[`Envia um cabeçalho opcional `,_jsx(_components.code,{children:`Idempotency-Key`}),` para tornar seguro repetir o carregamento. Consulta\n`,_jsx(_components.a,{href:`/pt/concepts/idempotency`,children:`Idempotência`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`o-que-faz-a-extração`,children:`O que faz a extração`}),`\n`,_jsxs(_components.p,{children:[`Com `,_jsx(_components.code,{children:`extract_results: true`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`A Aniva envia o ficheiro aos seus subcontratantes de OCR e IA para ler os valores.`}),`\n`,_jsx(_components.li,{children:`Os valores aparecem na app Aniva do membro, como qualquer outro resultado.`}),`\n`,_jsxs(_components.li,{children:[`Cada valor inclui `,_jsx(_components.code,{children:`origin: partner_upload`}),` e o mesmo `,_jsx(_components.code,{children:`status`}),` que qualquer outro resultado. Um valor\nde que a verificação automática da Aniva duvida tem o estado `,_jsx(_components.code,{children:`likely_wrong`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Sem isso, o ficheiro não vai para nenhum serviço externo quando também envias `,_jsx(_components.code,{children:`document_date`}),`.`]}),`\n`,_jsx(Accordion,{title:`Precisão e proteção de dados`,id:`precisao-e-protecao-de-dados`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A leitura automática pode ler mal um valor, uma unidade ou uma data. O ficheiro original continua\na ser a fonte de verdade. Confirma o valor com ele antes de o usares para uma decisão médica.\nOs valores extraídos não são um diagnóstico.`}),`\n`,_jsx(_components.li,{children:`Os subcontratantes são a Mistral AI (OCR, UE) e o Google Cloud Vertex AI, acedido através do\nVercel AI Gateway (extração, pode processar fora da UE). Processam o ficheiro apenas para o\nler.`}),`\n`,_jsx(_components.li,{children:`Precisas de uma base legal para carregar os dados de saúde de um membro, normalmente o\nconsentimento explícito do membro. És responsável por isso.`}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`pedido`,children:`Pedido`}),`\n`,_jsx(Heading,{level:`3`,id:`campos-do-formulário`,children:`Campos do formulário`}),`\n`,_jsx(ParamField,{body:`file`,type:`file`,required:true,id:`param-file`,children:_jsx(_components.p,{children:`O ficheiro. PDF, DOC, DOCX, PNG ou JPEG, no máximo 4 MB.`})}),`\n`,_jsx(ParamField,{body:`profile_id`,type:`string`,required:true,id:`param-profile-id`,children:_jsx(_components.p,{children:`UUID do perfil a que o documento pertence.`})}),`\n`,_jsx(ParamField,{body:`extract_results`,type:`boolean`,default:`false`,id:`param-extract-results`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` para ler os valores laboratoriais do ficheiro. Envia `,_jsx(_components.code,{children:`true`}),` ou `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsx(ParamField,{body:`document_date`,type:`string`,id:`param-document-date`,children:_jsxs(_components.p,{children:[`A data da amostra no formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, quando a conheces. Sem ela, a Aniva lê a data do\nficheiro.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsxs(_components.p,{children:[`A API devolve `,_jsx(_components.code,{children:`201 Created`}),` quando apenas guardou o ficheiro e `,_jsx(_components.code,{children:`202 Accepted`}),` quando a extração é executada.`]}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`ID do documento (UUID). Usa-o com `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),` e\n`,_jsx(_components.a,{href:`/pt/api/documents/download-document`,children:`Transferir documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`processing`}),` enquanto a Aniva extrai os valores, ou `,_jsx(_components.code,{children:`stored`}),` quando o ficheiro é apenas guardado.`]})}),`\n`,_jsx(ResponseField,{name:`profile_id`,type:`string`,required:true,id:`param-profile-id-1`,children:_jsx(_components.p,{children:`O perfil a que o documento pertence.`})}),`\n`,_jsx(ResponseField,{name:`document_date`,type:`string`,id:`param-document-date-1`,children:_jsxs(_components.p,{children:[`A data da amostra que enviaste, ou a que a Aniva leu de um ficheiro guardado. Pode ser `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`results_url`,type:`string`,required:true,id:`param-results-url`,children:_jsxs(_components.p,{children:[`O URL de `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),` deste documento.`]})}),`\n`,_jsx(ResponseField,{name:`file_name`,type:`string`,required:true,id:`param-file-name`,children:_jsxs(_components.p,{children:[`Nome do ficheiro a apresentar, o mesmo que `,_jsx(_components.a,{href:`/pt/api/documents/download-document`,children:`Transferir documento`}),` envia.`]})}),`\n`,_jsx(ResponseField,{name:`original_file_name`,type:`string`,required:true,id:`param-original-file-name`,children:_jsx(_components.p,{children:`O nome do ficheiro que carregaste.`})}),`\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 de média do ficheiro, por ex., `,_jsx(_components.code,{children:`application/pdf`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`etag`,type:`string`,id:`param-etag`,children:_jsxs(_components.p,{children:[`Versão do conteúdo do ficheiro. Pode ser `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`size_bytes`,type:`integer`,id:`param-size-bytes`,children:_jsxs(_components.p,{children:[`Tamanho do ficheiro em bytes. Pode ser `,_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`}),` para um documento carregado.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas-de-erro`,children:`Respostas de erro`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Estado`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Um campo do formulário é inválido ou o corpo não é `,_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:[`Falta um âmbito à tua chave de API, o perfil está fora do teu contexto de acesso ou enviaste `,_jsx(_components.code,{children:`extract_results: true`}),` sem `,_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:`Perfil não encontrado.`})]}),_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`}),`: o mesmo ficheiro já existe neste perfil. `,_jsx(_components.code,{children:`document_id`}),` indica-o, ou é `,_jsx(_components.code,{children:`null`}),` quando não o podes ler. Também enviado em caso de conflito de `,_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`}),`: o ficheiro tem mais de 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`}),`: o ficheiro não é um PDF, DOC, DOCX, PNG ou JPEG. O nome do ficheiro tem de terminar em `,_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`}),` ou `,_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:[`Erro interno do servidor. `,_jsx(_components.code,{children:`extraction_not_started`}),`: o ficheiro está guardado como `,_jsx(_components.code,{children:`document_id`}),`, mas a extração não pôde começar. Contacta a 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":"Carregar documento","description":"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais","api":"POST https://anivahealth.com/api/v1/documents","href":"/pt/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:[`Carrega um ficheiro para um perfil. Envia-o como `,_jsx(_components.code,{children:`multipart/form-data`}),`. Sem `,_jsx(_components.code,{children:`extract_results`}),`, a Aniva apenas\nguarda o ficheiro. Com `,_jsx(_components.code,{children:`extract_results: true`}),`, a Aniva também lê os valores de laboratório a partir do ficheiro.`]}),`\n`,_jsxs(_components.p,{children:[`Não indicas que tipo de relatório é o ficheiro. A Aniva decide. Um ficheiro sem resultados de laboratório, como\numa carta médica, termina como `,_jsx(_components.code,{children:`stored`}),` e não é um erro.`]}),`\n`,_jsxs(_components.p,{children:[`Lê os valores com `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),`. Não precisas de\nfazer polling: subscreve os `,_jsx(_components.a,{href:`/pt/concepts/webhooks`,children:`webhooks`}),` `,_jsx(_components.code,{children:`document.results.*`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Requer o âmbito `,_jsx(_components.code,{children:`documents_upload`}),` num grupo de perfis do perfil. `,_jsx(_components.code,{children:`extract_results: true`}),`\ntambém requer o âmbito `,_jsx(_components.code,{children:`documents_extract_results`}),` no mesmo grupo. Pede à Aniva para os adicionar. O\ndocumento pertence a esse grupo: as chaves com `,_jsx(_components.code,{children:`results_view`}),` nesse grupo leem o documento e os seus resultados.`]}),`\n`,_jsxs(_components.p,{children:[`Envia um cabeçalho opcional `,_jsx(_components.code,{children:`Idempotency-Key`}),` para tornar seguro repetir o carregamento. Consulta\n`,_jsx(_components.a,{href:`/pt/concepts/idempotency`,children:`Idempotência`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`o-que-faz-a-extração`,children:`O que faz a extração`}),`\n`,_jsxs(_components.p,{children:[`Com `,_jsx(_components.code,{children:`extract_results: true`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`A Aniva envia o ficheiro aos seus subcontratantes de OCR e IA para ler os valores.`}),`\n`,_jsx(_components.li,{children:`Os valores aparecem na app Aniva do membro, como qualquer outro resultado.`}),`\n`,_jsxs(_components.li,{children:[`Cada valor inclui `,_jsx(_components.code,{children:`origin: partner_upload`}),` e o mesmo `,_jsx(_components.code,{children:`status`}),` que qualquer outro resultado. Um valor\nde que a verificação automática da Aniva duvida tem o estado `,_jsx(_components.code,{children:`likely_wrong`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Sem isso, o ficheiro não vai para nenhum serviço externo quando também envias `,_jsx(_components.code,{children:`document_date`}),`.`]}),`\n`,_jsx(Accordion,{title:`Precisão e proteção de dados`,id:`precisao-e-protecao-de-dados`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A leitura automática pode ler mal um valor, uma unidade ou uma data. O ficheiro original continua\na ser a fonte de verdade. Confirma o valor com ele antes de o usares para uma decisão médica.\nOs valores extraídos não são um diagnóstico.`}),`\n`,_jsx(_components.li,{children:`Os subcontratantes são a Mistral AI (OCR, UE) e o Google Cloud Vertex AI, acedido através do\nVercel AI Gateway (extração, pode processar fora da UE). Processam o ficheiro apenas para o\nler.`}),`\n`,_jsx(_components.li,{children:`Precisas de uma base legal para carregar os dados de saúde de um membro, normalmente o\nconsentimento explícito do membro. És responsável por isso.`}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`pedido`,children:`Pedido`}),`\n`,_jsx(Heading,{level:`3`,id:`campos-do-formulário`,children:`Campos do formulário`}),`\n`,_jsx(ParamField,{body:`file`,type:`file`,required:true,id:`param-file`,children:_jsx(_components.p,{children:`O ficheiro. PDF, DOC, DOCX, PNG ou JPEG, no máximo 4 MB.`})}),`\n`,_jsx(ParamField,{body:`profile_id`,type:`string`,required:true,id:`param-profile-id`,children:_jsx(_components.p,{children:`UUID do perfil a que o documento pertence.`})}),`\n`,_jsx(ParamField,{body:`extract_results`,type:`boolean`,default:`false`,id:`param-extract-results`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` para ler os valores laboratoriais do ficheiro. Envia `,_jsx(_components.code,{children:`true`}),` ou `,_jsx(_components.code,{children:`false`}),`.`]})}),`\n`,_jsx(ParamField,{body:`document_date`,type:`string`,id:`param-document-date`,children:_jsxs(_components.p,{children:[`A data da amostra no formato `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, quando a conheces. Sem ela, a Aniva lê a data do\nficheiro.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsxs(_components.p,{children:[`A API devolve `,_jsx(_components.code,{children:`201 Created`}),` quando apenas guardou o ficheiro e `,_jsx(_components.code,{children:`202 Accepted`}),` quando a extração é executada.`]}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`ID do documento (UUID). Usa-o com `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),` e\n`,_jsx(_components.a,{href:`/pt/api/documents/download-document`,children:`Transferir documento`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`processing`}),` enquanto a Aniva extrai os valores, ou `,_jsx(_components.code,{children:`stored`}),` quando o ficheiro é apenas guardado.`]})}),`\n`,_jsx(ResponseField,{name:`profile_id`,type:`string`,required:true,id:`param-profile-id-1`,children:_jsx(_components.p,{children:`O perfil a que o documento pertence.`})}),`\n`,_jsx(ResponseField,{name:`document_date`,type:`string`,id:`param-document-date-1`,children:_jsxs(_components.p,{children:[`A data da amostra que enviaste, ou a que a Aniva leu de um ficheiro guardado. Pode ser `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`results_url`,type:`string`,required:true,id:`param-results-url`,children:_jsxs(_components.p,{children:[`O URL de `,_jsx(_components.a,{href:`/pt/api/documents/get-document-results`,children:`Obter resultados do documento`}),` deste documento.`]})}),`\n`,_jsx(ResponseField,{name:`file_name`,type:`string`,required:true,id:`param-file-name`,children:_jsxs(_components.p,{children:[`Nome do ficheiro a apresentar, o mesmo que `,_jsx(_components.a,{href:`/pt/api/documents/download-document`,children:`Transferir documento`}),` envia.`]})}),`\n`,_jsx(ResponseField,{name:`original_file_name`,type:`string`,required:true,id:`param-original-file-name`,children:_jsx(_components.p,{children:`O nome do ficheiro que carregaste.`})}),`\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 de média do ficheiro, por ex., `,_jsx(_components.code,{children:`application/pdf`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`etag`,type:`string`,id:`param-etag`,children:_jsxs(_components.p,{children:[`Versão do conteúdo do ficheiro. Pode ser `,_jsx(_components.code,{children:`null`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`size_bytes`,type:`integer`,id:`param-size-bytes`,children:_jsxs(_components.p,{children:[`Tamanho do ficheiro em bytes. Pode ser `,_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`}),` para um documento carregado.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas-de-erro`,children:`Respostas de erro`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Estado`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Um campo do formulário é inválido ou o corpo não é `,_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:[`Falta um âmbito à tua chave de API, o perfil está fora do teu contexto de acesso ou enviaste `,_jsx(_components.code,{children:`extract_results: true`}),` sem `,_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:`Perfil não encontrado.`})]}),_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`}),`: o mesmo ficheiro já existe neste perfil. `,_jsx(_components.code,{children:`document_id`}),` indica-o, ou é `,_jsx(_components.code,{children:`null`}),` quando não o podes ler. Também enviado em caso de conflito de `,_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`}),`: o ficheiro tem mais de 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`}),`: o ficheiro não é um PDF, DOC, DOCX, PNG ou JPEG. O nome do ficheiro tem de terminar em `,_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`}),` ou `,_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:[`Erro interno do servidor. `,_jsx(_components.code,{children:`extraction_not_started`}),`: o ficheiro está guardado como `,_jsx(_components.code,{children:`document_id`}),`, mas a extração não pôde começar. Contacta a 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":"Carregar documento","description":"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais","api":"POST https://anivahealth.com/api/v1/documents","href":"/pt/api/documents/upload-document"}}}},"mdxExtracts":{"tableOfContents":[{"title":"O que faz a extração","slug":"o-que-faz-a-extração","depth":2,"children":[]},{"title":"Pedido","slug":"pedido","depth":2,"children":[{"title":"Campos do formulário","slug":"campos-do-formulário","depth":3,"children":[]}]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Respostas de erro","slug":"respostas-de-erro","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":"Carregar 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":"O ficheiro. PDF, DOC, DOCX, PNG ou JPEG, no máximo 4 MB.","required":true}],"profile_id":[{"type":"string","description":"UUID do perfil a que o documento pertence.","required":true}],"extract_results":[{"type":"boolean","description":"`true` para ler os valores laboratoriais do ficheiro. Envia `true` ou `false` ."}],"document_date":[{"type":"string","description":"A data da amostra no formato `YYYY-MM-DD` , quando a conheces. Sem ela, a Aniva lê a data do ficheiro."}]}}],"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 do documento (UUID). Usa-o com Obter resultados do documento e Transferir documento .","required":true}],"status":[{"type":"string","description":"`processing` enquanto a Aniva extrai os valores, ou `stored` quando o ficheiro é apenas guardado.","required":true}],"profile_id":[{"type":"string","description":"O perfil a que o documento pertence.","required":true}],"document_date":[{"type":"string","description":"A data da amostra que enviaste, ou a que a Aniva leu de um ficheiro guardado. Pode ser `null` ."}],"results_url":[{"type":"string","description":"O URL de Obter resultados do documento deste documento.","required":true}],"file_name":[{"type":"string","description":"Nome do ficheiro a apresentar, o mesmo que Transferir documento envia.","required":true}],"original_file_name":[{"type":"string","description":"O nome do ficheiro que carregaste.","required":true}],"origin":[{"type":"string","description":"Sempre `partner_upload` .","required":true}],"content_type":[{"type":"string","description":"Tipo de média do ficheiro, por ex., `application/pdf` .","required":true}],"etag":[{"type":"string","description":"Versão do conteúdo do ficheiro. Pode ser `null` ."}],"size_bytes":[{"type":"integer","description":"Tamanho do ficheiro em bytes. Pode ser `null` ."}],"lab_code":[{"type":"string","description":"Sempre `null` para um documento carregado."}]}}],"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":"Carregar 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":1},"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":0},"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":"pt/api/documents/upload-document.mdx","locale":"pt"},"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=\"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\">\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=\"Carregar documento - Aniva API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aniva Partner API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.anivahealth.com/pt/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=Documentos\u0026amp;title=Carregar+documento\u0026amp;description=Carregar+um+relat%C3%B3rio+laboratorial+ou+qualquer+outro+documento+para+um+perfil+e%2C+opcionalmente%2C+extrair+os+seus+valores+laboratoriais\u0026amp;theme=ee63c32abd41d12dcedcfed1\u0026amp;signature=f238eea6800f79f7a0e489eccc1818b0b65b4ae4569f541b35ed65948a9433dd\">\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=\"Carregar documento - Aniva API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://anivahealth.mintlify.site/_mintlify/api/og/v2?division=Documentos\u0026amp;title=Carregar+documento\u0026amp;description=Carregar+um+relat%C3%B3rio+laboratorial+ou+qualquer+outro+documento+para+um+perfil+e%2C+opcionalmente%2C+extrair+os+seus+valores+laboratoriais\u0026amp;theme=ee63c32abd41d12dcedcfed1\u0026amp;signature=f238eea6800f79f7a0e489eccc1818b0b65b4ae4569f541b35ed65948a9433dd\">\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/pt/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=\"/pt/api/documents/upload-document.md\">\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=\"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=\"it\" href=\"https://docs.anivahealth.com/it/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=\"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/pt/api/documents/upload-document#webpage\",\"url\":\"https://docs.anivahealth.com/pt/api/documents/upload-document\",\"name\":\"Carregar documento\",\"description\":\"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\",\"dateModified\":\"2026-11-22T10:00:15.564Z\",\"isPartOf\":{\"@id\":\"https://docs.anivahealth.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.anivahealth.com/pt/api/documents/upload-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.anivahealth.com/pt/api/documents/upload-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Aniva API\",\"item\":\"https://docs.anivahealth.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Carregar documento\",\"item\":\"https://docs.anivahealth.com/pt/api/documents/upload-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.anivahealth.com/pt/api/documents/upload-document#apireference\",\"headline\":\"Carregar documento\",\"name\":\"Carregar documento\",\"description\":\"Carregar um relatório laboratorial ou qualquer outro documento para um perfil e, opcionalmente, extrair os seus valores laboratoriais\",\"url\":\"https://docs.anivahealth.com/pt/api/documents/upload-document\",\"mainEntityOfPage\":{\"@id\":\"https://docs.anivahealth.com/pt/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":"/pt/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"}]},"pages":[{"title":"it","href":"/it/api/documents/upload-document"}]},{"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"}]},"tabs":[{"tab":"Documentação","pages":[{"title":"Documentação","href":"/pt"}]},{"tab":"Referência da API","groups":[{"group":"Saúde","pages":[{"title":"Verificação de estado","api":"GET https://anivahealth.com/api/v1/health","href":"/pt/api/health/check-health"}]},{"group":"Perfis","pages":[{"title":"Listar perfis","api":"GET https://anivahealth.com/api/v1/profiles","href":"/pt/api/profiles/list-profiles"},{"title":"Criar perfil","api":"POST https://anivahealth.com/api/v1/profiles","href":"/pt/api/profiles/create-profile"},{"title":"Obter perfil","api":"GET https://anivahealth.com/api/v1/profiles/{id}","href":"/pt/api/profiles/get-profile"},{"title":"Atualizar perfil","api":"PATCH https://anivahealth.com/api/v1/profiles/{id}","href":"/pt/api/profiles/update-profile"},{"title":"Criar sessão de incorporação","api":"POST https://anivahealth.com/api/v1/profiles/{id}/embed-sessions","href":"/pt/api/profiles/create-embed-session"}]},{"group":"Marcações","pages":[{"title":"Listar marcações","api":"GET https://anivahealth.com/api/v1/appointments","href":"/pt/api/appointments/list-appointments"},{"title":"Criar marcação","api":"POST https://anivahealth.com/api/v1/appointments","href":"/pt/api/appointments/create-appointment"},{"title":"Obter marcação","api":"GET https://anivahealth.com/api/v1/appointments/{id}","href":"/pt/api/appointments/get-appointment"},{"title":"Atualizar marcação","api":"PATCH https://anivahealth.com/api/v1/appointments/{id}","href":"/pt/api/appointments/update-appointment"},{"title":"Cancelar marcação","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}","href":"/pt/api/appointments/cancel-appointment"},{"title":"Adicionar painéis","api":"POST https://anivahealth.com/api/v1/appointments/{id}/panels","href":"/pt/api/appointments/add-panels"},{"title":"Remover painéis","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}/panels","href":"/pt/api/appointments/remove-panels"},{"title":"Adicionar biomarcadores individuais","api":"PATCH https://anivahealth.com/api/v1/appointments/{id}/biomarkers","href":"/pt/api/appointments/add-individual-biomarkers"},{"title":"Remover biomarcadores individuais","api":"DELETE https://anivahealth.com/api/v1/appointments/{id}/biomarkers","href":"/pt/api/appointments/remove-individual-biomarkers"},{"title":"Pré-visualizar marcação","api":"GET https://anivahealth.com/api/v1/appointments/{id}/preview","href":"/pt/api/appointments/preview-containers"},{"title":"Confirmar colheita de sangue","api":"POST https://anivahealth.com/api/v1/appointments/{id}/confirm","href":"/pt/api/appointments/confirm-blood-draw"},{"title":"Obter resultados laboratoriais","api":"GET https://anivahealth.com/api/v1/appointments/{id}/results","href":"/pt/api/appointments/get-results"},{"title":"Enviar resultados por e-mail","api":"POST https://anivahealth.com/api/v1/appointments/{id}/results/email","href":"/pt/api/appointments/email-results"}]},{"group":"Encomendas de kits de teste em casa","pages":[{"title":"Listar encomendas de kit de teste em casa","api":"GET https://anivahealth.com/api/v1/home-kit-orders","href":"/pt/api/home-kit-orders/list-home-kits"},{"title":"Criar encomenda de kit de teste em casa","api":"POST https://anivahealth.com/api/v1/home-kit-orders","href":"/pt/api/home-kit-orders/create-home-kit"},{"title":"Obter encomenda de kit de teste em casa","api":"GET https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/pt/api/home-kit-orders/get-home-kit"},{"title":"Atualizar encomenda de kit de teste em casa","api":"PATCH https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/pt/api/home-kit-orders/update-home-kit"},{"title":"Cancelar encomenda de kit de teste em casa","api":"DELETE https://anivahealth.com/api/v1/home-kit-orders/{id}","href":"/pt/api/home-kit-orders/cancel-home-kit"},{"title":"Ativar encomenda de kit de teste em casa","api":"POST https://anivahealth.com/api/v1/home-kit-orders/{id}/activate","href":"/pt/api/home-kit-orders/activate-home-kit"},{"title":"Adicionar biomarcadores individuais","api":"PATCH https://anivahealth.com/api/v1/home-kit-orders/{id}/biomarkers","href":"/pt/api/home-kit-orders/add-individual-biomarkers"},{"title":"Remover biomarcadores individuais","api":"DELETE https://anivahealth.com/api/v1/home-kit-orders/{id}/biomarkers","href":"/pt/api/home-kit-orders/remove-individual-biomarkers"},{"title":"Obter resultados laboratoriais","api":"GET https://anivahealth.com/api/v1/home-kit-orders/{id}/results","href":"/pt/api/home-kit-orders/get-results"},{"title":"Enviar resultados por e-mail","api":"POST https://anivahealth.com/api/v1/home-kit-orders/{id}/results/email","href":"/pt/api/home-kit-orders/email-results"}]},{"group":"Catálogo de testes","pages":[{"title":"Listar biomarcadores","api":"GET https://anivahealth.com/api/v1/biomarkers","href":"/pt/api/biomarkers/list-biomarkers"},{"title":"Obter biomarcador","api":"GET https://anivahealth.com/api/v1/biomarkers/{id}","href":"/pt/api/biomarkers/get-biomarker"},{"title":"Listar painéis","api":"GET https://anivahealth.com/api/v1/panels","href":"/pt/api/panels/list-panels"}]},{"group":"Preços","pages":[{"title":"Obter tabela de tarifas","api":"GET https://anivahealth.com/api/v1/pricing/rate-card","href":"/pt/api/pricing/get-rate-card"},{"title":"Orçamentar carrinho","api":"POST https://anivahealth.com/api/v1/pricing/quote","href":"/pt/api/pricing/quote-cart"}]},{"group":"Unidades","pages":[{"title":"Listar unidades","api":"GET https://anivahealth.com/api/v1/units","href":"/pt/api/units/list-units"}]},{"group":"Locais","pages":[{"title":"Listar locais","api":"GET https://anivahealth.com/api/v1/locations","href":"/pt/api/locations/list-locations"},{"title":"Obter local","api":"GET https://anivahealth.com/api/v1/locations/{id}","href":"/pt/api/locations/get-location"},{"title":"Obter disponibilidade","api":"GET https://anivahealth.com/api/v1/locations/{id}/availability","href":"/pt/api/locations/get-availability"},{"title":"Listar preços ao público","api":"GET https://anivahealth.com/api/v1/locations/retail-prices","href":"/pt/api/locations/list-retail-prices"},{"title":"Obter preços ao público","description":"Obter os preços de painéis e de biomarcadores individuais que um local cobra a clientes sem marcação","api":"GET https://anivahealth.com/api/v1/locations/{id}/retail-prices","href":"/pt/api/locations/get-retail-prices"}]},{"group":"Documentos","pages":[{"title":"Carregar documento","api":"POST https://anivahealth.com/api/v1/documents","href":"/pt/api/documents/upload-document"},{"title":"Obter resultados do documento","description":"Ler o estado e os valores laboratoriais extraídos de um documento que carregaste","api":"GET https://anivahealth.com/api/v1/documents/{id}/results","href":"/pt/api/documents/get-document-results"},{"title":"Transferir documento","api":"GET https://anivahealth.com/api/v1/documents/{id}","href":"/pt/api/documents/download-document"},{"title":"Eliminar documento","api":"DELETE https://anivahealth.com/api/v1/documents/{id}","href":"/pt/api/documents/delete-document"}]},{"group":"Envios","pages":[{"title":"Criar envio","api":"POST https://anivahealth.com/api/v1/shipments","href":"/pt/api/shipments/create-shipment"},{"title":"Listar envios","api":"GET https://anivahealth.com/api/v1/shipments","href":"/pt/api/shipments/list-shipments"},{"title":"Obter envio","api":"GET https://anivahealth.com/api/v1/shipments/{id}","href":"/pt/api/shipments/get-shipment"},{"title":"Atualizar envio","api":"PATCH https://anivahealth.com/api/v1/shipments/{id}","href":"/pt/api/shipments/update-shipment"},{"title":"Cancelar envio","api":"DELETE https://anivahealth.com/api/v1/shipments/{id}","href":"/pt/api/shipments/cancel-shipment"},{"title":"Listar marcações do envio","api":"GET https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/pt/api/shipments/list-shipment-appointments"},{"title":"Associar marcações ao envio","api":"POST https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/pt/api/shipments/attach-appointments-to-shipment"},{"title":"Desassociar marcações do envio","api":"DELETE https://anivahealth.com/api/v1/shipments/{id}/appointments","href":"/pt/api/shipments/detach-appointments-from-shipment"}]},{"group":"Webhooks","pages":[{"title":"Listar webhooks","api":"GET https://anivahealth.com/api/v1/webhooks","href":"/pt/api/webhooks/list-webhooks"},{"title":"Criar webhook","api":"POST https://anivahealth.com/api/v1/webhooks","href":"/pt/api/webhooks/create-webhook"},{"title":"Obter webhook","api":"GET https://anivahealth.com/api/v1/webhooks/{id}","href":"/pt/api/webhooks/get-webhook"},{"title":"Atualizar webhook","api":"PATCH https://anivahealth.com/api/v1/webhooks/{id}","href":"/pt/api/webhooks/update-webhook"},{"title":"Eliminar webhook","api":"DELETE https://anivahealth.com/api/v1/webhooks/{id}","href":"/pt/api/webhooks/delete-webhook"},{"title":"Rodar segredo","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/rotate-secret","href":"/pt/api/webhooks/rotate-secret"},{"title":"Enviar evento de teste","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/ping","href":"/pt/api/webhooks/send-test-event"},{"title":"Listar entregas","api":"GET https://anivahealth.com/api/v1/webhooks/{id}/deliveries","href":"/pt/api/webhooks/list-deliveries"},{"title":"Reenviar entrega","api":"POST https://anivahealth.com/api/v1/webhooks/{id}/deliveries/{delivery_id}/resend","href":"/pt/api/webhooks/resend-delivery"}]}]}]},{"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":"Carregar 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"]}