Oracle NetSuite entegrasyonu:
siparişin faturası kendiliğinden kesilir.

NetSuite entegrasyonu kimler için anlamlı, panel ile ERP arasındaki iş bölümü nedir?

Oracle NetSuite, finans, stok, satın alma ve sipariş kayıtlarını tek veritabanında tutan bulut tabanlı bir ERP'dir; pazaryeri satıcısı için NetSuite entegrasyonu, muhasebe ekibinin çalıştığı sistem ile satış kanallarının çalıştığı paneli aynı sipariş numarası üzerinden birbirine bağlamak demektir. NetSuite bir e-Fatura entegratörü ya da basit bir ön muhasebe programı değildir; genelde birden fazla depo, para birimi ya da şirketle çalışan işletmeler tercih eder.

Bu yapıda roller nettir. Kanal tarafındaki işler, yani ilanlar, fiyat farkları, sipariş durumları, kargo ve iade kutusu panelde yürür. Finans ve stok kaydının ana kaynağı ise NetSuite olarak kalır. Satış kanallarınızın tamamını Yox İş Ortağım entegrasyon sayfasında görebilirsiniz; NetSuite bunların hepsinden gelen siparişleri aynı yoldan alır.

OneWorld kullanan çok şirketli yapılar

Oracle'ın dokümanına göre NetSuite OneWorld, tek hesapta birden fazla tüzel kişiliği (subsidiary) farklı vergi bölgeleri ve para birimleriyle yönetmeyi sağlar ve OneWorld'de neredeyse her işlem tek bir subsidiary'ye bağlanır. Pazaryeri siparişlerinin hangi şirkete yazılacağı bu yüzden kurulumdan önce verilmesi gereken bir karardır:

• Türkiye'deki pazaryerleri için tek bir Türk şirketi mi kullanılacak, yoksa yurt dışı kanalları ayrı bir şirkete mi yazılacak?
• Stok hangi şirketin ya da lokasyonun miktarından okunacak?
• Muhasebe ekibi bu siparişleri NetSuite'te hangi formla ve hangi müşteri kaydıyla görmek istiyor?

Yox İş Ortağım NetSuite'te hangi kaydı açar, hangi bilgiyi okur?

Panelin NetSuite bağlantısı üç iş yapar ve her biri NetSuite'in REST servisindeki belirli bir kayıt türüne karşılık gelir. Müşteri kartı, ürün kartı ya da başka bir sistemde kesilmiş faturayı NetSuite'e aktaran ayrı bir iş yoktur; ürünler stok koduyla eşleşir, kartlar iki tarafta ayrı ayrı tutulur.

External ID neden önemli?

Oracle, external ID'nin asıl kullanım amacını NetSuite dışındaki verilerle senkronizasyon olarak tanımlar ve bir kaydın, kayıt türü ile external ID ya da sistemin verdiği internal ID ile benzersiz biçimde tanımlandığını belirtir. Panel pazaryeri sipariş numarasını bu alana yazdığı için NetSuite'te bir siparişi kanal numarasıyla aramak kolaylaşır. Oracle'a göre external ID harf, rakam, alt çizgi ve tire içerebilir; kanal sipariş numaraları bu kalıba uyar.

Müşteri ve satır eşlemesi kurulumda neden birlikte yapılır?

Oracle'ın satış siparişi anlatımında sipariş bir müşteriye düzenlenir ve en az bir ürün satırı içerir. Bu müşteri kaydının ve satırların hangi internal ID'lerle eşleşeceği her NetSuite hesabında farklıdır: kullandığınız sipariş formu, varsayılan değerler ve subsidiary yapısı belirleyicidir. Bu yüzden eşlemeyi kurulumda sizin ya da NetSuite iş ortağınızın yapılandırmasına göre birlikte yapar, ilk siparişi NetSuite'te birlikte kontrol ederiz.

Bir Trendyol siparişi NetSuite'e hangi sırayla ulaşır?

Panelde sipariş akışı durumlara bağlıdır ve NetSuite'e giden kayıtlar bu durumlara göre tetiklenir. Aşağıdaki sıra, otomatik fatura ve otomatik ERP aktarımı açık bir satıcının Trendyol entegrasyonu üzerinden gelen bir siparişi için geçerlidir:

