SAP Business One entegrasyonu: Service Layer, satış belgeleri ve stok için uygulamalı rehber
SAP Business One entegrasyonu, Trendyol, Hepsiburada ve kendi sitenizden gelen siparişleri SAP B1'e elle girmeden göndermek, siparişin satış faturasını SAP Business One içinde oluşturmak ve SAP'deki stok miktarını bütün satış kanallarına aynı ürün kartından dağıtmak demektir. Yox İş Ortağım bu bağlantıyı SAP'nin resmî web API'si olan Service Layer üzerinden kurar ve kapsamı üç işle sınırlı tutar: sipariş aktarımı, fatura kesme ve stok çekme. Ekim 2026 itibarıyla SAP'nin Service Layer kılavuzuna (sürüm 1.29) ve SAP Learning içeriklerine dayanan bu rehberde; bir pazaryeri siparişinin SAP'de hangi belgeye dönüştüğünü, stok rakamının nereden okunduğunu, IT ekibinizin neyi hazırlaması gerektiğini ve faturayı nerede keseceğinize nasıl karar vereceğinizi anlatıyoruz.
SAP Business One entegrasyonu nedir, Yox İş Ortağım SAP B1'de hangi işleri yapar?
SAP Business One entegrasyonu, satış kanallarındaki siparişlerle SAP B1'deki satış belgeleri ve stok arasında kurulan otomatik bir köprüdür. Yox İş Ortağım bu köprüde yalnız üç işi üstlenir: siparişi SAP'ye aktarmak, siparişin faturasını SAP'de kesmek ve stoğu SAP'den çekmek. Aşağıdaki tablo her işin yönünü ve SAP B1'de hangi kayda karşılık geldiğini gösterir.
| Panel işi | Yön | SAP B1'deki kayıt (Service Layer nesnesi) | Gönderilen ya da okunan bilgi |
|---|---|---|---|
| Sipariş aktarımı | Panel → SAP B1 | Satış siparişi (Orders) | Alıcı adı, pazaryeri sipariş numarası, satırlarda kalem kodu, adet ve birim fiyat |
| Fatura kesme | Panel → SAP B1 | A/R satış faturası (Invoices) | Siparişteki aynı bilgiler; belge SAP'de doğrudan fatura olarak açılır |
| Stok çekme | SAP B1 → panel → satış kanalları | Kalem ana verisi (Items) | Kalem kodu ve stoktaki miktar; panelde aynı stok koduna sahip ürünler güncellenir |
| Cari, kalem kartı ve fatura aktarımı | Aktarım yok | SAP B1'de sizin tanımlarınızla tutulur | Panel SAP'de müşteri ya da kalem kartı açmaz, panelde kesilen faturayı SAP'ye taşımaz |
Bu sınır bilinçli bir tercihtir: ana veriler SAP Business One'da sizin kurallarınızla kalır, panel yalnız satış hareketini ve stok miktarını taşır. Aynı mantığın başka bir ERP'de nasıl uygulandığını Dynamics 365 entegrasyonu sayfasında görebilirsiniz.
SAP Business One kimin ürünü, pazaryeri satıcısı için ne anlama gelir?
SAP Business One, Alman yazılım şirketi SAP SE'nin küçük ve orta ölçekli şirketler için geliştirdiği ERP yazılımıdır; muhasebe, satın alma, stok, satış ve raporlamayı tek veritabanında toplar. SAP News Center'ın Aralık 2025 tarihli yazısına göre ürünün 83.000'i aşkın müşterisi ve 1,2 milyon kullanıcısı var; 170'ten fazla ülkede, 28 dilde ve 50 ülkeye özel yerelleştirmeyle kullanılıyor, yerel destek ise 850'yi aşkın iş ortağı üzerinden veriliyor.
Pazaryeri satıcısı açısından bu tablo şunu söyler: SAP B1 kullanıyorsanız muhasebe kaydınız ve depo stoğunuz zaten kapsamlı bir sistemde duruyor; eksik olan, Trendyol ya da Hepsiburada siparişlerinin bu sisteme düzenli ve hatasız ulaşmasıdır. Siparişleri SAP'ye elle yazmanın tipik maliyetleri şunlardır:
- Her siparişte aynı veriyi iki kez girmek: önce pazaryeri panelinde, sonra SAP ekranında.
- Elle girişin gecikmesiyle SAP stoğu ile pazaryeri stoğunun ayrışması.
- Ay sonunda hangi siparişin faturalandığını bulmak için tablo karşılaştırmak.
SAP iş ortağıyla çalışmak kurulumu nasıl etkiler?
SAP B1'in kurulumu ve yerel desteği SAP'nin iş ortağı ağı üzerinden verildiği için entegrasyonun SAP tarafındaki işleri (Service Layer'ın açık olması, entegrasyon kullanıcısı, müşteri kartı ve vergi kodu ayarları) çoğu zaman iş ortağınızın elindedir. Bu yüzden kurulum görüşmesine iş ortağınızdan ya da IT ekibinizden bir kişinin katılmasını öneririz.
Service Layer nedir, SAP B1 bağlantısı neden bu katmandan kurulur?
Service Layer, SAP'nin SAP Business One verisine ve iş nesnelerine web üzerinden erişim sağlayan uygulama sunucusudur; SAP'nin kılavuzu onu HTTP ve OData protokolleri üzerine kurulu, yeni nesil bir uzantı API'si olarak tanımlar. Yox İş Ortağım SAP B1'e yalnız Service Layer üzerinden bağlanır; masaüstü istemciye, DI API kurulumuna ya da veritabanına doğrudan erişim istemez. Kılavuzdaki temel bilgiler ve kurulumdaki karşılıkları:
| Konu | SAP kılavuzundaki bilgi (sürüm 1.29, Temmuz 2026) | Kurulumdaki anlamı |
|---|---|---|
| Protokol | HTTP ve OData; OData sürüm 3 için /b1s/v1, sürüm 4 için /b1s/v2 yolu | Panel istekleri /b1s/v1 yolu üzerinden gönderir |
| Varsayılan bağlantı | HTTPS varsayılandır; kılavuzdaki örnek adres https://databaseserver:50000/b1s/v1 | Panele sunucu adı ve port girilir; port kurulumunuza göre farklı olabilir |
| Oturum açma | Login isteği CompanyDB, UserName ve Password ile yapılır; yanıtta B1SESSION çerezi döner | Paneldeki şirket veritabanı, kullanıcı adı ve şifre alanları bu üç bilgidir |
| Kurulum | Sunucu bileşenleri kurulum sihirbazıyla kurulur; uzaktan kurulum desteklenmez | Service Layer'ı iş ortağınız ya da IT ekibiniz SAP sunucusuna kurar |
| İşletim sistemi | SUSE Linux Enterprise ve Microsoft Windows (Windows için SAP Business One 10.0 PL01 ve sonrası) | SQL Server ve SAP HANA kurulumlarında bağlantı yöntemi aynıdır |
Panele girilecek adres: kök adres mi, /b1s/v1 dahil mi?
Panelde istenen Service Layer URL'si protokol, sunucu adı ve porttan oluşan kök adrestir; örneğin https://sap.sirketiniz.com.tr:50000 gibi. Panel oturum ve veri isteklerinde /b1s/v1 yolunu kendisi ekler. Adresi /b1s/v1 ile birlikte yazarsanız istekler yanlış yola gider ve bağlantı testi başarısız olur.
Dış erişim ve güvenlik duvarı
Yox İş Ortağım bulutta çalışan bir panel olduğu için Service Layer adresinin internetten erişilebilir olması gerekir; şirket içi sunucularda bu adres çoğunlukla yalnız yerel ağda açıktır. Dışarıya hangi kurallarla açılacağı IT ekibinizin kararıdır. SAP de kılavuzunda, yük dengeleyici ile Service Layer düğümleri arasındaki trafik HTTP olduğu için düğümlerde yalnız yük dengeleyiciden gelen erişime izin verilmesini öneriyor.
Bir pazaryeri siparişi SAP B1'e hangi sırayla ve hangi belgeyle ulaşır?
Pazaryeri siparişi SAP Business One'a, paneldeki sipariş durumlarına bağlı bir sırayla ulaşır. Otomatik fatura ve otomatik ERP aktarımı açıkken akış şöyledir:
- Sipariş Trendyol, Hepsiburada ya da sitenizden panele düşer ve tek sipariş listesinde Yeni durumunda görünür.
- Siparişi Hazırlanıyor durumuna aldığınızda otomatik fatura açıksa fatura kesilir. Panele bağlı bir e-Fatura sağlayıcısı yoksa fatura SAP B1'de A/R satış faturası olarak oluşturulur.
- Fatura kesilince sipariş Faturalandı durumuna geçer.
- Otomatik ERP aktarımı açıksa faturalanan sipariş SAP B1'e satış siparişi olarak gönderilir; SAP'nin döndürdüğü belge numarası siparişin geçmişine yazılır.
- Kargo ve teslimat aşamaları panelde sürer; SAP'de teslimat belgesi panelden açılmaz.
Satış siparişi aktarımında SAP'ye giden alanlar
Satış siparişinde alıcının adı, pazaryeri sipariş numarası ve her satır için kalem kodu, adet ve birim fiyat gider. Sipariş numarası SAP belgesinin müşteri referans numarası (NumAtCard) alanına yazılır; muhasebe ekibiniz bir siparişi SAP'de bu numarayla bulabilir. Otomatik aktarımı kapalı tutup siparişleri listeden seçerek ya da toplu olarak da gönderebilirsiniz; daha önce aktarılmış sipariş tekrar gönderilmez.
A/R fatura kesme: belge SAP'de oluşur, GİB iletimi SAP tarafındadır
Fatura kesme işi, siparişten SAP B1'de A/R satış faturası belgesi oluşturur. SAP Learning'e göre öncesinde teslimat belgesi olmayan bir A/R faturası, malın stoktan çıkışını da kaydeder; yani bu yolda stok SAP'de faturayla düşer. Belgenin GİB'e e-Arşiv ya da e-Fatura olarak iletilmesi, SAP iş ortağınızın kurduğu e-belge çözümüne bağlıdır. Fatura PDF'i panele dönmediği için bu yolda faturanın pazaryerine otomatik yüklenmesi yapılmaz.
İki iş birlikte açıkken nelere dikkat etmelisiniz?
SAP B1 stoğu panele nasıl gelir: kalem kodu, stoktaki miktar ve taahhüt
Stok çekme, SAP B1'deki kalem ana verisinden kalem kodunu ve stoktaki miktarı okur; panelde stok kodu SAP'deki kalem koduyla birebir aynı olan ürünlerin stoğu bu miktarla güncellenir ve pazaryerlerine aynı ürün kartından gider. Kodları eşleşmeyen ürünler güncellenmez; bu yüzden eşleşme kurulumun en kritik adımıdır. Okunan rakamı doğru yorumlamak için SAP belgelerinin stoğa etkisini bilmek gerekir:
| SAP B1 belgesi | Stoktaki miktar | Diğer etkisi (SAP Learning) |
|---|---|---|
| Satış siparişi | Değişmez | Kullanılabilir stok azalır, taahhüt edilen miktar artar; stok hareketi ve muhasebe kaydı oluşmaz |
| Teslimat | Azalır | Satış siparişine dayanıyorsa o siparişin taahhüt edilen miktarı da düşer |
| Öncesinde teslimat olmayan A/R faturası | Azalır | Satılan malın maliyeti hesabına borç, stok hesabına alacak kaydı oluşur |
Panel kalem kartındaki stoktaki miktarı okur; bu miktar kalemin bütün depolarındaki stoğu kapsar. Fatura SAP'de kesiliyorsa satış faturayla birlikte stoktan düşer ve bir sonraki stok çekmede panele yansır. Fatura başka yerde kesiliyor ve SAP'ye yalnız satış siparişi gidiyorsa, o sipariş SAP'de teslimat ya da faturayla kapatılana kadar stoktaki miktar düşmez. Stok çekme sıklığını ve SAP'deki kapanış rutininizi buna göre planlayın.
Stok ne sıklıkla çekilir, hangi durumlar ayrıca konuşulmalı?
- Stok çekmeyi panelden elle başlatabilir ya da 6, 12, 24, 48, 72 saatte veya haftada bir çalışacak biçimde zamanlayabilirsiniz.
- Çekilen miktar tam sayıya yuvarlanır; kilogram ya da metre gibi kesirli birimle stok tutulan kalemleri kurulumda ayrıca değerlendirin.
- Pazaryerinde yalnız belirli bir deponun stoğunu satmak istiyorsanız bunu kurulum görüşmesinde belirtin.
SAP Business One entegrasyonu için veri hazırlığı: müşteri kartı, kalem kodu ve vergi kodu
SAP Business One entegrasyonunda hataların çoğu bağlantıdan değil, SAP'deki ana verinin gelen belgeyi karşılamaya hazır olmamasından çıkar. Panel SAP'de müşteri ya da kalem kartı açmadığı için belgenin dayanacağı kartların önceden SAP'de bulunması gerekir. Tabloyu iş ortağınıza iletebilirsiniz:
| Panelin gönderdiği bilgi | SAP B1'deki karşılığı | Kurulumdan önce hazırlık |
|---|---|---|
| Alıcı adı | Belgedeki muhatap adı (CardName); belge bir muhatap (business partner) kartına bağlanmalıdır | Pazaryeri siparişlerinin hangi müşteri kartına düşeceğini belirleyin |
| Pazaryeri sipariş numarası | Müşteri referans numarası (NumAtCard) | Ek hazırlık gerekmez |
| Stok kodu | Kalem kodu (ItemCode) | Satılan her ürün için SAP'de aynı kodla açılmış kalem kartı |
| Stok kodu boş satır | GENEL kalem kodu | Bütün ürünlere stok kodu verin ya da SAP'de GENEL kodlu bir kalem tanımlayın |
| Adet ve birim fiyat | Belge satırındaki miktar ve birim fiyat | Fiyatın KDV hariç mi dahil mi işlendiğini ilk test siparişinde kontrol edin |
Bireysel alıcılar için müşteri kartı kararı
Pazaryeri alıcılarının çoğu bireysel tüketicidir; her biri için ayrı muhatap kartı açmak gereksiz yüktür. Panel siparişi alıcının adıyla gönderir; siparişin hangi müşteri kartına bağlanacağı SAP ortamınızın ayarına bağlıdır ve kurulumda iş ortağınızla birlikte belirlenir. Sık görülen yaklaşım, bütün pazaryeri satışları ya da her kanal için tek bir genel müşteri kartı tutmaktır; kararı muhasebe ekibinizle birlikte verin.
Vergi kodu, birim fiyat ve KDV kontrolü
Panel belge satırlarında SAP'ye vergi kodu göndermez; KDV, SAP'deki kalem ve muhatap tanımlarınızdaki vergi koduyla hesaplanır. Pazaryerlerinde tüketiciye gösterilen fiyatlar KDV dahildir; bu yüzden ilk test siparişinde SAP'deki belge toplamını pazaryerindeki sipariş toplamıyla karşılaştırın. Tutarları elle kontrol ederken KDV hesaplama aracı işinizi hızlandırır.
Faturayı SAP B1'de mi, panele bağlı e-Fatura sağlayıcısında mı kesmelisiniz?
Faturayı nerede keseceğiniz, SAP Business One kurulumunuzda GİB'e e-Arşiv ve e-Fatura gönderebilen bir e-belge çözümü olup olmadığına bağlıdır. Panel, bağlı bir e-Fatura sağlayıcısı varsa faturayı önce ona keser; yoksa faturayı SAP B1'de oluşturur. Kararı vermeden önce 2026'da pazaryeri satıcısını ilgilendiren e-belge kurallarını hatırlayın:
- GİB'e göre e-Fatura uygulamasına kayıtlı mükellefler birbirlerine düzenledikleri faturaları e-Fatura olarak göndermek zorundadır; kayıtlı olmayan alıcıya e-Arşiv fatura düzenlenir.
- 535 Sıra No'lu VUK Genel Tebliği'ne göre internet ü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 VUK Genel Tebliği ile e-Arşiv Fatura düzenleme zorunluluğu 2025'te vergiler dahil 3 Bin TL'yi aşan faturalar için uygulandı; 1 Ocak 2026'dan itibaren tutarına bakılmaksızın uygulanıyor.
| Karşılaştırma | Fatura SAP B1'de | Fatura panele bağlı e-Fatura sağlayıcısında |
|---|---|---|
| Faturanın oluştuğu yer | SAP B1'de A/R satış faturası | e-Fatura sağlayıcısında |
| GİB'e iletim | SAP iş ortağınızın kurduğu e-belge çözümü | Sağlayıcı üzerinden |
| Fatura PDF'inin pazaryerine yüklenmesi | Panel yüklemez | Kanal destekliyorsa panel yükler |
| SAP'deki kayıt | Fatura SAP'de oluşur, stok faturayla düşer | SAP'ye satış siparişi gider; fatura SAP'ye aktarılmaz |
| Panelde bağlı program sayısı | 1 (SAP B1) | 2 (SAP B1 ve e-Fatura sağlayıcısı) |
| Gereken en düşük paket | Profesyonel | Kurumsal |
İkinci yolu düşünüyorsanız Nilvera entegrasyonu sayfası, bir e-Fatura sağlayıcısının panelde nasıl çalıştığını gösterir. Hangi yolu seçerseniz seçin aynı siparişi iki sistemde birden faturalamayın: panel faturası kesilmiş siparişi yeniden faturalamaz, ancak SAP'de elle açılan ikinci bir fatura iptal ve düzeltme işi doğurur. Mükellefiyetinizle ilgili son kararı mali müşavirinizle verin.
SAP Business One bağlantısı hangi Yox İş Ortağım paketinde, ne kadar?
SAP Business One bağlantısı Profesyonel, Kurumsal ve Enterprise paketlerinde kullanılabilir; Başlangıç ve Büyüme paketlerinde muhasebe, e-Fatura ya da ERP programı bağlanmaz. Panelde 51 muhasebe, e-Fatura ve ERP programı tanımlıdır ve SAP B1 bunlardan biri olarak sayılır. Pazaryeri ve site bağlantıları aynı paketin kanal hakkından kullanılır; SAP B1 bu haktan düşmez.
| Paket | Aylık fiyat | Muhasebe / ERP programı | Satış kanalı | Ürün | Aylık sipariş | Kullanıcı |
|---|---|---|---|---|---|---|
| Başlangıç | ₺499 | Yok | 1 | 500 | 100 | 1 |
| Büyüme | ₺999 | Yok | 3 | 5.000 | 500 | 2 |
| Profesyonel | ₺1.999 | 1 program | 5 (28 kanaldan) | 10.000 | 2.000 | 3 |
| Kurumsal | ₺3.999 | 3 program | Sınırsız | 25.000 | 5.000 | 10 |
| Enterprise | ₺7.999 | Sınırsız | Sınırsız | Sınırsız | Sınırsız | Sınırsız |
Yıllık ödemede %20 indirim uygulanır. Faturayı SAP B1'de kesecekseniz Profesyonel paket yeterlidir; yanına ayrı bir e-Fatura sağlayıcısı bağlayacaksanız iki program gerektiği için Kurumsal paket gerekir. Çok şirketli gruplar için Enterprise paketinde çoklu şirket ve özel SLA bulunur. SAP B1 lisansı ve iş ortağı hizmetleri bu fiyatlara dahil değildir. Bütün limitleri paket karşılaştırmasında görebilir, paneli 3 gün ücretsiz deneyebilirsiniz. Komisyon ve kargo sonrası gerçek kârınızı görmek için kâr hesaplama aracı da işinize yarar.
SAP Business One entegrasyonu karar rehberi: kurulum sırası, kontrol listesi ve sık hatalar
SAP Business One entegrasyonunu kurmanın en güvenli yolu, önce satış kanallarını bağlayıp stok kodu eşleşmesini görmek, SAP bağlantısını en sona bırakmaktır.
Önerilen kurulum sırası
- Yox İş Ortağım'a başvurun (başvuru formu) ve pazaryeri mağazalarınızı, örneğin Trendyol hesabınızı, resmî API anahtarıyla bağlayın; ilanlar panele okunur ve stok koduyla eşleşir.
- İş ortağınızdan Service Layer kök adresini, şirket veritabanının adını ve yalnız entegrasyon için açılmış bir SAP B1 kullanıcısını isteyin.
- Bilgileri panelin Muhasebe bölümüne girip bağlantıyı test edin. Test, bu bilgilerle Service Layer'a oturum açılabildiğini doğrular; kullanıcının belge yazma yetkisi ilk aktarımda ortaya çıkar.
- Mümkünse önce SAP'deki test şirketinin veritabanıyla bir siparişi aktarın ve bir siparişin faturasını kesin; oluşan belgeleri muhasebe ekibinizle SAP'de kontrol edin.
- Canlı veritabanına geçin, stok çekme aralığını seçin, ardından otomatik fatura ve otomatik ERP aktarımını ihtiyacınıza göre açın.
Kurulumdan önce yanıtlanacak sorular
- Fatura SAP B1'de mi kesilecek, e-Fatura sağlayıcısında mı? Bu karar paketinizi de belirler.
- SAP'ye hem fatura hem satış siparişi mi gidecek, yoksa yalnız biri mi?
- Pazaryeri siparişleri SAP'de hangi müşteri kartına bağlanacak?
- Satılan bütün ürünlerin SAP'de aynı kodla kalem kartı var mı?
- Service Layer internetten hangi güvenlik kurallarıyla erişilebilir olacak?
Sık yapılan hatalar
- Service Layer adresini /b1s/v1 yoluyla birlikte girmek; panel bu yolu kendisi ekler.
- Şirket veritabanı alanına ekranda görünen şirket unvanını yazmak; SAP'nin beklediği değer veritabanının adıdır.
- Entegrasyon için günlük kullanılan bir personel hesabını vermek; şifre değiştiğinde aktarımlar durur.
- Kalem kodlarını eşitlemeden stok çekmeyi açmak; eşleşmeyen ürünler güncellenmez ve fark gözden kaçar.
- Fatura SAP'de kesilirken aynı siparişi SAP'de elle de faturalamak.
Kurulumu birlikte yapmak isterseniz iletişim sayfasından görüşme talebi bırakabilirsiniz; ilk siparişleri sizinle ve iş ortağınızla birlikte doğrularız. Diğer ERP, kargo ve pazaryeri bağlantıları için entegrasyon listesine göz atabilirsiniz.
Son kontrol: 13 Ekim 2026
