Paraşüt API: kendi yazılımınızdan fatura kesmek ve e-faturayı tetiklemek

Paraşüt API nedir, kim için?

Paraşüt bulut ön muhasebe programı: fatura, tahsilat, gider, stok ve e-belge. Kendi operasyon sisteminiz olan bir şirketseniz — saha servis, üretim takibi, B2B sipariş, abonelik — muhasebeyi Paraşüt’te tutup faturayı operasyonun bittiği yerde doğurmak istersiniz. Paraşüt API v4 tam bunun için: Paraşüt’ün web arayüzüyle yapılan hemen her işlem programdan yapılabiliyor.

Bu yazıdaki teknik gerçekler Paraşüt’ün resmi API dokümanından (apidocs.parasut.com, OpenAPI 2.0 tanımı) 2 Eylül 2026’da doğrulandı. Alan adları ve uçlar dokümanın sürümüne göre değişebilir; projede ilk gün güncel tanım dosyası indirilip köprü ona göre üretilir.

Adres yapısı ve biçim

• Temel adres https://api.parasut.com, sürüm ucu https://api.parasut.com/v4.
• Her çağrı firma numarasıyla gider: https://api.parasut.com/v4/<firma_no>/contacts gibi. Firma numarası, Paraşüt’teki şirket kaydının numarasıdır; GET /v4/me ile giriş yapan kullanıcı ve şirket bilgisi okunur.
• İstek ve yanıtlar JSON:API biçimindedir: data, type, attributes, relationships. Yeni kayıt oluştururken kaydın kendi id alanı boş gönderilir; bağlı kayıtların (müşteri, ürün) id değeri dolu olmalıdır.
• Content-Type olarak application/json veya application/vnd.api+json kabul edilir.
• Sınır: 10 saniyede 10 istek.

Kimlik doğrulama: OAuth2, 2 saatlik jeton

Paraşüt destek ekibinden CLIENT_ID, CLIENT_SECRET ve gerekiyorsa REDIRECT_URL alınır. Jeton iki yolla üretilir:

Yol	Nasıl	Ne zaman
grant_type=authorization_code	Kullanıcı tarayıcıda Paraşüt'e girip uygulamayı onaylar; dönen code ile token alınır	Birden çok Paraşüt hesabına bağlanan ürünler
grant_type=password	E-posta ve şifreyle doğrudan POST /oauth/token	Tek şirketin kendi entegrasyonu

POST https://api.parasut.com/oauth/token
grant_type=password&client_id=…&client_secret=…&username=…&password=…&redirect_uri=urn:ietf:wg:oauth:2.0:oob

{"access_token": "…", "token_type": "bearer", "expires_in": 7200, "refresh_token": "…"}

Access token 2 saat geçerli; süresi dolunca grant_type=refresh_token ile yenilenir ve her yenilemede yeni bir refresh token gelir — eskisi saklanmaz. Bizim ara katmanımız jetonu ve yenileme jetonunu uygulama sunucusunda tutar, süreyi izler, yenilemeyi çağrıyı yapan uygulamaya hissettirmeden yapar. Şifre ve gizli anahtar hiçbir zaman tarayıcıya veya mobil cihaza inmez.

Uçlar: neyi okuyup neyi yazabilirsiniz

Listeleme uçlarında filtre, sıralama ve sayfalama standarttır. Örneğin satış faturalarında filter[issue_date], filter[contact_id], filter[payment_status] (overdue, not_due, unscheduled, paid), filter[print_status] (e_invoice_sent, e_archive_sent…), sort, page[number], page[size] ve bağlı kayıtları tek istekte getiren include (contact, details, details.product, payments) parametreleri var.

Akış: sipariş kapandı, fatura Paraşüt’te doğdu, e-belge gitti

1. Müşteriyi bul veya oluştur. Vergi numarasıyla contacts içinde aranır; yoksa oluşturulur, dönen id saklanır.
2. Satış faturasını yaz. POST /v4/<firma_no>/sales_invoices — müşteri ve ürün id'leri relationships içinde, kalemler details altında.
3. Senaryoyu seç. GET e_invoice_inboxes?filter[vkn]=… alıcının e-fatura kayıtlı kullanıcı olup olmadığını ve posta kutusu adresini verir.
4. Gönderimi tetikle. Kayıtlıysa POST e_invoices, değilse POST e_archives; gövdede faturaya bağ relationships.invoice ile verilir.
5. İşi izle. Yanıt 201 ile bir trackable_jobs kaydı döner; durum running → done veya error. Hata listesi iş kaydının errors alanında gelir ve kendi hata kuyruğunuza düşer.
6. Tahsilatı bağla. Ödeme geldiğinde POST sales_invoices/{id}/payments; açık bakiye Paraşüt'te kapanır.

