Paraşüt

Bu rehberde: Paraşüt hesabınızı API bilgileriyle bağlarsınız. İş akışlarından müşteri (cari) oluşturur, müşterileri arar ve satış faturası açarsınız. Örnek olarak bir marka iş birliği ödendiğinde faturanın otomatik oluşmasını kurarsınız.

⏱ 15 dakika

Kimlik kartı#

Ne işe yarar?#

• Satış faturası: bir müşteri ve bir veya daha fazla kalemle (hizmet adı, miktar, birim fiyat, KDV oranı) Paraşüt'te satış faturası oluşturur.
• Müşteri (cari) oluşturma: ad/unvan, e-posta, telefon, VKN/TCKN, vergi dairesi ve şehirle yeni müşteri ekler.
• Müşteri arama: ada, e-postaya veya vergi numarasına göre müşterileri listeler.

Fatura Paraşüt'te normal satış faturası olarak açılır. e-Fatura / e-Arşiv olarak resmileştirme ve müşteriye gönderme Paraşüt panelinden yapılır; OrqLabs bu adımı otomatik yapmaz.

Ön koşullar#

• Aktif bir Paraşüt aboneliği.
• Paraşüt'ten alınmış API erişimi (client id ve client secret). Paraşüt API erişimini destek ekibi üzerinden verir.
• Paraşüt'te giriş yapabilen bir kullanıcı (e-posta + şifre). Faturalar bu kullanıcı adına oluşturulur; mümkünse bu iş için ayrı bir kullanıcı açın.

Adım adım kurulum#

A) Paraşüt'ten API bilgileri#

1. Paraşüt destek ekibinden (uygulama içi destek veya destek e-postası) API erişimi isteyin. Size bir Client ID ve Client Secret iletilir.
2. Firma ID'nizi bulun: Paraşüt'e giriş yaptığınızda adres https://uygulama.parasut.com/123456/… biçimindedir; 123456 firma kimliğinizdir (yalnızca rakam).

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Paraşüt → Bağla.
2. Firma ID, Client ID, Client secret, Kullanıcı e-postası ve Şifre alanlarını doldurun.
3. Bağla. OrqLabs bir erişim anahtarı alır ve firmanın müşteri listesini okuyarak doğrular.

Güvenlik: Şifre OrqLabs'ta şifrelenmiş saklanır ve yalnızca Paraşüt'ten erişim anahtarı almak için kullanılır. Kullanıcının şifresini değiştirirseniz bağlantıyı da güncelleyin.

İşlemler (Paraşüt kutusu)#

Create sales invoice (satış faturası)#

• unitPrice KDV hariç birim fiyattır; vatRate 0, 1, 10 veya 20 olmalıdır (varsayılan 20).
• Her kalem Paraşüt'te bir ürün/hizmete bağlanır: aynı adlı ürün varsa o kullanılır, yoksa kalemin fiyatı ve KDV oranıyla yeni hizmet oluşturulur. Belirli bir ürünü kullanmak için kaleme "productId": "…" ekleyin.
• Çıktı: invoiceId, contactId, contactCreated, netTotal, totalVat, grossTotal, currency, issueDate.

Create contact (müşteri oluştur)#

Ad/unvan zorunludur; e-posta, telefon, vergi numarası (boşluklar silinir), vergi dairesi, şehir ve tür (şirket / şahıs) isteğe bağlıdır. Müşteri alıcı (customer) olarak açılır. Çıktı: contactId ve müşteri bilgileri.

List contacts (müşteri ara)#

Name contains, E-mail veya Tax number ile filtreler; en fazla 100 müşteri döner. Her müşteri bir öğedir: id, name, email, taxNumber, taxOffice, city, balance.

Test çalıştırmalarında fatura ve müşteri oluşturulmaz (öğe testMode notuyla geçer); müşteri arama test sırasında da çalışır.

Marka iş birliği ödendiğinde fatura açma#

