Paraşüt entegrasyonu:
siparişin faturası kendiliğinden kesilir.

Paraşüt entegrasyonu nedir, Yox İş Ortağım'da hangi işleri üstlenir?

Paraşüt, küçük ve orta ölçekli işletmelerin satış ve alış faturalarını, müşteri ve tedarikçi hesaplarını, stoklarını ve e-Fatura/e-Arşiv belgelerini tek hesapta tuttuğu bulut tabanlı bir ön muhasebe programıdır. Programın geliştiricilere açık bir API'si vardır ve Paraşüt'ün kendi dokümanı, web arayüzünde yapılan işlemlerin hemen hepsinin API ile de yapılabildiğini söyler. Yox İş Ortağım bağlantısı bu resmî API'yi kullanır; ekran kopyalama ya da dosya taşıma gibi ara yöntemler yoktur.

Satıcının gözünden mesele basittir: Trendyol, Hepsiburada ya da kendi sitenizden gelen her siparişi Paraşüt'e yeniden yazmak hem zaman alır hem de tutar, KDV oranı ya da alıcı bilgisinde hata riskini büyütür. Bağlantı bu adımı sipariş akışının parçası yapar.

Panelde Paraşüt için iki ayrı kayıt bulunur

• Paraşüt (e-Fatura ve e-Arşiv): Siparişin faturasını Paraşüt üzerinden e-Fatura ya da e-Arşiv olarak düzenler. Kesilen belgenin PDF'i panele gelir ve kanal destekliyorsa siparişin geldiği pazaryerine yüklenir.
• Paraşüt (Ön Muhasebe): Pazaryeri ve site siparişlerini Paraşüt'e aktarır, siparişin satış faturasını Paraşüt'te keser ve Paraşüt'teki stok miktarlarını panele çeker. Pazaryerlerindeki stok aynı ürün kartından güncellenir.
• Ortak nokta: İki kayıt da aynı bilgilerle kurulur: Client ID, Client Secret, bağlantıda kullanılacak Paraşüt kullanıcısının e-posta adresi ve şifresi, Firma ID. Hangisini ya da ikisini birden seçeceğiniz, Paraşüt'ü yalnız fatura için mi yoksa günlük ön muhasebe ve stok için mi kullandığınıza bağlıdır.

Önemli bir sınır: ön muhasebe kaydı cari kart, ürün kartı ya da geçmiş faturaları toplu aktarmaz. Yaptığı iş sipariş aktarmak, stok çekmek ve fatura kesmektir; bu ayrımı bilmek, kurulumda beklentiyi doğru kurmanızı sağlar.

Paraşüt API bağlantı koşulları: resmî dokümandaki kurallar ve pratik karşılıkları

Paraşüt bağlantısını belirleyen teknik kuralların tamamı Paraşüt'ün herkese açık API V4 dokümanında yazılıdır ve bunları kurulumdan önce bilmek, sonradan çıkacak sürprizlerin çoğunu önler. Aşağıdaki tabloda her kuralı, satıcı olarak sizin için ne anlama geldiğiyle birlikte özetledik.

Client ID ve Client Secret talebinde neler yazılmalı

Talebi Paraşüt'te kayıtlı e-posta adresinizden göndermek, kimlik doğrulamayı kolaylaştırır. E-postada şunları açıkça belirtin:

• Firma unvanınız ve Paraşüt hesabınızın bağlı olduğu e-posta adresi.
• API'yi neden istediğiniz: pazaryeri ve site siparişlerinin Paraşüt'te faturalanması, siparişlerin aktarılması ve stokların okunması için Yox İş Ortağım bağlantısı.
• Firma ID'nizi aynı yanıtta iletmeleri; numarayı nerede göreceğinizden emin değilseniz bu en kısa yoldur.
• API erişiminin hesabınızda açık olup olmadığı ve ek ücrete bağlı olup olmadığı. Resmî dokümanda bu konuda bir bilgi yoktur, kesin cevabı yalnız Paraşüt verir.

Bağlantı için ayrı bir Paraşüt kullanıcısı açın

