PaperOffice AI'de Entegrasyonlar: Kapsamlı Kılavuz

Genel Bakış: Hangi bağlantı size uygun?

• n8n, Make ve Zapier gibi otomasyon platformları: API anahtarı ile REST API ve webhooklar aracılığıyla. n8n ayrıca PaperOffice MCP sunucusunu da kullanabilir.
• ERP ve muhasebe sistemleri: Holded ve JTL-Wawi için hazır bağlantılar, siparişleri, faturaları ve fiyatları operasyonel kaynak olarak yansıtır.
• Taşıyıcılar: GLS, DB Schenker ve DHL için hazır bağlantılar, kargo durumunu çeker.
• Veri hizmetleri: KDV numarası doğrulama, döviz kurları, coğrafi kodlama ve haritalar; uygulamada ve API aracılığıyla kullanılabilir.

Operasyonel kaynaklar, Plus planından itibaren mevcut olan Knowledge Base AI'ün bir parçasıdır. Müşteri sipariş durumu gibi müşteri verilerini yalnızca müşteri kimliğini kanıtladıktan sonra paylaşır.

n8n, Make ve Zapier

Bu araçların standart yapı bloklarını kullanırsınız: REST API'ye HTTP istekleri ve webhooklar.

1. API Anahtarları sayfasında bir anahtar oluşturun ve bunu HTTP düğümünde bearer token olarak girin.
2. Örneğin yükleme veya arama yapmak için REST API'yi çağırın. Uç noktalar API Dokümantasyonu'nda yer alır.
3. Sonuçları almak için Workflow AI → Workflow Agents'nı açın, kaydedilmiş bir ajanı düzenleyin ve Webhooklar sekmesini seçin.
4. Webhook Hedefi Ekleyin'ye tıklayın ve n8n, Make veya Zapier'den gelen webhook adresini Hedef URL olarak girin.
5. Gönderim koşulları altında İşlem başarıyla tamamlandı, İşlem başarısız oldu veya her ikisini birden seçin.

• İnsan incelemesi için akışınız bir inceleme görevi oluşturur ve webhook bekler. task.completed olayı kararı bildirir.
• PaperOffice'den gelen webhooklar X-PaperOffice-Signature başlığında imzalanır. Akışınızda imzayı kontrol edin.
• {trigger.pofid} gibi yer tutucular yol, sorgu ve başlıklarda izinlidir; ana makine adında izinli değildir.
• İş akışı ajanlarındaki webhook hedefleri Professional planından itibaren mevcuttur. Her başarılı webhook teslimi ücretlidir ve API çağrıları ücretlidir.

Holded

PaperOffice, Holded'dan iletişim bilgileriyle satış siparişlerini, faturaları, iade faturalarını ve ürünleri okur ve bunları operasyonel kaynak olarak yansıtır. Yansıma salt okunurdur. Yalnızca ek dosyalar Holded'a gönderilir; bunun için ayrı bir onay ve yazma erişimi olan ayrı bir anahtar gerekir.

1. Knowledge Base AI → Operasyonel kaynaklar'ı açın ve Kaynak ekle'ye tıklayın. Bağlantı olarak Holded'u seçin.
2. Bağlantı sekmesinde Holded API anahtarınızı girin.
3. İsteğe bağlı: Belgeler için bir çalışma alanı seçin ve faturaları, iade faturalarını veya satış siparişlerini işaretleyin. PDF dosyalama yalnızca kaydettikten sonraki yeni belgeleri kapsar.
4. İsteğe bağlı: Holded'e ek dosya gönderimini etkinleştirin (ücretli) ve yazma erişimi olan Holded API anahtarını girin.
5. Kanıt sekmesinde müşterilerin kimliklerini nasıl doğrulayacağınıza karar verin ve kaydedin.

Bir belgeyi eklemek için belgenizi açın, Holded'da ekle'ye tıklayın ve hedefi onaylayın. PaperOffice, belge numarasına göre hedefi bulur; birden fazla eşleşme veya hiç eşleşme yoksa hiçbir şey gönderilmez. Dosyalar en fazla 10 MB olabilir ve eklenen belgeler tekrar gönderilmez. Veri çekme, dosyalama ve eklemeler ücretlidir.

JTL-Wawi

PaperOffice, resmi JTL API aracılığıyla JTL-Wawi'den siparişleri, takip numaralı teslimat fişlerini ve fiyatlı kalemleri okur. Bağlantı salt okunurdur; JTL-Wawi'de hiçbir değişiklik yapılmaz.

