İçeriğe geç
Program entegrasyonu

Paraşüt Entegrasyonu

Paraşüt entegrasyonlarında kodun zor kısmı yoktur; dokümantasyon açık ve arayüz düzenli. Projeyi geciktiren şey neredeyse her zaman aynı: API başvurusunun tamamlanması. Biz de takvimi buna göre kuruyoruz.

Kısa özet

  • Paraşüt bulut tabanlı bir ön muhasebe ürünüdür; veritabanına doğrudan bağlanmak gündemde değildir, entegrasyon tamamen API üzerinden kurulur.
  • Resmi API belgeleri 2026 itibarıyla Paraşüt Geliştirici Portalı’nda (devhub.parasut.com) yayımlanır; OpenAPI 3 tanımı, Postman koleksiyonu ve örnek uygulama oradan indirilir, eski belge adresi de portala yönlenir. Bu, entegrasyon planını tahmine değil belgeye dayandırmayı mümkün kılar.
  • Erişim, portaldan yapılan API başvurusuyla açılır: kendi firması için yazılım yaptıran Paraşüt kullanıcısı ile birden çok firmaya hizmet veren ticari uygulama için iki ayrı başvuru yolu vardır. İstemci kimliği başvuru tamamlanınca portalın API Bilgilerim sayfasında görünür. Projenin ilk maddesi kod yazmak değil, bu başvurunun tamamlanmasıdır.
  • Kimlik doğrulama OAuth 2.0 Authorization Code akışıyla ve zorunlu PKCE ile yapılır; kullanıcının şifresi entegrasyona hiç gelmez. Belgedeki örnek yanıtta erişim jetonu iki saat geçerlidir ve yenileme jetonuyla tazelenir. Entegrasyon katmanı jeton yaşam döngüsünü kendisi yönetmelidir.
  • İstek sınırı başvurulan API paketine bağlıdır; 2026 itibarıyla başvuruya açık Temel pakette 10 saniyede 10 istek ve ayda 25.000 istektir. Sınır dolunca API 429 yanıtıyla ne zaman yeniden denenebileceğini bildirir. Webhook da artık var, ama yalnızca paketi webhook içeren istemcilerde ve teslimat taahhüdü olmadan. Bu yüzden entegrasyonu hız sınırlama, kademeli bekleme ve zamanlanmış eşitleme ile kuruyoruz.

Ücretsiz online keşif isteyin

Programınızı ve ihtiyacınızı yazın. Size uygun yolu ve kapsamı konuşalım.

İş günlerinde en geç 24 saat içinde dönüş yapıyoruz. Bilgileriniz talebinize dönüş için işlenir. Ayrıntı: KVKK Aydınlatma Metni

Önce iyi haber: dokümantasyon açık ve üreticinin kendi adresinde

Türkiye’deki muhasebe yazılımı entegrasyonlarında sık rastlanan sorun, belgenin olmaması ya da yalnızca bayi kanalından dağıtılmasıdır. Paraşüt bu açıdan ayrışıyor: API belgeleri üreticinin kendi alan adında, devhub.parasut.com adresindeki Geliştirici Portalı’nda herkese açık yayımlanıyor. “Paraşüt - API V4” başlıklı OpenAPI 3 tanımı, Postman koleksiyonu, kimlik doğrulama, fatura ve webhook rehberleri buradan indirilebiliyor. Eski apidocs.parasut.com ve api.parasut.com/docs adresleri de kalıcı yönlendirmeyle portala gidiyor.

Bunun proje üzerindeki etkisi doğrudan. Teklif aşamasında hangi kaynakların mevcut olduğunu, hangi alanların zorunlu olduğunu ve hangi ilişkilerin kurulabildiğini okuyarak görebiliyoruz. Yani “bakalım çıkar mı” demeden kapsam çizebiliyoruz. Bizim gibi sabit fiyatla çalışan bir taraf için belgenin açık olması, riskin küçülmesi demek.

Adres kalıbı da düzenli: taban adres https://api.parasut.com/v4 üzerine kurulu ve resmi belgeye göre tüm uç noktalar /v4/{company_id} altında, yani şirket kimliğini içeren bir kalıpla ilerliyor. Yani çağrılar hesap bazlı bağlamlanıyor; birden fazla şirketi olan bir yapıda bu bağlamın yapılandırmadan gelmesi gerekiyor, koda gömülmemesi gerekiyor. Kaynak adları ve alan ayrıntıları proje başında güncel dokümantasyondan teyit ediliyor — açık dokümantasyonun tam da bu yüzden değeri var.

