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

Odoo nedir ve Odoo entegrasyonu pazaryeri satıcısına ne kazandırır?

Odoo, Belçika merkezli Odoo S.A. tarafından geliştirilen; muhasebe, satış, envanter, satın alma ve e-ticaret uygulamalarını aynı veritabanında çalıştıran modüler bir kurumsal kaynak planlama (ERP) yazılımıdır. Odoo'nun sürüm karşılaştırma sayfasına göre iki sürüm vardır: açık kaynaklı Odoo Community ve onun çekirdeği üzerine kurulan lisanslı Odoo Enterprise.

Pazaryerinde satan bir işletmede Odoo genellikle stoğun, satın almanın ve muhasebe kayıtlarının tutulduğu yerdir. Siparişler ise başka bir yerde doğar: Trendyol'a düşen bir sipariş Odoo'ya kendiliğinden gelmez. Bu iki taraf bağlanmadığında ekip aynı siparişi iki kez yazar, bir kanalda tükenen ürün diğer kanalda eski sayıyla satılmaya devam eder. Odoo entegrasyonunun asıl getirisi, siparişin ve stoğun tek kaynaktan yönetilmesidir.

• Satış kanalları tarafı: İlanlar, kanal fiyatları ve bütün kanalların siparişlerini gösteren tek liste Yox İş Ortağım'da durur.
• Odoo tarafı: Satış siparişi, müşteri faturası, stok hareketleri ve muhasebe kayıtları Odoo'da tutulur.
• Aradaki köprü: Sipariş ve fatura panelden Odoo'ya gider; stok miktarı Odoo'dan panele gelir ve kanallara dağıtılır.

Operasyon ekibi kanal işlerini panelde, muhasebe ekibi kayıtları Odoo'da yürütür. Panelin bağlandığı bütün kanal, kargo ve muhasebe programlarını entegrasyon sayfamızda görebilirsiniz; Odoo burada 51 muhasebe, e-Fatura ve ERP programından biri olarak yer alır.

Odoo entegrasyonu hangi işleri yapar, hangilerini yapmaz?

Yox İş Ortağım'daki Odoo bağlantısı üç iş yapar: siparişi Odoo'ya aktarır, Odoo'daki stoğu panele çeker ve siparişin müşteri faturasını Odoo'da oluşturur. Aşağıdaki tablo her işin yönünü ve Odoo'daki karşılığını gösterir.

Panelin ayrı bir cari kart, ürün kartı ya da fatura aktarımı yoktur. Sipariş Odoo'ya alıcının adı ve sipariş satırlarıyla (ürün adı, adet, birim fiyat) gider.

Müşteri kaydı ve vergi numarası Odoo'da nasıl karşılanır?

Alıcının adının Odoo'da hangi kişi ya da şirket kaydında karşılanacağı, bireysel alıcılar için genel bir kayıt kullanılıp kullanılmayacağı ve vergi bilgilerinin nasıl tamamlanacağı Odoo yapınıza bağlıdır; kurulumda birlikte belirleriz. Odoo'nun Türkiye dokümanına göre e-belge gönderilecek her müşteri kaydında adres, il, ülke, vergi numarası ve e-Fatura biçimi tanımlı olmalıdır.

Ürün eşleşmesi: Dahili Referans alanı

Ürünler stok koduyla eşleşir; ürün kartları Odoo'da ve panelde ayrı ayrı tutulur. Odoo tarafında bu kodun yeri, ürün formundaki Dahili Referans (Internal Reference) alanıdır. Kodu boş olan ürünün stoğu panele gelmez; aynı kodu iki farklı ürüne vermek ise stoğun yanlış ilana yazılmasına yol açar. Kodların panel kartlarındakiyle harfi harfine aynı olduğunu kurulumdan önce kontrol edin.

Odoo planınız ve barındırma türünüz entegrasyona izin veriyor mu?

Odoo'ya dışarıdan bir yazılımla bağlanabilmek için Custom fiyat planında olmanız gerekir. Odoo'nun dış API dokümanı, verilere dış API üzerinden erişimin yalnız Custom planda sunulduğunu, One App Free ve Standard planlarda bulunmadığını açıkça yazar. Fiyat sayfası da External API özelliğini yalnız Custom plan altında listeler.

Odoo Online (sirketiniz.odoo.com) kullanıyorsanız

