Onko olemassa PaperOffice:n solmua kohteelle n8n?
Ei. Omia solmuja, valmiita tunnuksia tai julkaistuja pohjia ei ole. Työskennellään standardisolmujen HTTP Request, Webhook ja MCP Client kanssa dokumentoidun REST-API:n ja MCP-palvelimen välillä.
Mikä avain tarvitaan?
Se luodaan sovelluksessa kohdasta Tili → API. REST:lle käytetään API-avainta (poai_) tai käyttäjätokenia (po_ut_), MCP:lle po_ut_:tä, po_gt_:tä tai OAuth 2.1:ta; API-avaimet (poai_), po_sk_ ja po_pk_ hylätään MCP-palvelimella. Vahvistettu sähköpostiosoite riittää. API on saatavilla kaikissa hinnoitteluasteikoissa, myös Free:ssa.
Miten n8n tietää, että dokumentti on valmis?
Webhook-tilauksen kautta, alkaen kohteesta Professional. Tilataan tapahtuma document.processed webhook-solmun tuotanto-URL:lla. Toimitus sisältää pofid:n, workspace_id:n, dokumentityypin, key_fields:t ja erotetut kentät. Tehtäville, jotka n8n käynnistää itse, kysytään GET /job/get/{job_id}.
Mitkä tapahtumat n8n voi vastaanottaa?
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 ja document.legal_hold_released. API-työn loppu tarkistetaan kohdasta job/get.
Onko n8n:n instanssin oltava julkisesti saavutettavissa?
Webhookien osalta kyllä. PaperOffice toimittaa vain http- tai https-yhteydellä julkisiin osoitteisiin eikä seuraa uudelleenohjauksia. Yksityiset osoitteet, localhost ja metatietopalvelimet on estetty. Kutsuille kohteisiin REST-API ja MCP-palvelin n8n:n tarvitsee vain lähtevän yhteyden osoitteisiin api.paperoffice.ai ja mcp.paperoffice.ai.
Voinko luoda webhook-tilauksia sovelluksessa?
MCP. Ei. Webhook-tilaukset luodaan API:n kautta POST /webhooks/subscribe-käytännöllä tai työkalulla po_webhooks_subscribe. Lähettämällä POST /webhooks/test lähetetään test.ping webhook-solmulle.
Miten varmistetaan, että toimitus tulee kohteesta PaperOffice?
Jokaiseen toimitukseen sisällytetään X-PaperOffice-allekirjoitus sha256=-arvolla ja HMAC-SHA256-algoritma alkuperäisen tekstin varassa. Salainen avain löytyy tilausta koskevasta vastauksesta. Lisäksi oma otsikko voidaan lähettää mukana, ja Webhook-solmussa Header Auth -toiminto voidaan ottaa käyttöön.
Voiko tekoälyagentti käyttää kohteessa n8n palvelua PaperOffice?
Kyllä, MCP-asiakkaan kautta palvelimella https://mcp.paperoffice.ai/dms käyttäen Streamable HTTP- tai SSE-yhteyttä. Kirjautuminen tapahtuu OAuth 2.1:n tai po_ut_- tai po_gt_-tokenin avulla. Tarjolla olevat työkalut riippuvat käytössä olevasta suunnitelmasta.
Voiko n8n lähettää liiketoimintatietoja kohteeseen PaperOffice?
Kyllä, lähteestä Plus. Lähteessä Knowledge Base AI luodaan liiketoimintatietolähde tyyppiä Push (ingest URL). n8n lähettää tilaukset, toimitukset, laskut tai tarjoukset JSON-muodossa, enintään 500 riviä kutsumiskerralla ja 60 kutsua joka 10. minuutti per lähde. Verkkosivuston chat ja Conversation Agent lukivat nämä tiedot lähteestä Professional eivätkä kirjoita niihin takaisin.
Onko kutsuille rajoituksia?
Kyllä. Jokaisessa tariffissa vähintään 5 kutsua sekunnissa, 30 minuutissa, 100 tunnissa ja 500 päivässä on mahdollista – Free-tariffissa avainta kohden, maksullisissa tarifeissa tiliä kohden. Kunnes Credits on saatavilla, nopeusrajoituksia ei sovelleta maksullisissa tarifeissa. Status-kyselyt GET /job/get:lla eivät sisälly laskentaan.
Onko tämä mahdollista myös kohteessa Make tai Zapier?
Kyllä, saman kaavan mukaisesti: kohteessa Make HTTP-moduulin kautta, kohteessa Zapier Custom Request -toiminnolla kohdetta REST-API vasten, ja tekoälyagenteille MCP-asiakkaan kautta palvelimella https://mcp.paperoffice.ai/dms. Omia sovelluksia tai moduuleja kohteille Make ja Zapier ei ole olemassa.
Missä tiedot sijaitsevat?
Dokumentit, jotka n8n lähettää kohteeseen PaperOffice, käsitellään kohteessa PaperOffice sen omassa EU-tietokeskuksessa. Se, mitä n8n itse tallentaa, sijaitsee siellä, missä n8n:n instanssi toimii, olipa se itse ylläpidetty tai n8n:n pilvipalvelussa.