Tek giriş, tek doğru
Ürün ve stok tek sistemde tutulur; diğer paneller bu kaynaktan beslenir. Hangi sistemin ana kaynak olduğu baştan yazılı olarak belirlenir.
API & EntegrasyonAynı ürünü iki panele
Aynı ürünü iki panele
iki kez girmeyin;
sistemleriniz bağlı kalsın.
Mağazanız, muhasebe programınız, pazaryeri panelleriniz ve e-belge sağlayıcınız arasındaki veri akışını kuruyor ve çalışır tutuyoruz. Kurulum tek seferlik iştir; asıl iş, akış durduğunda bunu sizden önce görmektir.
- ✓Ürün, stok ve sipariş tek yerde girilir
- ✓Başarısız aktarım kuyruğa alınır, yeniden denenir
- ✓Son senkron zamanı ve kuyruk görünür durur
- ✓Akış durduğunda bildirim tek kanaldan gelir
Ödeme ve kargo entegrasyonları bu sayfanın kapsamı dışındadır; ikisi de kendi sayfasında anlatılıyor: Sanal POS Entegrasyonu · Kargo Entegrasyonu.
⇄ panel.magazaniz.com/entegrasyon
MağazanızKaynak
✓
✓
•
ERP · PazaryeriHedef
✓
✓
•
Alan eşleştirme
stok_adedi→quantityeşleştibarkod→barcodeeşleştiliste_fiyati→salePriceeşleştiEntegrasyon sağlığıAkış çalışıyor
Son senkron
2 dk önce
Kuyruk
0 kayıt
Yeniden denenen
1 kayıt
Yeniden denemeBaşarısız kayıt kuyrukta bekler
Sorun
Çift veri girişi bir emek değil,
bir stok meselesidir.
Ürünü mağazanıza, sonra pazaryeri paneline, sonra muhasebe programına ayrı ayrı girdiğinizde üç ayrı doğru oluşur. Sipariş yoğunlaştığında bu üç doğru birbirini tutmaz: satılmış ürün satışta kalır, iptal edilen sipariş faturalanır, stok raporu ile depo eşleşmez.
Entegrasyon bir kurulum işi olarak satılır, oysa bir bakım işidir. Bağlantı ilk gün çalışır. Asıl soru, karşı taraf bir alanı değiştirdiğinde veya servis yanıt vermediğinde bunu kimin gördüğüdür.
Akış zamanlıdır
Aktarımın hangi sıklıkla ve hangi yönde çalışacağı tanımlanır; çift yönlü akış gereken alanlar tek tek işaretlenir.
Hata sessiz kalmaz
Başarısız aktarım kuyruğa alınır, yeniden denenir; çözülmezse ilgili kayıt ve hata sebebiyle birlikte bildirilir.
Durum görünür
Son senkron zamanı, bekleyen kayıt sayısı ve son hatalar panelde görünür; akışın çalıştığını doğrulamak için bize sormanız gerekmez.
Nasıl
çalışıyoruz
Aşağıdakiler bir performans iddiası değil, çalışma biçiminin tanımıdır.
Tek kanalTalepler tek adresten alınır; sohbet dağılmaz, kayıt tek yerde kalır.
Mesai içiİş günleri 09.00–18.00 arasında yanıt verilir; SLA yalnızca Yönetilen kapsamda tanımlıdır.
Yazılı kapsamHangi alanın hangi yönde aktarılacağı eşleştirme tablosunda yazılıdır.
Kayıt altındaHer aktarım günlüğe yazılır; bir kaydın ne zaman ve neden düştüğü sonradan görülebilir.
Aktarım günlüğüSizin erişiminiz
14:02Sipariş aktarımıPazaryeri → mağazaBaşarılı
14:00Stok güncellemesiMağaza → pazaryeriBaşarılı
13:47E-arşiv faturaServis zaman aşımı · 2. denemede geçtiYeniden denendi
13:31Ürün aktarımıZorunlu alan boş: barkodBildirildi
13:15Muhasebe fişiMağaza → ön muhasebeBaşarılı
Ayrıştığımız yer
Bağlantıyı kurmak bir iş,
bağlı kalmasını sağlamak başka bir iştir.
Entegrasyonun kırıldığı an genellikle kurulum günü değildir: karşı sistem bir alan adını değiştirir, servis birkaç dakika yanıt vermez, bir üründe zorunlu alan boş kalır. Fark yaratan şey, bunun kaç gün sonra fark edildiğidir.
- 1Alan eşleştirme tablosuÜrün kodu, barkod, varyant, fiyat ve stok alanlarının hangi karşılığa gideceği yazılı olarak sabitlenir.
- 2Yön ve sıklık tanımıHer akışın tek yönlü mü çift yönlü mü olduğu ve hangi aralıkla çalışacağı baştan belirlenir.
- 3Kuyruk ve yeniden denemeGeçici hatada kayıt kaybolmaz; kuyrukta bekler ve yeniden denenir.
- 4Hata bildirimiÇözülmeyen hata, ilgili kayıt ve sebebiyle birlikte bildirilir; genel bir uyarı yerine düşen kaydın kendisi gösterilir.
- 5Karşı taraf değişince bakımServis sürümü veya alan yapısı değiştiğinde entegrasyon, bakım kapsamı dahilinde güncellenir.
Kapsam
Hangi bağlantıları kuruyoruz?
Aşağıdaki beş bağlantı türü kurulum kapsamındadır; altıncısı kurulumdan sonra devam eden iştir. Mevcut altyapınıza göre hangilerinin gerektiği analizde belirlenir.
Pazaryeri entegrasyonu
Trendyol ve Hepsiburada başta olmak üzere pazaryeri panelleriyle ürün, stok, fiyat ve sipariş aktarımı kurulur; siparişler tek panelde toplanır.
Kurulumda
ERP / muhasebe entegrasyonu
Sipariş, iade ve cari hareketlerin ön muhasebe veya ERP tarafına aktarılması sağlanır; aktarılan alanlar eşleştirme tablosunda tanımlanır.
Kurulumda
Fatura ve e-belge entegrasyonu
E-arşiv / e-fatura sağlayıcınızla bağlantı kurulur; belge siparişten üretilir, numarası ve durumu sipariş kaydına geri yazılır.
Kurulumda
SMS / e-posta servis entegrasyonu
Sipariş ve hesap bildirimleri için SMS ve e-posta sağlayıcısı bağlanır; gönderim başarısız olursa bu durum kayıt altına alınır.
Kurulumda
XML / CSV ürün aktarımı
Tedarikçi XML veya CSV kaynağından ürün, stok ve fiyat aktarımı kurulur; eşleşmeyen ve eksik alan içeren kayıtlar ayrı raporlanır.
Kurulumda
Entegrasyon sağlık izlemesi
Kurulan akışların çalışmaya devam ettiği izlenir: son senkron zamanı, kuyruktaki kayıt sayısı ve tekrarlayan hatalar takip edilip bildirilir.
Sürekli
Ödeme ve kargo entegrasyonu bu sayfanın kapsamı dışındadır. İkisinin de kendi kapsamı ve kendi sayfası var: Sanal POS Entegrasyonu ve Kargo Entegrasyonu. Aynı projede birlikte gerekiyorsa tek analizde ele alınır, tekliflendirme ayrı yapılır.
Süreç
Veri haritası çıkmadan
tek satır bağlantı yazılmaz.
Entegrasyon işlerinde en pahalı hata, hangi alanın nereye gideceği netleşmeden bağlantıya başlamaktır. Süreç bu yüzden eşleştirme tablosuyla açılır.
01
Keşif ve veri haritası
Bağlanacak sistemler, alanlar ve yönler çıkarılır; hangi sistemin ana kaynak olacağı belirlenir.
Çıktı: alan eşleştirme tablosu
02
Bağlantı ve yetkilendirme
Karşı sistemin API erişimi veya dosya kaynağı tanımlanır; anahtarlar ve yetkiler kurulur.
Çıktı: test ortamında çalışan akış
03
Test aktarımı ve doğrulama
Örnek kayıtlarla uçtan uca aktarım yapılır; eşleşmeyen ve düşen kayıtlar tek tek kapatılır.
Çıktı: doğrulanmış ilk aktarım
04
İzleme ve bakım
Akış canlıda izlenir; kuyruk, tekrarlayan hatalar ve karşı taraftaki sürüm değişiklikleri takip edilir.
Çıktı: izlenen ve bakımı yapılan akış
Takvim, karşı sistemin erişim verme süresini içermez. Pazaryeri, ERP veya e-belge sağlayıcısının API erişimi ve yetki tanımlaması onların onayına bağlıdır. Bu süre bizim tarafımızın süresine dahil değildir; erişim açıldığı anda kurulum başlar.
Kapsam seviyeleri
Hangi seviye, neyi kapsıyor?
Aşağıdaki tablo bir fiyat listesi değil, işin sınırıdır. Bağlanan sistem sayısı, revizyon hakkı ve izleme kapsamı seviyeye göre tanımlıdır; kapsam dışı talepler ek hizmet olarak ele alınır.
Bağlanan sistem
Tekil Bağlantı1sistem
Çoklu Akış3sistem
Yönetilen Entegrasyon5+sistem
Alan eşleştirme revizyonu
Tekil Bağlantı1revizyon
Çoklu Akış3revizyon
Yönetilen Entegrasyon6revizyon
Test ortamı
Tekil Bağlantı1ortam
Çoklu Akış1ortam
Yönetilen Entegrasyon2ortam
Aktarım sıklığı
Tekil BağlantıGünlük planlı aktarım
Çoklu AkışSaatlik planlı aktarım
Yönetilen EntegrasyonKuyruk üzerinden sürekli aktarım
Yeniden deneme
Tekil BağlantıElle tetiklenir
Çoklu AkışOtomatik yeniden deneme
Yönetilen EntegrasyonOtomatik yeniden deneme ve eskalasyon
Sağlık izlemesi
Tekil BağlantıAktarım günlüğü erişimi
Çoklu AkışMesai içinde izleme
Yönetilen EntegrasyonSLA tanımlı izleme
Hata bildirimi
Tekil BağlantıE-posta
Çoklu AkışE-posta ve panel bildirimi
Yönetilen EntegrasyonÖncelikli kanal, kayıt bazında bildirim
Karşı taraftaki sürüm değişikliği
Tekil BağlantıEk hizmet
Çoklu AkışBakım kapsamında
Yönetilen EntegrasyonBakım kapsamında, öncelikli
Çalışma koşulları
1
Karşı sistemin lisans ve servis ücretleri dahil değildir.
Pazaryeri komisyonu, ERP lisansı, e-belge kontörü ve SMS paketi ilgili sağlayıcıya ödenir; paket bedeli yalnızca entegrasyon ve yönetim hizmetinin karşılığıdır.
2
API erişimi sizin hesabınız üzerinden açılır.
Pazaryeri, ERP ve e-belge sağlayıcısındaki hesap ve sözleşme sizinle o kurum arasındadır; biz yalnızca bağlantıyı ve yapılandırmayı yürütürüz.
3
Revizyon hakkı akış başınadır.
Alan eşleştirmesinde yapılan değişiklikler her akış için ayrı sayılır; hak dolduktan sonraki değişiklikler ek hizmettir.
4
Talepler tek kanaldan iletilir.
İş günleri 09.00–18.00 arasında alınır; SLA yalnızca Yönetilen Entegrasyon kapsamında tanımlıdır.
5
Karşı sistem yanıt vermediğinde akış durur.
Servis kesintisi bizim kontrolümüzde değildir; bu durumda kayıt kuyrukta tutulur, yeniden denenir ve durum bildirilir.
6
Kapsam dışı talepler ek hizmettir.
Ek sistem bağlantısı, özel alan dönüşümü ve rapor geliştirmelerinin birim fiyat listesi sözleşme ekinde yer alır.
Şeffaflık
Neler dahil değil
Aşağıdakiler API ve entegrasyon kapsamında yer almıyor. Bir kısmı ayrı bir hizmet kalemi, bir kısmı karşı kurumun kararına bağlı. Hangisi olduğunu görüşmede net söylüyoruz.
- —Ödeme / sanal POS entegrasyonu — kendi kapsamı var: Sanal POS Entegrasyonu
- —Kargo firması entegrasyonu — kendi kapsamı var: Kargo Entegrasyonu
- —Pazaryeri mağaza açılışı ve onayı — başvuru ve onay ilgili pazaryerine aittir
- —ERP kurulumu, lisansı ve eğitimi — mevcut ERP'nize bağlanırız, ERP'yi kurmayız
- —Karşı sistemde geliştirme — API'si olmayan bir programın içine kod yazılmaz
- —Geçmiş verinin toplu taşınması — ayrı bir veri aktarım işi olarak değerlendirilir
Sıkça Sorulan Sorular
API ve Entegrasyon
Hakkında Merak Edilenler
Kapsam, bakım ve karşı sistem sorumluluğu konusunda en sık iletilen sorular.
Entegrasyon çift yönlü mü çalışıyor?
Akışa göre değişir ve baştan tanımlanır. Örneğin ürün ve stok genellikle mağazadan pazaryerine tek yönlü gider; sipariş ise pazaryerinden mağazaya gelir. Hangi alanın hangi yönde aktarılacağı alan eşleştirme tablosunda yazılıdır.
Karşı sistem API'sini değiştirirse ne oluyor?
Çoklu Akış ve Yönetilen Entegrasyon kapsamında bu güncelleme bakım kapsamındadır. Tekil Bağlantı kapsamında ek hizmet olarak ele alınır. Değişikliğin ne zaman geleceği karşı kuruma bağlıdır; bizim tarafımızdaki iş, değişikliği akış bozulmadan önce görmektir.
Aktarım başarısız olursa nasıl haberimiz oluyor?
Kayıt kaybolmaz: kuyruğa alınır ve yeniden denenir. Tekrar denemelerde de geçmezse, düşen kaydın kendisi ve hata sebebi ile birlikte bildirilir. Aktarım günlüğüne panelden siz de erişirsiniz.
Ödeme ve kargo entegrasyonu da bu kapsamda mı?
Hayır. İkisinin de kendi kapsamı ve kendi sayfası var: Sanal POS Entegrasyonu ve Kargo Entegrasyonu. Aynı projede birlikte gerekiyorsa tek analizde ele alınır, tekliflendirme ayrı yapılır.
Kullandığımız muhasebe programının API'si yok, yine de bağlanabilir mi?
API yoksa dosya tabanlı aktarım değerlendirilir: programın dışa/içe aktarım desteklediği XML veya CSV yapısı üzerinden akış kurulabilir. Programın kendisi bu iki yoldan hiçbirini sunmuyorsa entegrasyon kurulamaz; bunu analizde peşinen söyleriz.
Mevcut bir entegrasyonumuz var ama stoklar tutmuyor; onu inceler misiniz?
Evet. Mevcut akış denetlenir; hangi alanın hangi yönde ezildiği, hangi kayıtların sessizce düştüğü ve ana kaynağın hangi sistem olduğu tespit edilir. Bulgular yazılı verilir; düzeltmenin kapsamı ondan sonra belirlenir.
Önce sistemlerinizi çıkaralım
Hangi sistemlerin bağlanacağını
birlikte netleştirelim.
Kullandığınız panelleri, programları ve hangi verinin nereye gitmesi gerektiğini inceleyip bağlanabilir olanı ve olmayanı yazılı söylüyoruz. Gereksiz entegrasyon eklemek ikimizin de işine yaramıyor.
Mevcut sistem ve panel envanteri✓
Bağlanabilirlik kontrolü (API / XML / CSV)✓
Alan eşleştirme taslağı✓
Kapsam ve sıra önerisi✓