Ama açık dokümantasyon, entegrasyonun kolay olacağı anlamına gelmiyor; işin niteliğini değiştiriyor. Zor kısım artık “veri nerede” sorusu değil, “bu veriyi hangi sıklıkta, hangi sırayla ve hangi hata senaryosuna dayanıklı şekilde taşıyacağız” sorusu. Bu sayfanın geri kalanı büyük ölçüde o sorunun cevabı.

Projenin ilk maddesi kod değil: API başvurusunun tamamlanması

Paraşüt entegrasyonu planlarken ilk söylediğimiz cümle şu oluyor: takvimin başlangıç noktası geliştirmeye başladığımız gün değil, API başvurusunun tamamlandığı gün. Erişim, Paraşüt Geliştirici Portalı’ndan yapılan başvuruyla açılır; istemci kimliği başvuru tamamlanınca portalın API Bilgilerim sayfasında görünür, gizli anahtar da yalnızca orada görüntülenir ve e-postayla gönderilmez.

Başvuruda iki karar baştan doğru verilmelidir. Birincisi başvuru türü: portal, kendi firması için özel yazılım yaptıran Paraşüt kullanıcısını ve birden çok şirket için işlem yapacak ticari uygulamayı ayrı başvuru yollarına yönlendiriyor. İkincisi geri dönüş adresi: belgeye göre en fazla üç adres tanımlanır ve başvurudan sonra değiştirilemez, değişiklik yeni başvuru gerektirir. Bu yüzden yazılımın nerede çalışacağı başvurudan önce netleşir.

Bu ön koşulun yarattığı tipik sorun teknik değil, planlama kaynaklı. Firma entegrasyon kararını alır, geliştirici ekip hazırdır, ama başvuru baştan yapılmamışsa ya da yanlış türle yapılmışsa proje ilk günlerini beklemekle geçirebilir ve bu gecikme yanlışlıkla yazılım tarafına mal edilir.

Bizim çalışma biçimimiz bu riski baştan kaldırıyor. Keşif görüşmesinin çıktısında iki ayrı iş listesi oluyor: bizim yapacaklarımız ve sizin yapacaklarınız. API başvurusu ikinci listenin ilk satırı ve takvim o satırın tamamlanmasına bağlanıyor. Anahtar gelmeden başlayabileceğimiz işler — veri modeli çıkarımı, eşleme tablosu tasarımı, kuyruk ve hata akışı altyapısı — paralel yürüyor, ama canlı bağlantı gerektiren hiçbir kalemi taahhüt takvimine yazmıyoruz.

OAuth 2.0: jeton yaşam döngüsü entegrasyonun sorumluluğunda

Paraşüt tarafında kimlik doğrulama OAuth 2.0 Authorization Code akışıyla yapılıyor ve belgeye göre PKCE zorunlu, yalnızca S256 yöntemi kabul ediliyor. Kullanıcı Paraşüt’ün kimlik sunucusuna yönlendirilir, kendi e-posta ve şifresiyle giriş yapıp uygulamaya izin verir; şifre entegrasyona hiç gelmez. Dönen yetkilendirme kodu, sunucu tarafında gizli anahtar ve PKCE doğrulayıcısıyla erişim ve yenileme jetonuna çevrilir. Erişim jetonu sonraki çağrılarda yetkilendirme başlığında taşıyıcı jeton olarak gönderilir. Belgedeki örnek yanıtta erişim jetonu iki saat geçerli; süre yanıttaki alandan okunur ve dolmadan yenileme jetonuyla tazelenir. Yenilemede genellikle yeni bir yenileme jetonu da döner ve sonraki seferde dönen son jeton kullanılır.

Bu modelin mimari sonucu, masaüstü ürünlerdeki “her istekte kimlik bilgisi taşı” yaklaşımından farklı: kimlik bilgileri tek bir yerde, jeton değişimi tek bir yerde olmalı ve tüm çağrılar bu ortak katmandan geçmeli. Her servis çağrısının kendi jetonunu almaya çalıştığı bir kurgu hem gereksiz istek üretir hem de yarış durumları yaratır.

Bir de eskime ve yetki sorunu var. Süresi dolmuş jetonla yapılan çağrı reddedilir; entegrasyon bunu bir iş hatası sanıp kaydı başarısız işaretlerse, ortada aslında var olmayan bir veri kaybı görünür. Bu yüzden jeton eskimesini iş hatasından ayırıp otomatik tazeleme ve tek seferlik yeniden deneme ile ele alıyoruz. Yetki hatası ise farklıdır: jeton, onayı veren kullanıcının o firmadaki rolüyle sınırlıdır ve rolün kapsamadığı istek 403 alır. Belgeye göre olağandışı sayıda 401 ya da 403 alan istemciler engellenebildiği için 403 hiç tekrar denenmez, kullanıcıya gösterilir.

