Dynamics 365 Business Central entegrasyonu

ModernMES, Microsoft Dynamics 365 Business Central'dan kalem ve müşteri kartlarını standart API v2.0 ile okur; biten işi ve fireyi kalem günlüğü satırı olarak gönderir. Bir şartı var: Business Central'ın standart API'sinde kalem günlüğü bulunmadığı için üretim girişi, iş ortağınızın yayımlayacağı küçük bir API sayfası üzerinden yapılır.

Son güncelleme: 20 Ekim 2026

Neden ek bir API sayfası gerekiyor?

Business Central'ın standart API v2.0'ı kalemleri, müşterileri ve satış belgelerini açar ama Item Journal Line (kalem günlüğü, tablo 83) üzerinden üretim çıktısı ya da düzeltme kaydı yazmaya izin vermez. Bunun yaygın yolu, iş ortağınızın bu tablo üzerinde özel bir API sayfası yayımlamasıdır; küçük bir AL geliştirmesidir.

ModernMES bu sayfaya aşağıdaki alanları gönderir; iş ortağınız sayfayı bu sözleşmeye göre yazar:

Alan	İçerik
itemNumber	Kalem no (ModernMES parça kodu ya da eşleştirilmiş BC kodu)
postingDate	İşin bittiği gün
entryType	Sağlam adet için Output (üretim emri kullanmıyorsanız Positive Adjmt.), fire için Negative Adjmt.
quantity	Adet
locationCode	Ayarlarda seçtiğiniz lokasyon
documentNumber	ModernMES iş emri numarası
description, externalReference	Proje bilgisi ve kaydın benzersiz ModernMES referansı

Satırın hemen nakledilmesi ya da kontrol için günlükte bekletilmesi, iş ortağınızın yazdığı sayfanın davranışına bağlıdır. Sayfa henüz yoksa bağlantı yine kurulur; o durumda yalnızca kalem ve müşteri kartları çekilir.

Business Central'dan ne alınır?

Kalemler: no, görünen ad, temel birim; engelli kalemler alınmaz. ModernMES'te parça olarak açılır.
Müşteriler: no, ad, vergi kayıt no, e-posta, telefon, şehir.

Kartlar ayarlar ekranındaki düğmeyle çekilir, hiçbir kayıt silinmez; kodlar farklıysa parça bazında eşleştirilir.

Kimlik doğrulama ve gerekenler

Microsoft Entra ID'de kayıtlı bir uygulama (istemci kimliği ve gizli anahtar) ve Business Central'da bu uygulama için Microsoft Entra Applications kaydı, uygun izin kümeleriyle. Bağlantı kullanıcı şifresi değil, hizmetten hizmete OAuth kullanır.
Entra kiracı kimliği (tenant ID), ortam adı (varsayılan production), şirket adı ve lokasyon kodu.
İş ortağınızın yayımladığı kalem günlüğü API sayfasının yolu.

Business Central bulutta çalıştığı için ModernMES'in bulut sürümüyle doğrudan bağlanır; ağ tarafında ek bir ayar gerekmez. Gizli anahtar ModernMES'te şifrelenerek saklanır.

Kurulum ve işleyiş

İş ortağınıza yukarıdaki alan sözleşmesini iletir, API sayfasını yayımlamasını isteriz.
Bağlantıyı birlikte tanımlar, önce bir sandbox ortamında deneme satırları gönderir, kayıtları iş ortağınızla kontrol ederiz.
Doğrulandıktan sonra production ortamına geçeriz. Aktarım zamanını siz seçersiniz: parçanın son operasyonu bitince (varsayılan), her operasyon bitince ya da yalnızca elle.

Gönderimler arka planda yapılır; Business Central yanıt vermezse 1 dakikadan 12 saate uzayan aralıklarla 8 deneme yapılır. Her aktarımın sonucu aktarım geçmişinde görünür.

Bu bağlantının yapmadıkları

Business Central üretim emirlerini veya satış siparişlerini ModernMES'e almaz.
Ürün ağacına göre tüketim kaydı yazmaz.
Stok miktarlarını ModernMES'e geri okumaz.

Sık sorulan sorular

API sayfası olmadan kullanılabilir mi?

Kısmen. Kalem ve müşteri kartları standart API ile çekilir; üretim ve fire gönderimi için kalem günlüğü API sayfası gerekir.

API sayfasını siz mi yazıyorsunuz?

Sayfa Business Central içinde AL ile yazılır ve sizin sisteminizde yayımlanır; bunu genellikle Business Central iş ortağınız yapar. Biz alan sözleşmesini verir ve testte birlikte çalışırız.

Fire nasıl kaydedilir?

"Fireyi de aktar" açıksa fire adedi Negative Adjmt. türünde bir kalem günlüğü satırı olarak aynı lokasyona gönderilir.

Business Central on-premise ile çalışır mı?

Bağlantı Business Central online'ın API adresleri ve Entra ID ile yazıldı. Kendi sunucunuzda çalışan bir Business Central kullanıyorsanız kurulum öncesinde bize yazın.