İş birlikleri sayfasında bir anlaşmanın durumunu Ödendi yaptığınızda (veya anlaşmayı doğrudan Ödendi olarak oluşturduğunuzda) OrqLabs deal.paid olayını yayınlar. Bu olay faturayı otomatik açar:

1. Yeni iş akışı → Platform olayı (trigger.event) tetikleyicisi → olay: Marka anlaşması ödendi (deal.paid). Gelen alanlar: dealId, brandName, value, currency, contactName, contactEmail, projectId, paidAt.
2. Paraşüt kutusu → Create sales invoice:
   • Contact name: {{ $json.brandName }}, E-mail: {{ $json.contactEmail }}. Marka Paraşüt'te kayıtlıysa e-postadan bulunur; yoksa yeni cari açılır. Faturada vergi numarası görünmesi gerekiyorsa markayı Paraşüt'te vergi numarasıyla birlikte önceden cari olarak kaydedin; aynı e-postayla eşleşir.
   • Currency: anlaşmalarınızın para birimi (TRY için TRY (₺)). Farklı para birimleriyle çalışıyorsanız her para birimi için ayrı bir Paraşüt kutusu kullanıp önüne {{ $json.currency }} koşuluyla bir If kutusu koyun.
   • Lines: [{ "productName": "{{ $json.brandName }} sponsorlu içerik", "quantity": 1, "unitPrice": "{{ $json.value }}", "vatRate": 20 }] (ifade tırnak içinde yazılır; sayıya OrqLabs çevirir)
3. Ekibe bildir kutusu: Fatura oluşturuldu: {{ $json.invoiceId }}.
4. İş akışını Etkinleştir. Bundan sonra her Ödendi işaretlemesinde taslak fatura Paraşüt'te oluşur; e-Fatura/e-Arşiv gönderimini Paraşüt'ten yaparsınız.

Olay anlaşma başına bir kez yayınlanır: zaten Ödendi olan bir anlaşmayı yeniden kaydetmek yeni fatura açmaz.

Deneme (gönderim yok) modunda fatura oluşturulmaz; Paraşüt adımı yalnızca neyi yapacağını gösterir.

Başka bir sistemden: Ödeme bilgisini ödeme sağlayıcınızdan (ör. iyzico, PayTR tetikleyicileri) veya bir Webhook tetikleyicisinden alıp aynı Paraşüt kutusunu bağlayabilirsiniz. Ayrıntılar: Webhook ve API tetikleyicileri.

Dikkat: Tutarı KDV hariç girin. Anlaşma bedeli KDV dahil konuşulduysa unitPrice = bedel ÷ 1,20 (KDV %20 için).

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et bir erişim anahtarı alır ve firmanın müşteri listesinden bir kayıt okur; firma kimliği ve toplam müşteri sayısı döner. Fatura oluşturma iznini doğrulamaz; ilk faturayı küçük bir tutarla deneyip Paraşüt'ten silebilirsiniz.

Kimlik bilgilerini yenileme#

• Kullanıcının Paraşüt şifresi değişirse bağlantı AUTH hatası verir; Kimlik bilgileri → Güncelle ile yeni şifreyi girin.
• Client secret yenilenirse aynı yoldan güncelleyin.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Fatura müşteriye otomatik gönderilir mi? Hayır. OrqLabs faturayı Paraşüt'te oluşturur; e-Fatura/e-Arşiv olarak resmileştirme ve gönderme Paraşüt'ten yapılır.

Aynı müşteri tekrar tekrar oluşur mu? Contact ID boşsa önce vergi numarası, sonra e-posta ile aranır; eşleşen müşteri varsa o kullanılır.

Döviz faturası kesebilir miyim? Evet; USD, EUR veya GBP seçin. Kur girmezseniz Paraşüt'ün varsayılanı kullanılır.

Sonraki adım#

• Tetikleyiciler ve zamanlamalar
• Webhook ve API tetikleyicileri
• Veri kutuları