Microsoft Dynamics 365 entegrasyonu:
siparişin faturası kendiliğinden kesilir.

Dynamics 365 entegrasyonu hangi Dynamics ürünüyle çalışır?

Yox İş Ortağım'daki Dynamics 365 bağlantısı, Microsoft'un finance and operations uygulamaları olarak adlandırdığı Dynamics 365 Finance ve Dynamics 365 Supply Chain Management ortamları için hazırlanmıştır. "Dynamics 365" adı tek bir yazılımı değil, Microsoft'un iş uygulamaları ailesini anlatır; muhasebe ve stok tarafında iki ayrı ürün bulunur ve ikisinin API adresi de veri modeli de farklıdır. Bu yüzden ilk görüşmede sorduğumuz soru, şirketinizde hangi Dynamics ürününün kullanıldığıdır.

Business Central kullanıyorsanız

Microsoft Learn, Business Central'ı küçük ve orta ölçekli kuruluşlar için iş yönetimi çözümü olarak tanımlar; çevrimiçi sürümün API'si ortam adını içeren ayrı bir adres yapısı kullanır. Paneldeki alanlar Finance ve Supply Chain Management'ın OData servisine göre çalıştığı için Business Central ortamını bu bağlantıyla eşlemeyiz. Business Central kullanıyorsanız kurulum öncesinde ekibimizle iletişime geçin; ortamınızı dinleyip neyin mümkün olduğunu baştan açıkça söyleriz.

Panel ile Dynamics 365 arasında hangi kayıtlar gider, hangileri gitmez?

Bağlantı üç iş yapar ve her işin yönü bellidir: sipariş ve fatura panelden Dynamics 365'e gider, stok miktarı Dynamics 365'ten panele gelir. Müşteri kartı, ürün kartı ya da fiyat listesi gibi ana kayıtlar her iki tarafta kendi yerinde kalır. Aşağıdaki tablo, her işin Dynamics 365 tarafında neye dokunduğunu gösterir.

• Sipariş başlık düzeyinde gider: Microsoft'a göre satış siparişinde başlık ve satırlar iki ayrı veri varlığıdır; başlık önce oluşturulur, ürün, adet ve satış fiyatı satır varlığında tutulur. Panelin Dynamics 365 bağlantısı siparişin başlık kaydını gönderir; ürün satırları bu aktarımın parçası değildir ve panelde siparişin içinde görünmeye devam eder.
• Müşteri hesabı önceden var olmalı: Learn dokümanı, sipariş başlığındaki müşteri hesabı alanının zorunlu olduğunu ve hesabın Accounts receivable > Customers > All customers altında tanımlı olması gerektiğini belirtir.
• Fiyat panelde yönetilir: Kanal başına yüzde ya da tutar farkı panelde tanımlanır; Dynamics 365'teki liste fiyatınız kanallara taşınmaz.

Bir pazaryeri siparişi Dynamics 365'e hangi sırayla ulaşır?

Panelde her sipariş Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim durumlarından geçer; Dynamics 365 ile temas bu zincirin iki noktasında kurulur. Örneğin Trendyol entegrasyonu üzerinden gelen bir sipariş şu yolu izler:

1. Sipariş, kanalın resmî API'siyle panele gelir; ürünler barkod ya da stok koduyla panel ürün kartına bağlanır.
2. Sipariş Hazırlanıyor durumuna geçtiğinde otomatik fatura açıksa ve panele ayrı bir e-Fatura sağlayıcısı bağlı değilse satış faturası Dynamics 365 üzerinden oluşturulur; sipariş Faturalandı durumuna ilerler.
3. Otomatik ERP aktarımı açıksa Faturalandı durumundaki sipariş Dynamics 365'e satış siparişi başlığı olarak gönderilir.
4. Dynamics 365'in döndürdüğü kayıt numarası ya da hata mesajı siparişin geçmişine yazılır.
5. Kargo etiketi basılır, takip numarası kanala bildirilir; Dynamics 365'teki stok değişimi bir sonraki stok çekmede panele ve bütün kanallara yansır.