Gizli anahtarın saklanması da bu bölümün bir parçası. Belgeye göre yeni istemciler varsayılan olarak gizli anahtarlı oluşturulur ve anahtar yalnızca sunucu tarafında saklanır. Biz de onu hiçbir koşulda kod deposuna, yapılandırma dosyasına düz metin olarak ya da istemci tarafına yazmıyoruz; erişimi sınırlı bir sır yönetimi katmanında tutuyoruz. Portalda anahtar yenilendiği anda eskisi hemen geçersiz olur, geçiş süresi yoktur; yenileme bu yüzden planlı yapılır.

Paraşüt tarafında kimlik doğrulama ve bağlam bilgileri. Alan adları ve yol kalıbı proje başında güncel dokümantasyondan teyit edilir; aşağıdaki tablo tasarım kararlarını göstermek içindir.
BilgiNerede kullanılırEntegrasyona etkisi
client_id / client_secretYetkilendirme kodunu jetona çevirirkenAPI başvurusu tamamlanınca portalda görünür; gizli anahtar yalnızca sunucuda tutulur
Geri dönüş adresiYetkilendirme akışındaEn fazla üç adres; başvurudan sonra değiştirilemez
PKCE doğrulayıcısıYetkilendirme isteğinde özeti, jeton isteğinde kendisiZorunlu; her oturum için yeniden üretilir, kayda geçirilmez
Erişim jetonuHer API çağrısının yetkilendirme başlığındaÖrnek yanıtta iki saat geçerli; tek merkezden yönetilir, çağrı başına alınmaz
Yenileme jetonuErişim jetonu süresi dolduğundaTazeleme otomatik olur; eskime iş hatasıyla karıştırılmaz
Şirket bağlamıKaynak yollarındaYapılandırmadan gelir; çok şirketli yapıda kod değişikliği gerekmez

İstek sınırı pakete bağlı: hız ve aylık kota birlikte planlanır

Paraşüt’ün güncel belgesine göre istek sınırı, başvurulan API paketine bağlıdır. Paket üç şeyi belirler: 10 saniyede kaç istek yapılabileceğini, bir ayda toplam kaç istek yapılabileceğini ve hangi firmalar için işlem yapılabileceğini. 2026 itibarıyla başvuruya açık Temel pakette sınır 10 saniyede 10 istek, aylık kota 25.000 istektir. Ücretlendirme sayfası daha yüksek hızlı Plus ve Pro paketlerini “yakında” olarak gösteriyor; bireysel paketlerin hepsi tek firma içindir, birden çok firma için iş ortaklığı planı gerekir.

Sınır dolduğunda API 429 yanıtı döner ve belgeye göre yanıtta ne zaman yeniden istek yapılabileceğine dair süre bilgisi bulunur. Bu bilginin hangi başlıkta ya da alanda geldiğini belgede bulamadık; kurulumda teyit edilir. Bu yüzden çağrı katmanı önce yanıttaki süreyi okumayı dener, okuyamazsa bekleme süresini kademeli olarak artırıp tekrar denemeleri rastgele bir gecikmeyle dağıtır. Asıl hedef ise 429 almamaktır: çağrı katmanı baştan paketin hız sınırının altında kalacak şekilde ayarlanır.

Hızdan daha sinsi olan aylık kotadır. Sık aralıklarla yapılan tek bir değişiklik sorgusu bile ay boyunca binlerce istek eder; sıklık iki katına çıkınca kota hesabı da iki katına çıkar. Bu yüzden yoklama sıklığı iş ihtiyacına göre seçilir, toplu aktarımlar kontrollü partiler halinde ve mümkünse mesai dışı saatlerde gönderilir, sık okunan veri sizin tarafınızdaki yerel bir kopyadan sunulur.

Üçüncü ayak görünürlük. Başarısız çağrılar sessizce kaybolmuyor: sebebiyle birlikte kaydediliyor, listeleniyor ve yeniden denenebiliyor. Aylık istek sayısı da izleniyor; kota sınıra yaklaşırken uyarı veriliyor.

Webhook var, ama eşitlemeyi yine zamanlanmış çekme taşır

Entegrasyon planlarken sorulan ilk sorulardan biri “Paraşüt bize haber verir mi” oluyor. Cevap 2026 itibarıyla değişti: API tanımına 23 Ekim 2026 tarihli güncellemeyle webhook kaynakları eklendi; cari, ürün, satış faturası, irsaliye ve gelen e-Fatura gibi kayıtlarda, kayıt türüne göre oluşturma, güncelleme ya da silme olayları için bildirim tanımlanabiliyor. İki koşul var. Webhook yalnızca paketi webhook içeren API istemcileriyle kullanılabiliyor, aksi hâlde istek 403 alıyor; ücretlendirme sayfası webhook’u “yakında” görünen Pro paketinde gösteriyor. Ayrıca belge, bildirimlerin işlem sırasıyla geleceğini ve her değişiklik için bildirim gönderileceğini taahhüt etmiyor; aynı olay birden fazla da gelebiliyor.