Odoo Online'da sunucu adresi https://sirketiniz.odoo.com biçimindedir; veritabanı adı da bu adresin başındaki örnek adıdır (sirketiniz). Odoo'nun 18. sürüm dokümanına göre Odoo Online kullanıcıları yerel şifre olmadan oluşturulur. Bu yüzden bağlantıda şifre yerine kullanıcıya ait API anahtarını kullanmak en pratik yoldur: anahtar şifrenin yerine geçer, kullanıcı adı aynı kalır.

Odoo.sh ya da kendi sunucunuz (on-premise) kullanıyorsanız

Bu iki seçenekte adres ve veritabanı adı kurulumunuza özeldir; bilgileri sistem yöneticinizden ya da Odoo hizmeti aldığınız firmadan isteyin. Odoo 19 dokümanı, tek sunucuda birden fazla veritabanı barındırıldığında isteğin hangi veritabanına gideceğinin ayrıca belirtilmesi gerektiğini hatırlatır; panelde veritabanı adı bu nedenle ayrı bir alan olarak istenir. Sunucunuz yalnız şirket ağından erişilebiliyorsa panel ona ulaşamaz, adresin internetten erişilebilir olması gerekir. Community sürümünü kendi sunucunuzda çalıştırıyorsanız sürümünüzü ve erişim yapınızı kurulumdan önce birlikte kontrol ederiz.

Odoo API anahtarı ve entegrasyon kullanıcısı nasıl hazırlanır?

Panel Odoo için dört bilgi ister: sunucu adresi (URL), veritabanı adı, kullanıcı adı ve API anahtarı ya da şifre. Odoo, dış API'den gelen her işlemi o kullanıcının erişim hakları, kayıt kuralları ve alan izinleriyle denetler. Odoo 19 dokümanı sürekli çalışan entegrasyonlarda kişisel hesap yerine ayrı bir entegrasyon (bot) kullanıcısı açmayı önerir: en az yetkiyle sınırlanır ve kayıt geçmişinde işlemi kimin yaptığı ayrı görünür.

1. Odoo'da Settings ‣ Users & Companies ‣ Users (Ayarlar › Kullanıcılar ve Şirketler › Kullanıcılar) menüsünden entegrasyon için yeni bir kullanıcı açın; adını işlevini anlatacak biçimde koyun.
2. Kullanıcıya satış siparişi, müşteri faturası ve stok tarafında aktarımın gerektirdiği yetkileri verin; tam yönetici yetkisi vermeyin. Yetkilerin yeterli olup olmadığını kurulumda bağlantı testiyle birlikte sınarız.
3. Bu kullanıcının oturumunda Preferences ‣ Account Security ‣ New API Key (Tercihler › Hesap Güvenliği › Yeni API Anahtarı) adımlarını izleyin.
4. Anahtara sonradan tanıyabileceğiniz bir açıklama yazın; Odoo 19'da ayrıca bir geçerlilik süresi seçmeniz istenir.
5. Oluşan anahtarı hemen kopyalayıp güvenli bir yerde saklayın: Odoo anahtarı yalnız oluşturulduğu anda gösterir, sonradan tekrar görüntülemez.
6. Panelin Muhasebe bölümünde Odoo'yu seçin; sunucu adresini, veritabanı adını, kullanıcının giriş adını (login) ve anahtarı girip bağlantı testini çalıştırın.

Anahtar süresi, yenileme ve iptal

Odoo 19 dokümanına göre güvenlik nedeniyle üç aydan uzun süreli API anahtarı oluşturulamaz; uzun süre kullanılacak anahtarlar en geç üç ayda bir yenilenmelidir. Odoo'nun önerdiği sıra şudur: önce yeni anahtarı oluşturun, panele kaydedin, aktarımın yeni anahtarla sürdüğünü görün, eski anahtarı en son iptal edin. Anahtar arayüze giriş için kullanılamaz ama verilere şifre kadar erişim sağlar; onu şifre gibi saklayın.

Bir pazaryeri siparişi Odoo'ya hangi sırayla ulaşır?

Sipariş önce panelde toplanır, ürün eşleşmesinden geçer ve sizin belirlediğiniz kurala göre Odoo'ya yazılır:

1. Sipariş Trendyol, Hepsiburada ya da bağlı başka bir kanaldan panelin sipariş listesine düşer; satırlar barkod ya da stok koduyla panel kartına eşlenir.
2. Sipariş, alıcının adı ve satırlarıyla Odoo'ya satış siparişi olarak yazılır, kanal sipariş numarası referans olur.
3. Fatura kuralında belirlediğiniz aşamaya gelindiğinde panel siparişin müşteri faturasını Odoo'da oluşturur.
4. Stok, Odoo'daki teslimat ve stok hareketlerinizle değişir; panel bir sonraki stok çekmede yeni miktarı alır ve kanallardaki stoğu aynı ürün kartından günceller.