Password yönteminde bağlantı, bir Paraşüt kullanıcısının e-posta ve şifresiyle oturum açar. Günlük kullandığınız kişisel hesabı değil, yalnız entegrasyona ayrılmış bir kullanıcıyı tanımlamak; çalışan değişikliği ya da kişisel şifre yenilemesi yüzünden faturaların bir sabah durmasını engeller.

Pazaryeri siparişinden Paraşüt faturasına giden yol adım adım

Paraşüt'te bir siparişin resmî belgeye dönüşmesi tek bir hamle değil, sırayla ilerleyen birkaç işlemdir: önce satış faturası oluşur, sonra bu fatura e-Fatura ya da e-Arşiv olarak resmileşir, en son PDF hazırlanır. Yox İş Ortağım tarafında akış şu sırayla ilerler:

1. Sipariş, kanalın resmî API'siyle panelin tek sipariş listesine düşer; alıcı adı, teslimat ve fatura adresi, varsa vergi numarası ya da TC kimlik numarası okunur.
2. Sipariş, kurulumda belirlediğiniz fatura aşamasına geldiğinde fatura işi başlar.
3. Paraşüt'te satış faturası oluşur. Paraşüt'ün yapısında her satış faturası bir müşteri kaydına, her fatura satırı da bir ürün kaydına bağlıdır.
4. Belge türü, kurduğunuz kurala göre e-Fatura ya da e-Arşiv olarak seçilir ve Paraşüt resmileştirmeyi arka planda yürütür.
5. Resmileşen belgenin PDF'i panele gelir, siparişle eşleşir; kanal destekliyorsa siparişin geldiği pazaryerine yüklenir ve sipariş Faturalandı durumuna geçer.

Fatura aşamasını ve seriyi seçerken neye bakmalı

Faturayı erken bir aşamada kesmek, belgenin kargodan önce hazır olmasını sağlar; ama sipariş sonradan iptal edilirse kesilmiş belgeyi kapatmak için ek işlem gerekir. Geç bir aşamada kesmek iptal riskini azaltır, buna karşılık e-Arşiv belgesinde istenen kargo bilgisinin o anda hazır olması gerekir. Hangi aşamanın size uygun olduğunu iptal oranınız ve kanalın fatura yükleme beklentisi belirler. Trendyol tarafındaki sipariş akışı için Trendyol entegrasyonu sayfasına da bakabilirsiniz. Seri ayarında ise panelden kesilen faturaların seri ve numarasının, Paraşüt'te elle kestiğiniz faturalarla çakışmaması gerekir; bunu ilk test siparişinde birlikte kontrol ederiz.

Paraşüt entegrasyonunda e-Fatura ve e-Arşiv ayrımı nasıl yapılır?

e-Fatura, GİB'in tanımına göre satıcı ile alıcı arasında merkezi platform üzerinden iletilen ve yalnız e-Fatura uygulamasına kayıtlı mükellefler arasında kullanılan elektronik belgedir; alıcı kayıtlı değilse e-Arşiv uygulamasındaki satıcı aynı satışı e-Arşiv Fatura ile belgeler. Paraşüt'ün dokümanı bu ayrımı pratik bir kurala çevirir: alıcının vergi kimlik numarasıyla e-Fatura gelen kutusu sorgulanır, kutu varsa e-Fatura, yoksa e-Arşiv düzenlenir.

Kimin bu sisteme geçmek zorunda olduğu ise mevzuatla belirlenir. 22 Ocak 2022 tarihli Resmî Gazete'de yayımlanan 535 Sıra No'lu VUK Genel Tebliği'ne göre kendi sitesinden ya da aracı platformlar üzerinden satış yapan mükellefler için 2022 ve sonraki dönemlerde haddi 500 Bin TL brüt satış hasılatıdır; haddi aşanlar ilgili hesap dönemini izleyen yedinci ayın başına kadar e-Fatura ve e-Arşiv'e geçer. Genel e-Fatura haddi aynı tebliğde 3 Milyon TL olarak belirlenmiştir.

İnternet satışı ve kargo bilgisi e-Arşiv'de neden zorunlu

