ERP yük planlama entegrasyonu: Logo, Netsis, SAP rehberi

Siparişleriniz, irsaliyeleriniz ve stok kartlarınız zaten ERP'de duruyorsa, yük planı için aynı bilgiyi bir kez daha elle yazmanın anlamı yoktur. ERP yük planlama entegrasyonu, çeki listesini ERP'den doğrudan yük planlama programına gönderir ve hesaplanan planı (araç sayısı, yükleme sırası, plan bağlantısı) geri alır. Bu yazıda bağlantının üç yolunu, ERP'de hazır olması gereken veriyi, alan listesini ve bir entegrasyon projesinin adımlarını anlatıyoruz. Yük planlama programının ne yaptığına önce genel olarak bakmak isterseniz yük planlama programı nedir yazısıyla başlayabilirsiniz.

ERP yük planlama entegrasyonu neden gerekir?

Kısa cevap: yük planı için gereken bilgi zaten ERP'dedir ve onu yeniden yazmak hata üretir. Sipariş satırları, alıcı, teslimat adresi ve belge numarası ERP'de oluşur. Birçok firmada planlama ise ayrı bir masada yapılır: biri ERP çıktısına bakar, satırları Excel'e ya da plan programına elle girer.

Elle aktarmanın riski tek bir yanlış rakamda saklıdır. Koli yüksekliğine 40 yerine 4 yazılırsa plan ekranda kusursuz görünür, rampada ise yük sığmaz. Bir satır atlanırsa araç eksik dolar ya da bir koli depoda kalır. Sipariş son anda değişirse planlayıcı bunu fark etmeyebilir ve depo eski planla yükler.

Entegrasyon bu üç sorunu birlikte ele alır:

• Tek kaynak: ölçü ve adet, ERP'deki stok kartından ve siparişten gelir; kimse yeniden yazmaz.
• Hız: plan, sipariş sevke hazır olduğu anda hesaplanır; planlayıcı yalnız istisnalarla uğraşır.
• İz: ERP belge numarası planla birlikte taşınır; hangi planın hangi siparişe ait olduğu kaybolmaz.

ERP'yi yük planlama programına bağlamanın üç yolu nedir?

Üç yol vardır ve üçü de aynı standart kapıya çıkar: StowCargo XML 1.0 ya da aynı alan adlarıyla JSON. Hangisini seçeceğiniz ERP'nizin markasından çok, elinizdeki yazılım kaynağına ve sevkiyat sıklığınıza bağlıdır. Teknik ayrıntılar ERP entegrasyonu sayfasındadır.

Kodsuz başlangıç: ERP'den Excel ya da CSV dökümü

Hemen her ERP, sipariş ya da irsaliye dökümünü Excel veya CSV olarak verebilir. Bu dosyayı çalışma alanına bırakır, sütunları (boy, en, yükseklik, adet, ağırlık) bir kez eşler ve şablon olarak kaydedersiniz. Sonraki dosyalar aynı şablonla tek tıkla gelir; ekip planlarında şablon herkesle paylaşılır. Bu tam bir entegrasyon değildir, ama yeniden yazmayı bitirir ve veri eksiklerini erkenden gösterir.

Kendi ekibinizle API bağlantısı

BT ekibiniz ya da ERP iş ortağınız sipariş kalemlerini XML veya JSON'a çevirip ERP API'ye gönderir. Herkese açık OpenAPI 3.1 tanımı Postman, Swagger UI ya da API yönetim araçlarına doğrudan yüklenir; istemci kodu buradan üretilebilir. Başlangıç için örnek çeki listesi XML dosyası ve XSD şeması da hazırdır. Birçok ERP kurulumunda HTTP üzerinden XML ya da JSON göndermek mümkündür. Asıl iş, sipariş satırlarını stok kartındaki ölçüyle birleştiren küçük bir ara katmandır.

Alan adları Türkçedir (boy, en, yukseklik, adet, agirlik); XML'de Length, Width, Height, Weight ve Quantity gibi yaygın İngilizce adlar da tanınır. Ölçü mm, cm, m ya da inç, ağırlık kg, ton ya da pound olarak gönderilebilir. Hata mesajları varsayılan olarak Türkçe döner ve eksik alanı açıkça söyler; yabancı bir iş ortağı bağlantıyı kuruyorsa istekte Accept-Language: en göndererek İngilizce mesaj alır.

