{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flusso di chiamate Certificazione","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"flusso-di-chiamate-certificazione","__idx":0},"children":["Flusso di chiamate Certificazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questa guida descrive come creare una certificazione tramite la Public API. Hai ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tre modalità"]}," a disposizione:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificazione hash"]}," — Una sola chiamata: invii nomi file e hash SHA-256 pre-calcolati. TrueScreen certifica gli hash senza ricevere i file originali."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificazione dati"]}," — Una sola chiamata: invii ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," e il campo obbligatorio ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," (stringhe chiave-valore). Nessun upload di file né elenco di hash."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificazione file"]}," — Tre chiamate in sequenza: registri i file, li carichi su URL temporanei, poi avvii la certificazione. TrueScreen riceve i file originali e ne calcola gli hash."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per i concetti di base (artefatti prodotti, processo asincrono, crediti, metadati), vedi la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-overview"},"children":["panoramica sulla certificazione"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"riferimento-rapido","__idx":1},"children":["Riferimento rapido"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scenario"},"children":["Scenario"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Chiamate"},"children":["Chiamate"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#1-certificazione-hash"},"children":["Certificazione hash"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/hash-certifications"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#2-certificazione-dati"},"children":["Certificazione dati"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/data-certifications"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#3-certificazione-file"},"children":["Certificazione file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications-attachments"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT upload_url"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#4-consultare-lo-stato-della-certificazione"},"children":["Consultare lo stato"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In tutti i casi le richieste devono includere l'",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it#autenticazione"},"children":["autenticazione"]}," con API key."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"certificazione-tramite-mcp","__idx":2},"children":["Certificazione tramite MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gli stessi flussi di certificazione sono disponibili tramite MCP con tool curati invece di chiamate HTTP dirette."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Su entrambi i server MCP puoi usare ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_hash_certification"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_data_certification"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_get_certification"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_wait_for_certification"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La certificazione file è disponibile solo sul server MCP locale, che espone anche ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification_attachments"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_upload_file"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/mcp-integration"},"children":["Integrazione MCP"]}," per installazione e scelta del canale."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"casi-duso","__idx":3},"children":["Casi d'uso"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-certificazione-hash","__idx":4},"children":["1. Certificazione hash"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hai già i file e i relativi hash SHA-256. Vuoi certificare che quegli hash esistevano a un determinato momento, senza caricare i file originali."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/hash-certifications"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Certificazione documenti progetto Alpha\",\n  \"files\": [\n    {\n      \"file_name\": \"contratto.pdf\",\n      \"hash\": \"2661f88efc456652aa9f65f6340fe0213e5bde437e3c613b2a235de81581161e\"\n    },\n    {\n      \"file_name\": \"allegato-tecnico.pdf\",\n      \"hash\": \"5c5ec4792053e87788d0be3f6c31c77f7e48e02466407da5c16ac1962a00e368\"\n    }\n  ],\n  \"webhook_url\": \"https://example.com/webhook/certification\",\n  \"generate_pdf_report\": true,\n  \"metadata\": {\n    \"case_number\": \"2024/001\",\n    \"client_name\": \"Mario Rossi\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Titolo della certificazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array di oggetti con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_name"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hash"]}," (SHA-256, 64 caratteri esadecimali)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL per la callback al completamento"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["generate_pdf_report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Se generare il report PDF (default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oggetto chiave-valore con dati personalizzati da includere nel jsonData e, quando generato, nel report PDF"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (201 Created):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"report_id\": \"d8c2aef3-72a7-4a5f-b0e7-4308a88c6cff\",\n  \"status\": \"pending\",\n  \"credits_amount\": 2,\n  \"title\": \"Certificazione documenti progetto Alpha\",\n  \"created_at\": \"2026-03-06T14:30:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_id"]}]}," — Identificativo univoco della certificazione. Usalo per consultare lo stato con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]}," — Stato iniziale ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pending\""]},": la certificazione è in lavorazione asincrona."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credits_amount"]}]}," — Crediti consumati: 1 per ogni hash inviato (in questo esempio, 2 hash = 2 crediti)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-certificazione-dati","__idx":5},"children":["2. Certificazione dati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vuoi certificare dati strutturati in formato stringa (riferimenti, campi contrattuali, identificativi CRM) senza caricare file né dichiarare hash."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/data-certifications"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Attestazione dati contratto\",\n  \"data\": {\n    \"case_number\": \"2024/001\",\n    \"client_name\": \"Mario Rossi\",\n    \"contract_ref\": \"CTR-20240315\"\n  },\n  \"webhook_url\": \"https://example.com/webhook/certification\",\n  \"generate_pdf_report\": true\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Titolo della certificazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oggetto con almeno una coppia chiave-valore; chiavi e valori devono essere stringhe"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL per la callback al completamento"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["generate_pdf_report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Se generare il report PDF (default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (201 Created):"]}," stessa forma della certificazione hash (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credits_amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]},"). ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credits_amount"]}]}," è ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1"]}," per certificazione."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-certificazione-file","__idx":6},"children":["3. Certificazione file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vuoi caricare i file originali affinché TrueScreen ne calcoli gli hash e li certifichi. Il processo richiede ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tre passaggi"]}," in sequenza."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-1--registrare-i-file-e-ottenere-gli-url-di-upload","__idx":7},"children":["Passo 1 — Registrare i file e ottenere gli URL di upload"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications-attachments"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"files\": [\n    { \"file_name\": \"contratto.pdf\" },\n    {\n      \"file_name\": \"foto-sopralluogo.jpg\",\n      \"creation_datetime\": \"2026-04-08T14:30:00.000Z\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array non vuoto."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files[].file_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nome del file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files[].creation_datetime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date-time"]}," (non futuro). Opzionale: se presente e valido, usato in jsonData per quell’allegato come data di acquisizione."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (201 Created):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"file_name\": \"contratto.pdf\",\n    \"upload_session_token\": \"sess_abc123def456\",\n    \"upload_url\": \"https://s3.amazonaws.com/bucket/contratto.pdf?X-Amz-Signature=...\"\n  },\n  {\n    \"file_name\": \"foto-sopralluogo.jpg\",\n    \"upload_session_token\": \"sess_abc123def456\",\n    \"upload_url\": \"https://s3.amazonaws.com/bucket/foto-sopralluogo.jpg?X-Amz-Signature=...\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}]}," — Token unico per la sessione di upload. È lo stesso per tutti i file della stessa richiesta. Lo userai nel passo 3."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_url"]}]}," — URL firmato temporaneo (presigned URL) per caricare il file. Ha una scadenza di 120 secondi."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-2--caricare-i-file","__idx":8},"children":["Passo 2 — Caricare i file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per ogni file, esegui una richiesta ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP PUT"]}," verso l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_url"]}," ricevuto, con il corpo della richiesta uguale al contenuto binario del file."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT https://s3.amazonaws.com/bucket/contratto.pdf?X-Amz-Signature=... HTTP/1.1\nContent-Type: application/pdf\n\n<contenuto binario del file>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il client deve usare esattamente l'URL ricevuto senza aggiungere header di autenticazione TrueScreen (la firma è nell'URL). L'unico header necessario è ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," con il MIME type del file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripeti l'operazione per ogni file. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tutti i file devono essere caricati"]}," prima di procedere al passo 3; in caso contrario la creazione della certificazione fallirà con errore ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-013"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-3--creare-la-certificazione","__idx":9},"children":["Passo 3 — Creare la certificazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Certificazione sopralluogo cantiere\",\n  \"upload_session_token\": \"sess_abc123def456\",\n  \"webhook_url\": \"https://example.com/webhook/certification\",\n  \"generate_pdf_report\": true,\n  \"metadata\": {\n    \"site_id\": \"CANT-042\",\n    \"inspector\": \"Luigi Verdi\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Titolo della certificazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token ricevuto nel passo 1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL per la callback al completamento"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["generate_pdf_report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Se generare il report PDF (default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Oggetto chiave-valore con dati personalizzati"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (201 Created):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"report_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"status\": \"pending\",\n  \"credits_amount\": 2,\n  \"title\": \"Certificazione sopralluogo cantiere\",\n  \"created_at\": \"2026-03-06T15:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credits_amount"]}]}," — Crediti consumati: 1 per ogni file caricato (in questo esempio, 2 file = 2 crediti)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"riassunto-sequenza-certificazione-file","__idx":10},"children":["Riassunto sequenza certificazione file"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications-attachments"]}," con i nomi dei file (e opzionale ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creation_datetime"]}," per file) → ottieni ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_url"]}," per ogni file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT upload_url"]}," per ogni file → carica il contenuto binario."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications"]}," con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}," → avvia la certificazione."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-consultare-lo-stato-della-certificazione","__idx":11},"children":["4. Consultare lo stato della certificazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il processo è ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["asincrono"]},": dopo la creazione, la certificazione è in stato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pending\""]},". Puoi sapere quando è completata in due modi."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"polling","__idx":12},"children":["Polling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interroga periodicamente l'endpoint passando il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report_id"]}," ricevuto nella risposta di creazione."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (certificazione in corso):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"report_id\": \"d8c2aef3-72a7-4a5f-b0e7-4308a88c6cff\",\n  \"status\": \"pending\",\n  \"created_at\": \"2026-03-06T14:30:00Z\",\n  \"title\": \"Certificazione documenti progetto Alpha\",\n  \"files\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (certificazione completata):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"report_id\": \"d8c2aef3-72a7-4a5f-b0e7-4308a88c6cff\",\n  \"status\": \"completed\",\n  \"created_at\": \"2026-03-06T14:30:00Z\",\n  \"title\": \"Certificazione documenti progetto Alpha\",\n  \"files\": [\n    {\n      \"type\": \"data\",\n      \"url\": \"https://s3.example.com/d8c2aef3.json?X-Amz-Signature=...\"\n    },\n    {\n      \"type\": \"report\",\n      \"url\": \"https://s3.example.com/d8c2aef3.pdf?X-Amz-Signature=...\"\n    },\n    {\n      \"type\": \"xml\",\n      \"url\": \"https://s3.example.com/d8c2aef3.xml?X-Amz-Signature=...\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I file restituiti nell'array ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}," hanno un campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," che identifica il tipo di artefatto:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Artefatto"},"children":["Artefatto"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["jsonData"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Documento JSON machine-readable con hash e metadati"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Report PDF"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Documento PDF human-readable con i dati salienti (presente solo se la generazione del report è prevista dalla configurazione)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xml"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["XML firmato"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envelope XML firmato digitalmente e marcato temporalmente"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["media"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File originali"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["I file caricati (solo per certificazione file)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gli URL sono ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["firmati"]}," (presigned) e hanno una scadenza temporale di 60 secondi: scarica i file entro il periodo di validità."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta (certificazione fallita dopo l'elaborazione asincrona):"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," di creazione è riuscito ma l'elaborazione successiva fallisce, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]}," risponde con ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/problem+json"]}]},", e il seguente corpo problema RFC 9457:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"HTTP/1.1 500 Internal Server Error\nContent-Type: application/problem+json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://truescreen.redocly.app/errors/server-error\",\n  \"title\": \"Certification processing error\",\n  \"status\": 500,\n  \"detail\": \"Digital signature error.\",\n  \"code\": \"TS-014\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"webhook","__idx":13},"children":["Webhook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se hai passato un ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_url"]}," nella richiesta di creazione, TrueScreen invia una ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["callback HTTP POST"]}," quando l'elaborazione ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["termina — con successo o con errore"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il payload della callback usa il formato envelope ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard Webhooks"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certification.completed"]}]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," coincide con la risposta ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["200"]}," della ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," (oggetto certificazione con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certification.error"]}]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," contiene il documento ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]}]}," che la ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," restituirebbe per quell'esito."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ogni callback è firmata con header Standard Webhooks (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook-id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook-timestamp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook-signature"]},"). Vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-overview#verifica-della-firma"},"children":["Certificazione — Panoramica"]}," per i dettagli sulla verifica."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errori-comuni","__idx":14},"children":["Errori comuni"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Codice"},"children":["Codice"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Situazione"},"children":["Situazione"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cosa fare"},"children":["Cosa fare"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payload malformato"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifica la struttura JSON della richiesta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-002"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campo obbligatorio mancante"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Controlla che ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}," siano presenti"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-008"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Crediti insufficienti"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifica il saldo con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/credits"]}," e acquista crediti dal portale TrueScreen"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-010"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificazione non trovata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifica il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportId"]}," passato a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-012"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upload session token già usato"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ogni ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_session_token"]}," può creare una sola certificazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-013"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non tutti i file sono stati caricati"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Completa l'upload di tutti i file prima di chiamare ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TS-014"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elaborazione certificazione non completata dopo la creazione"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/errors/server-error#fallimento-elaborazione-certificazione"},"children":["Errori server"]},"; il webhook invia un evento ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certification.error"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per il formato completo delle risposte di errore, vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/errors"},"children":["Errori API"]},"."]}]},"headings":[{"value":"Flusso di chiamate Certificazione","id":"flusso-di-chiamate-certificazione","depth":1},{"value":"Riferimento rapido","id":"riferimento-rapido","depth":2},{"value":"Certificazione tramite MCP","id":"certificazione-tramite-mcp","depth":2},{"value":"Casi d'uso","id":"casi-duso","depth":2},{"value":"1. Certificazione hash","id":"1-certificazione-hash","depth":3},{"value":"2. Certificazione dati","id":"2-certificazione-dati","depth":3},{"value":"3. Certificazione file","id":"3-certificazione-file","depth":3},{"value":"Passo 1 — Registrare i file e ottenere gli URL di upload","id":"passo-1--registrare-i-file-e-ottenere-gli-url-di-upload","depth":4},{"value":"Passo 2 — Caricare i file","id":"passo-2--caricare-i-file","depth":4},{"value":"Passo 3 — Creare la certificazione","id":"passo-3--creare-la-certificazione","depth":4},{"value":"Riassunto sequenza certificazione file","id":"riassunto-sequenza-certificazione-file","depth":4},{"value":"4. Consultare lo stato della certificazione","id":"4-consultare-lo-stato-della-certificazione","depth":3},{"value":"Polling","id":"polling","depth":4},{"value":"Webhook","id":"webhook","depth":4},{"value":"Errori comuni","id":"errori-comuni","depth":2}],"frontmatter":{"title":"Flusso di chiamate Certificazione","description":"Guida operativa per creare una certificazione (hash o file) via API pubblica","seo":{"title":"Flusso di chiamate Certificazione"}},"lastModified":"2026-06-25T15:58:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/certification-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}