Bu işlem için uygulamada bir arayüz var mıdır?
Evet, şablonlar için: Corporate planıyla başlayan şekilde, web uygulaması “Belge şablonları” sayfasını sunar. Burada şablonlar oluşturabilir, önizleme yapabilir ve önceki sürümleri geri yükleyebilirsiniz. Belgeler REST API aracılığıyla, bir AI asistanından MCP ile veya web uygulamasında Creator Agent ile oluşturulur. Tamamlanan PDF belgelerini seçilen Workspace konumunda bulabilirsiniz.
create-from-content ve create-from-template arasındaki fark nedir?
create-from-content, birlikte gönderdiğiniz Markdown veya HTML'i her zaman standart kenar boşluklarıyla A4 dikey olarak render eder. create-from-template ise kayıtlı bir şablonu değişkenlerinizle doldurur ve şablonun sayfa düzeni, kenar boşlukları ile üst ve alt bilgilerini kullanır.
Hangi yer tutucular ve yardımcılar mevcuttur?
Değerler için {{variable}}, listeler için {{#each liste}} ({{@index}} ve {{@number}} ile), hesaplamalar için sum, sum_product, multiply ve calculate; formatlama için format_number ve format_date; tarih/saat işlevleri için today, now, year, month, day ve time. Değerler HTML açısından güvenli şekilde kullanılır; doldurulmayan yer tutucular yok sayılır.
Bilmem gereken sınırlamalar nelerdir?
PDF, API'nin tek çıktı formatıdır. Corporate planından itibaren mevcut olan yeni motoru kullanan şablonlar yalnızca {{#if}} gibi koşulları değerlendirir; diğer şablonlarda her iki dal da PDF sonucuna ulaşır. Varsayılan olarak, hesaplama yardımcıları sayıları Alman formatında (1.234,56) ve tarihleri varsayılan olarak GG.AA.YYYY formatında çıktı verir. Varsayılan yazı tipi Japonca, Çince veya Korece karakterler içermez.
Bir zorunlu alan eksikse ne olur?
Bir alan variables_schema.required içinde yer alıyorsa ve eksik veya boşsa, API 400 MISSING_REQUIRED_VARIABLES yanıtını verir ve eksik alanları belirtir. Belge oluşturulmaz ve hiçbir hesaplama yapılmaz.
PDF nereye kaydedilir?
PDF. Belirttiğiniz Workspace içinde, bir yükleme gibi davranmanız gerekir. Orada yükleme yetkisine ihtiyacınız vardır. Workspace içinde bir AI-DMS otomasyonu ayarlanmışsa, bu da her yeni belgeyi işler.
Belge oluşturma işlemini MCP kullanarak gerçekleştirebilir miyim?
Evet. Yedi araç mevcuttur: po_documents_create_from_content, po_documents_create_from_template, po_templates_list, po_templates_get, po_templates_create, po_templates_update ve po_templates_delete. Örneğin, Claude şablonunuzdan bir teklif oluşturabilir. ChatGPT'de yalnızca po_documents_create_from_content mevcuttur; yani PDF, Markdown veya HTML'den alınır.
Şablonları kimler oluşturabilir ve değiştirebilir?
Ana hesap ve yöneticiler. Şablonlar, onları oluşturan hesaba aittir; alt hesaplar bunları göremez. template-delete bir şablonu devre dışı bırakır, template-update ile is_active=1 kullanıldığında şablon tekrar aktif hale gelir.
Çift belgeleri nasıl önlerim?
create-from-content isteğinde 8 ila 128 karakter arasında bir idempotency_key gönderin. Aynı istek, ikinci bir belge oluşturmadan 24 saat boyunca kaydedilen sonucu döndürür. Aynı anahtarın farklı içeriğiyle kullanılması 409 hatasına neden olur.
Belge oluşturma hangi planlarda dahildir?
Bu sayfadaki REST API ve MCP özellikleri tüm planlarda mevcuttur. Web uygulamasındaki “Belge şablonları” sayfası ve Creator Agent, Corporate planıyla başlar. Faturalandırma, oluşturulan ve depolanan her belgeye ile şablon yönetimi çağrılarına uygulanır. Workspace içindeki bir AI-DMS otomasyonu, herhangi bir yüklemede olduğu gibi ek maliyetlere yol açabilir.