Anlık Bağlantı Kurulumu▾
Anlık Bağlantı

Anlık Bağlantı Kurulumu

Anlık bağlantı: BT ekibinizin yayınladığı dört uçlu HTTPS servisi MutabakatAI çağırır. API anahtarı gerekmez.

Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0

BT ekibiniz ERP'nin önüne dört uçlu bir HTTPS servis koyar. Muhasebe personeli panelde "ERP'den getir" dediğinde MutabakatAI bu servisi imzalı olarak çağırır; veri birkaç saniye içinde panele gelir. Bu yöntem için API anahtarı gerekmez.

API anahtarı gerekmez
Bu yöntemde kimlik doğrulama paylaşılan sır ve HMAC imzasıyla yapılır. Profil → Entegrasyon sekmesinde API anahtarı üretmeniz ya da kapsam seçmeniz gerekmez. Servis sözleşmesi, imza kuralı ve örnek kod bu yöntem için gereken tüm bilgidir.

Kurulum adımları

  1. 1
    Servisi yazın

    Dört ucu (/ping, /counterparties?q=, /statements, /balances) ERP sorgularınızla dolduran bir HTTPS servis yazın. Her istek X-MutabakatAI-Timestamp ve X-MutabakatAI-Signature başlıklarıyla gelir; imzayı paylaşılan sırla doğrulayın (±300 sn). /statements ucunu sayfalı yazın (page_size + cursor → next_cursor): büyük muavinler (yüz binlerce satır) tek yanıta sığmaz; sayfalama uygulamayan servis en çok 20.000 satırlık ekstre verebilir. Node, C# ve Python örnekleri kopyalanıp ERP sorgusu yerleştirilerek kullanılabilir.

  2. 2
    Yayınlayın

    Servis herkese açık bir alan adında HTTPS ile erişilebilir olmalıdır (VPN arkasındaysa ters vekil ya da tünel kullanın). MutabakatAI'nın sabit çıkış IP'si yoktur; kimlik imzayla doğrulanır. Sırrı 16–256 karakter uzunluğunda rastgele seçin ve yalnız firma sahibine iletin.

  3. 3
    Panelde kaydedin ve test edin

    Firma sahibi panelde Profil → Entegrasyon → "ERP'den veri getirme yöntemi" → Anlık bağlantı seçer; bağlayıcı adresini ve sırrı girer; Bağlantıyı test et düğmesine basar. "Bağlı" rozeti ve ERP adı görünüyorsa kurulum tamamlanmıştır.

  4. 4
    Kullanın

    Muhasebe personeli panelde: Ekstre sihirbazı → "İki Ekstreyi de Ben Yüklerim" → çerçeve (ad, taraflar, para birimi) → Ekstreler adımında "Şirketiniz ekstresi" kartında ERP'den getir → cari arama (ERP'den canlı) → dönem → kart "hazırlanıyor" gösterir, ekstre arka planda sayfa sayfa çekilir ve hazır olunca karta dosya olarak gelir (bu arada karşı tarafın Excel dosyası yüklenebilir) → Başlat. Bakiye sihirbazı → "ERP'den" → dönem tarihi → Bakiyeleri getir → Firmalar → Gönder.

Nasıl çalışır

Muhasebe personeli panelde "ERP'den getir" dediğinde sunucu, panelde kayıtlı adrese imzalı bir GET isteği gönderir; yanıt doğrudan sihirbaza gelir. ERP'ye özgü sorgu (SAP FBL1N/FBL5N eşdeğeri, Logo SQL, Mikro cari hareket tablosu) servisin içinde kalır; MutabakatAI ERP'nin kendisine bağlanmaz. Servis sözleşmesi ve imza kuralı için Servis sözleşmesi sayfasına bakın.

Akış — ekstre

Anlık bağlantı — ekstre (MutabakatAI servisinizi çağırır)

Muhasebe personeli ekstre sihirbazının "Şirketiniz ekstresi" kartında cari arar ve dönemi seçer; MutabakatAI BT ekibinin yayınladığı servisi imzalı çağırır, ekstre saniyeler içinde karta dosya olarak gelir.

Muhasebe (panel)MutabakatAIBT'nin bağlayıcıservisilistesatırlar"Şirketiniz ekstresi" →"ERP'den getir" → cari araİmzalı istekGET {taban}/counterparties?q=ERP'de arar,listeyi dönerCari + dönem seç→ "Ekstreyi getir"İmzalı istekGET {taban}/statementsDönem hareketlerinidöner (JSON satırlar)Satırlar → şablon Excel→ karta dosya olarak otururKarşı taraf Excel'iniyükle → Başlat (iş açılır)Karşılaştırma sonucu(ENTEGRASYON rozeti)
Şemayı büyüt
adım karar başla / bit not isteğe bağlı / geri dönüş

Akış — bakiyeler

Anlık bağlantı — bakiyeler (MutabakatAI servisinizi çağırır)

Dönem sonu tarihi seçilir; MutabakatAI tüm cari bakiyelerini servisinizden çeker, taslak kampanya hazırlar; muhasebe personeli gözden geçirip gönderir.

Muhasebe (panel)MutabakatAIBT'nin bağlayıcıservisibakiyelerBakiye sihirbazı → dönem→ "Bakiyeleri getir"İmzalı istekGET {taban}/balances?period_date=&currency=Tüm cari bakiyelerinidöner (tutar, yön, e-posta)Rehbere upsert;taslak + kayıtlarAynı dönem yeniden getirilirsebakiye/yön yenilenir, e-postakorunur; tekrarlı cari → retFirmalar: e-posta eksiklerinitamamla → Önizleme → GönderKampanya aktif(ENTEGRASYON rozeti)
Şemayı büyüt
adım karar başla / bit not isteğe bağlı / geri dönüş