Otomatik aktarım mı, seçerek toplu gönderim mi?

Otomatik ERP aktarımını açmak, her faturalanan siparişin kendiliğinden Dynamics 365'e gitmesini sağlar. Geçiş döneminde ya da yalnız belirli kanalların siparişlerini ERP'ye almak istediğinizde otomatik aktarımı kapalı tutup sipariş listesinden seçtiğiniz siparişleri toplu olarak gönderebilirsiniz. Daha önce aktarılmış bir sipariş toplu gönderimde atlanır; aynı sipariş Dynamics 365'e ikinci kez yazılmaz.

Aktarım hata verirse ne olur?

Dynamics 365 bir kaydı reddederse sipariş panelde kalır, durum zinciri bozulmaz ve hata mesajı siparişin geçmişinde görünür. Otomatik aktarım açıkken faturalanmış ama ERP'ye ulaşmamış siparişler düzenli aralıklarla yeniden denenir. En sık görülen ret nedenleri bir sonraki bölümde anlattığımız müşteri hesabı, tüzel kişilik ve yetki eksiklikleridir; nedeni ERP'de giderdikten sonra sipariş bir sonraki denemede iletilir.

Dynamics 365 tarafında müşteri hesabı, tüzel kişilik ve madde numarası hazırlığı

Dynamics 365 entegrasyonunun ilk günden düzgün akması, bağlantıdan çok ERP'deki ana kayıtların hazır olmasına bağlıdır. Panel Dynamics 365'te müşteri hesabı ya da madde açmadığı için siparişin işaret ettiği kayıtların ERP'de önceden var olması gerekir. Aşağıdaki tablo, hangi bilginin Dynamics 365'te nerede karşılık bulması gerektiğini özetler.

Bireysel alıcılar için genel müşteri hesabı

Pazaryeri siparişlerinin büyük kısmı vergi numarası taşımayan bireysel alıcılardan gelir. Bu siparişler Dynamics 365'e WEB kodlu müşteri hesabıyla gider; hesabın ödeme koşulu, KDV grubu ve muhasebe profilini mali müşavirinizle birlikte belirleyip ERP'de bir kez tanımlarsınız. Kurumsal alıcılarda ise hesap numarası vergi numarasıyla eşleşmezse Dynamics 365 siparişi kabul etmez.

Tüzel kişilik ve şirket seçimi

Finance'te veriler tüzel kişilik bazında tutulur. Microsoft'un OData dokümanına göre servis, aksi belirtilmedikçe bağlanan kullanıcının varsayılan şirketine ait veriyi döndürür; başka şirkete ait kayıtlar için ayrı sorgu seçeneği gerekir. Birden çok tüzel kişiliğiniz varsa pazaryeri siparişlerinin hangi şirkete yazılacağını kurulumda birlikte netleştiririz.

Madde numarası ile stok kodu eşleşmesi

Stok çekme, Dynamics 365'teki madde numarasını panel ürün kartındaki stok koduyla eşler. Eşleşmeyen ürünlerin stoğu güncellenmez. Varyantlı ürünlerde her bedenin ya da rengin panelde ayrı bir stok kodu olduğu için Dynamics 365'teki karşılığını kurulumdan önce listeleyin.

Dynamics 365 entegrasyonu için Microsoft Entra uygulama kaydı ve izinler

Panel bağlantı için Tenant ID, Client ID, Client Secret ve Ortam URL ister; bunların hiçbiri bir kişinin kullanıcı şifresi değildir. Microsoft'un servis dokümanı, finance and operations servislerinin OAuth 2.0 ile korunduğunu ve istemci kimlik bilgileriyle (client credentials) servisten servise çağrıyı desteklediğini söyler. Kayıt için bir Azure aboneliği ve Microsoft Entra ID'de yönetici erişimi gerekir; bu işi genellikle BT yöneticiniz ya da Dynamics iş ortağınız yapar.

