Overview 6 Timp minim de citire

Integrări în PaperOffice AI: ghidul complet

Prezentare generală: ce conexiune se potrivește

  • Platforme de automatizare precum n8n, Make și Zapier: prin API-ul REST cu o cheie API și prin webhooks. n8n poate utiliza, de asemenea, serverul MCP PaperOffice.
  • Sisteme ERP și contabilitate: conexiuni gata făcute pentru Holded și JTL-Wawi care reflectă comenzile, facturile și prețurile ca sursă operațională.
  • Curieri: conexiuni gata făcute pentru GLS, DB Schenker și DHL care preiau starea expediției.
  • Servicii de date: verificare ID TVA, cursuri valutare, geocodare și hărți, în aplicație și prin API.

Sursele operaționale fac parte din Knowledge Base AI, care este disponibil din planul Plus. Agentul dumneavoastră de chat sau telefon partajează datele clientului, cum ar fi starea comenzii, doar după ce clientul și-a demonstrat identitatea.

n8n, Make și Zapier

Utilizați blocurile standard de construcție ale acestor instrumente: cereri HTTP către API-ul REST și webhooks.

  1. Creați o cheie pe pagina Chei API și introduceți-o în nodul HTTP ca token bearer.
  2. Apelați API-ul REST, de exemplu pentru încărcare sau căutare. Endpoint-urile se găsesc în Documentație API.
  3. Pentru a primi rezultate, deschideți Workflow AI → Workflow Agents, editați un agent salvat și selectați fila Webhook-uri.
  4. Faceți clic pe Adăugare destinație webhook și introduceți adresa webhook din n8n, Make sau Zapier ca Adresa URL țintă.
  5. Sub Trimitere la, selectați Eveniment finalizat cu succes, A eșuat execuția sau ambele.
  • Pentru o revizuire umană, fluxul dumneavoastră creează o sarcină de revizuire și așteaptă un webhook. Evenimentul task.completed raportează decizia.
  • Webhook-urile din PaperOffice sunt semnate în antetul X-PaperOffice-Signature. Verificați semnătura în fluxul dumneavoastră.
  • Șabloanele precum {trigger.pofid} sunt permise în cale, interogare și antete, nu în numele gazdei.
  • Destinațiile webhook în agenții de flux de lucru sunt disponibile din planul Professional. Fiecare livrare reușită a unui webhook este plătită, iar apelurile API sunt plătite.

Holded

PaperOffice citește comenzile de vânzare cu datele de contact, facturile, notele de credit și produsele din Holded și le reflectă ca sursă operațională. Reflectarea este doar pentru citire. Doar atașamentele se trimit la Holded, cu un opt-in separat și o cheie separată cu acces de scriere.

  1. Deschideți Knowledge Base AI → Surse operaționale și faceți clic pe Adăugare sursă. Alegeți Holded ca conexiune.
  2. Pe fila Conexiune, introduceți cheia API Holded.
  3. Opțional: alegeți un spațiu de lucru pentru documente și bifați facturile, notele de credit sau comenzile de vânzare. Arhivarea PDF acoperă doar documentele noi după ce salvați.
  4. Opțional: activați trimiterea atașamentelor la Holded (plătit) și introduceți cheia API Holded cu acces de scriere.
  5. Pe fila Dovadă, alegeți cum se identifică clienții și salvați.

Pentru a atașa un document, deschideți-l, faceți clic pe Atașați în Holded și confirmați ținta. PaperOffice găsește ținta după numărul documentului; cu mai multe potriviri sau fără niciuna, nu se trimite nimic. Fișierele pot avea până la 10 MB, iar documentele atașate nu se trimit din nou. Preluările, arhivarea și atașamentele sunt plătite.

JTL-Wawi

