Overview 7 Min. čas na přečtení

Integrace v PaperOffice AI: kompletní průvodce

Přehled: které připojení se hodí

  • Platformy pro automatizaci jako n8n, Make a Zapier: prostřednictvím REST API s klíčem API a prostřednictvím webhooků. n8n může také používat server MCP PaperOffice.
  • Systémy ERP a účetnictví: připravená připojení pro Holded a JTL-Wawi zrcadlí objednávky, faktury a ceny jako provozní zdroj.
  • Dopravci: připravená připojení pro GLS, DB Schenker a DHL načítají stav zásilky.
  • Datové služby: ověření DIČ, směnné kurzy, geokódování a mapy, v aplikaci i prostřednictvím API.

Provozní zdroje jsou součástí Knowledge Base AI, které je k dispozici od plánu Plus. Váš chatový nebo telefonní agent sdílí data zákazníka, jako je stav objednávky, pouze poté, co zákazník prokáže svou totožnost.

n8n, Make a Zapier

Používáte standardní stavební bloky těchto nástrojů: HTTP požadavky na REST API a webhooky.

  1. Vytvořte klíč na stránce API klíče a zadejte jej do uzlu HTTP jako nosič (bearer token).
  2. Volání REST API, například pro nahrání nebo vyhledávání. Koncové body jsou v Dokumentace API.
  3. Pro přijetí výsledků otevřete Workflow AI → Workflow Agents, upravte uloženého agenta a vyberte kartu Webhooky.
  4. Klikněte na Přidat cíl webhooku a zadejte adresu webhooku z n8n, Make nebo Zapier jako Cílová adresa URL.
  5. Podle Odeslat při vyberte Úspěšné dokončení běhu, Selhání běhu nebo obojí.
  • Pro lidskou kontrolu váš tok vytvoří úkol k revizi a čeká na webhook. Událost task.completed hlásí rozhodnutí.
  • Webhooky z PaperOffice jsou podepsány v záhlaví X-PaperOffice-Signature. Zkontrolujte podpis ve vašem toku.
  • Zástupné symboly jako {trigger.pofid} jsou povoleny v cestě, dotazu a záhlavích, nikoli v názvu hostitele.
  • Cíle webhooků ve workflow agentech jsou k dispozici od plánu Professional. Každé úspěšné doručení webhooku je zpoplatněno a volání API jsou zpoplatněna.

Holded

PaperOffice čte prodejní objednávky s kontaktními údaji, faktury, kreditní faktury a produkty z Holdedu a zrcadlí je jako provozní zdroj. Zrcadlo je pouze pro čtení. Pouze přílohy jdou do Holdedu, s odděleným souhlasem (opt-in) a odděleným klíčem s přístupem k zápisu.

  1. Otevřete Knowledge Base AI → Provozní zdroje a klikněte na Přidat zdroj. Vyberte Holded jako připojení.
  2. Na kartě Připojení zadejte váš klíč API Holdedu.
  3. Volitelné: vyberte pracovní prostor pro dokumenty a zaškrtněte faktury, kreditní faktury nebo prodejní objednávky. Ukládání PDF se týká pouze nových dokumentů po uložení.
  4. Volitelné: zapněte odesílání příloh do Holdedu (placené) a zadejte klíč API Holdedu s přístupem k zápisu.
  5. Na kartě Důkaz vyberte, jak se zákazníci identifikují, a uložte.

Pro připojení dokumentu jej otevřete, klikněte na Připojit v systému Holded a potvrďte cíl. PaperOffice najde cíl podle čísla dokumentu; při více shodách nebo žádné se nic neodesílá. Soubory mohou mít až 10 MB a připojené dokumenty se neodesílají znovu. Načítání, ukládání a připojení jsou zpoplatněna.

JTL-Wawi