1. Sipariş panelin tek sipariş listesine Yeni olarak düşer, eşleşen ürünlerin stoğu panelde rezerve edilir ve diğer kanallardaki stok aynı ürün kartından güncellenir.
2. Sipariş Hazırlanıyor durumuna geçtiğinde otomatik fatura açıksa fatura kuyruğa alınır. Panele ayrı bir e-Fatura sağlayıcısı bağlı değilse fatura NetSuite'te invoice kaydı olarak kesilir.
3. Sipariş Faturalandı durumuna geçtiğinde otomatik ERP aktarımı açıksa sipariş NetSuite'e salesOrder kaydı olarak gönderilir ve NetSuite'in döndürdüğü kayıt numarası siparişe yazılır.
4. Aktarım ya da fatura hata verirse sebebi siparişin geçmişinde görünür; NetSuite'e gitmemiş faturalı siparişler otomatik akışta daha sonra yeniden denenir.
5. Kargo ve teslim adımları panelde devam eder; NetSuite'teki sipariş kaydı bu adımlardan etkilenmez.

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

Otomatik ERP aktarımını kapalı tutup siparişleri listeden seçerek toplu da gönderebilirsiniz. Panel NetSuite'ten kayıt numarası almış bir siparişi ikinci kez göndermez; bu, ilk haftalarda elle ve otomatik gönderimi birlikte kullanırken çift kayıt riskini azaltır.

Stok çekme ne zaman çalışır?

Stok çekme iki yolla çalışır: Muhasebe ekranındaki stok çekme düğmesiyle elle ya da 6 saat, 12 saat, günlük, 2 gün, 3 gün ve haftalık seçeneklerinden biriyle otomatik. Panel NetSuite'ten yalnız pasif olmayan ürünlerin kodunu ve kullanılabilir miktarını okur, kodu panel stok koduyla aynı olan ürünleri günceller ve yeni stoğu bağlı kanallara dağıtır.

NetSuite entegrasyonu için TBA kurulumu: özellikler, rol ve erişim anahtarı

Panel NetSuite'e kullanıcı adı ve şifreyle değil, Oracle'ın token tabanlı kimlik doğrulamasıyla bağlanır ve her isteği HMAC-SHA256 ile imzalar. Kurulumu NetSuite yöneticiniz ya da Setup yetkisi olan bir kullanıcı yapar; Oracle dokümanındaki menü yolları şöyledir:

1. Setup > Company > Enable Features sayfasında SuiteCloud sekmesine geçin; Manage Authentication bölümünde Token-based Authentication, SuiteTalk (Web Services) bölümünde REST Web Services kutusunu işaretleyip SuiteCloud kullanım koşullarını kabul edin ve kaydedin.
2. Setup > Users/Roles > User Management > Manage Roles altında entegrasyon için ayrı bir rol açın ve aşağıdaki tablodaki izinleri ekleyin; satış siparişi, fatura ve ürün kayıtlarına erişimi de bu role verin.
3. Bu rolü yalnız entegrasyonda kullanılacak bir kullanıcıya atayın.
4. Setup > Integration > Manage Integrations > New ile bir entegrasyon kaydı açın; State alanı Enabled kalsın, Authentication sekmesinde Token-based Authentication işaretli olsun. Kaydedince Consumer Key ve Consumer Secret görünür.
5. Setup > Users/Roles > Access Tokens > New ile bu entegrasyon kaydı, kullanıcı ve rol için erişim anahtarı oluşturun. Kaydedince Token ID ve Token Secret görünür.
6. Setup > Company > Company Information sayfasındaki Account ID değerini büyük-küçük harfe dikkat ederek not edin ve beş bilgiyi panelin Muhasebe bölümüne girip bağlantıyı test edin.

Entegrasyon rolünün izinleri

Oracle, web servis entegrasyonlarında Administrator rolünün kullanılmasını güvenlik nedeniyle önermez. Ayrıca User Access Tokens izni olan kullanıcının ayrıca Log in using Access Tokens iznine ihtiyaç duymadığını belirtir.

Account ID, sandbox ve gizli anahtarlar

• Panel REST adresini Account ID'den kurar; Oracle'a göre adres hesap kimliğine özeldir ve SuiteTalk adresi Company Information sayfasının Company URLs sekmesinde görünür.
• Oracle'a göre üretim hesabında oluşturulan tokenlar sandbox ya da Release Preview hesaplarına kopyalanmaz; sandbox yenilendikçe yeni token gerekir.
• Consumer Key/Secret ile Token ID/Secret yalnız bir kez gösterilir. Consumer bilgileri yeniden üretilebilir, kaybolan token için yeni erişim anahtarı açmanız gerekir.
• Bu değerleri e-posta ya da mesajla paylaşmayın; panele kendiniz girin ya da kurulum görüşmesinde ekranınızda birlikte girelim.

Oracle'ın TBA takvimi NetSuite entegrasyonunu nasıl etkiler?

Oracle NetSuite yardım merkezine göre 2027.1 sürümünden itibaren SOAP ve REST web servisleri ile RESTlet'ler için TBA kullanan yeni entegrasyon oluşturulamayacak; mevcut entegrasyonlar çalışmaya devam edecek. Oracle yeni entegrasyonlar için OAuth 2.0'ı önerir. Panelin NetSuite bağlantısı bugün TBA bilgileriyle kurulduğu için bu takvim, kurulum zamanlamanızı doğrudan ilgilendirir.