Entegrasyonu ERP'nize özel kurdurmak

Ekibinizde bu işe ayıracak kimse yoksa entegrasyonu StowCargo kurar. Logo, Netsis, Mikro, SAP, Microsoft Dynamics, Oracle ya da şirket içinde yazılmış bir sistem fark etmez. Sipariş ve irsaliye kalemlerini stok kartındaki ölçü ve ağırlıkla birleştiren ara katman yazılır, alanlar eşlenir, deneme gönderimleriyle doğrulanır ve canlıya alınır.

ERP entegrasyon akışı adım adım nasıl işler?

Akış bir istek ve bir yanıttan oluşur; ERP'nin planı beklerken sürekli sorgulaması gerekmez.

1. Sipariş sevke hazır olur. ERP, çeki listesini XML ya da JSON olarak /api/erp/v1/planla adresine POST eder. Kimlik için firma yöneticisinin sitede oluşturduğu anahtar, Authorization: Bearer başlığıyla taşınır.
2. Plan aynı yanıtta döner. Motor yükü yerleştirir; yanıtta araç sayısı, doluluk, yük boyu ve her kutunun yükleme sırasındaki konumu bulunur. Yanıt genellikle 2–3 saniyede gelir.
3. ERP sonucu kaydeder. Plan bağlantısı ve araç sayısı ERP'deki siparişe yazılır. Plan ayrıca sitedeki arşive ERP etiketiyle düşer; ekip açıp düzenleyebilir.
4. Depo telefonla yükler. Depo ekibi plan linkini telefonda açar ve kutuları adım adım yükler. Link hesap istemez ve Türkçe, İngilizce, Almanca ve Rusça çalışır; ayrıntılar telefonla depo yükleme sayfasında.
5. ERP haberdar olur. Plandaki bütün araçlar yüklenince imzalı yukleme.tamamlandi bildirimi, ERP için tanımlanan adrese gider. ERP isterse planın son hâlini ve yükleme durumunu GET /api/erp/v1/planlar/{id} ile çeker.

Sipariş sonradan değişirse aynı belge numarasıyla (ref) yeniden gönderilir. Yeni plan açılmaz, aynı plana yeni sürüm eklenir; yanıttaki planSurumu alanı kaçıncı sürüm olduğunu gösterir.

ERP'de hangi verinin hazır olması gerekir?

Entegrasyon projelerinde en sık engel yazılım değil, stok kartındaki eksik veridir. Plan, aldığı ölçü kadar doğrudur. Sevk ettiğiniz her ürün için ERP'de üç bilgi bulunmalıdır:

• Koli ölçüsü: ürünün değil, sevk edilen koli ya da paletin dış ölçüsü. Birçok kurulumda stok kartında yalnız ürün ölçüsü vardır ya da bu alanlar hiç doldurulmamıştır.
• Ağırlık: koli ya da paletin brüt ağırlığı. Azami yük ve dingil yükü denetimi buna dayanır.
• Koli içi adet: sipariş çoğu zaman adet, metre ya da kilogram olarak girilir. Kaç koli çıkacağını bulmak için koli içi adet gerekir; yarım kalan kolinin nasıl gönderileceğine de baştan karar verin.

Eksikleri kapatmanın pratik yolu, son birkaç ayda sevk edilen ürünlerin listesini çıkarıp ölçüsü boş olanları depoda ölçtürmektir. Ölçüleri sınamak için ücretsiz yük hesaplama aracına birkaç kalem girip sonucu depodaki gerçek yüklemeyle karşılaştırabilirsiniz.

Ölçünün etkisi büyüktür. StowCargo motorunun hesabına göre 600 × 400 × 400 mm koliden, yalnız ölçüye göre, bir 13,60 tenteli tıra 884 adet sığar ve koli hacmi aracın %93,2'sini doldurur. Stok kartındaki koli ölçüsü birkaç santimetre yanlışsa bu sayı da yanlış çıkar.

Çeki listesinde hangi alanlar gönderilir?

Bir kalem için en az bilgi ölçü ve adettir; geri kalan alanlar planı zenginleştirir. Alan adları XML'de ve JSON'da aynıdır.