Bu yüzden senkronizasyonun omurgasını zamanlanmış çekme ile kurguluyoruz; webhook paketinizde varsa değişikliği daha erken yakalamak için yanına ekleniyor. Paraşüt’ün kendi webhook rehberi de bildirimi değişiklik haberi olarak kullanmayı ve veriyi düzenli aralıklarla API’den eşitlemeyi öneriyor. Belirlenen aralıklarla, son çalışma anından beri değişenleri hedefleyen dar sorgularla veri çekiliyor; her turun nereden devam edeceği kalıcı olarak saklanıyor, böylece bir tur atlansa bile veri kaybı olmuyor.

Zamanlanmış çekmenin iki klasik tuzağı var ve ikisini de baştan kapatıyoruz. Birincisi mükerrer işleme: aynı kayıt iki turda birden yakalandığında ikinci kez işlenmemeli. Bunu kayıt kimliği üzerinden kurulan bir işlenmişlik kontrolüyle çözüyoruz. İkincisi ise turların üst üste binmesi: bir tur uzun sürdüğünde bir sonraki tur başlarsa aynı veri iki akışta birden işlenir. Bunu tek çalışan kilidiyle engelliyoruz.

Sıklık ayarı ise iş ihtiyacına göre belirleniyor. Fatura tarafında dakikalar mertebesinde bir gecikme çoğu firma için sorun değil; stok ve sipariş tarafında beklenti daha sıkı olabiliyor. Bu kararı keşifte birlikte veriyoruz, çünkü sıklık arttıkça hem yük hem de hata yüzeyi büyüyor.

Okuma ve yazma: risk veritabanında değil, mükerrer kayıtta

Masaüstü muhasebe ürünlerinde okuma-yazma tartışması “veritabanına dokunalım mı” ekseninde döner. Paraşüt bulutta çalıştığı için o tartışma burada yok; her iki iş de aynı API üzerinden yapılıyor. Ama risk ortadan kalkmıyor, sadece yer değiştiriyor: ön muhasebede en pahalı hata, bozulan bir tablo değil, iki kez oluşan bir fatura.

Okuma — sayfalama ve tutarlılık

Okuma tarafında kayıt bozma riski yok; dikkat edilmesi gereken şey verinin eksiksiz ve tutarlı alınması.

  • Büyük listeler tek seferde değil sayfalanarak alınır; sayfa sınırı ve sıralama alanı açıkça belirlenir, varsayılana güvenilmez
  • Sayfalama sırasında yeni kayıt eklenirse kayma oluşabilir — bu yüzden sayfalamayı değişmez bir sıralama alanı üzerine kurarız
  • Şirket bağlamı yapılandırmadan gelir; çok şirketli hesaplarda yanlış bağlamla çekilen veri hata vermez, sessizce yanlış rapor üretir
  • Raporlama ihtiyacı sürekliyse veriyi her seferinde API’den çekmek yerine, sizin tarafınızda tutulan ve zamanlanmış çekme turlarıyla güncellenen yerel bir kopya kurmak hem paneli hızlandırır hem çağrı hacmini düşürür

Yazma — mükerrer kayıt en büyük tehdit

Yazma tarafında asıl tehlike başarısız istek değil, sonucu belirsiz kalan istektir. Çağrı gönderilmiş, ağ kesilmiş, yanıt alınamamış olabilir. Bu durumda kayıt oluştu mu oluşmadı mı bilinmez. Körlemesine tekrar denemek, muhasebe tarafında aynı faturanın iki kez oluşması anlamına gelir — ve bunu temizlemek, entegrasyondan kazanılan tüm zamandan daha pahalıya mal olur.

Bu yüzden her yazma işlemini idempotent kurguluyoruz: kendi tarafımızdaki kaydın benzersiz bir karşılığını tutuyor, Paraşüt tarafındaki kimliği geri yazıyor ve tekrar denemeden önce kaydın gerçekten oluşup oluşmadığını kontrol ediyoruz. Satış faturasında Paraşüt’ün kendi tekrar önleme anahtarı da var: her fatura için üretilen anahtar yeniden denemede aynen gönderilir; belgeye göre anahtar daha önce kullanıldıysa ikinci fatura açılmaz, hata yanıtında mevcut faturanın kimliği döner. Yanıtı belirsiz kalan istekler otomatik olarak “doğrula, sonra karar ver” akışına giriyor.