Microsoft Entra yönetim merkezinde yapılacaklar

• App registrations altında yeni bir kayıt açın; genel bakış sayfasındaki Application (client) ID değeri paneldeki Client ID, Directory (tenant) ID değeri Tenant ID alanına girer.
• API izinlerinde Microsoft Dynamics ERP (Microsoft.ERP) arayüzünü seçin; Microsoft'un dokümanı, aramada görünmezse tam adla aranmasını önerir.
• Certificates & secrets > Client secrets bölümünde bir gizli anahtar oluşturun ve değeri hemen kopyalayın; Microsoft'a göre bu değer sayfadan çıktıktan sonra bir daha gösterilmez.

Dynamics 365 içinde servis kullanıcısı ve API önceliği

Dynamics 365'te System administration > Setup > Microsoft Entra applications sayfasında yeni kayıt açılır, Client ID girilir ve uygulamaya bir kullanıcı atanır. Microsoft örnekte Admin kullanıcısını gösterse de yalnız gereken yetkilere sahip ayrı bir servis hesabı atanmasını daha iyi uygulama olarak önerir. Aynı ortamda başka entegrasyonlar da çalışıyorsa System administration > Setup > Throttling priority mapping sayfasında bu uygulamaya Low, Medium ya da High öncelik verebilirsiniz; ortam kaynakları zorlandığında düşük öncelikli entegrasyonlar önce yavaşlatılır ve servis 429 Too Many Requests yanıtı döndürür.

Dynamics 365 Finance'te Türkiye e-Faturası: UBL-TR, e-Arşiv ve GİB kuralları

Microsoft Learn'e göre Dynamics 365 Finance, birincil adresi Türkiye'de olan tüzel kişilikler için UBL-TR biçiminde elektronik fatura XML'i üretebilir. Bunun için Electronic Reporting yapılandırmaları (aralarında E-Invoice (TR) biçimi var) içe aktarılır, Accounts receivable parametrelerinde bu biçim seçilir ve müşteri kartında eInvoice seçeneği açılıp fatura türü belirlenir. Fatura türü ve senaryo, XML'deki ProfileID değerini belirler:

Learn dokümanı XML'in üretilmesini ve Electronic Reporting hedeflerine gönderilmesini anlatır; faturanın GİB'e ve alıcıya iletilmesi, Dynamics 365 tarafında kurduğunuz entegratör bağlantısına bağlıdır. Pazaryeri satıcıları için bu ayrım önemlidir: panel Dynamics 365'te fatura kaydını oluşturur, ancak e-Arşiv ya da e-Fatura olarak gönderim sizin ERP yapılandırmanızın işidir.

2026'da pazaryeri satıcısını ilgilendiren e-belge kuralları

• 535 Sıra No'lu VUK Genel Tebliği: İnternet üzerinden ya da pazaryerleri aracılığıyla satış yapanlar, brüt satış hasılatı 500 Bin TL ve üzerine çıktığında e-Fatura ve e-Arşiv Fatura uygulamalarına geçmek zorundadır.
• 573 Sıra No'lu Tebliğ: 2025'te vergiler dahil 3 Bin TL'yi aşan faturalar e-Arşiv olarak düzenlenir; 1 Ocak 2026'dan itibaren bu zorunluluk tutarına bakılmaksızın uygulanır.
• 589 Sıra No'lu Tebliğ: Basit usul mükellefleri ile işletme hesabı esasına göre defter tutanlar için tutar sınırı 2026 sonuna kadar sürer, tutarsız uygulama 1 Ocak 2027'de başlar.

Bu çerçeve genel bilgidir; kendi mükellefiyetiniz için son kararı mali müşavirinizle verin. Fatura tutarlarını kontrol ederken KDV hesaplama aracı işinizi hızlandırır.