Oracle'ın TBA sayfası iki adımlı doğrulama konusunda da açıktır: 2FA zorunlu roller kullanıcı parolasıyla entegrasyonda kullanılamaz, ancak bu roller TBA ile kullanılabilir. Bu yüzden 2FA'yı entegrasyon için kapatmanız gerekmez.

NetSuite'te fatura ve Türkiye e-belge kuralları

NetSuite'te oluşan bir invoice kaydı, kendiliğinden GİB'e iletilmiş bir e-Fatura ya da e-Arşiv Fatura değildir. Oracle'ın bölgeye özel SuiteApp listesinde Avrupa, Amerika ve Asya-Pasifik'ten ülkeler yer alır; Türkiye bu listede bulunmuyor. Faturanın GİB'e hangi yolla ulaşacağını NetSuite iş ortağınız ve mali müşavirinizle kurulumdan önce yazılı olarak netleştirin.

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

• GİB'e göre e-Fatura uygulamasına kayıtlı mükellefler birbirlerine düzenledikleri faturaları e-Fatura olarak göndermek ve almak zorundadır.
• Kayıtlı olmayan alıcılara, e-Arşiv uygulamasına dahil olan ya da dahil olması gereken mükellefler e-Arşiv Fatura düzenler.
• 573 Sıra No'lu VUK Genel Tebliği'ne göre e-Arşiv Fatura zorunluluğu 2025'te vergiler dahil 3 Bin TL'yi aşan faturalara uygulanırken, 1 Ocak 2026'dan itibaren tutarına bakılmaksızın uygulanır.
• Bazı mükellef grupları için geçiş tarihleri farklı olabilir; kendi durumunuz için son kararı mali müşavirinizle verin.

Fatura NetSuite'te mi, panele bağlı bir e-Fatura sağlayıcısında mı kesilmeli?

Panel faturayı keserken önce bağlı bir e-Fatura sağlayıcısı arar; sağlayıcı yoksa faturayı NetSuite'te keser. İki yolun farkı şöyledir:

İ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şe iki sistemde fatura kesmeyin; tutarları kontrol ederken KDV hesaplama aracı işinizi kısaltır.

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

Muhasebe, e-Fatura ve ERP bağlantıları Başlangıç ve Büyüme paketlerinde yoktur. NetSuite, Profesyonel paketteki tek program hakkını kullanır; NetSuite'in yanında bir e-Fatura sağlayıcısı da bağlayacaksanız Kurumsal paket gerekir. Güncel paket ayrıntıları paketler bölümündedir.

• Yıllık ödemede %20 indirim uygulanır; deneme süresi 3 gündür.
• Profesyonel ve üstü paketlerde ürün ve kanal bazında kâr, kesinti raporları da açılır; NetSuite'e giden sipariş ile panelde görünen net kâr aynı sipariş numarasıyla izlenir.
• Birden fazla NetSuite subsidiary'sini ayrı şirketler olarak yönetmeniz gerekiyorsa çoklu şirket desteği olan Enterprise paketini görüşelim.

NetSuite entegrasyonu karar rehberi: kontrol listesi ve sık hatalar

NetSuite entegrasyonunda ilk haftanın sorunları çoğunlukla bağlantıdan değil, iki taraftaki verinin farklı tutulmasından çıkar. Kurulum görüşmesinden önce aşağıdaki soruları yanıtlamak işi belirgin biçimde kısaltır; isterseniz kurulumu birlikte yapar, ilk siparişi NetSuite'te birlikte doğrularız.

Kurulumdan önce yanıtlanacak sorular

• NetSuite'teki ürün kodları ile pazaryerindeki stok kodları birebir aynı mı? Varyantlı ürünlerde her beden ve renk ayrı kodla mı duruyor?
• Fatura NetSuite'te mi kesilecek, yoksa ayrı bir e-Fatura sağlayıcısında mı? GİB'e iletimi kim yapıyor?
• Bireysel alıcıların siparişleri NetSuite'te hangi müşteri kaydına, kurumsal alıcılarınki hangi kayda bağlanacak?
• OneWorld kullanıyorsanız siparişler hangi subsidiary'ye, stok hangi lokasyondan okunacak?
• Hesabınız 2027.1 sürümüne ne zaman geçiyor?

Sık yapılan hatalar

Benzer bir yapıyı başka bir ERP ile karşılaştırmak isterseniz SAP Business One entegrasyonu sayfasına bakabilirsiniz. Hazırsanız Yox İş Ortağım'a başvurun; ön görüşmede NetSuite hesabınızın yapısını birlikte inceleyelim.