Bizim Hesap entegrasyonu: siparişin belgesi, muhasebe kaydı ve depo stoğu aynı hesapta
Bizim Hesap entegrasyonu, pazaryerlerinden ve kendi sitenizden gelen siparişlerin faturasını Bizim Hesap hesabınız üzerinden düzenleyen, siparişi Bizim Hesap'ın ön muhasebe tarafına aktaran ve Bizim Hesap'taki depo stoğunu satış kanallarınıza taşıyan bağlantıdır. Yox İş Ortağım'da bu bağlantı iki kayıt hâlinde çalışır: biri belgeyi e-Fatura ya da e-Arşiv olarak düzenletir, diğeri sipariş aktarımı, fatura kesme ve stok çekme işlerini üstlenir. Aşağıda Ekim 2026 itibarıyla Bizim Hesap'ın resmî API dokümanını, GİB kurallarını, belge türünün nasıl seçildiğini, depo bazlı stoğun ne anlama geldiğini ve kurulumda en çok zaman kaybettiren hataları ayrıntılı olarak anlatıyoruz.
Bizim Hesap entegrasyonu nedir, Yox İş Ortağım'da hangi iki kayıtla çalışır?
Bizim Hesap entegrasyonu, Yox İş Ortağım panelindeki siparişleri Bizim Hesap A.Ş.'nin bulut tabanlı ön muhasebe programına bağlar: belge tarafında fatura üretilir, muhasebe tarafında satış kaydı açılır, stok tarafında Bizim Hesap'taki miktarlar panele okunur. Bizim Hesap, 2015'te kurulan ve KOBİ'lere gelir-gider, cari hesap, stok ve depo, sipariş, e-Fatura ve e-Arşiv işlerini tarayıcı ve mobil uygulama üzerinden sunan bir programdır; kurulum gerektirmez.
Burada sık karıştırılan bir nokta var: Bizim Hesap, GİB'in yayımladığı e-Fatura ve e-Arşiv özel entegratör listelerinde yer almaz (listeler Ekim 2026'da kontrol edildi). Bizim Hesap'ın kendi açıklamasına göre e-Fatura hizmeti Türkiye'de yetkili entegratörlerle çalışılarak verilir ve kullanıcı entegratörünü kendisi seçebilir. Kısacası faturanın düzenlendiği yer Bizim Hesap'tır; belgenin GİB'e ve alıcıya iletimi hesabınıza tanımlı entegratör üzerinden yürür. Panelin diğer muhasebe ve kanal bağlantılarını Yox İş Ortağım entegrasyonları sayfasında görebilirsiniz.
Belge kaydı ile ön muhasebe kaydı arasındaki iş bölümü
Panelin Muhasebe bölümünde Bizim Hesap iki ayrı kayıt olarak görünür. İkisi de aynı Bizim Hesap hesabına bağlanır, ama farklı ihtiyaçlara cevap verir:
- e-Fatura kaydı: Bireysel alıcının siparişi için e-Arşiv, e-Fatura mükellefi alıcının siparişi için e-Fatura düzenletir. Kesilen belgenin PDF'i panele gelir; kanal destekliyorsa siparişin geldiği pazaryerine yüklenir.
- Ön muhasebe kaydı: Siparişi Bizim Hesap programına aktarır, satış faturasını doğrudan Bizim Hesap üzerinden keser ve Bizim Hesap'taki stoğu panele çeker.
- Ayrı cari ya da ürün kartı aktarımı yapılmaz: Sipariş, müşteri adı ve vergi ya da TC kimlik numarasıyla birlikte gider. Ürünler stok koduyla eşleşir; ürün kartları Bizim Hesap'ta ve panelde ayrı ayrı tutulur. Cari kartın nasıl açılacağı Bizim Hesap'ın davranışına bağlıdır, kurulumda birlikte bakarız.
Bizim Hesap Entegrasyon API'si: resmî dokümanda hangi servisler var?
Bizim Hesap'ın apidocs.bizimhesap.com adresinde yayımladığı Entegrasyon API dokümanı dört servisten oluşur: sipariş/fatura ekleme, ürün listesi, depo listesi ve depo stoğu. Bu kısa liste, dışarıdan kurulan her Bizim Hesap bağlantısının neden sipariş, fatura ve stok üçgeninde kaldığını da açıklar; dokümanda cari listesi, tahsilat ya da e-İrsaliye için ayrı bir servis bulunmaz.
| Servis | Resmî adres | Ne yapar | Satıcı için anlamı |
|---|---|---|---|
| Sipariş / Fatura Ekleme | bizimhesap.com/api/b2b/addinvoice | Satış (tip 3) ya da alış (tip 5) siparişi/faturası ekler; başarılı istekte kayıt kimliği (guid) ve belge bağlantısı döner | Dışarıdan gelen bir siparişin Bizim Hesap'ta satış kaydına dönüşmesini sağlayan servis budur |
| Ürün Listesi Alma | bizimhesap.com/api/b2b/products | Kayıtlı ürünlerin listesini getirir | Stok kodlarının iki tarafta aynı olup olmadığını kontrol etmenin dayanağıdır |
| Depoların Listesi Alma | bizimhesap.com/api/b2b/warehouses | Kayıtlı depoları getirir | Birden fazla deponuz varsa hangi deponun esas alınacağı buradan görülür |
| Depo Stoğu Getirme | bizimhesap.com/api/b2b/inventory/{depo-id} | Tek bir deponun stoklarını getirir | Stok depo bazında okunur; depo seçimi kurulumun parçasıdır |
Key, Token ve FirmID ne işe yarar?
Dokümandaki ürün, depo ve stok servisleri iki başlık değeri ister: bütün entegrasyonlarda ortak olan Key ve hesabınıza ait Token. Fatura ekleme isteğinde ayrıca FirmID alanı vardır; doküman bunu Bizim Hesap'ın verdiği, firmaya özel tekil kimlik olarak tanımlar. Panelde sizden istenen firma token'ı ve API anahtarı bu hesaba özel değerlerdir; Bizim Hesap kullanıcı adınız ve giriş şifreniz istenmez. Dokümanda token'ın hangi menüden üretildiği yazmadığı için entegrasyon bilgilerini Bizim Hesap destek ekibinden istemenizi öneririz.
Kayıtta olmayan müşteri ve ürün otomatik açılır
Fatura ekleme servisinin açıklamasına göre gönderilen verideki müşteri ve ürün Bizim Hesap'ta yoksa otomatik olarak oluşturulur, ardından fatura kaydedilir. Bu kural iş yükünü azaltır ama bir bedeli vardır: paneldeki stok kodu Bizim Hesap'takinden farklıysa aynı ürün için yeni kartlar birikir ve stok çekme yanlış karttan okunur. Doküman satırlarda barkodu isteğe bağlı gösterirken KDV oranı, miktar ve birim fiyatı temel alanlar arasında sayar; ürün kartlarınızda stok kodunu ve KDV oranını eksiksiz tutmak kurulumun yarısıdır. Dokümanda para birimi olarak TL, USD, EUR, CHF ve GBP tanımlıdır.
Pazaryeri siparişi Bizim Hesap'a nasıl ulaşır: adım adım akış
Yox İş Ortağım'da bütün kanalların siparişleri tek listede toplanır ve Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim durumlarından geçer; Bizim Hesap bağlantısı bu zincirin fatura ve muhasebe halkasına oturur. Trendyol entegrasyonu ya da Hepsiburada entegrasyonu üzerinden gelen bir siparişin izlediği yol şöyledir:
- Sipariş kanalın resmî API'siyle panele düşer; alıcının adı, fatura adresi ve kurumsal siparişlerde vergi numarası siparişle birlikte okunur.
- Satırlar barkod ya da stok koduyla paneldeki tek stok kartına bağlanır; adet, birim fiyat ve KDV oranı netleşir.
- Sipariş seçtiğiniz fatura aşamasına geldiğinde e-Fatura kaydı alıcının durumuna göre e-Arşiv ya da e-Fatura düzenletir; belge Bizim Hesap'taki seri ve entegratör ayarınızla oluşur.
- Ön muhasebe kaydı açıksa sipariş; sipariş numarası, müşteri adı, vergi ya da TC kimlik numarası, stok kodu, adet, birim fiyat, ürün adı ve KDV oranıyla Bizim Hesap'a aktarılır.
- Faturanın PDF'i panele döner ve sipariş Faturalandı durumuna geçer; kanal destekliyorsa PDF siparişin geldiği pazaryerine yüklenir.
- Stok çekme açıksa Bizim Hesap'taki stok panele okunur ve bütün satış kanallarındaki stok aynı ürün kartından güncellenir.
Fatura aşamasını ve seriyi seçerken neye bakmalı?
Kurulumun son adımında faturanın hangi aşamada kesileceğini, e-Fatura ve e-Arşiv seçimini ve seri ayarlarını belirlersiniz. Siparişi onayladığınız anda fatura kesmek hızlıdır, ama alıcının vazgeçtiği siparişlerde belge iptali gerektirir; faturayı kargo aşamasına bırakmak iptal sayısını azaltır. Bizim Hesap hesabınızda birden fazla seri tanımlıysa entegrasyondan gelen belgeler için ayrı bir seri kullanmak, mali müşavirinizin pazaryeri satışlarını mağaza ve toptan satışlarından ayırmasını kolaylaştırır. Hangi seçimi yaparsanız yapın ilk gerçek siparişte belgeyi Bizim Hesap ekranında açıp unvanı, adresi ve KDV satırlarını kontrol edin.
e-Fatura mı e-Arşiv mi: Bizim Hesap üzerinden kesilen belgenin türü nasıl belirlenir?
Belgenin türünü program değil alıcının durumu belirler: GİB'in açıklamasına göre e-Fatura uygulamasına kayıtlı alıcıya e-Fatura, kayıtlı olmayan vergi mükellefine ve nihai tüketiciye e-Arşiv Fatura düzenlenir. Bireysel alıcıdan gelen pazaryeri siparişleri bu yüzden e-Arşiv ile faturalanır; şirketi adına fatura isteyen ve e-Fatura'ya kayıtlı bir alıcıda belge e-Fatura olur.
| Konu | e-Fatura | e-Arşiv Fatura |
|---|---|---|
| Kime düzenlenir | e-Fatura uygulamasına kayıtlı mükellefe | e-Fatura'ya kayıtlı olmayan mükellefe ve nihai tüketiciye |
| İletim | GİB'in merkezi sistemi üzerinden alıcıya | Alıcının talebine göre kâğıt ya da elektronik; internet satışlarında elektronik iletim zorunlu |
| Faturada aranan ek bilgi | Alıcının vergi kimlik numarası ve unvanı | Web adresi, ödeme şekli ve tarihi, taşıyanın unvanı ve VKN/TCKN'si, gönderim tarihi, internet satışı ibaresi |
| İptal ve itiraz | Faturayı alan 8 gün içinde itiraz etmezse içeriği kabul etmiş sayılır (TTK 21/2); itiraz ve iptaller GİB'e bildirilir | İptal, belgenin alıcıya iletildiği tarihten itibaren 8 gün içinde yapılır |
| Pazaryerinde tipik alıcı | Şirket adına fatura isteyen, e-Fatura'ya kayıtlı alıcı | Bireysel alıcı |
İnternet satışında e-Arşiv faturaya eklenen bilgiler
GİB'in yayımladığı güncel 509 Sıra No'lu Tebliğ metnine göre elektronik ticaret kapsamındaki e-Arşiv faturalarda satışın yapıldığı web adresi, ödeme şekli, ödeme tarihi, gönderiyi taşıyanın adı/unvanı ile VKN/TCKN'si ve gönderim tarihi yer almalı, faturada satışın internet üzerinden yapıldığını belirten ifade bulunmalıdır. Taşıyan ve gönderim tarihi siparişin kargoya verilmesiyle kesinleştiği için fatura aşamasını seçerken bunu hesaba katın ve ilk belgede bu alanların Bizim Hesap şablonunuzda nasıl göründüğüne bakın.
Hangi satıcı e-Fatura ve e-Arşiv kullanmak zorunda?
- 535 Sıra No'lu Tebliğ: Kendi sitesinde ya da pazaryerinde satış yapan mükelleflerden 2022 ve sonraki hesap dönemlerinde brüt satış hasılatı 500 Bin TL ve üzeri olanlar, izleyen dönemin yedinci ayının başına kadar e-Fatura'ya geçer.
- 573 Sıra No'lu Tebliğ: e-Arşiv'e dahil olmayanların faturaları 2025'te vergiler dahil 3 Bin TL'yi aşarsa, 1 Ocak 2026'dan itibaren tutarına bakılmaksızın e-Arşiv Fatura olarak düzenlenir.
- 589 Sıra No'lu Tebliğ: Basit usulde vergilendirilenler ve işletme hesabına göre defter tutanlar için 3 Bin TL eşiği 2026 sonuna kadar sürer; tutara bakılmaksızın e-Arşiv 1 Ocak 2027'de başlar.
Kendi durumunuz için son kararı mali müşavirinizle verin. e-Fatura'ya kayıtlı değilseniz ve belge sayınız düşükse GİB e-Arşiv Portal bağlantısı da değerlendirilebilecek bir seçenektir.
Bizim Hesap stok entegrasyonu: depo stoğunu satış kanallarına taşımak
Stok çekme, Bizim Hesap'taki miktarı ana kaynak kabul eden satıcılar içindir: mağazada, depoda ya da toptan satışta düşen stok önce Bizim Hesap'ta görünür, panel bu miktarı okur ve pazaryerlerindeki stok aynı ürün kartından güncellenir. Bizim Hesap'ın resmî API'si stoğu depo bazında verir; birden fazla deponuz varsa satış kanallarına hangi deponun stoğunun yansıyacağını kurulumdan önce netleştirin. Aksi hâlde showroom'daki teşhir ürünü ya da sevkiyat bekleyen toptan stok pazaryerinde satılabilir görünür.
Stok kodu eşleşmesi, varyantlar ve paket ürünler
Eşleşme stok koduyla yapılır. Panelde beden ve renk gibi her varyant ayrı bir stok birimi olduğu için Bizim Hesap'ta da her varyantın kendi stok koduyla tutulması eşleşmeyi doğru kurar. Panelde 5'li ve 10'lu paket seçenekleri tek stok biriminden düşer, setler de bileşenlerinden; bu yüzden Bizim Hesap'ta paketleri ayrı stok kalemi olarak açmak yerine tekil ürünün stok kodunu esas almak çift sayımı önler.
- Stok çakışmaları listesi, aynı kodun birden fazla ürüne bağlandığı ya da kanallarda farklı miktar göründüğü durumları gösterir.
- Kritik stok uyarısı, Bizim Hesap'tan gelen miktar belirlediğiniz eşiğin altına indiğinde sizi uyarır.
- Senkron sağlığı ekranı, pazaryerinin reddettiği stok ya da ilan güncellemesini sebebiyle birlikte listeler.
Elle faturalama ile Bizim Hesap entegrasyonu arasındaki fark
Elle çalışan satıcı her siparişi iki kez işler: önce pazaryeri panelinde, sonra Bizim Hesap ekranında. Bağlantı kurulduğunda sipariş bir kez girer, belge, muhasebe kaydı ve stok aynı kaynaktan beslenir. Aşağıdaki karşılaştırma yalnız panelde tanımlı işleri içerir:
| İş | Elle (pazaryeri paneli + Bizim Hesap ekranı) | Yox İş Ortağım ile Bizim Hesap bağlantısı |
|---|---|---|
| Siparişi muhasebeye girmek | Her sipariş Bizim Hesap'ta yeniden yazılır | Sipariş, satırları ve alıcı bilgisiyle Bizim Hesap'a aktarılır |
| Belge türünü seçmek | Alıcının e-Fatura kaydı her siparişte ayrıca kontrol edilir | e-Fatura ya da e-Arşiv seçimi kurala bağlanır |
| Faturayı siparişe eklemek | PDF indirilip pazaryeri paneline tek tek yüklenir | PDF panele gelir, kanal destekliyorsa pazaryerine yüklenir |
| Stoğu güncellemek | Bizim Hesap'taki değişiklik her kanalda elle girilir | Bizim Hesap stoğu panele çekilir, kanallar aynı karttan güncellenir |
| Yoğun gün | Siparişler tek tek ilerletilir | Toplu fatura ve etiket işlemleri tek listeden yapılır |
| Eksik belgeyi bulmak | Pazaryeri listesi ile Bizim Hesap kayıtları karşılaştırılır | Faturalanmamış sipariş, sipariş listesinde durumuyla görünür |
Bizim Hesap'ın kendi e-ticaret modülünü kullanıyorsanız
Bizim Hesap'ın fiyat sayfasında e-ticaret entegrasyonları Tam Ticaret Paketi altında listelenir; Temel Ticaret Paketi ön muhasebe ve e-Belge tarafını kapsar. Pazaryerlerini Bizim Hesap'ın modülüyle bağlamış ve Yox İş Ortağım'a geçiyorsanız aynı kanalın siparişlerini iki yerden çekmeyin; aksi hâlde aynı siparişe iki satış kaydı ve iki fatura düşebilir. Pratik bir iş bölümü şudur: kanal, ilan, fiyat, stok ve hakediş işleri panelde; muhasebe kaydı ve resmî belge Bizim Hesap'ta. Panelde hakediş mutabakatıyla sipariş bazında net kârı, fazla kesilen komisyonu ve zarar eden siparişleri görürsünüz; tek bir ürünün marjını hızlıca görmek için kâr hesaplama aracı da işe yarar.
Bizim Hesap entegrasyonu hangi pakette, toplam maliyet nelerden oluşur?
Bizim Hesap bağlantısı Yox İş Ortağım'ın Profesyonel paketinden itibaren açılır; Başlangıç ve Büyüme paketlerinde muhasebe ve e-Fatura bağlantısı yoktur. Bizim Hesap, paket sayımında bir program olarak geçer.
| Paket | Aylık fiyat | Muhasebe / e-Fatura programı | Bizim Hesap bağlanır mı? |
|---|---|---|---|
| Başlangıç | ₺499 | Yok | Hayır |
| Büyüme | ₺999 | Yok | Hayır |
| Profesyonel | ₺1.999 | 1 program | Evet |
| Kurumsal | ₺3.999 | 3 program | Evet, yanında iki program daha |
| Enterprise | ₺7.999 | Sınırsız | Evet |
Profesyonel paket 5 kanal, 10.000 ürün ve aylık 2.000 sipariş sınırıyla gelir; ürün ve kanal bazında kâr raporları da bu pakette başlar. Yıllık ödemede %20 indirim uygulanır; bütün sınırları paket karşılaştırması bölümünde görebilirsiniz. Toplam maliyeti hesaplarken şu kalemleri birlikte düşünün:
- Yox İş Ortağım paketi: Yukarıdaki tablodaki aylık ücret.
- Bizim Hesap aboneliği: Programın kendi paketi. Bizim Hesap'ın e-ticaret modülünü kullanmayacaksanız dış API bağlantısının hangi pakette açık olduğunu Bizim Hesap'a sorun.
- Kontör: Bizim Hesap'ın açıklamasına göre e-Fatura tanımlaması ücretsizdir, ancak kesilen her fatura için kontör bedeli ödenir.
- Mali mühür ya da e-imza: Şahıs şirketleri e-imza, anonim ve limited şirketler mali mühürle başvurur.
Bizim Hesap kurulum kontrol listesi ve sık yapılan hatalar
Bizim Hesap bağlantısında sorunların çoğu panelde değil, Bizim Hesap tarafındaki eksik hazırlıkta başlar. Aşağıdaki iki listeyi kuruluma başlamadan önce tamamlamak, ilk hafta yaşanan düzeltmelerin büyük bölümünü ortadan kaldırır.
Kuruluma başlamadan önce
- e-Fatura ve e-Arşiv başvurunuz Bizim Hesap'ta tamamlanmış, mali mühür ya da e-imza işlemi bitmiş olsun.
- Firma token'ı ve API anahtarı Bizim Hesap destek ekibinden alınmış olsun.
- Ürünlerin stok kodları iki tarafta aynı, KDV oranları güncel olsun; oranları kontrol ederken KDV hesaplama aracı işinizi hızlandırır.
- Stok çekilecek depo ve entegrasyon belgeleri için kullanılacak seri belirlenmiş olsun.
- Faturanın e-Fatura kaydından mı, ön muhasebe kaydından mı kesileceğine mali müşavirinizle karar verilmiş olsun.
Bizim Hesap bağlantısında en sık görülen hatalar
- Çift fatura: İki kayıt da fatura kesebildiği için ikisinde de fatura kuralının açık bırakılması. Belgeyi tek kayıttan kesin.
- Kart çoğalması: Stok kodları farklı olduğunda Bizim Hesap'ın her siparişte yeni ürün kartı açması.
- Yanlış firma: Birden fazla firması olan kullanıcıda token'ın faturayı kesmeyecek firmaya ait olması.
- Yanlış depo: Satışa açık olmayan bir deponun stoğunun pazaryerlerine yansıması.
- Çift sipariş kaynağı: Aynı pazaryerinin hem Bizim Hesap'ın modülüne hem panele bağlı kalması.
Akışı kendi siparişlerinizle görmek için 3 günlük ücretsiz denemeyle başlayabilirsiniz. Yox İş Ortağım'a başvurun ya da sorularınız için iletişim sayfasından bize yazın.
Son kontrol: 13 Ekim 2026