Fatura Dynamics 365'te mi, ayrı bir e-Fatura sağlayıcısında mı kesilmeli?

Karar, Dynamics 365 ortamınızda Türkiye e-Faturası için çalışan bir entegratör kurulumu olup olmadığına bağlıdır. Kurulum varsa faturayı Dynamics 365'te kesmek satış kaydı ile faturayı tek sistemde toplar. Kurulum yoksa paneldeki e-Fatura sağlayıcısı faturayı keser, Dynamics 365 ise sipariş ve stok tarafında kalır. Panel, bağlı bir e-Fatura sağlayıcısı varsa faturayı önce ona keser; yoksa Dynamics 365'e yönelir.

İkinci yolu düşünüyorsanız örneğin Nilvera entegrasyonu sayfası, bir e-Fatura sağlayıcısının panelde nasıl çalıştığını anlatır. Hangi yolu seçerseniz seçin, aynı siparişin faturasını iki ayrı sistemde birden kesmeyin; çift fatura iptal ve düzeltme işi doğurur.

Dynamics 365 bağlantısı hangi Yox İş Ortağım paketinde?

Dynamics 365 bağlantısı Profesyonel, Kurumsal ve Enterprise paketlerinde kullanılabilir; Başlangıç ve Büyüme paketlerinde muhasebe ya da ERP programı bağlanmaz. Panelde 51 muhasebe, e-Fatura ve ERP programı tanımlıdır ve Dynamics 365 bunlardan biri olarak sayılır.

Yıllık ödemede %20 indirim uygulanır. Faturayı Dynamics 365'te kesecekseniz Profesyonel yeterlidir; yanına bir e-Fatura sağlayıcısı bağlayacaksanız iki program gerektiği için Kurumsal paketi seçin. Dynamics 365 kullanan çok şirketli yapılar için Enterprise paketinde çoklu şirket ve özel SLA vardır. Tüm limitleri paket karşılaştırmasında görebilir, paneli 3 gün ücretsiz deneyebilirsiniz.

Dynamics 365 entegrasyonu karar rehberi: kontrol listesi ve sık hatalar

Kurulum görüşmesine gelmeden önce aşağıdaki soruları yanıtlamak, ilk siparişin ERP'ye ilk denemede düşmesini sağlar. Bağlantıyı istenirse birlikte kurar, ilk siparişi Dynamics 365'te birlikte kontrol ederiz.

Kurulumdan önce yanıtlanacak sorular

• Ortamınız Finance ya da Supply Chain Management mı, yoksa Business Central mı?
• Entra uygulama kaydı açıldı mı, Client ID Dynamics 365'te bir servis kullanıcısıyla eşlendi mi?
• Bireysel alıcılar için WEB kodlu müşteri hesabı ve kurumsal alıcılar için vergi numarasıyla açılmış hesaplar hazır mı?
• Siparişlerin yazılacağı tüzel kişilik belli mi?
• Panel stok kodları ile Dynamics 365 madde numaraları birebir aynı mı?
• Fatura Dynamics 365'te mi, paneldeki e-Fatura sağlayıcısında mı kesilecek?

Sık yapılan hatalar

• Test (sandbox) ortamının adresini Ortam URL alanında bırakıp canlıya geçerken güncellemeyi unutmak.
• Uygulamaya Admin kullanıcısını atamak: bağlantı çalışır ama entegrasyona gereğinden geniş yetki verilmiş olur.
• Gizli anahtarın bitiş tarihini kaydetmemek: süre dolduğunda aktarım kimlik hatasıyla durur.
• Kurumsal alıcının müşteri hesabını vergi numarası dışında bir numarayla açmak: sipariş başlığı reddedilir.

Benzer bir yapıyı başka bir ERP ile kuruyorsanız SAP Business One entegrasyonu sayfası karşılaştırma için faydalıdır; bütün bağlantıları entegrasyon sayfamızda görebilirsiniz. Hazırsanız Yox İş Ortağım'a başvurun.