İkinci disiplin: eşleme tablosu. Cari, ürün ve birim eşleşmeleri kodda gömülü değil, yönetilebilir bir tabloda tutuluyor. Yeni bir ürün ya da cari eklendiğinde geliştirici çağırmak gerekmiyor. Bu, entegrasyon bakımının en büyük gizli maliyet kalemini baştan ortadan kaldırıyor.

Üçüncüsü: silme yetkisi. Silme akışlarını mümkün olduğunca entegrasyon dışında bırakıyoruz. İptal ve düzeltme işlemlerini, ürünün kendi mantığına uygun şekilde güncelleme üzerinden kurguluyoruz — yanlış çalışan bir döngünün geri alınamaz sonuç üretmesini engellemenin en ucuz yolu budur.

Sürüm yükseltmesi: karar sizde değil ve bu iyi bir şey

Masaüstü muhasebe programlarında sürüm yükseltmesi entegrasyonun klasik kâbusudur: tarih seçilir, yedek alınır, gece çalışılır ve bir sabah entegrasyon çalışmayı bırakır. Bulut ürünlerde bu ritüel yok. Paraşüt tek bir sürüm olarak çalışır; güncelleme üreticinin takvimine göre gelir ve müşteri bunu onaylamaz.

Bu farkın entegrasyon tarafındaki karşılığı çoğunlukla avantaj. Her müşteride farklı bir sürümle uğraşmıyoruz; “sizde V16 mı V17 mi” sorusu gündeme gelmiyor. Şema takibi, veritabanı nesnelerinin bozulması, yükseltme sonrası yeniden eşleme gibi kalemler tamamen listeden düşüyor. Arayüzün kendisi de sürümlü bir yüzey olarak tanımlanmış — adres kalıbının içindeki sürüm işareti, büyük değişikliklerin yönetilen bir şekilde geleceğini gösteriyor.

Sorumluluk tarafı şu: yükseltme zamanını siz seçmediğiniz için entegrasyonun dayanıklı olması gerekiyor. Bilmediği bir alan geldiğinde patlamaması, beklediği bir alan boş geldiğinde kaydı sessizce yok saymaması, başarısız çağrıları kuyrukta tutup yeniden denemesi gerekiyor. Bunlar sonradan eklenen özellikler değil, ilk günden yazılan davranışlar.

Burada somut bir kırılma örneği vermiyoruz, çünkü elimizde doğrulanmış bir örnek yok ve olmayan bir örneği uydurmak bu sayfanın güvenilirliğini bitirir. Yazdığımız şey bir tahmin değil, bir duruş: değişimin ne zaman geleceğini bilmediğiniz bir yüzeyle çalışıyorsanız, entegrasyonu değişimi kaldıracak şekilde yazarsınız.

Teslim sonrası 15 gün ücretsiz hata düzeltme sözleşmenin standart maddesi. Sonrasında izleme devreye giriyor: başarısız çağrılar, jeton tazeleme hataları ve senkronizasyon turlarının sağlığı takip edilmezse bir sorun ancak kullanıcı şikâyetiyle fark edilir. İzlemeyi sürdürmek isteyen firmalar için bu, bakım sözleşmesinde ayrı bir hizmet olarak yazılır.

Yazılım ajansları ve muhasebe ofisleri için: geliştirme tarafını devralıyoruz

Paraşüt’ün etrafındaki ekosistem, klasik ERP bayi yapısından farklı işliyor. Burada iki tipik muhatap var: kendi müşterisine e-ticaret veya özel uygulama yapan yazılım ajansları ve müşterilerinin ön muhasebesini yürütürken tekrar eden veri girişinden kurtulmak isteyen muhasebe ofisleri.

İki durumda da tablo benzer: ihtiyaç net, ürün bilgisi zaten sizde, eksik olan tek şey entegrasyonu yazacak ve yaşatacak mühendislik kapasitesi. Bizim önerdiğimiz iş bölümü bu boşluğa oturuyor — müşteri ilişkisi, ürün danışmanlığı ve mali süreçlerin sorumluluğu sizde kalır, API üzerinden yazılacak entegrasyon kodu ve bakımı bizde olur.

  • Beyaz etiketli çalışabiliriz: müşteriye karşı görünen taraf siz olursunuz, biz tamamen arka planda kalırız
  • API başvurusu ve hesap yönetimi müşterinin kendi hesabında yürür; biz süreci teknik olarak destekler, sizin yerinize taahhüt vermeyiz
  • Paraşüt’ün bireysel API paketleri tek firma içindir; birden çok müşterinin verisine tek uygulamayla erişilecekse portal iş ortaklığı planına yönlendiriyor, bu karar mimariden önce verilir
  • Birden çok müşteride tekrarlanan aynı akış için tek bir entegrasyon gövdesi kurar, müşteri bazlı yapılandırmayla çoğaltırız
  • Sabit fiyatla çalıştığımız için müşterinize verdiğiniz teklifin geliştirme kalemini kesin rakamla yazabilirsiniz
  • Kodun dokümantasyonu ve yapılandırma haritası size teslim edilir; iş birliği sonlansa bile elinizde çalışır bir varlık kalır

