Esiste un'interfaccia per questo nell'app?
Sì, per i modelli: a partire dal piano Corporate, l'applicazione web offre la pagina "Modelli di documento". È possibile creare i modelli, visualizzarne l'anteprima e ripristinare le versioni precedenti. I documenti vengono generati tramite REST API, tramite MCP da un assistente AI o nell'applicazione web con il Creator Agent. I PDF completati si trovano quindi nel Workspace selezionato.
Qual è la differenza tra create-from-content e create-from-template?
create-from-content renderizza il Markdown o l'HTML forniti come pagine A4 verticali con margini standard. create-from-template compila un modello salvato con le variabili dell'utente, utilizzando il formato della pagina, i margini e le intestazioni/piè di pagina del modello stesso.
Quali segnaposti e helper sono disponibili?
{{variable}} per i valori, {{#each lista}} per gli elenchi con {{@index}} e {{@number}}, sum, sum_product, multiply e calculate per i calcoli, format_number e format_date nonché today, now, year, month, day e time. I valori vengono inseriti in modo sicuro per l'HTML; i segnaposti non utilizzati vengono omessi.
Quali limiti è bene conoscere?
L'API genera PDF esclusivamente. Solo i modelli con il motore più recente, disponibile dal piano Corporate, valutano condizioni quali {{#if}}; negli altri modelli entrambi i rami terminano in PDF. Per impostazione predefinita, le funzioni di calcolo ausiliarie restituiscono i numeri nel formato tedesco (1.234,56) e le date seguono il formato GG.MM.AAAA. Il carattere predefinito non contiene caratteri giapponesi, cinesi o coreani.
Cosa succede se manca un campo obbligatorio?
Se un campo è presente in variables_schema.required ma manca o è vuoto, la API risponde con 400 MISSING_REQUIRED_VARIABLES indicando i campi mancanti. Non viene creato alcun documento e non vengono eseguiti calcoli.
Dove viene archiviato il PDF?
Nel Workspace, specificato tramite workspace_id, vale lo stesso principio di un upload. È necessario disporre del diritto di upload. Se nel Workspace è configurata un'automazione AI-DMS, questa elaborerà il PDF come ogni nuovo documento.
È possibile utilizzare la generazione di documenti tramite MCP?
Sì. Sono disponibili sette strumenti: po_documents_create_from_content, po_documents_create_from_template, po_templates_list, po_templates_get, po_templates_create, po_templates_update e po_templates_delete. Ad esempio, è possibile creare un preventivo dal proprio modello tramite Claude. In ChatGPT è disponibile esclusivamente il codice PDF derivato da Markdown o HTML, corrispondente a po_documents_create_from_content.
Chi può creare e modificare i modelli?
L'account principale e gli amministratori. I modelli appartengono all'account che li ha creati; gli account secondari non possono visualizzarli. template-delete disattiva un modello, mentre template-update con is_active=1 lo riattiva.
Come si evitano documenti duplicati?
Inviare una idempotency_key di 8-128 caratteri durante create-from_content. La stessa richiesta fornirà il risultato memorizzato per 24 ore senza creare un secondo documento. L'uso della stessa chiave con contenuto diverso restituirà un errore 409.
In quali piani è inclusa la generazione di documenti?
Tutti i piani includono le funzionalità REST API e MCP in questa pagina. La pagina “Modelli di documento” nell'app web e il Creator Agent sono disponibili dal piano Corporate. La fatturazione si applica a ogni documento generato e memorizzato, nonché alle chiamate di gestione dei modelli. Un'automazione AI-DMS in Workspace può causare costi aggiuntivi, come per qualsiasi caricamento.