1. Knowledge Base AI → Operasyonel kaynaklar'ı açın, Kaynak ekle'ye tıklayın ve bağlantı olarak JTL-Wawi'yi seçin.
2. Bağlantı sekmesinde JTL Cloud veya yerel JTL-Wawi'yi seçin. JTL Cloud için kiracı kimliğini girin; yerel kurulum için HTTPS adresini ve uygulama kaydından alınan API anahtarını girin.
3. Önizleme için gerçek bir sipariş numarası girin ve Kanıt sekmesinden kanıtı seçin.
4. Önizleme sekmesinde Kaydetmeden önizle'ye tıklayın, ardından kaydedin ve Şimdi senkronize et ile ilk eşitlemeyi başlatın.

Yerel kurulumda JTL-Wawi'nin standart 443 portunda açık bir HTTPS adresine ihtiyacı vardır; iç ağ adresleri ve HTTP engellenir. Hesabınızda JTL Cloud'un zaten etkin olup olmadığını destek ekibiyle kontrol edin. Üst üste üç başarısız çekme denemesinden sonra kaynak otomatik olarak duraklatılır. Çekme işlemleri ücretlidir.

GLS, DB Schenker ve DHL ile kargo takibi

Müşteriler "Paketim nerede?" diye sorduğunda, PaperOffice GLS, DB Schenker veya DHL'den gönderi durumunu alır. Taşıyıcıyla kendi kimlik bilgilerinizin bulunması gerekmektedir.

1. Knowledge Base AI → Operasyonel kaynaklar'ı açın, Kaynak ekle'ye tıklayın ve GLS (faz 2), Schenker (faz 2) veya DHL türünü seçin.
2. Bağlantı sekmesinde kimlik bilgilerinizi girin: GLS için ShipIT adresi, kullanıcı adı ve şifre; DB Schenker için erişim anahtarı; DHL için API anahtarı.
3. Önizleme için gerçek bir takip numarası girin, kanıtı seçin, önizlemeyi kontrol edin ve kaydedin.
4. Senkronizasyon sekmesinde Şimdi senkronize et'ye tıklayın.

Sonraki eşitlemeler mevcut takip numaralarını otomatik olarak okur. Müşterilere SMS veya e-posta ile gönderilen durum mesajları yalnızca gerçek bir durum değişikliğinde ve yalnızca Mesajlar sekmesinden etkinleştirirseniz gönderilir; varsayılan olarak kapalıdır. SMS ücretlidir.

Veri hizmetleri: KDV numarası, döviz kurları, coğrafi kodlama ve haritalar

PaperOffice, dört veri hizmeti sunar: AB VIES sistemiyle KDV numarası kontrolleri, para birimi dönüşümüyle döviz kurları, coğrafi kodlama ve haritalar. Bunları tüm planlarda bulunan Data AI Playground'de uygulamada deneyebilir ve kendi sistemlerinizde REST API veya MCP bağlayıcısı aracılığıyla kullanabilirsiniz. API istekleri ücretlidir.

• KDV numarası: Kontrol VIES üzerinden yapılır ve API aracılığıyla ayrıca 100 numaraya kadar toplu olarak da çalışır. 27 AB ülkesi için KDV oranları da mevcuttur.
• AI-DMS Ultra ile, PaperOffice her belge için tedarikçinin KDV numarasıni VIES üzerinden otomatik olarak kontrol eder. Bu hizmet ücretlidir.
• Coğrafi kodlama: Adresten koordinatlara, koordinattan adrese ve adres önerileri; API aracılığıyla ayrıca 1.000 adrese kadar toplu olarak.
• Haritalar: Analytics AI → Gönderen Haritası altında, AI-DMS belgelerinizi işledikten sonra belgelerinizin göndericilerini harita üzerinde görürsünüz. Analytics AI, Corporate planından itibaren mevcuttur.

Sıkça sorulan sorular

• Hazır bir n8n düğümü var mı? n8n'i HTTP istekleri, webhook'lar veya MCP istemcisi aracılığıyla bağlarsınız.
• PaperOffice Holded veya JTL-Wawi'deki verileri değiştirir mi? JTL-Wawi salt okunurdur. Holded'de yalnızca ekler gönderilir ve bu, ayrı bir anahtarla etkinleştirildiğinde yapılır.
• Müşterilerim kanıt olmadan sipariş durumlarını görebilir mi? Hayır. Ajan, kanıt verildikten sonra müşteri verilerini paylaşır.
• Hangi taşıyıcılar destekleniyor? Şu anda GLS, DB Schenker ve DHL için hazır bağlantılar mevcuttur.
• Birden fazla KDV numarasıni aynı anda kontrol edebilir miyim? Evet, API aracılığıyla 100 numaraya kadar toplu olarak.