Bu programın üstüne ne kurulur?

Programınız yerinde kalır. Aşağıdaki çözümler onun karşılamadığı süreci tamamlar ve kaydı programın resmi arayüzü üzerinden işler.

Yazılım Robotları ve İş Süreci Otomasyonu

Her gün aynı ekranlarda yapılan işi yazılıma devredin: rapor indirme, veri aktarma, kontrol ve bildirim. Ofis, depo ve fabrika süreçleri için.

Üretim Takip Yazılımı (MES)

Tezgâhta ne olduğunu vardiya bitmeden görün. İş emri, duruş, fire ve OEE ölçümü — mevcut ERP’nizin üstüne.

Sipariş ve İş Emri Takip

Müşteri siparişinin hangi operasyonda beklediğini ve terminin tutup tutmayacağını, gecikme oluşmadan önce görün.

Barkod, Stok ve El Terminali

Raftaki sayı ile sistemdeki sayı tutmuyorsa sorun programda değil sahada. Barkod, el terminali ve raf adresleme ile stok doğruluğu.

Fabrikaya Özel Yazılım

Paket yazılımın bittiği yerde başlayan iş. Süreçlerinize göre yazılan, veri ve kod hakları sözleşmede açık sistem.

Mali Müşavir Ofisi Otomasyonu

Luca’da fatura sorgulama, muhasebeleşme kontrolü ve dosyalama gibi her ay tekrar eden işleri yapan yazılım robotu. Kullanımda olan bir sistem.

Depo Yönetim Sistemi (WMS)

Malın nereye konacağına, kimin neyi toplayacağına ve sıradaki işin ne olduğuna sistem karar versin. Hazır WMS’in yetmediği depolar için süreç odaklı kurulum.

B2B Bayi Sipariş Portalı

Bayi kendi fiyatını, bakiyesini ve stok durumunu görür, siparişini kendisi girer. Sipariş, muhasebe veya ERP programınıza resmî arayüzünden düşer.

Fatura ve Cari Ekstre Otomasyonu

Tekrarlayan faturayı toplu hazırlayan, cari ekstreyi e-posta ya da WhatsApp ile gönderen, vadesi yaklaşan alacağı hatırlatan özel otomasyon. Muhasebe programınız yerinde kalır.

Üretim Planlama Programı

Kapasiteyi, darboğazı ve malzemeyi aynı anda hesaba katan bir plan. Excel’de her değişiklikte yeniden kurulan çizelgeden çıkış, ERP’niz yerinde kalarak.

Saha Satış Uygulaması

Plasiyer müşterinin yanında bakiyeyi, fiyatı ve stoğu görür; siparişi ve tahsilatı telefondan girer. Kayıt, muhasebe veya ERP programınıza resmî arayüzünden gider.

Yönetim Raporlama Paneli

ERP ve muhasebe verinizi salt okunur çekip satış, tahsilat, stok ve üretimi tek ekranda gösteren panel. Hazır BI aracı yetiyorsa bunu da açıkça söylüyoruz.

Kurulduğunda nasıl çalışır? (örnek akış)

E-ticaret siparişinden faturaya kesintisiz akış

Mağazada oluşan sipariş, Paraşüt tarafında ilgili kayıtlara dönüşüyor. Aynı sipariş ağ kesintisi sonrası tekrar gönderilse bile idempotent yazma sayesinde ikinci bir fatura oluşmuyor; muhasebe ekibi mükerrer kayıt temizlemekle uğraşmıyor.

Saha tahsilat ve cari bakiye görünürlüğü

Saha ekibi müşteri ziyaretinde güncel bakiyeyi kendi uygulamasından görüyor, tahsilat kaydı Paraşüt’e aktarılıyor. Bakiye, son senkron turunda yerel tabloya yazılan değerden okunduğu için ekran anında açılıyor; her ziyarette API’ye gidilmiyor.

Muhasebe ofisinde tekrar eden giriş yükünün kalkması

Müşterilerin farklı kanallardan gelen belgeleri tek bir akışta toplanıp Paraşüt’e aktarılıyor. Zamanlanmış çekme turları değişenleri yakalıyor, işlenmişlik kontrolü aynı belgenin iki kez işlenmesini engelliyor.

Ürün ve cari eşlemesinin yönetilebilir hale gelmesi

