Overview 6 Min. vreme čitanja

Integracije u PaperOffice AI: kompletni vodič

Pregled: koja veza odgovara

  • Platforme za automatizaciju poput n8n, Make i Zapier: putem REST API-ja sa API ključem i putem webhookova. n8n takođe može koristiti PaperOffice MCP server.
  • ERP i računovodstveni sistemi: gotove veze za Holded i JTL-Wawi preslikavaju porudžbine, račune i cene kao operativni izvor.
  • Kurirske službe: gotove veze za GLS, DB Schenker i DHL preuzimaju status pošiljke.
  • Servisi podataka: provera PDV ID-a, kursne liste, geokodiranje i mape, u aplikaciji i putem API-ja.

Operativni izvori su deo Knowledge Base AI, koji je dostupan od Plus plana. Vaš chat ili telefonski agent deli podatke o kupcu, kao što je status porudžbine, tek nakon što je kupac dokazao svoj identitet.

n8n, Make i Zapier

Koristite standardne blokove ovih alata: HTTP zahteve ka REST API-ju i webhookove.

  1. Kreirajte ključ na stranici API ključevi i unesite ga u HTTP čvor kao bearer token.
  2. Pozovite REST API, na primer za otpremanje ili pretragu. Krajnje tačke su u API dokumentacija.
  3. Da biste primili rezultate, otvorite Workflow AI → Workflow Agents, uredite sačuvanog agenta i izaberite karticu Webhookovi.
  4. Kliknite na Dodajte cilj webhooka i unesite adresu webhooka iz n8n, Make ili Zapier kao Ciljna URL adresa.
  5. U sekciji Pošaljite kada, izaberite Pokretanje uspešno završeno, Pokretanje neuspešno ili oba.
  • Za ljudsku proveru, Vaš tok kreira zadatak za proveru i čeka webhook. Događaj task.completed izveštava o odluci.
  • Webhookovi iz PaperOffice su potpisani u zaglavlju X-PaperOffice-Signature. Proverite potpis u Vašem toku.
  • Placeholderi poput {trigger.pofid} su dozvoljeni u putanji, upitu i zaglavljima, ali ne i u imenu hosta.
  • Odredišta webhookova u workflow agentima dostupna su od Professional plana. Svaka uspešna isporuka webhooka se naplaćuje, a pozivi API-ja se takođe naplaćuju.

Holded

PaperOffice čita prodajne porudžbine sa kontakt detaljima, račune, kreditne fakture i proizvode iz Holdeda i preslikava ih kao operativni izvor. Preslikavanje je samo za čitanje. Samo privitci se šalju u Holded, uz odvojenu saglasnost i odvojeni ključ sa dozvolom za pisanje.

  1. Otvorite Knowledge Base AI → Operativni izvori i kliknite na Dodajte izvor. Izaberite Holded kao vezu.
  2. Na kartici Veza, unesite Vaš Holded API ključ.
  3. Opciono: izaberite radni prostor za dokumenta i označite račune, kreditne fakture ili prodajne porudžbine. Slanje PDF-ova pokriva samo nova dokumenta nakon što sačuvate postavke.
  4. Opciono: uključite slanje privitaka u Holded (naplaćeno) i unesite Holded API ključ sa dozvolom za pisanje.
  5. Na kartici Dokaz, izaberite kako se kupci identifikuju i sačuvajte.

Da biste dodali dokument, otvorite ga, kliknite na Priložite u Holdedu i potvrdite odredište. PaperOffice pronalazi odredište po broju dokumenta; sa više podudarnosti ili bez njih, ništa se ne šalje. Datoteke mogu biti do 10 MB, a povezani dokumenti se ne šalju ponovo. Preuzimanja, arhiviranje i povezivanje su naplaćeni.

JTL-Wawi

