ASP.NET & ASP Web API ile Paraşüt API v4 Kullanımı Part 1
Api bilgilerini almak istiyorum diye mail attığınız zaman Client ID & Client Secret bilgileri geliyor.
API v4:
Firma Numarasını Öğrenme:
Postman:
https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop?hl=tr
Api de 2. grant_type=password yöntemi ile token alınabilir.
Kullanıcı Bilgisi Getirme:
Satış Faturası Oluşturma:
Ürün Listesi ve Oluşturma linkleri yanlış verilmiş:
Ürün Listesi: https://apidocs.parasut.com/#operation/listProducts
Ürün Oluşturma: https://apidocs.parasut.com/#operation/createProduct

Ben Ürünleri Elle Paraşüt’ün sitesinden oluşturmayı tercih ediyorum.
Product ID Contact ID gibi değerleri alttaki gibi bulabilirsiniz.
https://api.parasut.com/v4/{company_id}/contacts
https://api.parasut.com/v4/{company_id}/products
Bunlar site de de veriliyor.
Satış Faturası Oluşturma Örnek JSON:
Sitede verilen örneği kopyalayıp yapıştırdığınızda değişik hatalar veriyor alttaki eğer ID leri kendinize göre değiştirdiyseniz hata vermez.
https://paste.laravel.io/Zo0M8
Herhangi bir Tag eklenmesi istenmiyorsa bu:
https://paste.laravel.io/YAgrQ
Not: Fatura Sıra No dediği:
invoice_id oluyor. Aynı id ile kayıt ettirmiyor. Ve 0 dan büyük olmalı.
Tahsil Edildi şeklinde yapmak için:
https://api.parasut.com/v4/{company_id}/sales_invoices/{id}/payments
Tahsil edilen değer (amount (meblağ)) 5 TL den büyük olmalı.
Müşteri ekleme:
Müşteri eklenince aynı zamanda Tedarikçi de ekliyor. Tedarikçiyi silince müşteriyi de siliyor. Sorunu çözebilirsem güncelleme atarım.
https://paste.laravel.io/BNYz3
Buraya kadar ki kısım da Paraşüt API v4’ü inceledik. Sonraki partta Postman da yapılanların ASP.NET ve ASP Web API de yapımını inceleyeceğiz.
— — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — —
Skype dan gelen özel istek üzerine. Fatura oluşturma tahsil etme ve gönderme.
Daha gerçekci bir satış faturası:
https://paste.laravel.io/22e2a9de-9285-4b91-8ec0-f93615859e83
Daha gerçekci bir tahsilat ekleme:
https://paste.laravel.io/50f6f33d-3a92-44a4-9552-54b851db6ec2
Faturayı Resmileştirme:
E-Fatura kullanıcı olup olmadığının kontrolü: Alttaki TC NO benimki o yüzden e-fatura çıkar.
https://api.parasut.com/v4/FirmaNo/e_invoice_inboxes?filter%5Bvkn%5D=56350555622
Gelen veriler içindeki e_invoice_address kısmını alın.
E-Fatura Yollama:
https://api.parasut.com/v4/FirmaNo/e_invoices
https://paste.laravel.io/8e4e4d6d-ef0e-4b04-ab5e-7fa13aaff515
Links kısmındaki self e istek atınca status kısmında done yazıyorsa tamamdır.
NOT:
Paraşütün sitesinde verilen JSON örneğinde relationships sales_invoice değeri yanlış girilmiş. sales_invoice yerine invoice olucak. Üstteki linkteki JSON daki gibi olucak. Bunu da destek kısmına yazarım ama satış faturası oluşturma linklerinin yanlış olduğunu söyleyeli baya oldu hala yanlış. Büyük ihtimalle düzeltmeyeceklerdir. Başka hatalar alan yorum atabilir.
vat_withholding_code yazan kısım Tevkifat oranına ait vergi kodu. — Bu dosyada ilgili kodları bulabilirsiniz: https://www.efatura.gov.tr/dosyalar/kilavuzlar/UBLTR_1.2_Kilavuzlar.zip
Bilgisayarla ilgili bir şey olmadığı için 650 yazdım. Diğer parametlere de alttaki linkten bakıp kendinize göre ayarlayın kdv muafiyeti ile ilgili diğerleri.
https://apidocs.parasut.com/#operation/createEInvoice
E-Arşiv Yollama:
https://api.parasut.com/v4/FirmaNo/e_archives
Shipment kısmını kargo yollamayacağım için sildim o kısmı kendinize göre değiştirirsiniz.
https://paste.laravel.io/52f5c952-339b-4233-bb0a-904bb523ff91
Links kısmındaki self e istek atınca status kısmında done yazıyorsa tamamdır.
PDF Olarak İndirme:
https://api.parasut.com/v4/FirmaNo/sales_invoices/5135439?include=active_e_document
Satış Faturası getirme linkinin sonuna ?include=active_e_document eklendiğinde pdf urlsi geliyor oraya gidince ordaki url kısmında pdf indirme linki geliyor.
Link 1 saat aktifmiş. O linkten pdf’i indirip mail atan bir kod hazırlaması gerek. Part 2 ye sonra eklerim.
Originally published at teknoseyir.com on July 28, 2017.