Kendi sisteminizdeki ürün ve cari kodlarının Paraşüt karşılıkları yönetilebilir bir eşleme tablosunda tutuluyor. Yeni ürün eklendiğinde geliştirici çağırmak gerekmiyor; eşleme ekrandan yapılıyor ve akış kesintisiz devam ediyor.

Senkronizasyon sağlık panosu

Her çekme turunun ne zaman çalıştığı, kaç kayıt işlendiği ve hangi kayıtların hata aldığı tek ekranda izleniyor. Başarısız kayıtlar sebebiyle listeleniyor ve tek tıkla yeniden denenebiliyor; sessiz başarısızlık ihtimali ortadan kalkıyor.

Referans iş birliği

Entegrasyon tarafındaki ilk projeleri referans iş birliğiyle yürütüyoruz: projenin sonunda ölçülebilir sonuçları vaka çalışması olarak yayımlamamıza ve sizi referans göstermemize izin veren firmalara özel koşul uyguluyoruz. Sistem yine süreçlerinize göre yazılır ve geliştiren ekiple doğrudan çalışırsınız.

Şehriniz fark etmez

Türkiye'nin neresinde olursanız olun süreç aynı başlar: keşif online yapılır, geliştirme uzaktan yürür. Sahada yapılması gereken bir adım varsa (depo ölçümü, cihaz kurulumu, açılış sayımı gibi) ziyaret planı teklifte baştan yazılır.

Uzaktan nasıl çalıştığımızı burada anlattık

Sık sorulan sorular

Paraşüt veritabanına doğrudan bağlanabilir misiniz?

Hayır. Paraşüt bulut tabanlı bir üründür; veritabanı sizin makinenizde durmaz ve doğrudan erişim diye bir seçenek gündemde değildir. Entegrasyon tamamen API üzerinden kurulur. Bunu bir kısıt olarak görmüyoruz: şema takibi, tablo tahmini ve sürüm geçişi sonrası yeniden eşleme gibi masaüstü dertleri bu sayede hiç gündeme gelmiyor.

Entegrasyona ne zaman başlayabiliriz?

Takvimin başlangıç noktası geliştirmeye başladığımız gün değil, API başvurusunun tamamlandığı gün. Başvuru Paraşüt Geliştirici Portalı’ndan sizin hesabınızla yapılır; kendi firmanız için yaptırdığınız bir entegrasyonda “Paraşüt Kullanıcısıyım” yolu seçilir. İstemci kimliği başvuru tamamlanınca portalın API Bilgilerim sayfasında görünür. Geri dönüş adresi sonradan değiştirilemediği için yazılımın nerede çalışacağını başvurudan önce birlikte netleştiriyoruz. Keşif çıktısında iki ayrı iş listesi veriyoruz ve başvuru sizin listenizin ilk satırı oluyor. Başvuru sürerken veri modeli, eşleme tablosu ve hata akışı gibi işleri paralel yürütüyoruz; canlı bağlantı gerektiren kalemleri ise takvime yazmıyoruz.

Paraşüt’ün istek limiti nedir?

Sınır başvurulan API paketine bağlıdır. 2026 itibarıyla başvuruya açık Temel pakette 10 saniyede 10 istek ve ayda 25.000 istektir; ücretlendirme sayfası daha yüksek sınırlı Plus ve Pro paketlerini “yakında” olarak gösteriyor. Sınır dolunca API 429 yanıtı döner ve yanıtta ne zaman yeniden denenebileceğine dair süre bilgisi bulunur; bu bilginin hangi alanda geldiğini belgede bulamadık, kurulumda teyit edilir. Entegrasyonu baştan paketin hız sınırının altında kalacak şekilde yazıyoruz: hız sınırlama ve kademeli bekleme devrede, toplu aktarımlar kontrollü partiler halinde gönderiliyor, aylık istek sayısı izleniyor ve başarısız çağrılar sebebiyle kaydedilip yeniden denenebiliyor.

Paraşüt bize değişiklikleri webhook ile bildirir mi?

Bildirebilir, ama koşullu. API tanımına 23 Ekim 2026 tarihli güncellemeyle webhook kaynakları eklendi; ancak webhook yalnızca paketi webhook içeren API istemcileriyle kullanılabiliyor ve belge, her değişiklik için bildirim gönderileceğini ya da bildirimlerin sırayla geleceğini taahhüt etmiyor. Paraşüt’ün kendi rehberi de veriyi düzenli aralıklarla API’den eşitlemeyi öneriyor. Bu yüzden senkronizasyonun omurgasını zamanlanmış çekme ile kurguluyoruz, webhook paketinizde varsa yanına ekliyoruz: belirlenen aralıklarla, son turdan beri değişenleri hedefleyen dar sorgularla veri çekiliyor, her turun nereden devam edeceği kalıcı olarak saklanıyor, işlenmişlik kontrolü ve tek çalışan kilidi ile mükerrer işleme engelleniyor.