PaperOffice čte objednávky, dodací listy s čísly sledování a položky s cenami z JTL-Wawi prostřednictvím oficiálního API JTL. Připojení je pouze pro čtení; v JTL-Wawi se nic nemění.

  1. Otevřete Knowledge Base AI → Provozní zdroje, klikněte na Přidat zdroj a vyberte JTL-Wawi jako připojení.
  2. Na kartě Připojení zvolte JTL Cloud nebo JTL-Wawi on premises. Pro JTL Cloud zadejte ID tenanta; on premises zadejte HTTPS adresu a API klíč z registrace aplikace.
  3. Pro náhled zadejte skutečné číslo objednávky a na kartě Důkaz zvolte doklad.
  4. Na kartě Náhled klikněte na Náhled bez uložení, poté uložte a spusťte první synchronizaci pomocí Synchronizovat nyní.

On premises vyžaduje JTL-Wawi veřejnou HTTPS adresu na standardním portu 443; interní adresy a HTTP jsou blokovány. Ověřte prosím u podpory, zda je pro váš účet již aktivován JTL Cloud. Po třech neúspěšných načteních za sebou se zdroj automaticky pozastaví. Načtení jsou zpoplatněna.

Sledování zásilek s GLS, DB Schenker a DHL

Když se zákazníci ptají „Kde je můj balík?“, PaperOffice načte stav zásilky od GLS, DB Schenker nebo DHL. Potřebujete vlastní přihlašovací údaje u dopravce.

  1. Otevřete Knowledge Base AI → Provozní zdroje, klikněte na Přidat zdroj a zvolte typ GLS (fáze 2), Schenker (fáze 2) nebo DHL.
  2. Na kartě Připojení zadejte své přihlašovací údaje: pro GLS adresu ShipIT, uživatelské jméno a heslo, pro DB Schenker přístupový klíč, pro DHL klíč API.
  3. Pro náhled zadejte skutečné sledovací číslo, zvolte doklad, zkontrolujte náhled a uložte.
  4. Na kartě Synchronizace klikněte na Synchronizovat nyní.

Pozdější synchronizace načítají existující sledovací čísla samy. Stavové zprávy zákazníkům prostřednictvím SMS nebo e-mailu se odesílají pouze při skutečné změně stavu a pouze pokud je zapnete na kartě Zprávy; ve výchozím nastavení jsou vypnuté. SMS jsou zpoplatněny.

Datové služby: kontrola DIČ, směnné kurzy, geokódování a mapy

PaperOffice nabízí čtyři datové služby: ověřování DIČ proti systému EU VIES, směnné kurzy s převodem, geokódování a mapy. Můžete je vyzkoušet v aplikaci v Data AI Playground, která je dostupná ve všech plánech, a používat je ve vlastních systémech prostřednictvím REST API nebo MCP konektoru. API požadavky jsou zpoplatněny.

  • DIČ: ověření probíhá proti VIES a prostřednictvím API také v dávkách až 100 čísel. K dispozici jsou také sazby DPH pro 27 zemí EU.
  • S AI-DMS Ultra automaticky kontroluje PaperOffice DIČ dodavatele proti VIES u každého dokumentu. Tato funkce je zpoplatněna.
  • Geokódování: adresa na souřadnice, souřadnice na adresu a návrhy adres, prostřednictvím API také v dávkách až 1 000 adres.
  • Mapy: v části Analytics AI → Mapa odesílatelů uvidíte odesílatele svých dokumentů na mapě, jakmile je AI-DMS zpracuje. Analytics AI je k dispozici od plánu Corporate.

Často kladené otázky

  • Existuje hotový uzel pro n8n? n8n připojíte prostřednictvím HTTP požadavků, webhooků nebo jeho MCP klienta.
  • Mění PaperOffice data v Holded nebo JTL-Wawi? JTL-Wawi je pouze pro čtení. V Holded se odesílají pouze přílohy, a to pouze pokud tuto funkci zapnete samostatným klíčem.
  • Vidí moji zákazníci stav své objednávky bez dokladu? Ne. Agent sdílí zákaznická data pouze po předložení dokladu.
  • Kteří dopravci jsou podporováni? Hotová připojení v současnosti existují pro GLS, DB Schenker a DHL.
  • Mohu zkontrolovat mnoho DIČ najednou? Ano, prostřednictvím API v dávkách až 100 čísel.