Satış siparişinin Odoo'daki sonraki adımları

Odoo'da bir satış siparişinin onaylanması, teslimat emri ve stok düşümü Odoo'nun kendi iş akışıyla yürür. Odoo dokümanına göre teslimat emri doğrulandığında eldeki miktar otomatik olarak azalır. Panelden gelen siparişlerin Odoo'da hangi adımlardan geçeceğini ilk siparişlerde kaydı birlikte açıp kontrol ederek netleştiririz; ek modül ve özel alanlar bu adımları değiştirebilir.

Odoo'nun fatura politikası ile panelin fatura kuralı çakışmasın

Odoo Sales uygulamasında iki fatura politikası vardır: varsayılan Invoice what is ordered (sipariş onaylanınca faturala) ve Invoice what is delivered (teslimat tamamlanınca faturala). Bu politika, faturayı Odoo içinden satış siparişi üzerinden kestiğinizde geçerlidir. Panelin fatura kuralı ise faturayı panelde seçtiğiniz aşamada oluşturur. İki yolu aynı siparişte birlikte kullanırsanız aynı satışa iki fatura çıkabilir; fatura ya Odoo'daki satış akışından ya da panelin kuralından kesilmelidir.

Odoo'da Türkiye e-Faturası ve e-Arşivi: Nilvera modülleri ve GİB kuralları

Odoo, GİB'e doğrudan belge gönderen bir özel entegratör değildir; Odoo'nun Türkiye yerelleştirme dokümanına göre e-Fatura, e-Arşiv, e-İrsaliye ve e-Defter süreçleri GİB onaylı aracı Nilvera üzerinden yürütülür. Türkiye muhasebe paketi kurulduğunda GİB 7/A hesap planı ve vergiler hazır gelir; Nilvera modülleri ise elle kurulur ve Nilvera'da üretilen API bilgileri Accounting ‣ Configuration ‣ Settings altındaki Türkiye Electronic Integrations bölümüne girilir.

Alıcı e-Fatura sistemine kayıtlı değilse Odoo belgeyi kendiliğinden e-Arşiv olarak seçer; kayıtlıysa fatura senaryosu seçilir. Belgenin Nilvera'ya iletilmesi Odoo'da faturanın gönderim adımında yapılır. Panel faturayı Odoo'da oluşturur; resmî gönderim Odoo'daki Nilvera kurulumunuzun işidir. Odoo bu yolla düzenlenen belgelerde numaranın üç karakterlik ön ek, yıl ve sıra numarasından oluşmasını zorunlu tutar (örnek: INV/2025/00001); fatura serisini buna göre belirleyin. Nilvera'nın panelde ayrı bir sağlayıcı olarak nasıl çalıştığını Nilvera entegrasyonu sayfasında anlattık.

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

• 535 Sıra No'lu VUK Genel Tebliği: İnternetten ya da pazaryerleri aracılığıyla satış yapanlar için e-Fatura ve e-Arşiv Fatura'ya geçiş sınırı 500 bin TL brüt satış hasılatıdır.
• 573 Sıra No'lu VUK Genel Tebliği: 2025 yılında vergiler dahil 3 bin TL'yi aşan faturaların e-Arşiv olarak düzenlenmesi gerekiyordu; 1 Ocak 2026'dan itibaren tutara bakılmaksızın e-Arşiv düzenlenir.
• 589 Sıra No'lu VUK Genel Tebliği: Basit usul mükellefleri ve işletme hesabı esasına göre defter tutanlar için tutar sınırı 2026 sonuna kadar sürer; tutarsız uygulama onlar için 1 Ocak 2027'de başlar.

Bu çerçeve genel bilgidir; kendi mükellefiyetinize ilişkin kararı mali müşavirinizle verin. Tutarlar için KDV hesaplama aracını kullanabilirsiniz.

Fatura Odoo'da mı, panele bağlı bir e-Fatura sağlayıcısında mı kesilmeli?