PaperOffice čita porudžbine, dostavnice sa brojevima za praćenje i stavke sa cenama iz JTL-Wawi putem zvaničnog JTL API-ja. Veza je samo za čitanje; ništa se ne menja u JTL-Wawi.

  1. Otvorite Knowledge Base AI → Operativni izvori, kliknite na Dodajte izvor i izaberite JTL-Wawi kao vezu.
  2. Na kartici Veza izaberite JTL Cloud ili JTL-Wawi on premises. Za JTL Cloud unesite ID tenanta; on premises unesite HTTPS adresu i API ključ iz registracije aplikacije.
  3. Unesite stvarni broj porudžbine za pregled i izaberite dokaz na kartici Dokaz.
  4. Na kartici Pregled kliknite Pregled bez čuvanja, zatim sačuvajte i pokrenite prvu sinhronizaciju pomoću Sinhronizuj odmah.

On premises, JTL-Wawi zahteva javnu HTTPS adresu na standardnom portu 443; interne adrese i HTTP su blokirani. Molimo Vas da proverite sa podrškom da li je JTL Cloud već omogućen za Vaš nalog. Nakon tri uzastopna neuspešna preuzimanja, izvor se automatski pauzira. Preuzimanja se naplaćuju.

Praćenje pošiljki sa GLS, DB Schenker i DHL

Kada kupci pitaju „Gde je moja pošiljka?“, PaperOffice preuzima status pošiljke od GLS-a, DB Schenker-a ili DHL-a. Potrebni su Vam sopstveni akreditivi kod prevoznika.

  1. Otvorite Knowledge Base AI → Operativni izvori, kliknite na Dodajte izvor i izaberite tip GLS (faza 2), Schenker (faza 2) ili DHL.
  2. Na kartici Veza unesite svoje akreditive: za GLS ShipIT adresu, korisničko ime i lozinku, za DB Schenker ključ za pristup, za DHL API ključ.
  3. Unesite stvarni broj za praćenje za pregled, izaberite dokaz, proverite pregled i sačuvajte.
  4. Na kartici Sinhronizacija kliknite Sinhronizuj odmah.

Kasnije sinhronizacije same očitavaju postojeće brojeve za praćenje. Statusne poruke kupcima putem SMS-a ili e-pošte šalju se samo pri stvarnoj promeni statusa i samo ako ih uključite na kartici Poruke; podrazumevano je to isključeno. SMS poruke se naplaćuju.

Servisi podataka: PDV ID, kursevi valuta, geokodiranje i mape

PaperOffice nudi četiri servisa podataka: provere PDV ID-a prema EU VIES sistemu, kurseve valuta sa konverzijom, geokodiranje i mape. Možete ih isprobati u aplikaciji u Data AI Playground, koji je dostupan u svim planovima, i koristiti ih u sopstvenim sistemima putem REST API-ja ili MCP konektora. API zahtevi se naplaćuju.

  • PDV ID: provera se vrši prema VIES-u, a putem API-ja i u serijama do 100 brojeva. Stope PDV-a za 27 zemalja EU su takođe dostupne.
  • Sa AI-DMS Ultra, PaperOffice automatski proverava PDV ID dobavljača prema VIES-u za svaki dokument. Ovo se naplaćuje.
  • Geokodiranje: adresa u koordinate, koordinate u adresu i predlozi adresa, putem API-ja i u serijama do 1.000 adresa.
  • Mape: pod Analytics AI → Mapa pošiljalaca, vidite pošiljaoce Vaših dokumenata na mapi kada ih AI-DMS obradi. Analytics AI je dostupan od Corporate plana.

Često postavljana pitanja

  • Da li postoji gotov n8n čvor? Povezujete n8n putem HTTP zahteva, webhookova ili njegovog MCP klijenta.
  • Da li PaperOffice menja podatke u Holded-u ili JTL-Wawi-ju? JTL-Wawi je samo za čitanje. U Holded-u se šalju samo prilozi, i to samo ako to uključite posebnim ključem.
  • Da li moji kupci vide status svoje porudžbine bez dokaza? Ne. Agent deli podatke o kupcima tek nakon dokaza.
  • Koji prevoznici su podržani? Gotove veze trenutno postoje za GLS, DB Schenker i DHL.
  • Mogu li da proverim mnogo PDV ID-ova odjednom? Da, putem API-ja u serijama do 100 brojeva.