Има ли възел (Node) за PaperOffice за n8n?
Не. Няма собствен възел, няма готови идентификационни данни и няма публикувани шаблони. Работите със стандартните възли HTTP Request, Webhook и клиент на MCP срещу документирания REST-API и сървъра на MCP.
Какъв ключ ми е необходим?
Генерирате го в приложението под Секция → API. За REST използвайте API ключ (poai_) или потребителски токен (po_ut_), за MCP — po_ut_, po_gt_ или OAuth 2.1; API ключовете (poai_), po_sk_ и po_pk_ се отхвърлят от сървъра на MCP. Достатъчно е потвърден имейл. API-то е налично във всички планове, включително в Free.
Как n8n разбира, че документът е готов?
Чрез абонамент за Webhook, от Professional. Абонирайте се за document.processed с производствения URL на вашия възел за Webhook. Доставката включва pofid, workspace_id, тип документ, key_fields и извлечените полета. За задачи, които n8n стартира самостоятелно, правете заявка GET /job/get/{job_id}.
Какви събития може да получава n8n?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed и document.legal_hold_released. За да проверите дали една задача API е завършила, използвайте функцията job/get.
Трябва ли моята инстанция на n8n да е публично достъпна?
За Webhooks – да. PaperOffice доставя само по http или https към публични адреси и не следва препратки (redirects). Частни адреси, localhost и хостове за метаданни са блокирани. За обаждания към REST-API и сървъра на MCP на n8n е необходим само изходящ достъп до api.paperoffice.ai и mcp.paperoffice.ai.
Мога ли да създавам абонаменти за Webhook в приложението?
Не. Абонаментите за Webhook се създават чрез API с POST /webhooks/subscribe или чрез инструмента MCP po_webhooks_subscribe. С POST /webhooks/test изпращате test.ping към вашия възел за Webhook.
Как да проверя, че изпращането идва от PaperOffice?
Всяко изпращане носи X-PaperOffice-подпис с sha256= и HMAC-SHA256 върху неформатирания текст. Секретният ключ се съдържа в отговора на абонамента. Освен това можете да поискате изпращането на собствен заглавие и да активирате Header Auth във възела на уебхука.
Може ли KI-агент да използва n8n PaperOffice?
Да, чрез клиента MCP с URL адреса на сървъра https://mcp.paperoffice.ai/dms и транспорт Streamable HTTP или SSE. Удостоверяването става чрез OAuth 2.1 или токен po_ut_ или po_gt_. Кой инструменти са налични зависи от вашия план.
Може ли n8n да изпраща бизнес данни на PaperOffice?
Да, от Plus. Под Knowledge Base AI създавате бизнес източник на данни от тип Push (URL за поглъщане). n8n изпраща поръчки, пратки, фактури или оферти като JSON, най-много 500 записа на повикване и 60 повиквания на 10 минути на източник. Чатът за уебсайт и Conversation Agent четат тези данни от Professional и не връщат нищо обратно.
Има ли ограничения за повикванията?
Да. Във всеки план са възможни поне 5 извиквания в секунда, 30 в минута, 100 в час и 500 на ден — в тарифа Free на ключ, в платените тарифи на акаунт. Докато има налични Credits, в платените тарифи не се прилагат лимити за честота. Заявките за статус чрез GET /job/get не се броят.
Възможно ли е също с Make или Zapier?
Да, по същия модел: в Make с HTTP модула, в Zapier с Custom Request срещу REST-API, за KI-агенти с клиент MCP срещу https://mcp.paperoffice.ai/dms. Собствени приложения или модули за Make и Zapier няма.
Къде се намират данните?
Документите, които n8n изпраща на PaperOffice, се обработват от PaperOffice във собственото му европейско дата център. Това, което n8n съхранява само, се намира там, където работи вашият екземпляр на n8n, независимо дали е самостоятелно опериран или в облака на n8n.