Faturayı nerede keseceğiniz, Odoo'da çalışan bir Nilvera kurulumunuz olup olmadığına ve muhasebe ekibinin hangi ekranda çalıştığına bağlıdır. Odoo'da e-belge kurulumu varsa faturayı Odoo'da kesmek, satış kaydını ve faturayı tek sistemde toplar. Kurulum yoksa panele ayrı bir e-Fatura sağlayıcısı bağlanır; siparişe otomatik e-Arşiv ya da e-Fatura kesilir, Odoo sipariş ve stok tarafında kalır.

Panelde hem bir e-Fatura sağlayıcısı hem Odoo bağlıysa fatura sağlayıcıda kesilir, Odoo'ya yalnız sipariş gider. Panel bir siparişe fatura kestiyse aynı siparişe ikinci kez kesmez; ancak aynı satışı Odoo içinden de faturalarsanız çift kayıt oluşur ve iptal işi doğar.

Odoo entegrasyonu hangi Yox İş Ortağım paketinde kullanılır?

Odoo bağlantısı Profesyonel, Kurumsal ve Enterprise paketlerinde kullanılır; Başlangıç ve Büyüme paketlerinde muhasebe, e-Fatura ya da ERP programı bağlanmaz. Odoo, panelde bağlanan programlardan biri olarak sayılır.

Yıllık ödemede %20 indirim uygulanır. Faturayı Odoo'da kesecekseniz Profesyonel paket yeterlidir; yanına ayrı bir e-Fatura sağlayıcısı bağlayacaksanız iki program gerektiği için Kurumsal paketi seçin. Odoo'da birden çok şirketi yönetiyorsanız Enterprise paketteki çoklu şirket seçeneğine bakın. Bütün limitleri paket karşılaştırmasında görebilir, paneli 3 gün ücretsiz deneyebilirsiniz.

• Bütün paketlerde stok ve fiyat senkronu, merkezi sipariş listesi ve stok sağlığı raporu vardır.
• Profesyonel ve üstünde ürün ve kanal bazında kâr raporu ile kesinti raporları açılır.
• Kurumsal pakette depo yönetimi (5 depo) ve B2B bayi portalı da bulunur.

Odoo entegrasyonu karar rehberi: kontrol listesi ve sık yapılan hatalar

Odoo entegrasyonuna karar vermeden önce üç soruyu netleştirin: stoğun tek kaynağı neresi olacak, fatura hangi sistemde kesilecek ve Odoo planınız dış bağlantıya izin veriyor mu?

Odoo içine pazaryeri modülü mü, dışarıdan bağlanan bir panel mi?

İki yol da kullanılır. Odoo içine modül kurduğunuzda kanal işleri Odoo ekranlarında yürür; modülün sürüm yükseltmelerinde güncel tutulması sizin sorumluluğunuzdadır. Dışarıdan bağlanan bir panelde ise ilanlar, kanal fiyatları, stok dağıtımı ve hakediş kontrolü panelde, satış ve muhasebe kayıtları Odoo'da kalır. Karar, kanal işlerini hangi ekranda yönetmek istediğinize bağlıdır.

Kurulumdan önce yanıtlanacak sorular

• Odoo planınız Custom mı, dış API erişimi açık mı?
• Entegrasyon kullanıcısı açıldı mı, API anahtarının bitiş tarihi not edildi mi?
• Satılan bütün ürünlerde Dahili Referans dolu ve paneldeki stok koduyla aynı mı?
• Bireysel alıcılar Odoo'da hangi müşteri kaydında karşılanacak, vergi bilgileri nasıl tamamlanacak?
• Fatura Odoo'da mı kesilecek, panele bağlı bir e-Fatura sağlayıcısında mı?

Sık yapılan hatalar

• Standard planda bağlantı denemek: Odoo bu planda dış API erişimi vermez; bağlantı testi kimlik hatası verir.
• Kişisel yönetici hesabını bağlamak: O kişi ayrıldığında ya da anahtarını sildiğinde aktarım durur.
• Odoo Online'da şifre girmeye çalışmak: Kullanıcılar yerel şifresiz açıldığı için API anahtarı kullanın.
• Stoğu iki yerden güncellemek: Stok hem panelde hem Odoo'da elle değiştirilirse sayılar birbirini ezer; tek kaynak seçin.
• Aynı siparişi iki yoldan faturalamak: Odoo'nun satış akışı ile panelin fatura kuralını aynı anda çalıştırmayın.

Paketinizi seçmeden önce Odoo yapınızı birlikte incelemek isterseniz bize ulaşın; hazırsanız Yox İş Ortağım'a başvurun, ön görüşmeden sonra kurulumu isterseniz birlikte yapalım.