Entegrasyon Kütüphanesi
Business Central ile B2B Portal: API, Webhook ve Senkronizasyon
Microsoft Dynamics 365 Business Central API ve webhook özellikleriyle B2B portal entegrasyonu için mimari öneriler.
- Business CentralAna kayıtlar ve ticari kurallar
- Yetkili entegrasyon servisiEşleştirme, kuyruk ve sonuç kontrolü
- Bayi portalıİzinli görünüm ve işlem talebi
Dynamics 365 Business Central ile çalışan bir B2B portalda ana mesele sadece siparişin aktarılması değildir. Değişiklikleri zamanında fark etmek, eş zamanlı talepleri yönetmek ve API sınırlamalarını aşmadan veri güncel tutmak gerekir.
API ve webhook farkı
API, portalın belirli veri veya işlemleri talep etmesini sağlar. Webhook ise desteklenen bir kaynak değiştiğinde abone sisteme bildirim ulaşmasına yardımcı olur. Microsoft'un Business Central dokümanında webhook aboneliği oluşturulurken validationToken ile bir doğrulama el sıkışması yapılması gerektiği açıklanıyor.
Bu nedenle önerilen yaklaşım her birkaç saniyede bir tüm kayıtları yeniden indirmek değil; mümkün olan olayları webhook üzerinden almak, gerekli durumda API ile kaydı ayrıntılı sorgulamaktır.
Örnek akış
- Bayi portalı kimlik ve rol denetiminden geçer.
- Kullanıcı sipariş talebini oluşturur.
- Portal, benzersiz sipariş kimliğiyle entegrasyon kuyruğuna kayıt ekler.
- Yetkili arka uç Business Central API üzerinden gerekli işlemi başlatır.
- API cevabı kaydedilir; başarısız durumda kullanıcıya yanlış başarı bilgisi verilmez.
- Desteklenen değişiklikler webhook veya kontrollü eşitleme ile portala yansır.
API sınırları neden önemli?
Microsoft, Business Central API'lerinde sınırlar ve 429 Too Many Requests yanıtı belgeliyor. Bu durumda soğuma süresi ve kontrollü yeniden deneme gerekir. Büyük veri aktarımlarını bloklar halinde yapmak ve gerekirse webhook kullanmak yükü azaltabilir.
Öncelikli testler
- Abonelik doğrulama isteği doğru yanıtlanıyor mu?
- Tekrar gelen webhook çift işlem yaratıyor mu?
- 429 alındığında işlem kaybolmadan kuyruğa dönüyor mu?
- Bir bayi yalnızca kendi ticari verilerini görüyor mu?
- Uzayan işlemlerde bekleme ve hata mesajları anlaşılır mı?
Ne zaman özel yazılım?
Standart sipariş ekranı dışında bölgesel fiyat listeleri, onay kademeleri, bayi rol hiyerarşisi ve operasyonel raporlar gerekiyorsa özel tasarım anlamlı olabilir.
Abonelik susarsa neyi kontrol etmelisiniz?
Business Central abonelikleri yenilenmezse sona erer; oluşturma ve yenilemede doğrulama yanıtı gerekir. Kaynağın webhook desteğini ve aboneliğin expirationDateTime değerini kontrol edin. Bildirim gecikebilir veya toplu değişiklik bildirimi gelebilir; bunu her kayıt için anında ve bir kez teslim garantisi gibi yorumlamayın. Microsoft webhook belgesi.
Örnek senaryo: Bir fiyat değişikliği sonrasında portalın katalog kopyası eskimiş olsun. Bildirimi alan servis önce doğrulama bilgisini denetler, işi kalıcı kayda alır, ardından gerekli kaydı API ile okur. Aynı kayıt yeniden gelirse eski veriyi yeni verinin üstüne yazmaz. Abonelik kesildiğinde son başarılı eşitlemeden sonraki değişiklikler kontrollü biçimde karşılaştırılır.
| Kontrol | Yayına çıkmadan beklenen sonuç |
|---|---|
| Yenileme başarısız | Sorumlu kişiye uyarı; sessizce güncel görünüm yok |
| Bildirim tekrarı | İkinci sipariş veya çift yan etki yok |
| Yanlış bayi kimliği | Sunucuda erişim reddi; yalnız arayüz filtresi değil |
| Uzun süre veri gelmiyor | Abonelik ve veri tazeliği ayrı kontrol edilir |
API hata ayrımı için 429 rehberi ve 504 rehberini inceleyin.
Kaynaklar ve doğrulama
Örnek akışlar mimari öneridir; tamamlanmış müşteri projesi veya üretici iş ortaklığı iddiası değildir. Teknik kaynak kontrolü: 17 Ekim 2026. Kurulumun sürümü, lisansı ve izinleri ayrıca doğrulanır.
İşletmenizdeki akışa uyarlayın
ERP entegrasyonu planlama rehberi. B2B portal geliştirme kapsamını inceleyebilir, mevcut sürecinizi birlikte değerlendirebiliriz.
İhtiyacınızı konuşalım →