Araç, hazır bir kodla (ör. tir-tenteli, 40hc) ya da iç ölçüleriyle gönderilir; güncel kodlar GET /api/erp/v1/araclar ile alınır. Varsayılan boşluk önceliğinde istif kuralları uygulanmaz: istiflenebilir ve ustYuk, “kurallar” önceliği seçildiğinde devreye girer. Yön kuralı ise her zaman korunur.

Entegrasyon çözümü seçerken neye bakmalısınız?

Kısaca: belgelenmiş bir arayüz, sipariş değişikliğine dayanıklı sürümleme, güvenli bildirim ve verinin nerede durduğu. Bu ölçütler hangi ürünü seçerseniz seçin işe yarar:

• Makinenin okuyabildiği tanım: OpenAPI ya da XSD tanımı ERP tarafındaki işi kısaltır. StowCargo'da ikisi de anahtar istemeden indirilebilir.
• Belge numarasıyla sürümleme: sipariş değişince kopya plan oluşmamalı; aynı ref, aynı planın yeni sürümü olmalı.
• İmzalı webhook: her bildirim, zaman damgası ve ham gövde üzerinden HMAC-SHA256 ile imzalanır (X-StowCargo-Imza başlığı). 5 dakikadan eski imzayı reddedin; aynı bildirim iki kez gelebileceği için X-StowCargo-Teslim ile tekilleştirin. Başarısız bildirim 1 dk, 5 dk, 30 dk, 2 sa ve 6 sa sonra yeniden denenir.
• Veri ayrımı: ERP anahtarları ve istek kayıtları, site verisinden ayrı bir veritabanında tutulur. Şirketin kendi sunucusuna kurulum (on-prem) seçeneği de vardır.
• Sınırlar: istek başına en fazla 8 MB ve 5.000 kalem satırı; anahtar başına dakikada 120 istek, firmada aynı anda en çok 2 planlama. ERP tarafındaki toplu gönderimi buna göre kurun.
• Görünürlük: her istek sitede “Son istekler” listesinde zaman, belge numarası, sonuç ve süreyle görünür; hata ararken önce ERP günlüğüne bakmanız gerekmez.

Özel entegrasyon projesi hangi adımlardan geçer?

Entegrasyonu StowCargo kurduğunda iş dört adımda ilerler:

1. Keşif: ERP'niz, sevk süreciniz ve planın hangi belgeden doğacağı (sipariş, irsaliye ya da sevk emri) birlikte belirlenir.
2. Veri: sevk edilen ürünlerin stok kartında koli ölçüsü, ağırlık ve koli içi adet olup olmadığına bakılır; eksikler listelenir.
3. Eşleme ve ara katman: ERP alanları StowCargo alanlarına eşlenir; gönderim ve dönen planın ERP'ye yazılması (plan bağlantısı, araç sayısı, yükleme durumu) kurulur.
4. Deneme ve canlı: gerçek siparişlerinizle deneme gönderimleri yapılır, sonuçlar depodaki yüklemeyle karşılaştırılır, ardından canlıya alınır.

Projenin süresini çoğu zaman ikinci adım belirler. Stok kartları eksiksizse eşleme hızlı biter; eksikse önce ölçüm yapmak gerekir.

ERP entegrasyonu hangi planda var?

ERP API ve webhook İş planındadır. İş planı kullanıcı başına aylık 29,99 ABD dolarıdır (vergiler hariç). Yıllık ödemede 10 ayın ücreti ödenir; İş planını yıllık alanlara +1 ay ve ERP entegrasyon süreci desteği hediyedir. Birden çok depo, özel onay adımları ya da ERP'ye geri yazılan ek alanlar gibi kapsamlı akışlar için ayrıca teklif verilir.

Sonuç

ERP yük planlama entegrasyonu, aynı bilgiyi iki kez yazmayı bitirir ve her planı kendi siparişine bağlar. Excel şablonuyla bugün başlayabilir, API'yi kendi ekibinizle bağlayabilir ya da entegrasyonu ERP'nize özel kurdurabilirsiniz. Hangi yolu seçerseniz seçin ilk iş aynıdır: stok kartındaki koli ölçüsünü, ağırlığı ve koli içi adedi tamamlamak.

İş planını ve yıllık alımla gelen entegrasyon desteğini fiyatlar sayfasında inceleyebilirsiniz.