Există un nod PaperOffice pentru n8n?
Nu. Nu există un nod dedicat, nu există credențiale preconfigurate și nici șabloane publicate. Lucrați cu nodurile standard HTTP Request, Webhook și MCP Client împotriva REST-ului documentat API și a serverului MCP.
Cheia de care aveți nevoie?
Generați-l în aplicație la secțiunea Cont → API. Pentru REST utilizați o cheie API (poai_) sau un token de utilizator (po_ut_), pentru MCP utilizați po_ut_, po_gt_ sau OAuth 2.1; serverul MCP respinge cheile API (poai_), po_sk_ și po_pk_. Un e-mail confirmat este suficient. API-ul este disponibil în toate planurile, inclusiv în Free.
Cum învață n8n că un document este gata?
Prin intermediul unei abonări webhook, de la Professional. Vă abonați la document.processed cu URL-ul de producție al nodului dumneavoastră Webhook. Livrarea conține pofid, workspace_id, tipul documentului, key_fields și câmpurile extrase. Pentru job-urile pe care n8n le inițiază singur, puteți interoga GET /job/get/{job_id}.
Ce evenimente poate primi 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 și document.legal_hold_released. Puteți verifica sfârșitul unui job API prin job/get.
Instanța dumneavoastră n8n trebuie să fie accesibilă public?
Pentru webhook-uri, da. PaperOffice livrează exclusiv prin http sau https către adrese publice și nu urmează redirecționări. Adresele private, localhost și gazdele de metadate sunt blocate. Pentru apelurile către REST API și serverul MCP, n8n are nevoie doar de acces outbound către api.paperoffice.ai și mcp.paperoffice.ai.
Pot crea abonări webhook în aplicație?
Nu. Abonamentele de webhook se creează prin intermediul API cu POST /webhooks/subscribe sau cu instrumentul MCP po_webhooks_subscribe. POST /webhooks/test trimite un test.ping către nodul dumneavoastră Webhook.
Cum pot verifica dacă o livrare provine de la PaperOffice?
Fiecare livrare include semnătura X-PaperOffice-Signature cu sha256= și HMAC-SHA256 aplicată corpului brut. Secretul este furnizat împreună cu răspunsul la abonare. De asemenea, puteți configura trimiterea propriului antet și activa autentificarea prin antet în nodul Webhook.
Poate un agent AI din n8n să utilizeze PaperOffice?
Da, prin clientul MCP cu URL-ul serverului https://mcp.paperoffice.ai/dms și transportul HTTP Streamable sau SSE. Autentificarea se realizează prin OAuth 2.1 sau un token po_ut_ sau po_gt_. Instrumentele disponibile depind de planul dumneavoastră.
Poate n8n să transmită date de afaceri către PaperOffice?
Da, din Plus. În cadrul Knowledge Base AI creați o sursă de date de afaceri de tipul Push (URL de ingestie). n8n trimite comenzi, expediții, facturi sau cotații sub formă de JSON, maxim 500 înregistrări per apel și 60 apeluri la 10 minute per sursă. Chat-ul pe site și Conversation Agent citesc aceste date din Professional și nu scriu nimic înapoi.
Există limite pentru apeluri?
Da. În fiecare plan sunt posibile cel puțin 5 apeluri pe secundă, 30 pe minut, 100 pe oră și 500 pe zi – în tarifului Free per cheie, în tarifele plătite per cont. Atâta timp cât există Credits, nu se aplică limite de rată în tarifele plătite. Interogările de status prin GET /job/get nu sunt numărate.
Funcționează acest lucru și cu Make sau Zapier?
Da. Pentru Make, există aplicația oficială PaperOffice AI cu pașii săi proprii, de exemplu pentru datele facturilor, verificarea duplicatelor și înnegrirea; aplicația Zapier este în curs de revizuire. Power Automate, Pipedream și Activepieces funcționează ca n8n cu acțiunea HTTP și webhook către serverul REST-API. Agenții AI utilizează peste tot serverul MCP https://mcp.paperoffice.ai/dms.
Unde sunt stocate datele?
Documentele pe care n8n le trimite către PaperOffice sunt procesate în propriul nostru centru de date din UE. Ceea ce n8n stochează în mod autonom rămâne acolo unde rulează instanța dumneavoastră n8n, fie pe gazdă proprie, fie în Cloud-ul n8n.