Logo, Mikro, Nebim ve Netsis için ERP köprüsü
Dört ERP aynı ekranı paylaşır: her adres aynı görünümü yalnızca sağlayıcıyı değiştirerek açar. Farklı olan, sağlayıcının neye ihtiyaç duyduğu ve neler yapabildiğidir; bunu platform her ERP için bildirir (ERP’ye göre farklar). Her birinin kendi adresi vardır ve sayfa başlığı ERP’nin adıdır.
| ERP | Ekran |
|---|---|
| Logo ERP | /settings/integrations/logo-rest |
| Mikro ERP | /settings/integrations/mikro |
| Nebim ERP | /settings/integrations/nebim-v3 |
| Netsis ERP | /settings/integrations/netsis-rest |
settings.manage yetkisi gerekir. Ekran şu cümlelerle açılır: “Siparişler, faturalar ve stok eşit kalsın diye kendi ERP’nizi bağlayın. ERP kimliklerini siz verirsiniz; ağınızdan çıkmazlar.” ve “Siz bağlamadan hiçbir şey olmaz.” Bir maliyet notu da ekler: “ERP lisansı veya API ücreti ERP satıcısına sizin tarafınızdan ödenir; CIQRA bunu satın almaz ve yeniden satmaz.” Platformda köprü kapalıysa ekran, yeniden açılana kadar hiçbir ERP’ye bir şey gönderilmediğini ve hiçbir ERP’den bir şey okunmadığını söyler.
ERP’ye göre farklar
Bölüm başlığı “ERP’ye göre farklar”Dört sayfa yalnızca sağlayıcıyı iletir; aşağıdaki farklar arkalarındaki sağlayıcı kaydından ve bağlayıcılardan gelir. Her bağlantı aynı şekilde başlar: taslak, deneme modu, tüm akışlar kapalı.
| Logo (Tiger 3 / Go 3, REST) | Mikro (Run / Jump / Fly) | Nebim V3 (Integrator) | Netsis (3 / Wings, NetOpenX REST) | |
|---|---|---|---|---|
| Sizin vereceğiniz kimlikler | REST istemci kimliği, REST istemci gizli anahtarı, Logo kullanıcısı, Logo parolası | API Key, API kullanıcısı, API parolası | Veritabanı adı, kullanıcı grubu, Integrator kullanıcısı, Integrator parolası | Netsis kullanıcısı ve parolası, veritabanı adı, veritabanı kullanıcısı ve parolası |
| Ayrıca gerekenler | Logo REST servisi (varsayılan port 32001), Logo Objects lisansı, firma numarası | MikroAPI servisi (port 8094 / 8084), lisansla verilen API Key, firma ve şube numarası | IIS üzerinde Nebim V3 Integrator, DBA’nızın kurduğu CIQRA Nebim sorgu paketi | NetOpenX lisansı, yalnızca yerel ağdan erişilen REST, 2.0.6.9’dan yeni bir REST sürümü, en az yetkili bir SQL hesabı |
| ERP’den ürünler | Evet, ERP’de ürün kaynağı varsa | Evet | Evet, sorgu paketi üzerinden | Evet |
| ERP’den stok | Kurulumunuzda bir stok kaynağı gerekir | Evet, depo bazında | Evet, sorgu paketi üzerinden | DBA’nın tanımladığı bir sorgu gerekir |
| ERP’den fiyatlar | Evet, satış fiyatı kaynağı varsa | Evet, bir fiyat listesi varsa | Evet, sorgu paketi üzerinden | Hayır: belgelenmiş fiyat listesi uç noktası yok |
| ERP’ye sipariş ve faturalar | Evet | Evet | Evet, sorgu paketi üzerinden | Evet, stok fişi olarak |
| ERP’ye tahsilatlar | Kurulumunuzda bir tahsilat kaynağı bulunmalı | Evet | Evet (kart ödemeleri) | Hayır: belge gövdesi doğrulanmadı |
| ERP’ye ürünler | Hayır | Evet | Hayır | Hayır |
| Sipariş iptali | Hayır | Evet | Evet | Hayır |
Diğer farklar. Firma kodu ve Şube kodu bağlantıyı oluştururken verilir; Logo firma numarasını (boşsa 1), Mikro firma ve şube numarasını (şube boşsa 0) kullanır, Mikro ayrıca bir çalışma yılı alır. Netsis, genel bir arayüzde yanıt veren REST servisini reddeder. E-belgenin durumunu geri okuyabilen yalnızca Mikro’dur; Nebim onu kendiliğinden oluşturur. Pek çok satıcı alan adı İkincil ya da Doğrulanmadı olarak işaretlidir ve kullanılmadan önce kurulumunuza karşı doğrulanır.
Bağlantının yapısı
Bölüm başlığı “Bağlantının yapısı”“CIQRA, ERP’nize kendi ağınıza kurduğunuz küçük bir ajan üzerinden ulaşır. Ajan yalnızca dışarı doğru bağlanır; port açmazsınız ve ERP kimlik bilgileriniz makinenizden çıkmaz.” Yeni bağlantı taslak olarak, deneme modunda ve tüm akışlar ile tahsilat kapalı başlar. Durumu Taslak, Bağlı, Güvenlik denetimi tarafından engellendi veya Devre dışı; modu Deneme (dry-run) veya Canlı’dır. Her şeyi durdur anahtarı bağlantıyı duraklatır; siparişler kuyrukta birikir, hiçbir şey kaybolmaz. Bağlantıyı kaldır bekleyen belgeleri tutar; ERP’nizde olan belgeler orada kalır, ERP’den hiçbir şey silinmez.
Bağlantı oluşturmak bir Ad ve isteğe bağlı olarak Firma kodu ile Şube kodu ister.
Kurulum sekmesi
Bölüm başlığı “Kurulum sekmesi”Dört numaralı bölüm:
- Köprü ajanı — CIQRA Köprü Ajanı, ERP’nize erişebilen bir makinede çalışır ve tek kullanımlık kodla eşleştirilir. Ekran ajanın bağlı olup olmadığını gösterir; Yeni eşleştirme kodu, Bu bağlantı için kullan ve İptal et eylemlerini sunar. Ajan yalnızca HTTPS ile dışarı bağlanır; port açılmaz.
- ERP kimlik bilgileri — ERP adresi (yerel ağ) dahil; “Kendi ağınızdaki bir adres olmalı; genel (internet) adresi reddedilir.” Kimlik bilgileri “ajanınıza mühürlenir, CIQRA bunları saklamaz” ve alanlar yalnızca yazılır.
- Bağlantıyı dene — “Bağlantıyı, girişi ve bir okumayı sınar. Hiçbir şey yazmaz.”
- Bu ERP neler sunuyor — Keşfet, ERP’nin sürümünü, depolarını ve hangi akışları desteklediğini okur.
Akışlar sekmesi
Bölüm başlığı “Akışlar sekmesi”“Her akışı tek tek siz açarsınız. Bir akış yalnızca ERP’niz destekliyorsa açılır.” Akışlar: ERP’den ürünler, ERP’den stok, ERP’den fiyatlar, ERP’ye siparişler, ERP’ye faturalar, ERP’ye tahsilatlar ve ERP’ye ürünler. Bunlardan ikisi toplu veri hareketi olarak işaretlidir ve siz açana kadar kapalıdır: tahsilatlar (“Para hareketi kaydıdır”) ve ERP’ye ürünler (“Toplu veri değişikliğidir”); ERP’den fiyatları açmak, “ERP’nizdeki fiyatlar müşterilerin gördüğü temel fiyat olur” diye onay ister.
Her akışta Gerçekten gönder vardır: deneme modunda “belgeler hazırlanır ve gösterilir, hiçbir şey gönderilmez” ve başarılı bir bağlantı denemesi gerekir.
Sekme ayrıca Çakışmada kim kazanır (Stok, Fiyat ile Ad, metin ve görseller için tek kaynak: ERP veya CIQRA; “CIQRA kampanya ve indirimleri ERP fiyatının üstüne uygulanır ve ERP’ye asla geri yazılmaz”) ve E-belgeyi kim keser bölümlerini içerir: ERP’m keser veya CIQRA keser. “Bir faturayı yalnızca tek taraf numaralandırabilir”; belge kesildikten sonra mod değiştirilemez.
Eşleme sekmesi
Bölüm başlığı “Eşleme sekmesi”Alan eşleme, her alan için bir satır içerir — solda CIQRA alanı, sağda ERP’nin alanı — ve bir Şablonu yükle eylemi vardır. Referans tabloları Depo, Fiyat listesi, KDV kodu, Ödeme hesabı ve Kargo anahtarlarını eşler. Örnek sipariş önizlemesi “bir siparişin göndereceği belgeyi hazırlar. Hiçbir şey gönderilmez.” ERP alan adları, köprünün kullandığı her alan adını Resmî, İkincil veya Doğrulanmadı güveniyle listeler; ekran, ikincil adların kullanılmadan önce sizdeki kuruluma karşı doğrulandığını söyler.
Senkron durumu sekmesi
Bölüm başlığı “Senkron durumu sekmesi”“Tüm akışlar tek bakışta.” Her akış Sağlıklı, Geride, İlgi gerekiyor veya Kapalı olarak, bekleyen belgelerle ve aylık belge sayısıyla gösterilir. İlgi bekleyen belgeler Yeniden dene, Düzeltildi, tekrar gönder veya Atla ile işlenir (“Atla, belgeyi göndermeden kapatır.”). Deneme önizlemeleri “Gösterilir, gönderilmez.” Son çalışmalar okunan, uygulanan ve hata sayılarını verir.