Business Central'dan Etiket Yazdırma

Dynamics 365 Business Central'dan kargo ve barkod etiketi: Labelixa nakledilmiş satış sevkiyatlarınızı standart API ile okur, ZPL şablonunu doldurur, etiketi ekranda gösterir ve DirectPrint ajanıyla basar.

Sorun

Business Central sevkiyatı kaydeder ama termal etiketi başka bir yerde basılır: rapor düzeni ZPL üretmez, iş ortağı uzantısı yazdırmak pahalıdır ve şablon doğru mu sorusu ancak yazıcıdan çıkınca cevaplanır. Arada alanları okuyan, etiketi ekranda gösteren ve yazıcıya ileten bir katman eksiktir.

Labelixa ne yapar?

Entra kimliğiyle bağlantı

Kendi kiracınızda bir uygulama kaydı (client credentials) açar, Labelixa'da konnektör ayarına kiracı, ortam ve şirket kimliğini girersiniz. Gizli anahtar şifreli saklanır, hiçbir ekranda görünmez.

Sevkiyat alanlarını eşleme

`salesShipments` kaydının alıcı, adres, şehir, posta kodu ve belge numarası gibi alanlarını etiket değişkenlerine eşlersiniz; yalnız eşlenen alanlar istenir.

Ekranda önizleme

Eşlenen veriyle üretilen ZPL gerçek ölçüde render edilir; barkod gerçekten çözülerek doğrulanır. Yanlış alan baskı tüketmeden görünür.

DirectPrint ile baskı

Hazır etiket, ağdaki ya da USB'deki Zebra sınıfı yazıcıya DirectPrint ajanı üzerinden gider; iş geçmişi panelde durur.

Örnek etiket

Bu görsel, yandaki ZPL kodundan Labelixa motoruyla üretildi.

Kendi ZPL kodunuzu deneyin →

^XA
^FO25,20^A0N,26,24^FDSHIP TO^FS
^FO25,52^A0N,22,20^FDTrey Research^FS
^FO25,80^A0N,20,18^FD153 Thomas Drive^FS
^FO25,106^A0N,20,18^FDChicago 61236^FS
^BY2,3,80^FO25,140^BCN,80,Y,N,N^FDS-SHPT102001^FS
^FO470,20^BXN,5,200^FDS-SHPT102001|Trey Research^FS
^XZ

Sık kullanılan sembolojiler

Business Central'dan etiket yazdırma nasıl çalışır?

1. Entra ID'de uygulama kaydı açın: Business Central API izni (Application, API.ReadWrite.All) + yönetici onayı; BC'de Microsoft Entra Applications kartına istemci kimliğini ekleyin.
2. Labelixa'da konnektör ayarı oluşturun: kiracı, ortam, şirket kimliği, kaynak (salesShipments) ve sevkiyat alanlarının etiket şablonunuzun değişkenlerine eşlenmesi. 4×6 kargo etiketi şablonu · tüm etiket şablonları
3. Çalıştırın: sevkiyat satırları gelir; ilk satırı şablonla render edip etiketi ve barkodunu ekranda kontrol edin. ZPL görüntüleyici
4. DirectPrint ajanını kurun, yazıcıyı eşleyin, işi gönderin. DirectPrint ajanını indirin

Entegrasyonun ölçülmüş sınırları

Hangi veri okunur?

Standart Business Central API v2.0 (`companies/{id}/salesShipments`) ile sevkiyat başlıkları okunur; sorgu yalnız eşlenen alanları ister. Gerçek bir BC ortamında ölçüldü: 42 alanlı kayıt, 200 kayıtlık sayfa.

Geri yazma yok

Entegrasyon yalnız okur. "Etiket basıldı" bilgisi Business Central'a yazılmaz; bunun için müşteri tarafında küçük bir AL uzantısı gerekir ve bu pilotla birlikte şekillenir. Çalışmayan bir özellik vaat edilmez.

Sayfalama ve limitler

Bir çağrı en çok 200 kayıt işler ve devamı olup olmadığını bildirir; filtreyle (örneğin belge numarası) tek sevkiyat çekmek tipik kullanımdır. Yanıt tavanı 1 MB; aşılırsa anlaşılır hata döner.

Güvenlik

Gizli anahtar AES-256-GCM ile şifreli sütunda durur ve hiçbir okuma yüzeyine çıkmaz; giden istekler şema, IP ve yönlendirme denetiminden geçer; jeton ve müşteri verisi loglanmaz.

API referansına gidin →

Sık sorulan sorular