Czy istnieje do tego interfejs w aplikacji?
Tak, dla szablonów: zaczynając od planu Corporate, aplikacja internetowa oferuje stronę „Szablony dokumentów”. Można tam tworzyć szablony, podglądać je oraz przywracać wcześniejsze wersje. Dokumenty generowane są za pośrednictwem REST API, poprzez MCP z asystenta AI lub w aplikacji internetowej z użyciem Creator Agent. Gotowe PDF znajdują się następnie w wybranym Workspace.
Jaka jest różnica między create-from-content a create-from-template?
create-from-content renderuje Markdown lub HTML, który zostaje przesłany, zawsze jako dokument A4 w orientacji pionowej z domyślnymi marginesami. create-from-template wypełnia zapisany szablon zmiennymi i wykorzystuje jego format strony, marginesy oraz nagłówki i stopki.
Jakie istnieją placeholdery i pomocniki?
{{variable}} dla wartości, {{#each lista}} dla list z {{@index}} i {{@number}}, sum, sum_product, multiply oraz calculate do obliczeń, format_number i format_date oraz today, now, year, month, day i time. Wartości są używane w sposób bezpieczny dla HTML; nieobsadzone placeholdery są usuwane.
Jakie ograniczenia należy znać?
PDF jest jedynym formatem wyjściowym dla API. Tylko szablony z nowszym silnikiem, dostępnym w planie Corporate, oceniają warunki takie jak {{#if}}; w pozostałych szablonach obie gałęzie kończą się w PDF. Domyślnie pomocnicze funkcje obliczeniowe wypisują liczby w formacie niemieckim (1.234,56), a daty domyślnie przyjmują format DD.MM.RRRR. Domyślna czcionka nie zawiera znaków japońskich, chińskich ani koreańskich.
Co się dzieje, gdy brakuje pola obowiązkowego?
Jeśli pole znajduje się w variables_schema.required i jest puste lub nie istnieje, API odpowiada kodem 400 MISSING_REQUIRED_VARIABLES oraz wymienia brakujące pola. Nie powstaje żaden dokument i nic nie jest obliczane.
Gdzie przechowywany jest PDF?
W folderze Workspace, który podają Państwo za pomocą workspace_id, działa to tak samo jak przy przesyłaniu plików. Należy posiadać tam uprawnienia do uploadu. Jeśli w Workspace ustawiono automatyzację typu AI-DMS, przetwarza ona dokument PDF w sposób analogiczny do każdego nowego dokumentu.
Czy można korzystać z generowania dokumentów za pomocą MCP?
Tak. Dostępnych jest siedem narzędzi: po_documents_create_from_content, po_documents_create_from_template, po_templates_list, po_templates_get, po_templates_create, po_templates_update oraz po_templates_delete. Na przykład za pomocą narzędzia Claude można utworzyć wycenę z szablonu. Narzędzie ChatGPT oferuje wyłącznie opcję po_documents_create_from_content, czyli PDF z Markdown lub HTML.
Kto może tworzyć i modyfikować szablony?
Główne konto oraz administratorzy. Szablony należą do konta, które je utworzyło; podkonta ich nie widzą. Komenda template-delete dezaktywuje szablon, natomiast template-update z parametrem is_active=1 aktywuje go ponownie.
Jak uniknąć tworzenia duplikatów dokumentów?
Podczas wywołania create-from-content należy przesłać idempotency_key o długości od 8 do 128 znaków. Wówczas ta sama żądanie przez 24 godziny zwraca zapisany wynik, bez tworzenia drugiego dokumentu. Użycie tego samego klucza z inną treścią spowoduje błąd 409.
W jakich planach zawarte jest generowanie dokumentów?
Funkcje REST API oraz MCP na tej stronie są dostępne we wszystkich planach. Strona „Szablony dokumentów” w aplikacji internetowej oraz Creator Agent są dostępne od planu Corporate. Rozliczenie dotyczy każdego wygenerowanego i przechowywanego dokumentu oraz wywołań zarządzania szablonami. Automatyzacja AI-DMS w systemie Workspace może powodować dodatkowe koszty, podobnie jak w przypadku każdego przesyłania pliku.