Aynı fatura iki kez oluşur mu?

Doğru kurulmuş bir entegrasyonda oluşmaz, ama bu kendiliğinden olmaz. Asıl tehlike başarısız istek değil, sonucu belirsiz kalan istektir: çağrı gönderilmiş, bağlantı kopmuş, yanıt alınamamıştır. Körlemesine tekrar denemek tam da bu noktada mükerrer kayıt üretir. Bu yüzden her yazma işlemini idempotent kurguluyoruz — kendi tarafımızdaki kaydın benzersiz karşılığını tutuyor, Paraşüt tarafındaki kimliği geri yazıyor ve tekrar denemeden önce kaydın gerçekten oluşup oluşmadığını doğruluyoruz. Satış faturasında Paraşüt’ün tekrar önleme anahtarını da kullanıyoruz: aynı anahtarla gelen ikinci istek belgeye göre yeni fatura açmaz, mevcut faturanın kimliğini döndürür. Yanıtı belirsiz kalan istekler otomatik olarak “önce doğrula, sonra karar ver” akışına giriyor.

Paraşüt güncellenirse entegrasyon bozulur mu?

Bulut ürünlerde yükseltme bir karar anı değil; güncelleme üreticinin takvimine göre gelir ve siz onaylamazsınız. Bu çoğunlukla avantaj: her müşteride farklı sürümle uğraşmıyoruz, şema takibi ve yükseltme sonrası yeniden eşleme gibi kalemler listeden düşüyor. Sorumluluk tarafı ise entegrasyonun dayanıklı olması: bilmediği alan geldiğinde patlamaması, beklediği alan boş geldiğinde kaydı sessizce yok saymaması, başarısız çağrıları kuyrukta tutup yeniden denemesi. Bu davranışlar bir “ileride ekleriz” listesi değil, ilk teslimin parçasıdır. Somut bir kırılma örneği vermiyoruz çünkü elimizde doğrulanmış bir örnek yok.

Paraşüt iş ortağı mısınız?

Hayır. Paraşüt’le ya da başka bir yazılım üreticisiyle iş ortaklığı, çözüm ortaklığı veya bayilik sözleşmemiz yok; bağımsız bir geliştirme ekibiyiz. Hesap açılışı, abonelik, API başvurusu ve ürün danışmanlığı sizin kendi kanalınıza ait ve o alana girmiyoruz. Paraşüt’ün geliştirici portalındaki iş ortaklığı başvurusu, birden çok firmanın verisine erişen ticari ürünler içindir; tek bir firmaya yazdığımız entegrasyonda başvuruyu firma kendi hesabıyla yapar. Yaptığımız iş, ürünün açık şekilde yayımlanmış API dokümantasyonu üzerinden entegrasyon geliştirmek. Yazılım ajansları ve muhasebe ofisleriyle de taşeron geliştirme modelinde çalışıyoruz: müşteri ilişkisi sizde kalır, kod ve bakım bizde olur.

İstanbul’dayız; sizin Mersin’de olmanız sorun olur mu?

Paraşüt için olmaz. Ürün bulutta, entegrasyon tamamen API üzerinden; keşif görüşmesi de geliştirme de uzaktan yürür ve Türkiye’nin her ilinde aynı şekilde çalışırız. Yerinde bulunmamızın anlam taşıdığı tek durum sahadır — depo, mağaza ya da üretim tarafında bir kurulum varsa. Bunu Mersin, Tarsus, Adana, Hatay, İskenderun ve Osmaniye’de yerinde yapıyoruz; diğer illerde saha montajı gerekirse seyahat takvime başta yazılır.

Mevcut sisteminizi konuşalım

Hangi programı kullandığınızı, sahada hangi verinin elle girildiğini ve neyi otomatikleştirmek istediğinizi anlatın. İlk görüşmede teknik olarak mümkün olup olmadığını ve hangi yöntemle yapılacağını netleştiriyoruz.

Talebinizi buradan iletin

Telefon veya e-posta bırakın; iş günlerinde en geç 24 saat içinde dönelim.

İş günlerinde en geç 24 saat içinde dönüş yapıyoruz. Bilgileriniz talebinize dönüş için işlenir. Ayrıntı: KVKK Aydınlatma Metni

Bu sayfada adı geçen ürün ve markalar ilgili firmaların tescilli ticari markalarıdır. D'Cloud Software bağımsız bir yazılım geliştiricisidir; anılan firmaların yetkili bayisi, çözüm ortağı veya iş ortağı değildir. Entegrasyon hizmeti, ürünlerin kendi belgelenmiş arayüzleri ve veri erişim yöntemleri üzerinden sunulur.