POST https://api.parasut.com/v4/115/e_invoices
Authorization: Bearer …
Content-Type: application/vnd.api+json

{"data": {
  "type": "e_invoices",
  "attributes": { "scenario": "basic" },
  "relationships": { "invoice": { "data": { "type": "sales_invoices", "id": "48213" } } }
}}

HTTP/1.1 201 Created
{"data": {"id": "90311", "type": "trackable_jobs", "attributes": {"status": "running", "errors": []}}}

Gönderim asenkron olduğu için “fatura gitti mi” sorusunun cevabı 201 değil, iş kaydının done olmasıdır. Sisteminizde faturanın durumu bu kayda bağlanır; senaryo seçimi, durum listesi ve mutabakat disiplinini e-fatura entegrasyonu rehberinde programdan bağımsız anlattık.

İstek sınırıyla yaşamak

10 saniyede 10 istek, kullanıcı bekleyen ekranlar için yeterli, toplu işler için değil. Kurduğumuz köprü üç şey yapar:

• Kuyruk ve hız sınırı. Paraşüt’e giden her istek bir kuyruktan saniyede bir çıkar; 1.000 faturalık gece aktarımı yaklaşık 17 dakika sürer ve kimse fark etmez.
• Sınır aşımında bekleme. Reddedilen istek atılmaz, bekletilip yeniden denenir.
• Kendi kopyanız. Müşteri, ürün ve fatura listesi kendi veritabanınızda tutulur; ekranlar Paraşüt’e değil bu kopyaya bakar, Paraşüt yalnız değişiklikte çağrılır.

Paraşüt ile ERP entegrasyonunun farkı

Paraşüt bir ERP değil, ön muhasebe programı; entegrasyonun ağırlık merkezi de ona göre değişir. Logo, Netsis, Mikro, DİA ve SAP Business One köprülerinde sipariş, stok ve üretim ERP’de yaşar, dış uygulama onun etrafına kurulur. Paraşüt köprüsünde tersi: operasyon sizin sisteminizdedir, Paraşüt’e yalnız muhasebeyi ilgilendiren belge — fatura, tahsilat, gider — gider. Şirket büyüyüp stok, üretim ve maliyet takibi Paraşüt’ün dışına taştığında ERP entegrasyonu ve Excel’den sisteme geçiş yazıları bir sonraki adımı anlatır.

En sık kurulan Paraşüt entegrasyon senaryoları

Entegrasyonda dikkat edilecek noktalar

1. Tek fatura, tek kaynak. Aynı sipariş için ikinci fatura açılmasın diye sisteminizdeki belge numarası Paraşüt faturasının açıklama veya sipariş numarası alanına yazılır ve gönderim öncesi kontrol edilir.
2. İş kaydı kapanmadan “gitti” denmez. E-belge durumu trackable job done olunca güncellenir; error gelen fatura hata kuyruğuna düşer, sorumlusuna bildirim gider.
3. Jeton yönetimi tek yerde. Refresh token her yenilemede değiştiği için iki ayrı uygulama aynı jetonu paylaşırsa biri diğerini geçersiz kılar; köprü tek sahip olur.
4. Alan ve uç sürümü. Köprü, OpenAPI tanımının indirildiği tarihi ve sürümünü saklar; Paraşüt tanımı güncellediğinde fark raporlanır.
5. Yetki ve gizlilik. Paraşüt kullanıcısı entegrasyon için ayrı açılır; şifre, client secret ve jetonlar uygulama sunucusunda kalır.

Bütçe ve süre

Paraşüt köprüsü kendi sisteminizin yanına ek modül olarak kurulur: kapsama göre 8.000 - 45.000 ₺ bandında, tek yönlü fatura ve e-belge akışı 2-3 haftada, tahsilat ve stok senkronunu da kapsayan çift yönlü akış 2-4 haftada devreye girer. Bantların tamamı fiyat sayfasında; Paraşüt aboneliği ve e-belge kontör bedeli sizinle Paraşüt arasındaki sözleşmeye göre ayrıca işler.

