ERP entegrasyonu
ERP'niz çeki listesini XML ya da JSON olarak gönderir; StowCargo planı hesaplar ve 2–3 saniyede aynı yanıtta döndürür. Depo yüklemeyi bitirince imzalı webhook ERP'ye haber verir.
Sipariş sevkiyata hazır olunca ERP, çeki listesini StowCargo XML 1.0 ya da aynı alan adlarıyla JSON olarak POST eder. Belge numarası (ref) planı siparişe bağlar.
Motor yükü yerleştirir; yanıtta araç sayısı, doluluk, yük boyu ve her kutunun yükleme sırasındaki konumu vardır. Plan sitedeki arşive ERP etiketiyle düşer, ekip açıp düzenleyebilir.
Depo ekibi telefonda adım adım yükler. Bütün araçlar bitince imzalı webhook (yukleme.tamamlandi) ERP'ye gider; ERP sevk irsaliyesini o anda kesebilir.
StowCargo tek bir standart kapı sunar; ERP'nize uyan yol seçilir. Excel'le bugün başlayın, ekibinizle API'yi bağlayın ya da entegrasyonu ERP'nize özel biz kuralım.
ERP'nizin sipariş ya da irsaliye dökümünü Excel veya CSV olarak alın, çalışma alanına bırakın. Sütunları bir kez eşleyip şablon olarak kaydedersiniz; sonraki dosyalar tek tıkla gelir.
BT ekibiniz ya da ERP iş ortağınız sipariş kalemlerini StowCargo XML veya JSON'a çevirip gönderir; plan aynı yanıtta döner, yükleme bitince webhook haber verir. OpenAPI tanımından istemci kodu üretilir.
Logo, Netsis, Mikro, SAP, Microsoft Dynamics, Oracle ya da şirket içinde yazılmış kendi sisteminiz: ERP'niz hangisi olursa olsun entegrasyonu size özel kurarız. Sipariş ve irsaliye kalemlerini stok kartındaki ölçü ve ağırlıkla birleştiren ara katmanı yazar, alanları eşler, deneme gönderimleriyle doğrular ve canlıya alırız.
ERP'nizi, sevk sürecinizi ve planın hangi belgeden doğacağını (sipariş, irsaliye, sevk emri) birlikte belirleriz.
Sevk edilen ürünlerin stok kartında koli ölçüsü, ağırlık ve koli içi adet var mı bakarız; eksikleri listeleriz. Planın doğruluğu bu veriye bağlıdır.
ERP alanlarını StowCargo alanlarına eşler, gönderimi ve dönen planın ERP'ye yazılmasını kurarız (plan bağlantısı, araç sayısı, yükleme durumu).
Gerçek siparişlerinizle deneme gönderimleri yapar, sonuçları depoyla karşılaştırır, ardından canlıya alırız.
Bir kalem için gereken en az bilgi ölçü ve adettir; ağırlık dingil ve azami yük denetimi için önerilir. Alan adları StowCargo XML 1.0 ile aynıdır, JSON'da da aynı alanlar kullanılır.
| Alan | Durum | Ne için |
|---|---|---|
boy · en · yukseklik | Zorunlu | Koli ya da paletin dış ölçüsü (mm, cm, m ya da inç; birim belgede bir kez) |
adet | Zorunlu | Kaç koli / palet |
agirlik | Önerilir | Birim ağırlık (kg ya da lb): dingil yükü ve azami yük denetimi için |
ad · kod | Önerilir | Ürün adı ve stok kodu: rapor, etiket ve depo ekranında görünür |
siparis · durak | İsteğe bağlı | Sipariş no ve teslimat sırası: çok noktalı sevkiyatta yükleme sırası |
istiflenebilir · ustYuk · yon | İsteğe bağlı | İstif ve yön kuralları: üstüne yük konmaz, üst yük sınırı, dik durmalı |
ref | İsteğe bağlı | ERP belge no: aynı numara yeniden gelirse aynı plana yeni sürüm olur |
Alan adları XML'de ve JSON'da aynıdır, Türkçedir. Yanıttaki yerleşimler yükleme sırasıyladır: x ön duvardan kapıya, y sağ duvardan, z zeminden, milimetre. Örnekteki sayılar motorun gerçek sonucudur.
<cekiListesi ref="SIP-2026-0118" ad="Hamburg sevkiyatı"> <arac kod="tir-tenteli"/> <kalem ad="Bornoz paleti" boy="1200" en="800" adet="17"/> <kalem ad="Havlu kolisi" boy="600" en="400" adet="248"/> <kalem ad="Nevresim kolisi" boy="800" en="600" adet="99"/> …</cekiListesi><plan ref="SIP-2026-0118" planSurumu="1" oncelik="bosluk"> <sonuc aracSayisi="1" yerlesen="414" toplam="414"> <yukleme arac="1" hacimDoluluk="0.912" yukBoyu="13200"> <yerlesim sira="1" x="0" y="0" z="0"/> …| POST | /api/erp/v1/planla | Çeki listesini planla, planı aynı yanıtta döndür |
| GET | /api/erp/v1/planlar/{id} | Planın son sürümü ve depodaki yükleme durumu |
| GET | /api/erp/v1/araclar | Araç kodları ve iç ölçüleri |
| GET | /erp/openapi.json | OpenAPI 3.1 tanımı (kimlik gerekmez) |
| GET | /xml/stowcargo-1.0.xsd | XML şeması (kimlik gerekmez) |
Yönetici sitede bir alıcı adres tanımlar; seçilen olaylarda StowCargo bu adrese imzalı JSON gönderir. Bildirim 10 saniyede 2xx almazsa kuyrukta bekler ve yeniden denenir; sunucu yeniden başlasa da kaybolmaz.
plan.olusturulduArşive yeni plan girdi (sitede kaydedildi, ERP'den geldi ya da kopyalandı)plan.guncellendiPlana yeni sürüm kaydedildi (ör. depo planı elle düzeltti)plan.silindiPlan silindi (30 gün içinde geri alınabilir)plan.geriAlindiSilinen plan geri alındıyukleme.tamamlandiDepo, plandaki bütün araçların yüklemesini telefonda bitirdi{ "olay": "yukleme.tamamlandi", "plan": { "ref": "SIP-2026-0118", "planSurumu": 1 }}const { t, v1 } = parse(headers["x-stowcargo-imza"]);if (Date.now() / 1000 - t > 300) return false;const sig = hmacSha256(key, `${t}.${rawBody}`);return timingSafeEqual(sig, v1);StowCargo tek bir standart kapı sunar: XML ya da JSON ile ERP API. ERP tarafında yapılan iş, sipariş ya da irsaliye kalemlerini stok kartındaki ölçü ve ağırlıkla birleştirip bu biçime çevirmektir. Bunu kendi ekibiniz OpenAPI tanımıyla yapabilir ya da Logo, Netsis, Mikro, SAP, Dynamics, Oracle veya şirket içi yazılımınız için entegrasyonu biz kurarız. Hiç yazılım işi istemeyen başlangıç için ERP'den alınan Excel dökümü şablonla içe aktarılır.
Evet. ERP'nize özel ara katmanı biz yazar, alanları eşler, gerçek siparişlerinizle dener ve canlıya alırız. İş planını yıllık alanlara entegrasyon süreci desteği hediyedir; kapsamlı ya da özel akışlar (birden çok depo, özel onay adımları, ERP'ye geri yazılan ek alanlar) için teklif veririz.
HTTP üzerinden XML ya da JSON gönderebilen her sistemle: Logo, Netsis, Mikro, SAP, Dynamics, Oracle ya da kendi yazılımınız. Hazır bir eklenti gerekmez; OpenAPI tanımından istemci kodu üretilebilir.
Firmanın yöneticisi sitede ERP bağlantısı sayfasından anahtar oluşturur; her istekte Authorization: Bearer başlığıyla gönderilir. Anahtar yalnız oluşturulurken bir kez gösterilir, kaybolursa yenisi açılıp eskisi kapatılır.
Aynı belge numarası (ref) yeniden gelirse yeni plan açılmaz; aynı plana yeni sürüm eklenir. Yanıttaki planSurumu kaçıncı sürüm olduğunu söyler.
Her bildirimde X-StowCargo-Imza başlığı var: t=<unix saniye>,v1=HMAC-SHA256(imza anahtarı, "<t>.<ham gövde>"). 5 dakikadan eski imzayı reddedin; aynı bildirim iki kez gelebilir, X-StowCargo-Teslim ile tekilleştirin.
ERP anahtarları ve istek kayıtları site verisinden ayrı bir veritabanında tutulur. stowcargo.com'da StowCargo'nun kendi sunucularında, on-prem kurulumda sizin sunucunuzda.
ERP API ve webhook İş planında ve on-prem kurulumda. İş planını yıllık alana +1 ay ve ERP entegrasyon süreci desteği hediyedir.
Bağlantıyı kendi ekibinizle örnek XML ve OpenAPI tanımından kurun ya da ERP'niz için biz kuralım. İş planını yıllık alana entegrasyon süreci desteği hediye.