Paraşüt entegrasyonu, e-ticaret sitenizi, CRM'inizi ya da kendi yazılımınızı Paraşüt ön muhasebe hesabınıza bağlayarak müşteri, ürün, fatura ve tahsilat kayıtlarının elle girilmeden oluşmasını sağlar. Bunun iki yolu vardır: Paraşüt'ün hazır e-ticaret bağlantıları ya da doğrudan Paraşüt API v4 ile yazılan özel entegrasyon.
İlgili içerikler: REST API güvenliği · API istek sınırı stratejileri · Luca entegrasyonu
Hazır Entegrasyon mu, API mi?
Kullandığınız platform Paraşüt'ün hazır listesindeyse önce ona bakın. Paraşüt'ün e-Ticaret kılavuzunda WooCommerce, Shopify, Ticimax, Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama ve PttAVM bağlantıları sayılıyor. Bu bağlantılar platformun kendi API bilgileri girilerek kurulur, kod yazmak gerekmez.
| Hazır entegrasyon | API ile özel entegrasyon | |
|---|---|---|
| Kurulum | Panelden, platform API bilgileriyle | Geliştirici gerekir |
| Esneklik | Paraşüt'ün sunduğu alanlarla sınırlı | Belgelenmiş tüm uç noktalar kullanılabilir |
| Uygun olduğu durum | Listede olan e-ticaret ve pazaryeri altyapıları | Kendi yazılımı, CRM, özel sipariş akışı |
Paraşüt API v4 Temel Bilgileri
- Adres: İstekler
https://api.parasut.com/v4/{firma_no}/...biçimindedir.firma_no, firmanızın Paraşüt'teki numarasıdır. - Biçim: Belgeye göre API büyük ölçüde JSON:API standardını izler. Gövde
data,attributesverelationshipsalanlarından oluşur. - Kimlik doğrulama: OAuth2. Token adresi
https://api.parasut.com/oauth/token. - Token süresi: Erişim tokenı 2 saat (7200 saniye) geçerlidir, süresi dolunca refresh token ile yenilenir.
- İstek sınırı: Belgedeki ifadeyle 10 saniyede 10 istek.
API Bilgileri Nasıl Alınır?
Paraşüt belgesine göre CLIENT_ID, CLIENT_SECRET ve REDIRECT_URL bilgileri için destek@parasut.com adresine yazılır. Kendi redirect adresinizi tanımlatmak için de aynı adres kullanılır. API erişiminin hangi pakete dahil olduğu herkese açık belgede yazmıyor; başvururken sorun.
Token almanın üç yolu belgelenmiştir: authorization_code (kullanıcının Paraşüt'te izin verdiği akış), password (e-posta ve şifreyle, kendi sunucunuzdaki tek firmalı entegrasyonlar için) ve süresi dolan token için refresh_token.
curl -X POST https://api.parasut.com/oauth/token \
-d grant_type=password \
-d client_id=CLIENT_ID \
-d client_secret=CLIENT_SECRET \
-d username=paraşüt-eposta \
-d password=paraşüt-şifre \
-d redirect_uri=urn:ietf:wg:oauth:2.0:oobSık Kullanılan Uç Noktalar
| İş | Uç nokta |
|---|---|
| Müşteri ve tedarikçi | contacts |
| Ürün | products |
| Satış faturası | sales_invoices |
| Tahsilat ekleme | sales_invoices/{id}/payments |
| e-Fatura mükellefi sorgulama | e_invoice_inboxes |
| e-Fatura ve e-Arşiv | e_invoices, e_archives |
| Asenkron iş takibi | trackable_jobs |
| Stok ve depo | stock_updates, warehouses |
Bir müşteri oluşturma isteği JSON:API biçiminde şöyle görünür (yeni kayıtta id gönderilmez):
curl -X POST https://api.parasut.com/v4/FIRMA_NO/contacts \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/vnd.api+json" \
-d '{"data":{"type":"contacts","attributes":{"name":"Örnek Ltd. Şti.","account_type":"customer"}}}'Siparişten e-Faturaya: Tipik Akış
- Müşteriyi bulun veya oluşturun: Aynı müşteriyi iki kez açmamak için önce
contactsüzerinde arayın. - Satış faturasını oluşturun:
sales_invoicesile kalemleri, ürün ilişkilerini ve vergi oranlarını gönderin. - Belge türünü belirleyin: Alıcının vergi numarasıyla
e_invoice_inboxessorgulanır. Gelen kutusu varsa e-Fatura, yoksa e-Arşiv kesilir. Belgeye göre ihracat faturaları her zaman e-Faturadır. - Resmileştirin ve bekleyin: e-Fatura ve e-Arşiv oluşturma asenkron çalışır, bir iş numarası döner.
trackable_jobsile durum (pending, running, error, done) izlenir. - Tahsilatı işleyin: Ödeme alındıysa
sales_invoices/{id}/paymentsile kaydedin. - PDF'i alın: PDF hazır değilse uç nokta 204 döner. Dönen PDF adresi 1 saat geçerlidir ve belgeye göre doğrudan müşteriyle paylaşılmamalıdır; dosyayı indirip kendi sisteminizden sunun.
Sık Yapılan Hatalar
- Yanlış firma numarası: Birden fazla firmaya erişimi olan kullanıcıda her isteğin doğru
firma_noile gittiğinden emin olun. - Token yenilememek: 2 saat sonra istekler yetki hatası verir. Refresh token ile yenilediğinizde yeni bir refresh token da gelir; eskisini değil yenisini saklayın.
- e-Fatura kontrolünü atlamak: Alıcının e-Fatura mükellefi olup olmadığını sormadan belge türü seçmek hatalı resmileştirmeye yol açar.
- Asenkron işi beklememek: Resmileştirme isteği hemen sonuç döndürmez; iş tamamlanmadan PDF istemek boş yanıt verir.
Sık Sorulan Sorular
Paraşüt API için test ortamı var mı?
Herkese açık API belgesinde ayrı bir test (sandbox) ortamından söz edilmiyor. Destek ekibinden API bilgilerini isterken test için nasıl ilerlemeniz gerektiğini sorun.
Paraşüt webhook gönderiyor mu?
Herkese açık belgede webhook bölümü görünmüyor. Değişiklikleri izlemek için belirli aralıklarla listeleme uçlarını sorgulamak gerekir.
Kod yazmadan e-ticaret sitemi bağlayabilir miyim?
Altyapınız Paraşüt'ün hazır listesindeyse evet. WooCommerce, Shopify, Ticimax ve büyük pazaryerleri bu listede yer alıyor. Pazaryeri tarafını pazaryeri entegrasyonu rehberinde anlattık.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.