Faturanın operasyonunuzun hangi noktasında doğması gerektiğini bir cümleyle yazın; teklif formundan başlayalım.

---

İlgili Bütçe Araçları ve Karşılaştırma Rehberleri

• Paket vs Özel 5 Yıllık TCO Hesaplayıcı — Kiralık SaaS lisansı ile özel yazılımın 5 yıllık maliyetini kıyaslayın.
• Yazılım Bütçe ve Süre Tahmincisi — İhtiyacınız olan modülleri seçerek bütçe ve teslim bandınızı görün.
• ERP Fiyat Listesi 2026 Karşılaştırması — Türkiye kurumsal ERP lisans ve bakım bedelleri.
• Özel Yazılım Teknik Şartnamesi (RFP) Rehberi — Bütçe aşımını önleyen şartname hazırlama kılavuzu.

Sıkça sorulan sorular

Paraşüt API nedir?

Paraşüt'ün web arayüzüyle yapılan hemen her işlemi programdan yapmayı sağlayan resmi arayüzdür. Temel adres https://api.parasut.com, sürüm v4; her istek https://api.parasut.com/v4/firma_no/... biçiminde ilgili firmanın kayıt numarasıyla gönderilir. İstek ve yanıtlar JSON:API standardına yakın biçimdedir ve Content-Type olarak application/json veya application/vnd.api+json kabul edilir.

Paraşüt API'de kimlik doğrulama nasıl çalışır?

OAuth2 ile. Paraşüt'ten CLIENT_ID, CLIENT_SECRET ve gerekiyorsa REDIRECT_URL alınır. Access token iki yolla üretilir: authorization_code (kullanıcı tarayıcıda onaylar) veya password (e-posta ve şifreyle doğrudan). Access token 2 saat (7200 saniye) geçerlidir; süresi dolunca refresh_token ile yenilenir ve her yenilemede yeni bir refresh_token gelir. İstekler Authorization: Bearer başlığıyla gönderilir.

Paraşüt API ile e-fatura nasıl gönderilir?

Önce satış faturası sales_invoices ucuna yazılır. Sonra alıcının e-fatura mükellefi olup olmadığı e_invoice_inboxes ucunda vergi numarası filtresiyle sorgulanır. Mükellefse e_invoices, değilse e_archives ucuna, ilgili faturaya bağlı bir gönderim kaydı açılır. Yanıt 201 ile bir trackable job döner; iş running, done veya error durumuna geçene kadar trackable_jobs/{id} ile izlenir.

Paraşüt API'nin istek sınırı nedir?

Dokümana göre 10 saniyede 10 istek gönderilebilir. Bu yüzden toplu senkron işleri kuyrukla ve hızı düşürerek yapılır; örneğin 1.000 faturalık gece aktarımı saniyede bir istekle yaklaşık 17 dakika sürer. Sınırı aşan istekler için köprü bekleyip yeniden dener.

Paraşüt'ten gelen e-faturalar API ile okunabilir mi?

Swagger dokümanında alıcı kutusundan gelen e-faturaları çeken bir uç yer almıyor. e_invoice_inboxes ucu gelen kutusu değil, e-fatura kayıtlı kullanıcı sorgusudur. Alış faturaları purchase_bills ucuyla okunur ve yazılır; gelen e-belgenin otomatik işlenmesi için akışı buna göre kurmak gerekir.

Paraşüt entegrasyonu hangi şirkete uygundur?

Muhasebesini Paraşüt'te tutan ve operasyonunu (saha servis, üretim takibi, B2B sipariş, abonelik) kendi sisteminde yürüten şirketlere. Fatura operasyonun bittiği yerde doğar, Paraşüt'e API ile yazılır, e-belge Paraşüt'ten gider. Tam kapsamlı ERP ihtiyacı olan şirket için Paraşüt tek başına yeterli olmaz; o zaman ERP entegrasyonu rehberlerine bakılır.

İlgili rehberler

• Logo ve Netsis entegrasyon rehberi: REST API, Objects ve özel web/mobil arayüz köprüsü
• DİA Web Servis API: kendi yazılımınızı DİA'ya nasıl bağlarsınız?
• Nebim V3 Entegratör REST API: perakende ERP'nizi dış sistemlere nasıl bağlarsınız?

Hizmet sayfası: Entegrasyon hizmeti