Paraşüt'ün e-Arşiv oluşturma alanlarında, internet üzerinden yapılan satışta site adresi, ödeme tipi, ödeme platformu ve ödeme tarihinin doldurulması zorunlu olarak işaretlenmiştir. Ödeme tipi için kredi kartı/banka kartı, EFT/havale, kapıda ödeme ve ödeme aracısı seçenekleri vardır. Ürün kargo ya da kuryeyle gönderiliyorsa kargo şirketinin adı ve VKN'si (kuryede ad ve TCKN) ile gönderi tarihi de istenir. Pazaryeri satışlarında hangi ödeme tipinin seçileceğini mali müşavirinizle netleştirin; bu bilgi her siparişte aynı kuralla dolacağı için ilk ayarın doğru olması önemlidir.

Kurumsal alıcının vergi numarası eksik gelirse

Gelen kutusu sorgusu vergi numarasıyla yapılır. Kurumsal bir alıcı siparişte vergi numarasını girmemişse belge e-Arşiv olarak düzenlenir; alıcı aslında e-Fatura mükellefiyse belge yanlış türde kesilmiş olur. Paraşüt kullanmadan yalnız e-Arşiv düzenlemek isteyen küçük satıcılar için GİB e-Arşiv Portal entegrasyonu ayrı bir seçenektir.

Paraşüt ön muhasebe tarafında sipariş aktarımı ve stok çekme

Ön muhasebe kaydı üç iş yapar: siparişi Paraşüt'e aktarır, siparişin satış faturasını Paraşüt'te keser ve Paraşüt'teki stok miktarlarını panele çeker. Bu üç işin doğru çalışması, iki tarafta aynı ürünün aynı kodla tanınmasına bağlıdır.

Siparişle birlikte Paraşüt'e giden bilgiler

• Sipariş numarası.
• Müşteri adı ile vergi numarası ya da TC kimlik numarası.
• Sipariş satırları: stok kodu, ürün adı, adet, birim fiyat ve KDV oranı.

Paraşüt'te satış faturası bir müşteri kaydı olmadan oluşmaz. Siparişteki alıcının Paraşüt'te yeni cari olarak mı açılacağı yoksa mevcut bir cariyle mi eşleşeceği Paraşüt'teki ayarınıza bağlıdır; kurulumda birlikte bakarız. Ürünler ise stok koduyla eşleşir; ürün kartları Paraşüt'te ve panelde ayrı ayrı tutulur. Bu yüzden Paraşüt'teki ürün kodu ile paneldeki stok kodunun birebir aynı olması gerekir. Aynı mantıkla çalışan bir başka ön muhasebe bağlantısı için Bizim Hesap entegrasyonu sayfasına da bakabilirsiniz.

Paraşüt'te stok hangi belgeyle düşer

Paraşüt'ün irsaliye düzenine ilişkin kullanım kılavuzuna göre stok takibi yapılan ürünlerde stok çıkışı irsaliyeli fatura ya da faturaya bağlı irsaliyeyle olur; tek başına irsaliyesiz bir fatura ürünlerin stok miktarını etkilemez. Stoğu Paraşüt'ten çekiyorsanız bu kural doğrudan pazaryerindeki rakamı belirler: Paraşüt'te stok düşmezse panele çekilen miktar da düşmez. Paraşüt API'si stok seviyesini ürün ve depo bazında listeler; birden fazla depo kullanıyorsanız pazaryerine hangi depodaki miktarın gideceğini de kurulumda netleştirin.

Elle faturalama ile Paraşüt entegrasyonu arasındaki fark

Elle düzende her sipariş için pazaryeri paneli ile Paraşüt ekranı arasında gidip gelinir; bağlantılı düzende sipariş bilgisi faturaya kendiliğinden taşınır ve faturanın durumu siparişin yanında görünür. Fark, sipariş sayısı arttıkça büyür.

Paraşüt'ün kendi e-Ticaret modülü kullanılıyorsa

Paraşüt'ün entegrasyonlar sayfası, Trendyol, n11 ve Hepsiburada satışlarından fatura üretebilen kendi e-Ticaret modülünü de tanıtır. Bu modül ile Yox İş Ortağım bağlantısını aynı kanal için birlikte açarsanız aynı siparişe iki fatura kesilebilir. Kural basittir: bir kanalın siparişleri yalnız bir yerden faturalanır. Siparişi, kargoyu ve iadeyi panelde yönetiyorsanız faturayı da aynı akışta kesmek, siparişin bütün durumlarını tek ekranda tutar. Örneğin Hepsiburada entegrasyonu kurduğunuz bir mağazada geçişi yaparken Paraşüt modülündeki aynı kanalın otomatik faturasını kapatmayı unutmayın.

