Is er een PaperOffice-node voor n8n?
Nee. Er is geen eigen node, geen kant-en-klaar credential en geen gepubliceerde sjablonen. U werkt met de standaard-knooppunten HTTP Request, Webhook en MCP Client tegen de gedocumenteerde REST-API en de MCP-server.
Welke sleutel heb ik nodig?
U maakt deze aan in de app onder Account → API. Voor REST gebruikt u po_sk_ of po_ut_, voor MCP po_ut_, po_gt_ of OAuth 2.1; po_sk_ en po_pk_ worden afgewezen door de MCP-server. Een bevestigd e-mailadres is voldoende. De API is beschikbaar in alle pakketten, ook in Free.
Hoe weet n8n dat een document klaar is?
Via een webhook-abonnement, vanaf Professional. U abonneert zich op document.processed met de productiewebhook-URL van uw webhook-knooppunt. De levering bevat pofid, workspace_id, documenttype, key_fields en de geëxtraheerde velden. Voor taken die n8n zelf start, vraagt u GET /job/get/{job_id} op.
Welke gebeurtenissen kan n8n ontvangen?
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 en document.legal_hold_released. U controleert het einde van een API taak via job/get.
Moet mijn n8n-instantie publiek bereikbaar zijn?
Voor webhooks ja. PaperOffice stuurt alleen naar openbare adressen via http of https en volgt geen omleidingen. Privé-adressen, localhost en metadata-hosts zijn geblokkeerd. Voor aanroepen naar REST-API en de MCP-server heeft n8n alleen uitgaande toegang nodig tot api.paperoffice.ai en mcp.paperoffice.ai.
Kan ik webhook-abonnementen in de app aanmaken?
Nee. Webhook-abonnementen maakt u aan via API met POST /webhooks/subscribe of via het MCP-hulpmiddel po_webhooks_subscribe. Met POST /webhooks/test stuurt u een test.ping naar uw webhook-knooppunt.
Hoe controleer ik of een levering van PaperOffice komt?
Elke levering draagt de X-PaperOffice-handtekening met sha256= en de HMAC-SHA256 over de ruwe tekst. Het geheim staat in het antwoord op het abonnement. Bovendien kunt u een eigen header laten meesturen en Header Auth inschakelen in de webhook-knoop.
Kan een KI-agent in n8n PaperOffice gebruiken?
Ja, via de MCP-client met de server-URL https://mcp.paperoffice.ai/dms en het transport Streamable HTTP of SSE. De aanmelding verloopt via OAuth 2.1 of een po_ut_- of po_gt_-token. Welke gereedschappen beschikbaar zijn, hangt af van uw plan.
Kan n8n bedrijfsgegevens naar PaperOffice sturen?
Ja, vanaf Plus. Onder Knowledge Base AI maakt u een operationele bron van het type Push (Ingest-URL) aan. n8n verzendt opdrachten, zendingen, facturen of offertes als JSON, maximaal 500 records per aanroep en 60 aanroepen per 10 minuten en bron. Chat- en telefoon-agenten lezen deze gegevens af vanaf Professional, maar schrijven niets terug.
Zijn er grenzen voor aanroepen?
Ja. Per sleutel zijn in elk plan minimaal 5 aanroepen per seconde, 30 per minuut, 100 per uur en 500 per dag mogelijk, in betaalde plannen meer. Opvraag-lussen tellen mee, plan daarom pauzes van 5 tot 10 seconden in.
Gaat dit ook met Make of Zapier?
Ja, volgens hetzelfde patroon: in Make met de HTTP-module, in Zapier met Custom Request tegen de REST-API, voor KI-agenten met een MCP-client tegen https://mcp.paperoffice.ai/dms. Eigen apps of modules voor Make en Zapier bestaan er niet.
Waar liggen de gegevens?
Documenten die n8n naar PaperOffice verzendt, verwerkt PaperOffice in het eigen EU-datacenter. Wat n8n zelf opslaat, ligt daar waar uw n8n-instantie draait, of nu zelf beheerd of in n8n Cloud.