PaperOffice citește comenzile, avizele de livrare cu numerele de urmărire și articolele cu prețurile din JTL-Wawi prin API-ul oficial JTL. Conexiunea este doar pentru citire; nimic nu se modifică în JTL-Wawi.

  1. Deschideți Knowledge Base AI → Surse operaționale, faceți clic pe Adăugare sursă și alegeți JTL-Wawi ca conexiune.
  2. Pe fila Conexiune, selectați JTL Cloud sau JTL-Wawi on premises. Pentru JTL Cloud, introduceți ID-ul tenantului; pentru on premises, introduceți adresa HTTPS și cheia API din înregistrarea aplicației.
  3. Introduceți un număr de comandă real pentru previzualizare și selectați dovada pe fila Dovadă.
  4. Pe fila Previzualizare, faceți clic pe Previzualizare fără salvare, apoi salvați și începeți prima sincronizare cu Sincronizează acum.

Pentru JTL-Wawi on premises, este necesară o adresă HTTPS publică pe portul standard 443; adresele interne și HTTP sunt blocate. Vă rugăm să verificați cu suportul dacă JTL Cloud este deja activat pentru contul dumneavoastră. După trei încercări eșuate consecutive de preluare, sursa se pune în pauză automat. Preluările sunt plătite.

Urmărirea coletelor cu GLS, DB Schenker și DHL

Când clienții întreabă „Unde este pachetul meu?”, PaperOffice preia statusul expedierii de la GLS, DB Schenker sau DHL. Aveți nevoie de propriile acreditări cu transportatorul.

  1. Deschideți Knowledge Base AI → Surse operaționale, faceți clic pe Adăugare sursă și selectați tipul GLS (faza 2), Schenker (faza 2) sau DHL.
  2. Pe fila Conexiune, introduceți acreditările dumneavoastră: pentru GLS, adresa ShipIT, numele de utilizator și parola; pentru DB Schenker, cheia de acces; pentru DHL, cheia API.
  3. Introduceți un număr de urmărire real pentru previzualizare, selectați dovada, verificați previzualizarea și salvați.
  4. Pe fila Sincronizare, faceți clic pe Sincronizează acum.

Sincronizările ulterioare citesc automat numerele de urmărire existente. Mesajele de status către clienți prin SMS sau email sunt trimise doar la o schimbare reală a statusului și doar dacă le activați pe fila Mesaje; în mod implicit, aceasta este dezactivată. SMS-urile sunt plătite.

Servicii de date: ID TVA, cursuri valutare, geocodare și hărți

PaperOffice oferă patru servicii de date: verificări ale ID-ului TVA împotriva sistemului EU VIES, cursuri valutare cu conversie, geocodare și hărți. Le puteți testa în aplicație în secțiunea Data AI Playground, disponibilă în toate planurile, și le puteți utiliza în sistemele dumneavoastră prin API-ul REST sau conectorul MCP. Solicitările API sunt plătite.

  • ID TVA: verificarea se execută împotriva VIES, iar prin API și în loturi de până la 100 de numere. Sunt disponibile și cotele TVA pentru cele 27 de țări UE.
  • Cu AI-DMS Ultra, PaperOffice verifică automat ID-ul TVA al furnizorului împotriva VIES pentru fiecare document. Acest serviciu este contra cost.
  • Geocodare: adresă către coordonate, coordonate către adresă și sugestii de adrese, prin API și în loturi de până la 1.000 de adrese.
  • Hărți: sub Analytics AI → Harta Expeditorilor, vedeți expeditorii documentelor dumneavoastră pe o hartă odată ce AI-DMS le-a procesat. Analytics AI este disponibil din planul Corporate.

Întrebări frecvente

  • Există un nod n8n gata făcut? Conectați n8n prin solicitări HTTP, webhook-uri sau clientul său MCP.
  • Modifică PaperOffice datele în Holded sau JTL-Wawi? JTL-Wawi este doar pentru citire. În Holded, se trimit doar atașamente, și doar dacă activați această opțiune cu o cheie separată.
  • Văd clienții dumneavoastră statusul comenzii fără dovadă? Nu. Agentul partajează datele clientului doar după verificarea dovezii.
  • Ce transportatori sunt acceptați? Conexiuni gata făcute există în prezent pentru GLS, DB Schenker și DHL.
  • Pot verifica multe ID-uri TVA simultan? Da, prin API în loturi de până la 100 de numere.