Paraşüt entegrasyonu hangi pakette yer alır, toplam maliyet nelerden oluşur?

Muhasebe ve e-Fatura bağlantıları Yox İş Ortağım'da Profesyonel paketten itibaren açılır ve Paraşüt bir program olarak sayılır. Panelde 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ve 51 muhasebe, e-Fatura ve ERP programı tanımlıdır; tam liste entegrasyon ana sayfasında yer alır.

Yıllık ödemede paketlere %20 indirim uygulanır; ayrıntılar paket karşılaştırmasında. Toplam maliyeti yalnız panel ücreti oluşturmaz, Paraşüt tarafındaki kalemleri de hesaba katın:

• Paraşüt aboneliği: e-Fatura hizmetini kullanmak için Paraşüt aboneliği gerekir; güncel fiyatı Paraşüt'ten öğrenin.
• Kurulum ücreti: Paraşüt'ün kullanım kılavuzuna göre Paraşüt ile e-Fatura'ya geçişte başvuru, kurulum ya da entegrasyon ücreti yoktur.
• e-Kontör: Aynı kılavuza göre gönderilen ya da alınan her e-fatura bir e-kontör değerindedir; e-Arşiv belgelerinin nasıl sayıldığını Paraşüt'e sorun.
• Mali mühür: e-Fatura kullanıcısı olmak için mali mühür gerekir; şahıs işletmeleri e-imzayla başvurabilir.

Paneli 3 gün ücretsiz deneyebilir, ön görüşmede Paraşüt kurulumunu nasıl yapacağımızı konuşabilirsiniz; bunun için Yox İş Ortağım'a başvurun.

Paraşüt entegrasyonu kurulum kontrol listesi ve sık yapılan hatalar

Paraşüt kurulumlarında vakit kaybının büyük kısmı bağlantının kendisinden değil, Paraşüt hesabındaki eksik ayarlardan çıkar. Aşağıdaki listeyi kuruluma başlamadan tamamlamak, ilk test siparişinde karşılaşılan hataların çoğunu baştan ortadan kaldırır.

Kuruluma başlamadan önce kontrol edin

• Paraşüt'te e-Fatura aktivasyonunuz tamamlandı mı, mali mühür ya da e-imzanız tanımlı mı?
• e-Kontör bakiyeniz kampanya dönemindeki sipariş hacmine yetiyor mu?
• Client ID, Client Secret ve Firma ID Paraşüt'ten geldi mi, entegrasyon kullanıcısı açıldı mı?
• Paraşüt'teki ürün kodları paneldeki stok kodlarıyla aynı mı, stok takibi bu ürünlerde açık mı?
• Her üründe KDV oranı doğru mu? KDV dahil ve hariç tutarları karşılaştırmak için KDV hesaplama aracını kullanabilirsiniz.
• Hangi kanalın faturasının hangi yerden kesileceği, fatura aşaması ve seri ayarı belli mi?

Paraşüt bağlantısında en sık görülen hatalar

• Çift faturalama: Aynı kanal hem Paraşüt'ün e-Ticaret modülüne hem panele bağlıdır; siparişe iki belge kesilir.
• Aktivasyon öncesi siparişler: e-Belgenin düzenleme tarihi e-Fatura aktivasyon tarihinden önce olamaz; geçişten önceki siparişler bu yolla resmileşmez.
• Farklı stok kodu: Paraşüt'teki kod paneldekinden farklıysa sipariş satırı ve stok doğru ürüne bağlanmaz.
• Stok düşmüyor sanılması: İrsaliyesiz fatura Paraşüt'te stoğu düşürmez; panele çekilen rakam da bu yüzden değişmez.
• Şifre değişikliği: Entegrasyon kullanıcısının şifresi değişip panel güncellenmezse yeni oturum açılamaz ve faturalar Paraşüt'e gitmez.